feat: Add OIDC client resource.

This adds support for the OIDC Provider OIDCClient resource.

Author: bigkevmcd

aspell_custom.txt

@@ -43,3 +43,4 @@ destructuring
 yaml
 ttl
 pkce
+oidcclients

docs/resources/oidc_client.md

@@ -0,0 +1,51 @@
+---
+page_title: "rancher2_oidc_client Resource"
+---
+
+# rancher2\_oidc_client Resource
+
+Provides a Rancher OIDC Client. This can be used to configure the OIDC Clients
+available for the Rancher OIDC Provider.
+
+## Example Usage
+
+### Creating a Rancher OIDC Client.
+
+```hcl
+resource "rancher2_oidc_client" "oidc-test-client" {
+  description = "Access for Test Client"
+  token_expiration_seconds = 600 # expiration of the id_token and access_token
+  refresh_token_expiration_seconds = 7200 # expiration of the refresh_token
+  redirect_uris = [
+    "http://127.0.0.1:5556/auth/rancher/callback",
+    "http://127.0.0.1:33418/",
+    "https://vscode.dev/redirect"
+  ]
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `description` - A human-readable description for the OIDC Client.
+* `token_expiration_seconds` - ID Token and Access Token will only be valid for this many seconds.
+* `refresh_token_expiration_seconds` - How long can the refresh token be used for?
+* `redirect_uris` - Provides a list of allowed redirect URIs for this OIDC Client.
+* `annotations` - (Optional/Computed) Annotations for OIDC Client object (map)
+* `labels` - (Optional/Computed) Labels for OIDC Client object (map)
+
+## Attributes Reference
+
+The following attributes are exported:
+
+* `id` - (Computed) The ID of the resource (string)
+* `client_id` - (Computed) The ID to be used when authenticating as this OIDC Client.
+
+## Import
+
+OIDC Clients can be imported using the Client name in the format `<client_name>`
+
+```
+$ terraform import rancher2_oidc_client.foo &lt;CLIENT_NAME&gt;
+```

rancher2/provider.go

@@ -140,6 +140,7 @@ func Provider() terraform.ResourceProvider {
 			"rancher2_namespace":                                     resourceRancher2Namespace(),
 			"rancher2_node_driver":                                   resourceRancher2NodeDriver(),
 			"rancher2_node_pool":                                     resourceRancher2NodePool(),
+			"rancher2_oidc_client":                                   resourceRancher2OIDCClient(),
 			"rancher2_pod_security_admission_configuration_template": resourceRancher2PodSecurityAdmissionConfigurationTemplate(),
 			"rancher2_project":                                       resourceRancher2Project(),
 			"rancher2_project_role_template_binding":                 resourceRancher2ProjectRoleTemplateBinding(),

rancher2/resource_rancher2_oidc_client.go

@@ -0,0 +1,175 @@
+package rancher2
+
+import (
+	"fmt"
+	"log"
+	"maps"
+
+	"github.com/hashicorp/terraform-plugin-sdk/helper/schema"
+	managementClient "github.com/rancher/rancher/pkg/client/generated/management/v3"
+)
+
+func resourceRancher2OIDCClient() *schema.Resource {
+	return &schema.Resource{
+		Create: resourceRancher2OIDCClientCreate,
+		Read:   resourceRancher2OIDCClientRead,
+		Update: resourceRancher2OIDCClientUpdate,
+		Delete: resourceRancher2OIDCClientDelete,
+		Importer: &schema.ResourceImporter{
+			State: resourceRancher2OIDCClientImport,
+		},
+
+		Schema: oidcClientFields(),
+	}
+}
+
+func oidcClientFields() map[string]*schema.Schema {
+	s := map[string]*schema.Schema{
+		"token_expiration_seconds": {
+			Type:        schema.TypeInt,
+			Optional:    true,
+			Computed:    true,
+			Description: "The duration (in seconds) before an access token and ID token expire.",
+		},
+		"refresh_token_expiration_seconds": {
+			Type:        schema.TypeInt,
+			Optional:    true,
+			Computed:    true,
+			Description: "The duration (in seconds) a refresh token remains valid before it expires.",
+		},
+		"redirect_uris": {
+			Description: "List of allowed redirect_uris for this client.",
+			Required:    true,
+			Type:        schema.TypeList,
+			Elem: &schema.Schema{
+				Type: schema.TypeString,
+			},
+		},
+		"description": {
+			Type:        schema.TypeString,
+			Optional:    true,
+			Description: "OIDCClient description",
+		},
+		"client_id": {
+			Type:        schema.TypeString,
+			Computed:    true,
+			Description: "The Client ID for OIDC Access.",
+		},
+	}
+
+	maps.Copy(s, commonAnnotationLabelFields())
+
+	return s
+}
+
+func resourceRancher2OIDCClientCreate(d *schema.ResourceData, meta any) error {
+	log.Printf("[INFO] Creating OIDCClient")
+	oidcClient, err := expandOIDCClient(d)
+	if err != nil {
+		return err
+	}
+
+	client, err := meta.(managementClientGetter).ManagementClient()
+	if err != nil {
+		return fmt.Errorf("getting a client when creating OIDC Client: %w", err)
+	}
+
+	createdClient, err := client.OIDCClient.Create(oidcClient)
+	if err != nil {
+		return fmt.Errorf("creating OIDCClient: %w", err)
+	}
+
+	d.SetId(createdClient.ID)
+
+	return resourceRancher2OIDCClientRead(d, meta)
+}
+
+func resourceRancher2OIDCClientRead(d *schema.ResourceData, meta any) error {
+	log.Printf("[INFO] Refreshing OIDCClient ID %s", d.Id())
+
+	client, err := meta.(managementClientGetter).ManagementClient()
+	if err != nil {
+		return fmt.Errorf("getting a client when reading OIDC Client: %w", err)
+	}
+	oidcClient, err := client.OIDCClient.ByID(d.Id())
+	if err != nil {
+		if IsNotFound(err) || IsForbidden(err) || IsNotAccessibleByID(err) {
+			d.SetId("")
+			return nil
+		}
+		return fmt.Errorf("reading OIDC Client %s: %w", d.Id(), err)
+	}
+
+	return flattenOIDCClient(d, oidcClient)
+}
+
+func resourceRancher2OIDCClientUpdate(d *schema.ResourceData, meta any) error {
+	log.Printf("[INFO] Updating OIDCClient ID %s", d.Id())
+
+	client, err := meta.(managementClientGetter).ManagementClient()
+	if err != nil {
+		return fmt.Errorf("getting a client when updating OIDC Client: %w", err)
+	}
+
+	oidcClient, err := client.OIDCClient.ByID(d.Id())
+	if err != nil {
+		return fmt.Errorf("getting OIDC Client %s for update: %w", d.Id(), err)
+	}
+
+	update := map[string]any{
+		"labels":                        toMapString(d.Get("labels").(map[string]any)),
+		"annotations":                   toMapString(d.Get("annotations").(map[string]any)),
+		"description":                   d.Get("description"),
+		"redirectURIs":                  toArrayString(d.Get("redirect_uris").([]any)),
+		"tokenExpirationSeconds":        d.Get("token_expiration_seconds"),
+		"refreshTokenExpirationSeconds": d.Get("refresh_token_expiration_seconds"),
+	}
+
+	_, err = client.OIDCClient.Update(oidcClient, update)
+	if err != nil {
+		return fmt.Errorf("updating OIDC Client %s: %w", d.Id(), err)
+	}
+
+	return resourceRancher2OIDCClientRead(d, meta)
+}
+
+func resourceRancher2OIDCClientDelete(d *schema.ResourceData, meta any) error {
+	log.Printf("[INFO] Deleting OIDCClient ID %s", d.Id())
+
+	client, err := meta.(managementClientGetter).ManagementClient()
+	if err != nil {
+		return fmt.Errorf("getting a client when deleting OIDC Client: %w", err)
+	}
+
+	oidcClient, err := client.OIDCClient.ByID(d.Id())
+	if err != nil {
+		if IsNotFound(err) || IsForbidden(err) || IsNotAccessibleByID(err) {
+			d.SetId("")
+			return nil
+		}
+		return fmt.Errorf("getting OIDC Client %s for deletion: %w", d.Id(), err)
+	}
+
+	err = client.OIDCClient.Delete(oidcClient)
+	if err != nil {
+		if !IsNotFound(err) {
+			return fmt.Errorf("deleting OIDC Client %s: %w", d.Id(), err)
+		}
+	}
+
+	d.SetId("")
+	return nil
+}
+
+func resourceRancher2OIDCClientImport(d *schema.ResourceData, meta interface{}) ([]*schema.ResourceData, error) {
+	err := resourceRancher2OIDCClientRead(d, meta)
+	if err != nil || d.Id() == "" {
+		return []*schema.ResourceData{}, err
+	}
+
+	return []*schema.ResourceData{d}, nil
+}
+
+type managementClientGetter interface {
+	ManagementClient() (*managementClient.Client, error)
+}