Client-IDs erstellen

Wenn der Zugriff auf das API-Back-End nur mit Authentifizierung möglich sein soll, müssen die erforderlichen Client-IDs abgerufen und über das richtige API-Annonationsattribut an das Back-End übergeben werden.

Android

Zum Erstellen einer Android-Client-ID für OAuth 2.0 benötigen Sie den Fingerabdruck eines Zertifikatschlüssels. Wenn Sie Android Studio verwenden, werden automatisch ein Keystore und ein Schlüssel für die Fehlerbehebung erstellt. Für Testzwecke reicht der Fehlerbehebungsschlüssel aus, während für die Produktion ein Releaseschlüssel erforderlich ist.

Das Standardpasswort des Schlüsselspeichers der Fehlerbehebung lautet android und der Schlüsselalias androiddebugkey. Der Standardspeicherort für Linux und macOS ist ~/.android/debug.keystore.

  1. Generieren Sie einen Fehlerbehebungs- oder Releaseschlüssel für Ihre Android-Anwendung, sofern nicht bereits geschehen. Wenn Sie Android Studio verwenden, wird beim ersten Erstellen eines Android-Projekts im Keystore für die Fehlerbehebung automatisch ein Fehlerbehebungsschlüssel generiert.
  2. Den Fingerabdruck des Schlüssels können Sie in einem Linux- oder macOS-Terminalfenster mit dem im Java SDK enthaltenen keytool abrufen:
    keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
    Die Ausgabe zeigt einen Fingerabdruck ähnlich dem folgenden an: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  3. Kopieren und speichern Sie den Fingerabdruck des Schlüssels, der nach Ausführung des obigen keytool-Befehls angezeigt wird. Sie müssen den Fingerabdruck angeben, um die Android-Client-ID in der Google Cloud Console zu generieren.
  4. Wechseln Sie in der Google Cloud Console zur Seite Anmeldedaten.

    Zur Seite "Domainbestätigung"

  5. Wählen Sie aus der Projektliste das Projekt aus, in dem sich die API befindet.
  6. Wenn Sie zum ersten Mal eine Client-ID in diesem Projekt erstellen, führen Sie die Unterschritte aus, um zum OAuth-Zustimmungsbildschirm zu gelangen. Fahren Sie andernfalls mit dem nächsten Schritt fort.
    1. Klicken Sie auf OAuth-Zustimmungsbildschirm.
    2. Geben Sie im Feld Name der Anwendung einen Namen ein.
    3. Füllen Sie gegebenenfalls die restlichen Felder aus.
    4. Klicken Sie auf Speichern.
  7. Wählen Sie in der Drop-down-Liste Anmeldedaten erstellen die Option OAuth-Client-ID aus.
  8. Wählen Sie als Anwendungstyp Android aus.
  9. Geben Sie im Feld Name einen Namen für Ihre Client-ID ein.
  10. Geben Sie im Feld Signaturzertifikat-Fingerabdruck den zuvor abgerufenen Fingerabdruck ein.
  11. Geben Sie unter Paketname den Namen des Android-Anwendungspakets wie in der Datei AndroidManifest.xml angegeben ein.
  12. Klicken Sie auf Erstellen.

    Die generierte Client-ID wird in Ihrem API-Back-End und in Ihrer Clientanwendung verwendet.

Webclient

  1. Wechseln Sie in der Google Cloud Console zur Seite Anmeldedaten.

    Zur Seite "Domainbestätigung"

  2. Wählen Sie aus der Projektliste das Projekt aus, in dem sich die API befindet.
  3. Wenn Sie zum ersten Mal eine Client-ID in diesem Projekt erstellen, führen Sie die Unterschritte aus, um zum OAuth-Zustimmungsbildschirm zu gelangen. Fahren Sie andernfalls mit dem nächsten Schritt fort.
    1. Klicken Sie auf OAuth-Zustimmungsbildschirm.
    2. Geben Sie im Feld Name der Anwendung einen Namen ein.
    3. Füllen Sie gegebenenfalls die restlichen Felder aus.
    4. Klicken Sie auf Speichern.
  4. Wählen Sie in der Drop-down-Liste Anmeldedaten erstellen die Option OAuth-Client-ID aus.
  5. Wählen Sie als Anwendungstyp Webanwendung aus.
  6. Geben Sie im Feld Name einen Namen für Ihre Client-ID ein.
  7. Geben Sie unter Autorisierte JavaScript-Quellen eine der folgenden Optionen ein:
    • http://localhost:8080, wenn Sie das Back-End lokal testen.
    • https://YOUR_PROJECT_ID.appspot.com, wobei YOUR_PROJECT_ID durch Ihre App Engine-Projekt-ID ersetzt wird, wenn Sie die Back-End API in der App Engine-Produktionsumgebung bereitstellen.

  8. Klicken Sie auf Erstellen.

    Sie verwenden die generierte Client-ID in Ihrem API-Back-End und in Ihrer Clientanwendung.

Nächste Schritte

Informationen darüber, wie Sie Authentifizierung in Ihrer Android- oder JavaScript-Anwendung unterstützen, finden Sie unter folgenden Links: