amazonka-iotsecuretunneling-2.0: Amazon IoT Secure Tunneling 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.IoTSecureTunneling.RotateTunnelAccessToken

Description

Revokes the current client access token (CAT) and returns new CAT for clients to use when reconnecting to secure tunneling to access the same tunnel.

Requires permission to access the RotateTunnelAccessToken action.

Rotating the CAT doesn't extend the tunnel duration. For example, say the tunnel duration is 12 hours and the tunnel has already been open for 4 hours. When you rotate the access tokens, the new tokens that are generated can only be used for the remaining 8 hours.

Synopsis

Creating a Request

data RotateTunnelAccessToken Source #

See: newRotateTunnelAccessToken smart constructor.

Constructors

RotateTunnelAccessToken' 

Fields

Instances

Instances details
ToJSON RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

ToHeaders RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

ToPath RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

ToQuery RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

AWSRequest RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Generic RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Associated Types

type Rep RotateTunnelAccessToken :: Type -> Type #

Read RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Show RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

NFData RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Methods

rnf :: RotateTunnelAccessToken -> () #

Eq RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Hashable RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

type AWSResponse RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

type Rep RotateTunnelAccessToken Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

type Rep RotateTunnelAccessToken = D1 ('MetaData "RotateTunnelAccessToken" "Amazonka.IoTSecureTunneling.RotateTunnelAccessToken" "amazonka-iotsecuretunneling-2.0-B7tp11579Ld35NvrM5xQuK" 'False) (C1 ('MetaCons "RotateTunnelAccessToken'" 'PrefixI 'True) (S1 ('MetaSel ('Just "destinationConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DestinationConfig)) :*: (S1 ('MetaSel ('Just "tunnelId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "clientMode") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ClientMode))))

newRotateTunnelAccessToken Source #

Create a value of RotateTunnelAccessToken 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:

RotateTunnelAccessToken, rotateTunnelAccessToken_destinationConfig - Undocumented member.

RotateTunnelAccessToken, rotateTunnelAccessToken_tunnelId - The tunnel for which you want to rotate the access tokens.

$sel:clientMode:RotateTunnelAccessToken', rotateTunnelAccessToken_clientMode - The mode of the client that will use the client token, which can be either the source or destination, or both source and destination.

Request Lenses

rotateTunnelAccessToken_tunnelId :: Lens' RotateTunnelAccessToken Text Source #

The tunnel for which you want to rotate the access tokens.

rotateTunnelAccessToken_clientMode :: Lens' RotateTunnelAccessToken ClientMode Source #

The mode of the client that will use the client token, which can be either the source or destination, or both source and destination.

Destructuring the Response

data RotateTunnelAccessTokenResponse Source #

See: newRotateTunnelAccessTokenResponse smart constructor.

Constructors

RotateTunnelAccessTokenResponse' 

Fields

Instances

Instances details
Generic RotateTunnelAccessTokenResponse Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Associated Types

type Rep RotateTunnelAccessTokenResponse :: Type -> Type #

Show RotateTunnelAccessTokenResponse Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

NFData RotateTunnelAccessTokenResponse Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

Eq RotateTunnelAccessTokenResponse Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

type Rep RotateTunnelAccessTokenResponse Source # 
Instance details

Defined in Amazonka.IoTSecureTunneling.RotateTunnelAccessToken

type Rep RotateTunnelAccessTokenResponse = D1 ('MetaData "RotateTunnelAccessTokenResponse" "Amazonka.IoTSecureTunneling.RotateTunnelAccessToken" "amazonka-iotsecuretunneling-2.0-B7tp11579Ld35NvrM5xQuK" 'False) (C1 ('MetaCons "RotateTunnelAccessTokenResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "destinationAccessToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (Sensitive Text))) :*: S1 ('MetaSel ('Just "sourceAccessToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (Sensitive Text)))) :*: (S1 ('MetaSel ('Just "tunnelArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newRotateTunnelAccessTokenResponse Source #

Create a value of RotateTunnelAccessTokenResponse 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:

$sel:destinationAccessToken:RotateTunnelAccessTokenResponse', rotateTunnelAccessTokenResponse_destinationAccessToken - The client access token that the destination local proxy uses to connect to IoT Secure Tunneling.

$sel:sourceAccessToken:RotateTunnelAccessTokenResponse', rotateTunnelAccessTokenResponse_sourceAccessToken - The client access token that the source local proxy uses to connect to IoT Secure Tunneling.

RotateTunnelAccessTokenResponse, rotateTunnelAccessTokenResponse_tunnelArn - The Amazon Resource Name for the tunnel.

$sel:httpStatus:RotateTunnelAccessTokenResponse', rotateTunnelAccessTokenResponse_httpStatus - The response's http status code.

Response Lenses

rotateTunnelAccessTokenResponse_destinationAccessToken :: Lens' RotateTunnelAccessTokenResponse (Maybe Text) Source #

The client access token that the destination local proxy uses to connect to IoT Secure Tunneling.

rotateTunnelAccessTokenResponse_sourceAccessToken :: Lens' RotateTunnelAccessTokenResponse (Maybe Text) Source #

The client access token that the source local proxy uses to connect to IoT Secure Tunneling.