feat: Add user management resources and data sources

Author: gpontejos-cs

docs/data-sources/user.md

@@ -0,0 +1,36 @@
+---
+page_title: "crowdstrike_user Data Source - crowdstrike"
+subcategory: "User"
+description: |-
+  This data source provides information about an existing CrowdStrike user in the Falcon Console.
+  API Scopes
+  The following API scopes are required:
+  User Management | Read & Write
+---
+
+# crowdstrike_user (Data Source)
+
+This data source provides information about an existing CrowdStrike user in the Falcon Console.
+
+## API Scopes
+
+The following API scopes are required:
+
+- User Management | Read & Write
+
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `cid` (String) The CrowdStrike Customer ID (CID) where the existing user resides. If not assigned, the CID associated with the provider credentials will be used.
+- `uid` (String) The user's email address, which serves as their username. Either this or the UUID must be provided to locate an existing user.
+- `uuid` (String) Unique identifier assigned to the user by CrowdStrike. Either uid or uuid must be provided to find an existing user
+
+### Read-Only
+
+- `first_name` (String) First name of the user.
+- `last_name` (String) Last name of the user.

docs/data-sources/user_roles.md

@@ -0,0 +1,30 @@
+---
+page_title: "crowdstrike_user_roles Data Source - crowdstrike"
+subcategory: "User Roles"
+description: |-
+  This data source retrieves available roles for a specified CID.
+  API Scopes
+  The following API scopes are required:
+  User Management | Write
+---
+
+# crowdstrike_user_roles (Data Source)
+
+This data source retrieves available roles for a specified CID.
+
+## API Scopes
+
+The following API scopes are required:
+
+- User Management | Write
+
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `cid` (String) The CrowdStrike Customer ID (CID) associated with the user roles to be retrieved. If not specified, the CID associated with the provider credentials will be used.
+- `role_ids` (List of String) List of role IDs associated with the specified CID

docs/resources/user.md

