v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

Tests a custom authorization behavior by invoking a specified custom authorizer. Use this to test and debug the custom authorization behavior of devices that connect to the IoT device gateway.

Requires permission to access the TestInvokeAuthorizer action.

post/authorizer/{authorizerName}/test

Path parameters

authorizerNamestring required

The custom authorizer name.

Request body

tokenstring

The token returned by your custom authentication service.

tokenSignaturestring

The signature made with the token and your custom authentication service's private key. This value must be Base-64-encoded.

Response

Success

isAuthenticatedboolean

True if the token is authenticated, otherwise false.

principalIdstring

The principal ID.

policyDocumentsPolicyDocument[]

IAM policy documents.

refreshAfterInSecondsinteger

The number of seconds after which the temporary credentials are refreshed.

disconnectAfterInSecondsinteger

The number of seconds after which the connection is terminated.