Authorization

class aws_cdk.aws_events.Authorization

Bases: object

Authorization type for an API Destination Connection.

ExampleMetadata:

infused

Example:

connection = events.Connection(self, "Connection",
    authorization=events.Authorization.api_key("x-api-key", SecretValue.secrets_manager("ApiSecretName")),
    description="Connection with API Key x-api-key"
)

destination = events.ApiDestination(self, "Destination",
    connection=connection,
    endpoint="https://example.com",
    description="Calling example.com with API key x-api-key"
)

rule = events.Rule(self, "Rule",
    schedule=events.Schedule.rate(Duration.minutes(1)),
    targets=[targets.ApiDestination(destination)]
)

Static Methods

classmethod api_key(api_key_name, api_key_value)

Use API key authorization.

API key authorization has two components: an API key name and an API key value. What these are depends on the target of your connection.

Parameters:
  • api_key_name (str) –

  • api_key_value (SecretValue) –

Return type:

Authorization

classmethod basic(username, password)

Use username and password authorization.

Parameters:
Return type:

Authorization

classmethod oauth(*, authorization_endpoint, client_id, client_secret, http_method, body_parameters=None, header_parameters=None, query_string_parameters=None)

Use OAuth authorization.

Parameters:
  • authorization_endpoint (str) – The URL to the authorization endpoint.

  • client_id (str) – The client ID to use for OAuth authorization for the connection.

  • client_secret (SecretValue) – The client secret associated with the client ID to use for OAuth authorization for the connection.

  • http_method (HttpMethod) – The method to use for the authorization request. (Can only choose POST, GET or PUT).

  • body_parameters (Optional[Mapping[str, HttpParameter]]) – Additional string parameters to add to the OAuth request body. Default: - No additional parameters

  • header_parameters (Optional[Mapping[str, HttpParameter]]) – Additional string parameters to add to the OAuth request header. Default: - No additional parameters

  • query_string_parameters (Optional[Mapping[str, HttpParameter]]) – Additional string parameters to add to the OAuth request query string. Default: - No additional parameters

Return type:

Authorization