Nesta página, você aprende como oferecer suporte à autenticação de usuário no Cloud Endpoints.
Para autenticar um usuário, um aplicativo cliente precisa enviar um token da Web do JSON (JWT, na sigla em inglês) no cabeçalho de autorização da solicitação HTTP para sua API de back-end. O Extensible Service Proxy (ESP) valida o token em nome da API, de modo que não é preciso adicionar nenhum código na API para processar a autenticação. No entanto, você precisa configurar o documento da OpenAPI para oferecer suporte aos métodos de autenticação escolhidos.
O ESP valida um JWT de maneira eficiente usando as chaves públicas do emissor do JWT. O ESP armazena as chaves públicas em cache por cinco minutos. Além disso, o ESP armazena em buffer os JWTs validados por cinco minutos ou até a expiração do JWT, o que ocorrer primeiro.
Antes de começar
- Adicione o código de autenticação ao seu aplicativo cliente, seguindo a documentação do Firebase Authentication. O Firebase é compatível com a autenticação por meio de senhas, números de telefone e provedores de identidade federada, como Google, Facebook e Twitter.
-
Quando seu aplicativo cliente envia uma solicitação HTTP, o cabeçalho de autorização na solicitação deve conter as seguintes declarações do JWT:
iss
(emissor)sub
(assunto)aud
(público-alvo)iat
(emitido em)exp
(prazo de validade)
Como configurar o documento da OpenAPI
É preciso ter um objeto de requisito de segurança e um objeto de definições de segurança (ambos em inglês) no documento da OpenAPI para que o ESP valide as declarações no JWT assinado.
Para dar suporte à autenticação Firebase:
Adicione o seguinte à definição de segurança no documento da OpenAPI:
securityDefinitions: firebase: authorizationUrl: "" flow: "implicit" type: "oauth2" # Replace YOUR-PROJECT-ID with your project ID x-google-issuer: "https://securetoken.google.com/YOUR-PROJECT-ID" x-google-jwks_uri: "https://www.googleapis.com/service_accounts/v1/metadata/x509/securetoken@system.gserviceaccount.com" x-google-audiences: "YOUR-PROJECT-ID"
Adicione uma seção de segurança no nível da API, para ser aplicável a toda a API, ou no nível do método, para ser aplicável a um método específico.
security: - firebase: []
É possível estabelecer várias definições de segurança no documento da OpenAPI, mas cada uma delas precisa ter um emissor diferente. Se você usar seções "security" no nível da API e do método, as configurações no nível do método modificarão as configurações no nível da API.
Você também pode personalizar os locais do JWT adicionando x-google-extensions
. Para detalhes, consulte extensões da OpenAPI.
Como fazer uma chamada autenticada para uma Endpoints API
Quando enviar uma solicitação usando um token de autenticação, recomendamos que você coloque o token no cabeçalho Authorization:Bearer
. Exemplo:
curl -H "Authorization: Bearer ${TOKEN}" "${ENDPOINTS_HOST}/echo"
Aqui, ENDPOINTS_HOST
e TOKEN
são variáveis de ambiente contendo o nome do host da API e o token de autenticação, respectivamente. Consulte Como fazer uma solicitação autenticada para uma API Endpoints. Para o código de amostra que envia uma solicitação usando o cabeçalho Authorization:Bearer
.
Se não for possível usar o cabeçalho ao enviar a solicitação, coloque o token de autenticação em um parâmetro de consulta denominado access_token
. Por exemplo:
curl "${ENDPOINTS_HOST}/echo?access_token=${TOKEN}"
Como receber resultados autenticados na API
O ESP geralmente encaminha todos os cabeçalhos recebidos. No entanto, ele substitui o cabeçalho Authorization
original quando o endereço de back-end é especificado por x-google-backend
na especificação OpenAPI ou BackendRule
na configuração do serviço de gRPC.
O ESP enviará o resultado da autenticação no X-Endpoint-API-UserInfo
para a API de back-end. Recomendamos usar esse cabeçalho em vez do cabeçalho
Authorization
original. Esse cabeçalho é uma string em que base64url
codifica
um objeto JSON. O formato de objeto JSON é diferente no ESPv2 e no ESP.
Para o ESPv2, o objeto JSON é exatamente o payload do JWT original. No ESP,
o objeto JSON usa nomes de campos diferentes e coloca o payload original do JWT no campo claims
.
Consulte Processar JWTs no serviço de back-end
para mais informações sobre o formato.
A seguir