feat(enterprise-scim): add github_enterprise_scim_user data source

Retrieve information about a single SCIM user by ID.

Includes:
- Data source implementation
- Acceptance tests
- Documentation

Author: github-actions[bot]

github/data_source_github_enterprise_scim_user.go

@@ -0,0 +1,78 @@
+package github
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func dataSourceGithubEnterpriseSCIMUser() *schema.Resource {
+	s := enterpriseSCIMUserSchema()
+	s["enterprise"] = &schema.Schema{
+		Description: "The enterprise slug.",
+		Type:        schema.TypeString,
+		Required:    true,
+	}
+	s["scim_user_id"] = &schema.Schema{
+		Description: "The SCIM user ID.",
+		Type:        schema.TypeString,
+		Required:    true,
+	}
+
+	return &schema.Resource{
+		Description: "Lookup SCIM provisioning information for a single GitHub enterprise user.",
+		ReadContext: dataSourceGithubEnterpriseSCIMUserRead,
+		Schema:      s,
+	}
+}
+
+func dataSourceGithubEnterpriseSCIMUserRead(ctx context.Context, d *schema.ResourceData, meta any) diag.Diagnostics {
+	client := meta.(*Owner).v3client
+
+	enterprise := d.Get("enterprise").(string)
+	scimUserID := d.Get("scim_user_id").(string)
+
+	user, _, err := client.Enterprise.GetProvisionedSCIMUser(ctx, enterprise, scimUserID)
+	if err != nil {
+		return diag.FromErr(err)
+	}
+
+	d.SetId(fmt.Sprintf("%s/%s", enterprise, scimUserID))
+
+	if err := d.Set("schemas", user.Schemas); err != nil {
+		return diag.FromErr(err)
+	}
+	if user.ID != nil {
+		if err := d.Set("id", *user.ID); err != nil {
+			return diag.FromErr(err)
+		}
+	}
+	if err := d.Set("external_id", user.ExternalID); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("user_name", user.UserName); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("display_name", user.DisplayName); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("active", user.Active); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("name", flattenEnterpriseSCIMUserName(user.Name)); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("emails", flattenEnterpriseSCIMUserEmails(user.Emails)); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("roles", flattenEnterpriseSCIMUserRoles(user.Roles)); err != nil {
+		return diag.FromErr(err)
+	}
+	if err := d.Set("meta", flattenEnterpriseSCIMMeta(user.Meta)); err != nil {
+		return diag.FromErr(err)
+	}
+
+	return nil
+}

github/data_source_github_enterprise_scim_user_test.go

@@ -0,0 +1,36 @@
+package github
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+func TestAccGithubEnterpriseSCIMUserDataSource(t *testing.T) {
+	t.Run("reads user without error", func(t *testing.T) {
+		resource.Test(t, resource.TestCase{
+			PreCheck:          func() { skipUnlessEnterprise(t) },
+			ProviderFactories: providerFactories,
+			Steps: []resource.TestStep{{
+				Config: fmt.Sprintf(`
+					data "github_enterprise_scim_users" "all" {
+						enterprise = "%s"
+					}
+
+					data "github_enterprise_scim_user" "test" {
+						enterprise   = "%[1]s"
+						scim_user_id = data.github_enterprise_scim_users.all.resources[0].id
+					}
+				`, testAccConf.enterpriseSlug),
+				Check: resource.ComposeTestCheckFunc(
+					resource.TestCheckResourceAttrSet("data.github_enterprise_scim_user.test", "id"),
+					resource.TestCheckResourceAttrSet("data.github_enterprise_scim_user.test", "user_name"),
+					resource.TestCheckResourceAttrSet("data.github_enterprise_scim_user.test", "display_name"),
+					resource.TestCheckResourceAttrSet("data.github_enterprise_scim_user.test", "schemas.#"),
+					resource.TestCheckResourceAttrSet("data.github_enterprise_scim_user.test", "emails.#"),
+				),
+			}},
+		})
+	})
+}

website/docs/d/enterprise_scim_user.html.markdown

@@ -0,0 +1,28 @@
+---
+layout: "github"
+page_title: "GitHub: github_enterprise_scim_user"
+description: |-
+  Get SCIM provisioning information for a GitHub enterprise user.
+---
+
+# github_enterprise_scim_user
+
+Use this data source to retrieve SCIM provisioning information for a single enterprise user.
+
+## Example Usage
+
+```hcl
+data "github_enterprise_scim_user" "example" {
+  enterprise   = "example-co"
+  scim_user_id = "123456"
+}
+```
+
+## Argument Reference
+
+* `enterprise` - (Required) The enterprise slug.
+* `scim_user_id` - (Required) The SCIM user ID.
+
+## Attributes Reference
+
+* `schemas`, `id`, `external_id`, `user_name`, `display_name`, `active`, `name`, `emails`, `roles`, `meta`.