amazonka-iot-2.0: Amazon IoT SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.IoT.CreateAuthorizer

Description

Creates an authorizer.

Requires permission to access the CreateAuthorizer action.

Synopsis

Creating a Request

data CreateAuthorizer Source #

See: newCreateAuthorizer smart constructor.

Constructors

CreateAuthorizer' 

Fields

  • enableCachingForHttp :: Maybe Bool

    When true, the result from the authorizer’s Lambda function is cached for clients that use persistent HTTP connections. The results are cached for the time specified by the Lambda function in refreshAfterInSeconds. This value does not affect authorization of clients that use MQTT connections.

    The default value is false.

  • signingDisabled :: Maybe Bool

    Specifies whether IoT validates the token signature in an authorization request.

  • status :: Maybe AuthorizerStatus

    The status of the create authorizer request.

  • tags :: Maybe [Tag]

    Metadata which can be used to manage the custom authorizer.

    For URI Request parameters use format: ...key1=value1&key2=value2...

    For the CLI command-line parameter use format: &&tags "key1=value1&key2=value2..."

    For the cli-input-json file use format: "tags": "key1=value1&key2=value2..."

  • tokenKeyName :: Maybe Text

    The name of the token key used to extract the token from the HTTP headers.

  • tokenSigningPublicKeys :: Maybe (HashMap Text Text)

    The public keys used to verify the digital signature returned by your custom authentication service.

  • authorizerName :: Text

    The authorizer name.

  • authorizerFunctionArn :: Text

    The ARN of the authorizer's Lambda function.

Instances

Instances details
ToJSON CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

ToHeaders CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

ToPath CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

ToQuery CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

AWSRequest CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Associated Types

type AWSResponse CreateAuthorizer #

Generic CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Associated Types

type Rep CreateAuthorizer :: Type -> Type #

Read CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Show CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

NFData CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Methods

rnf :: CreateAuthorizer -> () #

Eq CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Hashable CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

type AWSResponse CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

type Rep CreateAuthorizer Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

type Rep CreateAuthorizer = D1 ('MetaData "CreateAuthorizer" "Amazonka.IoT.CreateAuthorizer" "amazonka-iot-2.0-6w03vgAfmrM1SG22OsNJXL" 'False) (C1 ('MetaCons "CreateAuthorizer'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "enableCachingForHttp") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "signingDisabled") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AuthorizerStatus)) :*: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag])))) :*: ((S1 ('MetaSel ('Just "tokenKeyName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "tokenSigningPublicKeys") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text Text)))) :*: (S1 ('MetaSel ('Just "authorizerName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "authorizerFunctionArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newCreateAuthorizer Source #

Create a value of CreateAuthorizer with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

CreateAuthorizer, createAuthorizer_enableCachingForHttp - When true, the result from the authorizer’s Lambda function is cached for clients that use persistent HTTP connections. The results are cached for the time specified by the Lambda function in refreshAfterInSeconds. This value does not affect authorization of clients that use MQTT connections.

The default value is false.

CreateAuthorizer, createAuthorizer_signingDisabled - Specifies whether IoT validates the token signature in an authorization request.

CreateAuthorizer, createAuthorizer_status - The status of the create authorizer request.

$sel:tags:CreateAuthorizer', createAuthorizer_tags - Metadata which can be used to manage the custom authorizer.

For URI Request parameters use format: ...key1=value1&key2=value2...

For the CLI command-line parameter use format: &&tags "key1=value1&key2=value2..."

For the cli-input-json file use format: "tags": "key1=value1&key2=value2..."

CreateAuthorizer, createAuthorizer_tokenKeyName - The name of the token key used to extract the token from the HTTP headers.

CreateAuthorizer, createAuthorizer_tokenSigningPublicKeys - The public keys used to verify the digital signature returned by your custom authentication service.

CreateAuthorizer, createAuthorizer_authorizerName - The authorizer name.

CreateAuthorizer, createAuthorizer_authorizerFunctionArn - The ARN of the authorizer's Lambda function.

Request Lenses

createAuthorizer_enableCachingForHttp :: Lens' CreateAuthorizer (Maybe Bool) Source #

When true, the result from the authorizer’s Lambda function is cached for clients that use persistent HTTP connections. The results are cached for the time specified by the Lambda function in refreshAfterInSeconds. This value does not affect authorization of clients that use MQTT connections.

The default value is false.

createAuthorizer_signingDisabled :: Lens' CreateAuthorizer (Maybe Bool) Source #

Specifies whether IoT validates the token signature in an authorization request.

createAuthorizer_status :: Lens' CreateAuthorizer (Maybe AuthorizerStatus) Source #

The status of the create authorizer request.

createAuthorizer_tags :: Lens' CreateAuthorizer (Maybe [Tag]) Source #

Metadata which can be used to manage the custom authorizer.

For URI Request parameters use format: ...key1=value1&key2=value2...

For the CLI command-line parameter use format: &&tags "key1=value1&key2=value2..."

For the cli-input-json file use format: "tags": "key1=value1&key2=value2..."

createAuthorizer_tokenKeyName :: Lens' CreateAuthorizer (Maybe Text) Source #

The name of the token key used to extract the token from the HTTP headers.

createAuthorizer_tokenSigningPublicKeys :: Lens' CreateAuthorizer (Maybe (HashMap Text Text)) Source #

The public keys used to verify the digital signature returned by your custom authentication service.

createAuthorizer_authorizerFunctionArn :: Lens' CreateAuthorizer Text Source #

The ARN of the authorizer's Lambda function.

Destructuring the Response

data CreateAuthorizerResponse Source #

See: newCreateAuthorizerResponse smart constructor.

Constructors

CreateAuthorizerResponse' 

Fields

Instances

Instances details
Generic CreateAuthorizerResponse Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Associated Types

type Rep CreateAuthorizerResponse :: Type -> Type #

Read CreateAuthorizerResponse Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Show CreateAuthorizerResponse Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

NFData CreateAuthorizerResponse Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

Eq CreateAuthorizerResponse Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

type Rep CreateAuthorizerResponse Source # 
Instance details

Defined in Amazonka.IoT.CreateAuthorizer

type Rep CreateAuthorizerResponse = D1 ('MetaData "CreateAuthorizerResponse" "Amazonka.IoT.CreateAuthorizer" "amazonka-iot-2.0-6w03vgAfmrM1SG22OsNJXL" 'False) (C1 ('MetaCons "CreateAuthorizerResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "authorizerArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "authorizerName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newCreateAuthorizerResponse Source #

Create a value of CreateAuthorizerResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

CreateAuthorizerResponse, createAuthorizerResponse_authorizerArn - The authorizer ARN.

CreateAuthorizer, createAuthorizerResponse_authorizerName - The authorizer's name.

$sel:httpStatus:CreateAuthorizerResponse', createAuthorizerResponse_httpStatus - The response's http status code.

Response Lenses