Kontoverknüpfung

Jede Cloud-to-cloud-Integration muss einen Mechanismus zur Authentifizierung von Nutzern enthalten.

Über die Authentifizierung kannst du die Google-Konten deiner Nutzer mit Nutzerkonten in deinem Authentifizierungssystem verknüpfen. So kannst du Nutzer identifizieren, wenn deine Auftragsausführung einen Smart-Home-Intent empfängt. Google Smart Home unterstützt nur OAuth mit einem Autorisierungscode-Ablauf.

Sobald Sie eine OAuth 2.0-Implementierung haben, können Sie optional OAuth-basierte App Flip konfigurieren. Damit können Ihre Nutzer ihre Konten in Ihrem Authentifizierungssystem schneller mit ihren Google-Konten verknüpfen.

OAuth

Für smart home müssen Sie OAuth mit einem Autorisierungscode-Flow verwenden. Dazu benötigen Sie zwei Endpunkte: den Autorisierungs- und den Tokenaustausch-Endpunkt.

Wenn Sie einen Nutzer authentifiziert haben, wird das OAuth 2.0-Zugriffstoken des Nutzers für Drittanbieter im Autorisierungsheader gesendet, wenn smart home-Intents an Ihr Fulfillment gesendet werden. Alle Nutzer müssen die Kontoverknüpfung durchführen, da Geräteinformationen mit dem Intent action.devices.SYNC an Google Assistant gesendet werden. Dafür ist eine Kontoverknüpfung erforderlich.

Ihre Cloud-to-cloud-Integration muss die Verbindung mehrerer Google-Nutzer mit demselben Nutzerkonto unterstützen (z. B. wenn Nutzer anderen Nutzern in ihrem Haushalt Zugriff gewähren). Wenn Ihr Dienst keine Verbindungen für mehrere Nutzer unterstützt, sollten bei der Kontoverknüpfung Fehler ausgegeben werden.

Eine Anleitung zum Einrichten eines OAuth 2.0-Servers für Ihre Integration finden Sie unter OAuth 2.0-Server implementieren.

App Flip auf OAuth-Basis

OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.

This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.

You can set up App Flip for both iOS and Android apps.

This figure shows the steps for a user to link their Google account to your authentication system. The first screenshot shows how a user can select your app if their Google account is linked to your app. The second screenshot shows the confirmation for linking their Google account with your app. The third screenshot shows a successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

Requirements

To implement App Flip, you must fulfill the following requirements:

  • You must have an Android or iOS app.
  • You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.

Weitere Informationen zum OAuth-Verknüpfungsvorgang mit Autorisierungscode finden Sie unter OAuth 2.0-Server implementieren.

Eine Anleitung zum Konfigurieren von App Flip für Ihre Integration finden Sie unter OAuth-basiertes App Flip.

Zurück
Auftragsausführung