Como autenticar com uma conta de serviço

Pré-requisitos

Nesta página, presume-se que você já:

• criou um projeto do Google Cloud;

• adicionou gerenciamento de API.

Como configurar a autenticação

Para autenticar com uma conta de serviço:

1. Importe a API do App Engine Endpoints na classe de API:

   import endpoints
   

2. Adicione um objeto emissor da conta de serviço ao decorador de API. Exemplo:

   @endpoints.api(
       name='echo',
       version='v1',
       issuers={'serviceAccount': endpoints.Issuer(
           'YOUR_SERVICE_ACCOUNT_EMAIL',
           'https://www.googleapis.com/robot/v1/metadata/x509/YOUR_SERVICE_ACCOUNT_EMAIL')},
       audiences={'serviceAccount': ['YOUR_AUDIENCE']})
   

   • Substitua echo pelo nome da API.
   • Substitua v1 pela versão da API.
   • Substitua YOUR_SERVICE_ACCOUNT_EMAIL pelo e-mail da conta de serviço.
   • Substitua YOUR_AUDIENCE pelo valor no campo aud enviado pelo serviço de chamada.

3. Em cada método de API em que você quer verificar se a autenticação é adequada, confira se há um User válido. Se não houver, como no exemplo de definição de método visto a seguir, gere o erro 401:

   user = endpoints.get_current_user()
   # If there's no user defined, the request was unauthenticated, so we
   # raise 401 Unauthorized.
   

4. Implante a API. É necessário implantar a API sempre que adicionar novos clientes.