PrivateCAConnectorforSCEP / Client / create_challenge

create_challenge#

PrivateCAConnectorforSCEP.Client.create_challenge(**kwargs)#

For general-purpose connectors. Creates a challenge password for the specified connector. The SCEP protocol uses a challenge password to authenticate a request before issuing a certificate from a certificate authority (CA). Your SCEP clients include the challenge password as part of their certificate request to Connector for SCEP. To retrieve the connector Amazon Resource Names (ARNs) for the connectors in your account, call ListConnectors.

To create additional challenge passwords for the connector, call CreateChallenge again. We recommend frequently rotating your challenge passwords.

See also: AWS API Documentation

Request Syntax

response = client.create_challenge(
    ConnectorArn='string',
    ClientToken='string',
    Tags={
        'string': 'string'
    }
)
Parameters:

  • ConnectorArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the connector that you want to create a challenge for.

  • ClientToken (string) –

    Custom string that can be used to distinguish between calls to the CreateChallenge action. Client tokens for CreateChallenge time out after five minutes. Therefore, if you call CreateChallenge multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.

    This field is autopopulated if not provided.

  • Tags (dict) –

    The key-value pairs to associate with the resource.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Challenge': {
        'Arn': 'string',
        'ConnectorArn': 'string',
        'CreatedAt': datetime(2015, 1, 1),
        'UpdatedAt': datetime(2015, 1, 1),
        'Password': 'string'
    }
}

Response Structure

  • (dict) –

    • Challenge (dict) –

      Returns the challenge details for the specified connector.

      • Arn (string) –

        The Amazon Resource Name (ARN) of the challenge.

      • ConnectorArn (string) –

        The Amazon Resource Name (ARN) of the connector.

      • CreatedAt (datetime) –

        The date and time that the challenge was created.

      • UpdatedAt (datetime) –

        The date and time that the challenge was updated.

      • Password (string) –

        The SCEP challenge password, in UUID format.

Exceptions

  • PrivateCAConnectorforSCEP.Client.exceptions.ResourceNotFoundException

  • PrivateCAConnectorforSCEP.Client.exceptions.BadRequestException

  • PrivateCAConnectorforSCEP.Client.exceptions.InternalServerException

  • PrivateCAConnectorforSCEP.Client.exceptions.ValidationException

  • PrivateCAConnectorforSCEP.Client.exceptions.ThrottlingException

  • PrivateCAConnectorforSCEP.Client.exceptions.AccessDeniedException

  • PrivateCAConnectorforSCEP.Client.exceptions.ConflictException

  • PrivateCAConnectorforSCEP.Client.exceptions.ServiceQuotaExceededException