From b5dbf9117de118a705483f52b7a99eaf25f44020 Mon Sep 17 00:00:00 2001 From: sophiajose-okta Date: Wed, 1 Jul 2026 12:33:08 +0530 Subject: [PATCH 1/3] terraform oig update --- .../terraform-oig-resources/main/index.md | 57 ++++++++++++++++++- 1 file changed, 56 insertions(+), 1 deletion(-) diff --git a/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md b/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md index 1d43d7dae5e..d5ac0cb38ae 100644 --- a/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md +++ b/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md @@ -12,7 +12,7 @@ Learn how to create, import, and modify Okta Identity Governance (OIG) resources - Define and create OIG resources using Terraform. - Modify existing OIG resources that are managed by Terraform. - Import existing OIG resources from Okta into your Terraform state. - +- Manage OIG labels and resource owners to categorize and organize OIG resources. #### What you need - Familiarity with the Terraform terms, such as configuration, resources, state, and commands. @@ -181,3 +181,58 @@ To modify a resource already managed by Terraform: 1. Update the code in your `.tf` configuration file. 2. Run `terraform plan` to view the detected changes. 3. Run `terraform apply` to push the changes to your Okta org. + +### Manage labels + +Labels help you categorize and organize OIG resources such as apps, groups, and entitlements. You can use Terraform to manage the label resource with the given example. Simply define a label resource block in your configuration, edit it to make changes, or remove it to delete the label from your Okta org. + +``` +resource "okta_label" "test" { + name = "test-label-replace_with_uuid" + + values { + name = "test-value" + } +} +``` + +Run `terraform apply` to create the label. To add, modify, or remove label values, update the `resource` block and run `terraform apply` again. To delete the label, remove the resource block from your configuration and run `terraform apply`. + +You can also retrieve label information using the data source: + +``` +data "okta_label" "test" { + id = okta_label.test.id +} +``` + +### Manage resource owners + +Resource owners define who is responsible for managing specific OIG resources, such as apps, entitlements, and bundles. You can use Terraform to manage the resource owner resource with the given example. Simply define a resource owner block in your configuration, edit it to make changes, or remove it to revoke the owner assignment from your Okta org. + +``` +resource "okta_resource_owner" "test" { + resource_orns = ["orn:oktapreview:idp::apps:oidc_client:"] +} +``` + +Run `terraform apply` to assign the resource owner. To add or remove owners, update the `resource_orn` block and run `terraform apply` again. To revoke the owner assignment, remove the resource block from your configuration and run `terraform apply`. + +You can query resource owner information using data sources: + +``` +data "okta_resource_owner" "test" { + parent_resource_orn = "orn:oktapreview:idp::apps:oidc_client:" + depends_on = [okta_resource_owner.test] +} +data "okta_resource_owner" "example" { parent_resource_orn = "orn:oktapreview:idp::apps:oidc_client:" } + +``` + +To discover which resources do not have owners assigned, use: + +``` +data "okta_resource_owners_catalog_resource" "test" { + parent_resource_orn = "orn:oktapreview:idp::apps:oidc_client:" +} +``` \ No newline at end of file From 6b413ad2c328780c70c387d69a0651a921f461d7 Mon Sep 17 00:00:00 2001 From: sophiajose-okta Date: Wed, 1 Jul 2026 12:34:01 +0530 Subject: [PATCH 2/3] terraform oig update --- .../docs/guides/terraform-oig-resources/main/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md b/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md index d5ac0cb38ae..5e2478dce78 100644 --- a/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md +++ b/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md @@ -15,6 +15,7 @@ Learn how to create, import, and modify Okta Identity Governance (OIG) resources - Manage OIG labels and resource owners to categorize and organize OIG resources. #### What you need + - Familiarity with the Terraform terms, such as configuration, resources, state, and commands. - An Okta org that's subscribed to [Okta Identity Governance](https://www.okta.com/products/identity-governance/). - A Terraform configuration that can access your Okta org. See [Okta provider configuration](#okta-provider-configuration). From 6afeee076206198f4c80bc05f65b2b8f66d24759 Mon Sep 17 00:00:00 2001 From: sophiajose-okta Date: Thu, 2 Jul 2026 09:00:01 +0530 Subject: [PATCH 3/3] editorial suggestions --- .../docs/guides/terraform-oig-resources/main/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md b/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md index 5e2478dce78..98d48ee78ff 100644 --- a/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md +++ b/packages/@okta/vuepress-site/docs/guides/terraform-oig-resources/main/index.md @@ -185,7 +185,7 @@ To modify a resource already managed by Terraform: ### Manage labels -Labels help you categorize and organize OIG resources such as apps, groups, and entitlements. You can use Terraform to manage the label resource with the given example. Simply define a label resource block in your configuration, edit it to make changes, or remove it to delete the label from your Okta org. +Labels help you categorize and organize OIG resources such as apps, groups, and entitlements. You can use Terraform to manage the label resource with the given example. Define a label resource block in your configuration, edit it to make changes, or remove it to delete the label from your Okta org. ``` resource "okta_label" "test" { @@ -209,7 +209,7 @@ data "okta_label" "test" { ### Manage resource owners -Resource owners define who is responsible for managing specific OIG resources, such as apps, entitlements, and bundles. You can use Terraform to manage the resource owner resource with the given example. Simply define a resource owner block in your configuration, edit it to make changes, or remove it to revoke the owner assignment from your Okta org. +Resource owners define who is responsible for managing specific OIG resources, such as apps, entitlements, and bundles. You can use Terraform to manage the resource owner resource with the given example. Define a resource owner block in your configuration, edit it to make changes, or remove it to revoke the owner assignment from your Okta org. ``` resource "okta_resource_owner" "test" { @@ -230,7 +230,7 @@ data "okta_resource_owner" "example" { parent_resource_orn = "orn:oktapreview:id ``` -To discover which resources do not have owners assigned, use: +To discover which resources do not have owners assigned, use the following: ``` data "okta_resource_owners_catalog_resource" "test" {