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

Mit der OAuth-basierten App Flip-Verknüpfung (App Flip) können Ihre Nutzer ihre Konten in Ihrem Authentifizierungssystem ganz einfach und schnell mit ihren Google-Konten verknüpfen. Wenn deine App beim Starten der Kontoverknüpfung auf dem Smartphone des Nutzers installiert ist, wird er nahtlos zu deiner App gewechselt, um die Nutzerautorisierung zu erhalten.

Dieser Ansatz bietet einen schnelleren und einfacheren Verknüpfungsprozess, da der Nutzer seinen Nutzernamen und sein Passwort nicht noch einmal eingeben muss, um sich zu authentifizieren. Stattdessen nutzt App Flip die Anmeldedaten aus dem Konto des Nutzers in Ihrer App. Sobald ein Nutzer sein Google-Konto mit Ihrer App verknüpft hat, kann er alle von Ihnen entwickelten Integrationen nutzen.

Sie können App-Flip sowohl für iOS- als auch für Android-Apps einrichten.

Auf dieser Abbildung sind die Schritte zu sehen, die ein Nutzer ausführen muss, um sein Google-Konto mit Ihrem Authentifizierungssystem zu verknüpfen. Auf dem ersten Screenshot ist zu sehen, wie ein Nutzer Ihre App auswählen kann, wenn sein Google-Konto mit Ihrer App verknüpft ist. Auf dem zweiten Screenshot ist die Bestätigung für die Verknüpfung des Google-Kontos mit Ihrer App zu sehen. Auf dem dritten Screenshot ist ein erfolgreich verknüpftes Nutzerkonto in der Google App zu sehen.
Abbildung 1. Kontoverknüpfung auf dem Smartphone eines Nutzers 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 Inhaber, Administrator und Wartungsperson eines OAuth 2.0-Servers sein, 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-basiertes App Flip.

Zurück
Auftragsausführung