OpenSearchServiceServerless / Client / update_security_config
update_security_config#
- OpenSearchServiceServerless.Client.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. Default is 60 minutes (12 hours).
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. Default is 60 minutes (12 hours).
userAttribute (string) –
A user attribute for this SAML integration.
type (string) –
The type of security configuration.
Exceptions