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 du eine OAuth 2.0-Implementierung hast, kannst du optional eine 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 müssen Sie OAuth mit einem Autorisierungscode-Flow verwenden. Dazu sind zwei Endpunkte erforderlich: die Endpunkte Autorisierung und Tokenaustausch.

Wenn du einen Nutzer authentifiziert hast, wird das OAuth 2.0-Zugriffstoken des Drittanbieters im Autorisierungsheader gesendet, wenn smart home-Intents an deine Auftragsausführung gesendet werden. Alle Nutzer müssen eine Kontoverknüpfung vornehmen, da Geräteinformationen mit der action.devices.SYNC-Intention an die Google Assistant gesendet werden, für die eine Kontoverknüpfung erforderlich ist.

Deine Cloud-to-cloud-Integration sollte mehrere Google-Nutzer unterstützen, die eine Verbindung zum selben Nutzerkonto herstellen (z. B. wenn Nutzer anderen Nutzern in ihrem Haushalt Zugriff gewähren). Wenn Ihr Dienst keine Verbindungen mehrerer Nutzer unterstützt, sollten bei der Kontoverknüpfung Fehler auftreten.

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

OAuth-basierte App-Weiterleitung

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 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-basierte App Flip.

Zurück
Auftragsausführung