ManagedGrafana / Client / describe_workspace_authentication

describe_workspace_authentication#

ManagedGrafana.Client.describe_workspace_authentication(**kwargs)#

Displays information about the authentication methods used in one Amazon Managed Grafana workspace.

See also: AWS API Documentation

Request Syntax

response = client.describe_workspace_authentication(
    workspaceId='string'
)
Parameters:

workspaceId (string) –

[REQUIRED]

The ID of the workspace to return authentication information about.

Return type:

dict

Returns:

Response Syntax

{
    'authentication': {
        'awsSso': {
            'ssoClientId': 'string'
        },
        'providers': [
            'AWS_SSO'|'SAML',
        ],
        'saml': {
            'configuration': {
                'allowedOrganizations': [
                    'string',
                ],
                'assertionAttributes': {
                    'email': 'string',
                    'groups': 'string',
                    'login': 'string',
                    'name': 'string',
                    'org': 'string',
                    'role': 'string'
                },
                'idpMetadata': {
                    'url': 'string',
                    'xml': 'string'
                },
                'loginValidityDuration': 123,
                'roleValues': {
                    'admin': [
                        'string',
                    ],
                    'editor': [
                        'string',
                    ]
                }
            },
            'status': 'CONFIGURED'|'NOT_CONFIGURED'
        }
    }
}

Response Structure

  • (dict) –

    • authentication (dict) –

      A structure containing information about the authentication methods used in the workspace.

      • awsSso (dict) –

        A structure containing information about how this workspace works with IAM Identity Center.

        • ssoClientId (string) –

          The ID of the IAM Identity Center-managed application that is created by Amazon Managed Grafana.

      • providers (list) –

        Specifies whether this workspace uses IAM Identity Center, SAML, or both methods to authenticate users to use the Grafana console in the Amazon Managed Grafana workspace.

        • (string) –

      • saml (dict) –

        A structure containing information about how this workspace works with SAML, including what attributes within the assertion are to be mapped to user information in the workspace.

        • configuration (dict) –

          A structure containing details about how this workspace works with SAML.

          • allowedOrganizations (list) –

            Lists which organizations defined in the SAML assertion are allowed to use the Amazon Managed Grafana workspace. If this is empty, all organizations in the assertion attribute have access.

            • (string) –

          • assertionAttributes (dict) –

            A structure that defines which attributes in the SAML assertion are to be used to define information about the users authenticated by that IdP to use the workspace.

            • email (string) –

              The name of the attribute within the SAML assertion to use as the email names for SAML users.

            • groups (string) –

              The name of the attribute within the SAML assertion to use as the user full “friendly” names for user groups.

            • login (string) –

              The name of the attribute within the SAML assertion to use as the login names for SAML users.

            • name (string) –

              The name of the attribute within the SAML assertion to use as the user full “friendly” names for SAML users.

            • org (string) –

              The name of the attribute within the SAML assertion to use as the user full “friendly” names for the users’ organizations.

            • role (string) –

              The name of the attribute within the SAML assertion to use as the user roles.

          • idpMetadata (dict) –

            A structure containing the identity provider (IdP) metadata used to integrate the identity provider with this workspace.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: url, xml. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

            'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
            
            • url (string) –

              The URL of the location containing the IdP metadata.

            • xml (string) –

              The full IdP metadata, in XML format.

          • loginValidityDuration (integer) –

            How long a sign-on session by a SAML user is valid, before the user has to sign on again.

          • roleValues (dict) –

            A structure containing arrays that map group names in the SAML assertion to the Grafana Admin and Editor roles in the workspace.

            • admin (list) –

              A list of groups from the SAML assertion attribute to grant the Grafana Admin role to.

              • (string) –

            • editor (list) –

              A list of groups from the SAML assertion attribute to grant the Grafana Editor role to.

              • (string) –

        • status (string) –

          Specifies whether the workspace’s SAML configuration is complete.

Exceptions

  • ManagedGrafana.Client.exceptions.ResourceNotFoundException

  • ManagedGrafana.Client.exceptions.ThrottlingException

  • ManagedGrafana.Client.exceptions.ConflictException

  • ManagedGrafana.Client.exceptions.ValidationException

  • ManagedGrafana.Client.exceptions.AccessDeniedException

  • ManagedGrafana.Client.exceptions.InternalServerException