Creating a Custom Authorizer

Scenario

API Gateway supports custom authentication of both frontend and backend requests.

• Frontend custom authentication: If you already have an authentication system, you can configure it in a function and then create a custom authorizer by using the function to authenticate API requests.
• Backend custom authentication: You can create a custom authorizer to authenticate requests for different backend services, eliminating the need to customize APIs for different authentication systems and simplifying API development. You only need to create a function-based custom authorizer in API Gateway to connect to the backend authentication system.

Custom authentication is implemented using FunctionGraph and not supported if FunctionGraph is unavailable in the selected region.

For details about custom authentication, see Developer Guide.

The following figure shows the process of calling APIs through custom authentication.

Figure 1 Calling APIs through custom authentication

Prerequisites

• You have created a function in FunctionGraph.
• You have the FunctionGraph Administrator permission.

Procedure

1. Log in to the management console.
2. Click in the upper left corner and choose API Gateway.
3. In the navigation pane, choose Dedicated Gateways. Then click Access Console in the upper right corner of a dedicated gateway.
4. Choose API Publishing > Custom Authorizers, and click Create Custom Authorizer.
5. Set the parameters listed in Table 1.
   

   Table 1 Parameters for creating a custom authorizer

   Parameter	Description
   Name	Authorizer name.
   Type	Frontend: Authenticates access to APIs. Backend: Authenticates access to backend services.
   Function URN	Select a FunctionGraph function.
   Identity Sources	Request parameters for authentication. You can add headers and query strings. Header names are case-insensitive. This parameter is mandatory only if you set Type to Frontend, and Max. Cache Age (s) is greater than 0. When the cache is used, this parameter is used as a search criterion to query authentication results.
   Max. Cache Age (s)	The time for caching authentication results. Value 0 means that authentication results will not be cached. The maximum value is 3600.
   Send Request Body	Determine whether to send the body of each API request to the authentication function. If you enable this option, the request body will be sent to the authentication function in the same way as the headers and query strings.
   User Data	Customized request parameters to be used together with Identity Sources when API Gateway invokes a function.

6. Click OK.