Skip to main content

IAM Identity Center Module

Derived from aws-ia/terraform-aws-iam-identity-center v1.0.4 (Apache-2.0). Custom direct resources (aws_ssoadmin_*, aws_identitystore_*) with HCL variable inputs.

Overview

AttributeValue
Regionus-east-1 (global service)
PatternCustom direct resources (ADR-007: aws-ia fork)
Config APIHCL variables + YAML config (via config_path)
Upstreamaws-ia/terraform-aws-iam-identity-center v1.0.4
Cost$0/month (IAM Identity Center is free)
Terraform>= 1.11.0
AWS Provider>= 6.28, < 7.0

Usage

module "identity_center" {
source = "oceansoft/iam-identity-center/aws"

sso_groups = {
PlatformTeam = { group_name = "PlatformTeam", group_description = "Platform team" }
}

permission_sets = {
Admin = {
description = "Full administrator access"
session_duration = "PT4H"
aws_managed_policies = ["arn:aws:iam::aws:policy/AdministratorAccess"]
}
}

account_assignments = {
PlatformAdmins = {
principal_name = "PlatformTeam"
principal_type = "GROUP"
principal_idp = "INTERNAL"
permission_sets = ["Admin"]
account_ids = ["123456789012"]
}
}
}

Outputs

OutputTypeDescription
permission_set_arnsmap(string)Permission set name to ARN
sso_groups_idsmap(string)Group key to group ID
sso_users_idsmap(string)User key to user ID
sso_instance_arnstringSSO instance ARN
identity_store_idstringIdentity Store ID
account_assignment_datalist(object)Flattened assignments
principals_and_assignmentsmap(object)Map of principal-account-permission assignments
sso_applications_arnsmap(string)Application name to ARN
sso_applications_group_assignmentsmap(string)App-group assignment to principal ID
sso_applications_user_assignmentsmap(string)App-user assignment to principal ID

Testing

task test:tier1    # 7 snapshot tests (2-3s, $0, mock_provider)
task test:tier2 # SKIP — ssoadmin API not in LocalStack Free
task test:tier3 # Real AWS (HITL gate, $0 — SSO is free)