Attach a JWT authorizer to methods and require scopes
After you create a JWT authorizer, you attach it to the methods that it protects. You set
the authorization type to JWT, reference the authorizer, and optionally require
authorization scopes for the method. One authorizer can serve many methods, and each method
can require its own scopes.
API Gateway reads a method's scopes from the token's scope or scp
claim. A request passes the scope check when the token carries at least one of the method's
scopes. For example, a method that requires orders:read accepts a token whose
scope claim contains orders:read, even if the token also
carries other scopes. A valid token that carries none of the method's scopes receives a
403 Forbidden response.
Amazon Cognito names scopes in the form ,
such as resource-server/scopeorders/read. If a JWT authorizer trusts an Amazon Cognito user pool and
other issuers, list each scope form that a method accepts. A method passes when the
token carries any one of its listed scopes.
You can mix authorizer types across the methods of one API. For example, one method can use a JWT authorizer, and another can use a Lambda authorizer. Each method uses the authorizer that you attach to it.
Attach a JWT authorizer to a method using the console
The following steps show how to attach a JWT authorizer to a method and require a scope by using the console.
To attach a JWT authorizer to a method using the console
Sign in to the API Gateway console at https://console.aws.amazon.com/apigateway
. -
Choose a REST API.
-
In the main navigation pane, choose Resources.
-
Choose a method, for example, GET.
-
On the Method request tab, under Method request settings, choose Edit.
-
For Authorization, choose your JWT authorizer, which appears under JWT authorizers.
-
(Optional) For Authorization scopes, enter a scope, for example,
orders:read, and then choose Add. Repeat for each scope that the method accepts. A request passes when its token carries at least one of the listed scopes. -
Choose Save.
To require a different scope on another method, repeat these steps for that method.
For example, require the orders:write scope on the POST method
of the same resource.
Attach a JWT authorizer to a method using the AWS CLI
The following put-method
command attaches a JWT authorizer to a method and requires the orders:read
scope.
aws apigateway put-method \ --rest-api-idapi-id\ --resource-idresource-id\ --http-method GET \ --authorization-type JWT \ --authorizer-idauthorizer-id\ --authorization-scopes orders:read
To require a different scope on another method, run the command again with that
method and its scope. The following command requires the orders:write scope
on the POST method of the same resource.
aws apigateway put-method \ --rest-api-idapi-id\ --resource-idresource-id\ --http-method POST \ --authorization-type JWT \ --authorizer-idauthorizer-id\ --authorization-scopes orders:write
Changes to a method take effect only after you deploy the API. After you attach an authorizer or change a method's scopes, deploy the API to a stage. For more information, see Deploy REST APIs in API Gateway.