SSOAdmin / Client / create_instance_access_control_attribute_configuration

create_instance_access_control_attribute_configuration#

SSOAdmin.Client.create_instance_access_control_attribute_configuration(**kwargs)#

Enables the attributes-based access control (ABAC) feature for the specified IAM Identity Center instance. You can also specify new attributes to add to your ABAC configuration during the enabling process. For more information about ABAC, see Attribute-Based Access Control in the IAM Identity Center User Guide.

Note

After a successful response, call DescribeInstanceAccessControlAttributeConfiguration to validate that InstanceAccessControlAttributeConfiguration was created.

Request Syntax

response = client.create_instance_access_control_attribute_configuration(
    InstanceArn='string',
    InstanceAccessControlAttributeConfiguration={
        'AccessControlAttributes': [
            {
                'Key': 'string',
                'Value': {
                    'Source': [
                        'string',
                    ]
                }
            },
        ]
    }
)

Parameters:

InstanceArn (string) –
[REQUIRED]

The ARN of the IAM Identity Center instance under which the operation will be executed.
InstanceAccessControlAttributeConfiguration (dict) –
[REQUIRED]

Specifies the IAM Identity Center identity store attributes to add to your ABAC configuration. When using an external identity provider as an identity source, you can pass attributes through the SAML assertion. Doing so provides an alternative to configuring attributes from the IAM Identity Center identity store. If a SAML assertion passes any of these attributes, IAM Identity Center will replace the attribute value with the value from the IAM Identity Center identity store.
- AccessControlAttributes (list) – [REQUIRED]
  
  Lists the attributes that are configured for ABAC in the specified IAM Identity Center instance.
  - (dict) –
    
    These are IAM Identity Center identity store attributes that you can configure for use in attributes-based access control (ABAC). You can create permissions policies that determine who can access your AWS resources based upon the configured attribute values. When you enable ABAC and specify AccessControlAttributes, IAM Identity Center passes the attribute values of the authenticated user into IAM for use in policy evaluation.
    - Key (string) – [REQUIRED]
      
      The name of the attribute associated with your identities in your identity source. This is used to map a specified attribute in your identity source with an attribute in IAM Identity Center.
    - Value (dict) – [REQUIRED]
      
      The value used for mapping a specified attribute to an identity source.
      - Source (list) – [REQUIRED]
        
        The identity source to use when mapping a specified attribute to IAM Identity Center.
        
        (string) –

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

(dict) –

Exceptions

SSOAdmin.Client.exceptions.InternalServerException
SSOAdmin.Client.exceptions.AccessDeniedException
SSOAdmin.Client.exceptions.ThrottlingException
SSOAdmin.Client.exceptions.ValidationException
SSOAdmin.Client.exceptions.ResourceNotFoundException
SSOAdmin.Client.exceptions.ConflictException