Association de comptes

Chaque action smart home doit inclure un mécanisme d'authentification des utilisateurs.

L'authentification vous permet d'associer les comptes Google de vos utilisateurs à des comptes utilisateur dans votre système d'authentification. Cela vous permet d'identifier vos utilisateurs lorsque votre traitement reçoit un intent de maison connectée. Google Smart Home n'est compatible avec OAuth qu'avec un flux avec code d'autorisation.

Une fois que vous avez implémenté OAuth 2.0, vous pouvez éventuellement configurer un App Flip basé sur OAuth, qui permet à vos utilisateurs d'associer plus rapidement leur compte dans votre système d'authentification à leur compte Google.

OAuth

Pour smart home, vous devez utiliser OAuth avec un flux de code d'autorisation, ce qui nécessite deux points de terminaison : les points de terminaison d'autorisation et d'échange de jetons.

Une fois que vous avez authentifié un utilisateur, son jeton d'accès OAuth 2.0 tiers est envoyé dans l'en-tête d'autorisation lorsque les intents smart home sont envoyés à votre traitement. Tous les utilisateurs doivent effectuer l'association de compte, car les informations sur les appareils sont envoyées à Google Assistant avec l'intent action.devices.SYNC, qui nécessite une association de compte.

Votre action smart home doit permettre à plusieurs utilisateurs Google de se connecter au même compte utilisateur (par exemple, lorsque des utilisateurs accordent l'accès à d'autres utilisateurs de leur foyer). Si votre service ne peut pas accepter plusieurs connexions utilisateur, des erreurs devraient s'afficher au moment de l'association du compte.

Pour savoir comment configurer un serveur OAuth 2.0 pour votre action, consultez Implémenter votre serveur OAuth 2.0.

Application Flip basée sur OAuth

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.

Pour en savoir plus sur le parcours de code d'autorisation d'association OAuth, consultez Implémenter votre serveur OAuth 2.0.

Pour obtenir des instructions sur la configuration de App Flip pour votre action, consultez App Flip basé sur OAuth.