Kontoverknüpfung

Jede smart home-Aktion muss einen Mechanismus zur Authentifizierung von Nutzern enthalten.

Mit der Authentifizierung können Sie die Google-Konten Ihrer Nutzer mit den Nutzerkonten in Ihrem Authentifizierungssystem verknüpfen. So kannst du deine Nutzer identifizieren, wenn die Auftragsausführung einen Smart-Home-Intent erhält. Google Smart Home unterstützt OAuth nur mit Autorisierungscode.

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

OAuth

Für smart home müssen Sie OAuth mit einem Autorisierungscode-Flow verwenden. Dafür sind zwei Endpunkte erforderlich: die Endpunkte für die Autorisierung und den Tokenaustausch.

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

Die Aktion smart home unterstützt voraussichtlich mehrere Google-Nutzer, die sich mit demselben Nutzerkonto verbinden (z. B. wenn Nutzer anderen Nutzern in ihrem Haushalt Zugriff gewähren). Wenn Ihr Dienst nicht mehrere Nutzerverbindungen unterstützen kann, sollten bei der Kontoverknüpfung Fehler auftreten.

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

OAuth-basierte App-Flip

OAuth-basierte App-Flip-Verknüpfung (App-Flip) ermöglicht es Ihren Nutzern, ihre Konten in Ihrem Authentifizierungssystem einfach und schnell mit ihren Google-Konten zu verknüpfen. Wenn deine App auf dem Smartphone des Nutzers installiert ist, wenn er die Kontoverknüpfung einleitet, wird der Nutzer nahtlos zur App weitergeleitet, um die Autorisierung zu erhalten.

Dieser Ansatz ermöglicht eine schnellere und einfachere Verknüpfung, da der Nutzer nicht zur Authentifizierung seinen Nutzernamen und das Passwort noch einmal eingeben muss. Stattdessen nutzt App Flip die Anmeldedaten des Nutzers in deiner App. Sobald ein Nutzer sein Google-Konto mit deiner App verknüpft hat, kann er alle entwickelten Integrationen nutzen.

Sie können App Flip für iOS- und Android-Apps einrichten.

In dieser Abbildung werden die Schritte dargestellt, mit denen Nutzer ihr Google-Konto mit ihrem Authentifizierungssystem verknüpfen können. Der erste Screenshot zeigt, wie ein Nutzer Ihre App auswählen kann, wenn sein Google-Konto mit Ihrer App verknüpft ist. Der zweite Screenshot zeigt die Bestätigung für die Verknüpfung seines Google-Kontos mit Ihrer App. Der dritte Screenshot zeigt ein erfolgreich verknüpftes Nutzerkonto in der Google App.
Abbildung 1: Kontoverknüpfung auf einem Smartphone mit App Flip.

Voraussetzungen

Wenn Sie App Flip implementieren möchten, müssen die folgenden Anforderungen erfüllt sein:

  • Sie benötigen eine Android- oder iOS-App.
  • Sie müssen einen OAuth 2.0-Server besitzen, verwalten und verwalten, der den OAuth 2.0-Vorgang mit Autorisierungscode unterstützt.

Weitere Informationen zum Vorgang mit Autorisierungscode für die OAuth-Verknüpfung finden Sie unter OAuth 2.0-Server implementieren.

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