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-Vorgang.

Sobald du eine OAuth 2.0-Implementierung hast, kannst du optional die OAuth-basierte App Flip konfigurieren. So können deine Nutzer ihre Konten in deinem Authentifizierungssystem schneller mit ihren Google-Konten verknüpfen.

OAuth

Für smart home musst du OAuth mit einem Autorisierungscode -Vorgang verwenden. Dazu sind zwei Endpunkte erforderlich: die Endpunkte für die Autorisierung und den Token-Austausch.

Wenn du einen Nutzer authentifiziert hast, wird das OAuth 2.0-Zugriffstoken des Nutzers von Drittanbietern im Autorisierungsheader gesendet, wenn smart home Intents an deine Auftragsausführung gesendet werden. Alle Nutzer müssen die Kontoverknüpfung durchführen, da Geräteinformationen mit dem Google Assistant mit dem action.devices.SYNC Intent an den Google Assistant gesendet werden. Dafür ist eine Kontoverknüpfung erforderlich.

Deine Cloud-to-cloud Integration muss unterstützen, dass mehrere Google-Nutzer sich mit demselben Nutzerkonto verbinden können (z. B. wenn Nutzer anderen Nutzern in ihrem Haushalt Zugriff gewähren). Wenn dein Dienst mehrere Nutzerverbindungen nicht unterstützt, sollten bei der Kontoverknüpfung Fehler auftreten.

Eine Anleitung zum Einrichten eines OAuth 2.0-Servers für deine Integration findest du unter OAuth 2.0-Server implementieren.

OAuth-basierte App-Umstellung

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 Autorisierungscode-Vorgang für die OAuth-Verknüpfung findest du unter OAuth 2.0-Server implementieren.

Eine Anleitung zum Konfigurieren von App Flip für deine Integration findest du unter OAuth-basierte App Flip.

Zurück
Auftragsausführung