SSOAdmin / Client / update_instance_access_control_attribute_configuration

update_instance_access_control_attribute_configuration#

SSOAdmin.Client.update_instance_access_control_attribute_configuration(**kwargs)#

Updates the IAM Identity Center identity store attributes that you can use with the IAM Identity Center instance for attributes-based access control (ABAC). When using an external identity provider as an identity source, you can pass attributes through the SAML assertion as an alternative to configuring attributes from the IAM Identity Center identity store. If a SAML assertion passes any of these attributes, IAM Identity Center replaces the attribute value with the value from the IAM Identity Center identity store. For more information about ABAC, see Attribute-Based Access Control in the IAM Identity Center User Guide.

See also: AWS API Documentation

Request Syntax

response = client.update_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]

    Updates the attributes for your ABAC configuration.

    • 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