update_security_config

update_security_config(**kwargs)

Updates a security configuration for OpenSearch Serverless. For more information, see SAML authentication for Amazon OpenSearch Serverless.

See also: AWS API Documentation

Request Syntax

response = client.update_security_config(
    clientToken='string',
    configVersion='string',
    description='string',
    id='string',
    samlOptions={
        'groupAttribute': 'string',
        'metadata': 'string',
        'sessionTimeout': 123,
        'userAttribute': 'string'
    }
)
Parameters
  • clientToken (string) --

    Unique, case-sensitive identifier to ensure idempotency of the request.

    This field is autopopulated if not provided.

  • configVersion (string) --

    [REQUIRED]

    The version of the security configuration to be updated. You can find the most recent version of a security configuration using the GetSecurityPolicy command.

  • description (string) -- A description of the security configuration.
  • id (string) --

    [REQUIRED]

    The security configuration identifier. For SAML the ID will be saml/<accountId>/<idpProviderName> . For example, saml/123456789123/OKTADev .

  • samlOptions (dict) --

    SAML options in in the form of a key-value map.

    • groupAttribute (string) --

      The group attribute for this SAML integration.

    • metadata (string) -- [REQUIRED]

      The XML IdP metadata file generated from your identity provider.

    • sessionTimeout (integer) --

      The session timeout, in minutes. Minimum is 15 minutes and maximum is 1440 minutes (24 hours or 1 day). Default is 60 minutes.

    • userAttribute (string) --

      A user attribute for this SAML integration.

Return type

dict

Returns

Response Syntax

{
    'securityConfigDetail': {
        'configVersion': 'string',
        'createdDate': 123,
        'description': 'string',
        'id': 'string',
        'lastModifiedDate': 123,
        'samlOptions': {
            'groupAttribute': 'string',
            'metadata': 'string',
            'sessionTimeout': 123,
            'userAttribute': 'string'
        },
        'type': 'saml'
    }
}

Response Structure

  • (dict) --

    • securityConfigDetail (dict) --

      Details about the updated security configuration.

      • configVersion (string) --

        The version of the security configuration.

      • createdDate (integer) --

        The date the configuration was created.

      • description (string) --

        The description of the security configuration.

      • id (string) --

        The unique identifier of the security configuration.

      • lastModifiedDate (integer) --

        The timestamp of when the configuration was last modified.

      • samlOptions (dict) --

        SAML options for the security configuration in the form of a key-value map.

        • groupAttribute (string) --

          The group attribute for this SAML integration.

        • metadata (string) --

          The XML IdP metadata file generated from your identity provider.

        • sessionTimeout (integer) --

          The session timeout, in minutes. Minimum is 15 minutes and maximum is 1440 minutes (24 hours or 1 day). Default is 60 minutes.

        • userAttribute (string) --

          A user attribute for this SAML integration.

      • type (string) --

        The type of security configuration.

Exceptions

  • OpenSearchServiceServerless.Client.exceptions.InternalServerException
  • OpenSearchServiceServerless.Client.exceptions.ResourceNotFoundException
  • OpenSearchServiceServerless.Client.exceptions.ConflictException
  • OpenSearchServiceServerless.Client.exceptions.ValidationException