Criar IDs de cliente

Se quiser exigir autenticação para aceder ao back-end da API, tem de obter os IDs de cliente necessários e fornecê-los ao back-end através do argumento do decorador da API adequado.

Android

Para criar o ID de cliente Android do OAuth 2.0, tem de ter uma impressão digital da chave do certificado. Se usar o Android Studio, é criado automaticamente um keystore de depuração e uma chave de depuração. Pode usar a chave de depuração para fins de teste, mas tem de usar uma chave de lançamento para produção.

Tenha em atenção que a palavra-passe predefinida do repositório de chaves de depuração é android e o alias da chave é androiddebugkey. A localização predefinida para Linux e macOS é ~/.android/debug.keystore.

  1. Se ainda não tiver uma, gere uma chave de depuração ou de lançamento para a sua aplicação Android. Se usar o Android Studio, este gera automaticamente uma chave de depuração no keystore de depuração na primeira vez que compila um projeto Android.
  2. Numa janela de terminal do Linux ou macOS, pode obter a impressão digital da chave através do keytool incluído no SDK Java da seguinte forma: 
    keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
     O resultado apresenta uma impressão digital semelhante à seguinte: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  3. Copie e guarde a impressão digital da chave apresentada depois de executar o comando keytool anterior. Tem de fornecer a impressão digital para gerar o ID de cliente Android na Google Cloud consola.
  4. Na Google Cloud consola, aceda à página Credenciais.

    Aceda à página Credenciais

  5. Na lista de projetos, selecione o projeto que contém a sua API.
  6. Se for a primeira vez que cria um ID de cliente neste projeto, use os subpassos para aceder à página de consentimento do OAuth. Caso contrário, avance para o passo seguinte.
    1. Clique em Ecrã de consentimento OAuth.
    2. Introduza um nome no campo Nome da aplicação.
    3. Preencha os restantes campos conforme necessário.
    4. Clique em Guardar.
  7. Na lista pendente Criar credenciais, selecione ID de cliente OAuth.
  8. Selecione Android como o tipo de aplicação.
  9. Em Nome, introduza um nome para o ID de cliente.
  10. Em Impressão digital do certificado de assinatura, introduza a impressão digital que obteve anteriormente.
  11. Em Nome do pacote, introduza o nome do pacote da aplicação Android, conforme especificado no ficheiro AndroidManifest.xml.
  12. Clique em Criar.

    Usa o ID de cliente gerado no back-end da API e na aplicação cliente.

Cliente Web

  1. Na Google Cloud consola, aceda à página Credenciais.

    Aceda à página Credenciais

  2. Na lista de projetos, selecione o projeto que contém a sua API.
  3. Se for a primeira vez que cria um ID de cliente neste projeto, use os subpassos para aceder à página de consentimento do OAuth. Caso contrário, avance para o passo seguinte.
    1. Clique em Ecrã de consentimento OAuth.
    2. Introduza um nome no campo Nome da aplicação.
    3. Preencha os restantes campos conforme necessário.
    4. Clique em Guardar.
  4. Na lista pendente Criar credenciais, selecione ID de cliente OAuth.
  5. Selecione Aplicação Web como tipo de aplicação.
  6. Em Nome, introduza um nome para o ID de cliente.
  7. Em Origens JavaScript autorizadas, introduza uma das seguintes opções:
    • http://localhost:8080 se estiver a testar o back-end localmente.

    • https://YOUR_PROJECT_ID.appspot.com, substituindo YOUR_PROJECT_ID pelo ID do projeto do App Engine se estiver a implementar a sua API de back-end no App Engine de produção.

  8. Clique em Criar.

    Usa o ID de cliente gerado no back-end da API e na aplicação cliente.

O que se segue?

Para obter informações sobre como suportar a autenticação na sua aplicação Android ou JavaScript, consulte o seguinte: