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 ihren Konten 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 Sie eine OAuth 2.0-Implementierung haben, können Sie optional die OAuth-basierte App Flip konfigurieren. Damit können Ihre Nutzer ihre Konten nahtlos von Ihrer mobilen Anwendung mit ihren Google-Konten verknüpfen. Sie können auch Deeplinks verwenden, um Nutzer von Ihrer App oder Produktwebsite direkt zum Verknüpfungsvorgang weiterzuleiten.

OAuth

Für smart home musst du OAuth mit einem Autorisierungscode-Vorgang verwenden. Dazu benötigst du zwei Endpunkte: den Autorisierungs- und den Tokenaustausch-Endpunkt.

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 die Kontoverknüpfung durchführen, da Geräteinformationen mit dem Intent action.devices.SYNC an den Google Assistant gesendet werden, was eine Kontoverknüpfung erfordert.

Deine Cloud-to-cloud-Integration sollte mehrere Google-Nutzer unterstützen, 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ützt, sollten bei der Kontoverknüpfung Fehler angezeigt werden.

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

OAuth-basiertes App Flip

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 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 Ihre Integration finden Sie unter OAuth-basiertes App Flip.

Zurück
Auftragsausführung