How can we help?

AWS Identity Center Integration

Netanel Hugi
Netanel Hugi
  • Updated

Overview

Torii integrates with AWS Identity Center and syncs:

User Fields License Types
Username AWS Identity Center
Status
  • Torii supports syncing multiple AWS Identity Center accounts.
  • You can constantly stay updated with application information from our Integrations Page
    >> Integration Capabilities button >> Integration Capabilities table.

Important

Role and policy must be created in your AWS Management account. 

Side note:
Even though the role ARN is created within a specific AWS account, it isn’t limited to data from that account only. The Identity Store is defined at an organization-wide level, and all of your AWS accounts are associated with it. 

As a result, when Torii lists users from the Identity Store, it retrieves all users in the organization, regardless of which AWS account the role was created under.

Requirements

Accounts & Permissions

  • To connect this integration, we require the following:
    • Role ARN (Required)
    • Region (Required)
    • Identity Store ID (Required)
    • InstanceArn (Required)


How to Generate the Required Values

1. Retrieve the Identity Store ID and InstanceArn

  • Navigate to AWS IAM Identity CenterSettings
  • Copy the Identity Store ID and InstanceArn

    Untitled design.png

2. Create the IAM Policy

  • Navigate to the IAM page in your AWS Console.
  • Click PoliciesCreate Policy
     
  • In the JSON tab, paste the following:
{
 "Version": "2012-10-17",
 "Statement": [
   {
     "Sid": "IdentityStoreRead",
     "Effect": "Allow",
     "Action": [
       "identitystore:ListUsers",
       "identitystore:DescribeUser",
       "identitystore:ListGroups",
       "identitystore:DescribeGroup",
       "identitystore:ListGroupMemberships",
       "identitystore:ListGroupMembershipsForMember"
     ],
     "Resource": "*"
   },
   {
     "Sid": "IdentityCenterRead",
     "Effect": "Allow",
     "Action": [
       "sso:ListInstances",
       "sso:ListPermissionSets",
       "sso:DescribePermissionSet",
       "sso:ListAccountAssignments",
       "sso:ListAccountAssignmentsForPrincipal",
       "sso:ListPermissionSetsProvisionedToAccount",
       "sso:ListManagedPoliciesInPermissionSet",
       "sso:GetInlinePolicyForPermissionSet",
       "sso:ListCustomerManagedPolicyReferencesInPermissionSet",
       "sso:ListTagsForResource"
     ],
     "Resource": "*"
   },
   {
     "Sid": "OrganizationsReadForAccountNames",
     "Effect": "Allow",
     "Action": [
       "organizations:DescribeOrganization",
       "organizations:ListAccounts",
       "organizations:DescribeAccount",
       "organizations:ListTagsForResource"
     ],
     "Resource": "*"
   }
 ]
}

  • Click Next, then give the policy a name (for example, torii-identity-center-integration-policy).
  • Click Create Policy.
image (7).png

3. Create the IAM Role

  • Go to RolesCreate Role
  • Choose AWS AccountCustom trust policy

  • Paste the JSON below and replace sts:ExternalId with your Torii Org ID:
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::458158785647:role/torii-integration-delegator"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "<Enter Your Torii Organization Id Here>"
        }
      }
    }
  ]
}
  • Click Next
  • Search for the policy you've created in the 2nd step, choose it, and click next  
     
  • Name the role and click Create Role
  • Copy the role ARN

Untitled design.png

How to Connect the Integration

  1. Go to the Integrations page in Torii
  2. Select the AWS Identity Center tile
    image (2).png
  3. Click Connect
  4. Enter:
    • Role ARN
    • Identity Store ID
    • Region

      image (6).png

  5. Click Connect
  6. Once synced, a green checkbox will appear
    image (3).png

For any further questions, please contact Torii Support.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request