Créer des ID clients

Si vous souhaitez exiger une authentification pour accéder au backend de l'API, vous devez obtenir les ID clients requis et les fournir au backend à l'aide de l'attribut d'annotation d'API approprié.

Android

Pour créer l'ID client OAuth 2.0 Android, vous devez disposer d'une empreinte de clé de certificat. Si vous utilisez Android Studio, un magasin de clés de débogage et une clé de débogage sont créés automatiquement. Vous pouvez utiliser cette dernière à des fins de test, mais vous devez utiliser une clé de libération pour la production.

Notez que le mot de passe du magasin de clés de débogage par défaut est android, et que l'alias de la clé est androiddebugkey. L'emplacement par défaut pour Linux et macOS est ~/.android/debug.keystore.

  1. Si vous ne possédez pas encore de clé de débogage ou de libération, générez-en une pour l'application Android. Si vous utilisez Android Studio, ce dernier génère automatiquement une clé de débogage dans le magasin de clés de débogage la première fois que vous créez un projet Android.
  2. Dans une fenêtre de terminal Linux ou macOS, vous pouvez obtenir l'empreinte de la clé à l'aide de la commande keytool (incluse dans le SDK Java) comme suit :
    keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
     Le résultat affiche une empreinte semblable à celle-ci: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  3. Copiez et enregistrez l'empreinte de la clé qui s'affiche une fois que vous avez exécuté la commande keytool précédente. Vous devez fournir l'empreinte pour générer l'ID de client Android dans la console Google Cloud.
  4. Dans la console Google Cloud, accédez à la page Identifiants.

    Accéder à la page Identifiants

  5. Dans la liste des projets, sélectionnez le projet contenant l'API.
  6. Si c'est la première fois que vous créez un ID client dans ce projet, suivez les sous-étapes pour accéder à la page Autorisation OAuth. Sinon, passez à l'étape suivante.
    1. Cliquez sur l'écran d'autorisation OAuth.
    2. Saisissez un nom dans le champ Nom de l'application.
    3. Remplissez le reste des champs selon les besoins.
    4. Cliquez sur Save.
  7. Dans le menu déroulant Créer des identifiants, sélectionnez ID client OAuth.
  8. Sélectionnez Android comme type d'application.
  9. Dans Nom, saisissez un nom pour votre ID client.
  10. Dans Empreinte du certificat de signature, saisissez l'empreinte que vous avez obtenue ci-dessus.
  11. Dans Nom du package, saisissez le nom du package de l'application Android, tel que spécifié dans le fichier AndroidManifest.xml.
  12. Cliquez sur Créer.

    Vous pouvez utiliser l'ID client généré dans le backend de votre API et dans votre application cliente.

Client Web

  1. Dans la console Google Cloud, accédez à la page Identifiants.

    Accéder à la page Identifiants

  2. Dans la liste des projets, sélectionnez le projet contenant l'API.
  3. Si c'est la première fois que vous créez un ID client dans ce projet, suivez les sous-étapes pour accéder à la page Autorisation OAuth. Sinon, passez à l'étape suivante.
    1. Cliquez sur l'écran d'autorisation OAuth.
    2. Saisissez un nom dans le champ Nom de l'application.
    3. Remplissez le reste des champs selon les besoins.
    4. Cliquez sur Save.
  4. Dans le menu déroulant Créer des identifiants, sélectionnez ID client OAuth.
  5. Sélectionnez Application Web comme type d'application.
  6. Dans Nom, saisissez un nom pour votre ID client.
  7. Dans Origines JavaScript autorisées, saisissez l'un des éléments suivants :
    • http://localhost:8080, si vous testez le backend localement.

    • https://YOUR_PROJECT_ID.appspot.com, en remplaçant YOUR_PROJECT_ID par votre ID de projet App Engine, si vous déployez votre API backend sur votre App Engine de production.

  8. Cliquez sur Créer.

    Vous pouvez utiliser l'ID client généré dans le backend de votre API et dans votre application cliente.

Étapes suivantes

Pour en savoir plus sur la façon d'assurer l'authentification dans l'application Android ou JavaScript, consultez les pages suivantes :