@@ -0,0 +1,94 @@
+---
+page_title: "crowdstrike_user Resource - crowdstrike"
+subcategory: "User"
+description: |-
+  This resource allows management of a user on the CrowdStrike Falcon Platform.
+  Users represent the people who access the Falcon console to manage your Falcon environment. Every user account has a home CID. The home CID is where a user account is created, stored, and managed.
+  For newly created users, the system automatically sends an email containing a link for password configuration, unless the user's CID employs Single Sign-On (SSO).
+  API Scopes
+  The following API scopes are required:
+  User Management | Read & Write
+---
+
+# crowdstrike_user (Resource)
+
+This resource allows management of a user on the CrowdStrike Falcon Platform.
+
+Users represent the people who access the Falcon console to manage your Falcon environment. Every user account has a home CID. The home CID is where a user account is created, stored, and managed.
+For newly created users, the system automatically sends an email containing a link for password configuration, unless the user's CID employs Single Sign-On (SSO).
+
+## API Scopes
+
+The following API scopes are required:
+
+- User Management | Read & Write
+
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    crowdstrike = {
+      source = "registry.terraform.io/crowdstrike/crowdstrike"
+    }
+  }
+}
+
+provider "crowdstrike" {
+  cloud = "us-2"
+}
+
+
+resource "crowdstrike_user" "example" {
+  uid        = "[email protected]"
+  first_name = "FirstName"
+  last_name  = "LastName"
+  cid        = "ABCDEF0123456789ABCDEF0123456789"
+}
+
+output "user_uuid" {
+  value = crowdstrike_user.example.uuid
+}
+output "user_uid" {
+  value = crowdstrike_user.example.uid
+}
+output "user_cid" {
+  value = crowdstrike_user.example.cid
+}
+output "user_first_name" {
+  value = crowdstrike_user.example.first_name
+}
+output "user_last_name" {
+  value = crowdstrike_user.example.last_name
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `first_name` (String) First name of the user.
+- `last_name` (String) Last name of the user.
+- `uid` (String) The username to assign to the user. This must be a valid email address. Either uid or uuid must be provided to find an existing user.
+
+### Optional
+
+- `cid` (String) The CrowdStrike Customer ID (CID) for user creation. If not specified, the CID associated with the provider credentials will be used.
+
+### Read-Only
+
+- `uuid` (String) Unique identifier assigned to the user by CrowdStrike.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+# User can be imported by specifying the UUID.
+# The UUID can be found in the URL of the user's profile page within the Falcon UI via the query string.
+# Example:
+# https://falcon.crowdstrike.com/users-v2/?id=683adeb9-100a-43e6-8968-b2934ebe6a8b
+terraform import crowdstrike_user.example 683adeb9-100a-43e6-8968-b2934ebe6a8b
+```

docs/resources/user_role_assignments.md

@@ -0,0 +1,38 @@
+---
+page_title: "crowdstrike_user_role_assignments Resource - crowdstrike"
+subcategory: "User Role Assignments"
+description: |-
+  This resource manages user roles for an existing CrowdStrike userUser roles determine what a user can see and do in the Falcon console. Every Falcon user is required to have at least one role, which is assigned when a user account is created.
+  User roles are granted at the CID level, and you can have different roles in each CID you're associated with. In each CID, you have access to all of the features that your roles allow.
+  API Scopes
+  The following API scopes are required:
+  User Management | Read & Write
+---
+
+# crowdstrike_user_role_assignments (Resource)
+
+This resource manages user roles for an existing CrowdStrike userUser roles determine what a user can see and do in the Falcon console. Every Falcon user is required to have at least one role, which is assigned when a user account is created.
+User roles are granted at the CID level, and you can have different roles in each CID you're associated with. In each CID, you have access to all of the features that your roles allow.
+
+## API Scopes
+
+The following API scopes are required:
+
+- User Management | Read & Write
+
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `assigned_role_ids` (Set of String) Roles to assign to the user. All available for a cid can be retrieved with the `crowdstrike_user_roles` data source
+
+### Optional
+
+- `cid` (String) The CrowdStrike Customer ID (CID) where the existing user resides. If not specified, the CID associated with the provider credentials will be used.
+- `skip_revoke_on_destroy` (Boolean) Retain user permissions upon resource deletion, bypassing the default revocation process
+- `uid` (String) The user's email address, which serves as their username. Either uid or uuid must be provided to find an existing user.
+- `uuid` (String) Unique identifier assigned to the user by CrowdStrike. Either uid or uuid must be provided to find an existing user.

examples/data-sources/crowdstrike_user_data_source/data-source.tf

@@ -0,0 +1,32 @@
+terraform {
+  required_providers {
+    crowdstrike = {
+      source = "registry.terraform.io/crowdstrike/crowdstrike"
+    }
+  }
+}
+
+provider "crowdstrike" {
+  cloud = "us-2"
+}
+
+
+data "crowdstrike_user" "example" {
+  uuid = "2db50655-9b58-4d63-9ddd-3edd6499f087"
+}
+
+output "user_data_source_uuid" {
+  value = data.crowdstrike_user.example.uuid
+}
+output "user_data_source_uid" {
+  value = data.crowdstrike_user.example.uid
+}
+output "user_data_source_cid" {
+  value = data.crowdstrike_user.example.cid
+}
+output "user_data_source_first_name" {
+  value = data.crowdstrike_user.example.first_name
+}
+output "user_data_source_last_name" {
+  value = data.crowdstrike_user.example.last_name
+}

examples/data-sources/crowdstrike_user_roles_data_source/data-source.tf

@@ -0,0 +1,19 @@
+terraform {
+  required_providers {
+    crowdstrike = {
+      source = "registry.terraform.io/crowdstrike/crowdstrike"
+    }
+  }
+}
+
+provider "crowdstrike" {
+  cloud = "us-2"
+}
+
+
+data "crowdstrike_user_roles" "all" {}
+
+# Filter all roles that contain read or guest
+output "user_data_source" {
+  value = [for role in data.crowdstrike_user_roles.all.role_ids : role if can(regex("(read|guest)", role))]
+}

examples/resources/crowdstrike_user/import.sh

@@ -0,0 +1,5 @@
+# User can be imported by specifying the UUID.
+# The UUID can be found in the URL of the user's profile page within the Falcon UI via the query string.
+# Example:
+# https://falcon.crowdstrike.com/users-v2/?id=683adeb9-100a-43e6-8968-b2934ebe6a8b
+terraform import crowdstrike_user.example 683adeb9-100a-43e6-8968-b2934ebe6a8b

examples/resources/crowdstrike_user/resource.tf

@@ -0,0 +1,35 @@
+terraform {
+  required_providers {
+    crowdstrike = {
+      source = "registry.terraform.io/crowdstrike/crowdstrike"
+    }
+  }
+}
+
+provider "crowdstrike" {
+  cloud = "us-2"
+}
+
+
+resource "crowdstrike_user" "example" {
+  uid        = "[email protected]"
+  first_name = "FirstName"
+  last_name  = "LastName"
+  cid        = "ABCDEF0123456789ABCDEF0123456789"
+}
+
+output "user_uuid" {
+  value = crowdstrike_user.example.uuid
+}
+output "user_uid" {
+  value = crowdstrike_user.example.uid
+}
+output "user_cid" {
+  value = crowdstrike_user.example.cid
+}
+output "user_first_name" {
+  value = crowdstrike_user.example.first_name
+}
+output "user_last_name" {
+  value = crowdstrike_user.example.last_name
+}

examples/resources/crowdstrike_user_role_assignment/import.sh

@@ -0,0 +1,2 @@
+# Import existing User Role Assignment by specifying the user's UUID followed by their assigned roles, separated by commas
+terraform import crowdstrike_user_role_assignments.example "2db50655-9b58-4d63-9ddd-3edd6499f087,falcon_console_guest,image_viewer"

examples/resources/crowdstrike_user_role_assignment/resource.tf

@@ -0,0 +1,35 @@
+terraform {
+  required_providers {
+    crowdstrike = {
+      source = "registry.terraform.io/crowdstrike/crowdstrike"
+    }
+  }
+}
+
+provider "crowdstrike" {
+  cloud = "us-2"
+}
+
+locals {
+  // Get all read and guest roles
+  read_guest_roles = [for role in data.crowdstrike_user_roles.all.role_ids : role if can(regex("(read|guest)", role))]
+}
+
+data "crowdstrike_user_roles" "all" {}
+
+resource "crowdstrike_user" "example" {
+  uid        = "[email protected]"
+  first_name = "FirstName"
+  last_name  = "LastName"
+  cid        = "ABCDEF0123456789ABCDEF0123456789"
+}
+
+resource "crowdstrike_user_role_assignments" "example" {
+  uuid              = crowdstrike_user.example.uuid
+  assigned_role_ids = local.read_guest_roles
+  depends_on        = [crowdstrike_user.example]
+}
+
+output "user_role_assignments" {
+  value = crowdstrike_user_role_grant.example
+}