Authentification unique avec Google
Solde requis Tunnels HTTP
Sur cette page 4 sections
Permettez aux visiteurs de se connecter avec leur compte Google avant de pouvoir ouvrir un tunnel HTTP. Vous créez un client OAuth dans Google Cloud, vous l'ajoutez à Localtonet comme fournisseur, puis vous l'activez pour le tunnel.
Avant de commencer #
- Un tunnel HTTP et du solde sur votre compte. Voir la vue d'ensemble de l'authentification unique (SSO).
- Un compte Google ayant accès à la console Google Cloud et un projet dans celle-ci.
Étapes #
-
Créer un client OAuth dans Google Cloud #
Google modifie sa console de temps à autre. Son propre guide est Manage OAuth Clients. En bref :
- Dans la console Google Cloud, ouvrez Google Auth Platform pour votre projet. Si le projet est nouveau, la console vous demande d'abord de configurer l'application : un nom d'application, un e-mail d'assistance, le public et les informations de contact.
- Sous Audience, choisissez qui peut se connecter. Voir le tableau ci-dessous.
- Ouvrez Clients et sélectionnez Create client.
- Définissez Application type sur Web application et donnez un nom au client.
- Sous Authorized redirect URIs, ajoutez l'URI de redirection ci-dessous. Authorized JavaScript origins peut rester vide.
- Sélectionnez Create, puis copiez le Client ID et le Client secret. Google n'affiche le secret complet qu'à ce moment-là.
Authorized redirect URIhttp://auth.localtonet.com/auth/callbackAudience dans Google Qui peut se connecter Internal Uniquement les membres de votre organisation Google Cloud. External, état de publication Testing Les utilisateurs de test que vous listez dans Google, jusqu'à 100. Google fait une exception pour les applications qui ne demandent que le nom, l'adresse e-mail et le profil de l'utilisateur : pour celles-ci, les utilisateurs n'ont pas besoin de figurer dans la liste. Ne comptez pas sur la liste des utilisateurs de test pour tenir des personnes à l'écart ; utilisez les règles d'accès de Localtonet. External, état de publication In production Toute personne ayant un compte Google. Utilisez les règles d'accès de Localtonet pour restreindre. La demande de connexion réclame les portées
openid,emailetprofile. Si Google vous demande de choisir des portées pour l'application, ces trois-là suffisent.Google indique qu'une modification d'un client peut mettre de 5 minutes à quelques heures pour prendre effet.
-
Ajouter le fournisseur dans Localtonet #
Ouvrez Mes tunnels › HTTP et sélectionnez SSO en haut de la page. Dans la boîte de dialogue Fournisseurs SSO, sélectionnez Ajouter un fournisseur.
Champ Valeur Nom du fournisseur N'importe quel nom, par exemple Company Google. Vous le voyez dans les paramètres du tunnel.Type de fournisseur Google. Changer le type d'un fournisseur enregistré vide Client ID : saisissez donc à nouveau l'ID client et le secret client. Actif Activé Client ID L'ID client fourni par Google. Client secret Le secret client fourni par Google. Il n'est jamais affiché après l'enregistrement. Sous Endpoints et callback, les adresses Google standard sont renseignées automatiquement. Laissez-les telles quelles :
Champ Valeur préremplie Endpoint d'autorisation https://accounts.google.com/o/oauth2/v2/authEndpoint de jeton https://oauth2.googleapis.com/tokenEndpoint d'informations utilisateur https://openidconnect.googleapis.com/v1/userinfoChemin de callback /auth/callback/googleRemplissez éventuellement Règles d'accès par e-mail. Pour n'admettre que votre entreprise, saisissez son domaine, par exemple
example.com, sous Domaines e-mail autorisés. Sélectionnez Enregistrer le fournisseur. -
L'activer pour un tunnel #
Sous Vos tunnels, sélectionnez Paramètres sur le tunnel, puis Gérer à côté de Fournisseurs SSO. Dans la boîte de dialogue Authentification unique, activez Exiger une connexion et l'interrupteur de votre fournisseur Google. Sélectionnez Enregistrer.
Les listes sous Qui peut se connecter et les Chemins de connexion sont facultatifs. Ils sont expliqués dans la vue d'ensemble.
-
Le tester #
Ouvrez l'URL du tunnel dans une fenêtre de navigation privée. Localtonet affiche Sign in to continue avec un bouton pour votre fournisseur. Après votre connexion chez Google, vous êtes renvoyé vers le tunnel et votre service se charge.
Dépannage #
Google signale redirect_uri_mismatch
L'URI de redirection de la requête ne figure pas parmi les Authorized redirect URIs du client. Ajoutez exactement http://auth.localtonet.com/auth/callback au client dans Google et laissez un peu de temps à la modification pour prendre effet.
La console Google n'accepte pas l'URI de redirection
Google vérifie les URI de redirection d'après ses règles de validation. Le message à côté du champ nomme la règle qui a échoué.
Google refuse le compte, par exemple avec org_internal
Google a refusé le compte avant que Localtonet ne le voie. Avec l'audience Internal, seuls les membres de votre organisation peuvent se connecter, et Google signale org_internal pour tous les autres. Avec External en Testing, vérifiez la liste des utilisateurs de test dans Google.
Google signale invalid_client
Google n'accepte pas le client. Vérifiez le Client ID et le Client secret enregistrés dans Localtonet, et que le client existe toujours dans Google. Collez à nouveau les deux et sélectionnez Enregistrer le fournisseur. Si vous n'avez plus le secret, créez-en un nouveau dans Google.
« 403 - Access Denied » après une connexion Google réussie
Une règle de Localtonet a refusé le compte. Comparez l'adresse avec laquelle le visiteur s'est connecté aux Domaines e-mail autorisés, aux Domaines e-mail bloqués et aux Adresses e-mail bloquées du fournisseur, ainsi qu'à Qui peut se connecter sur le tunnel.
Il n'y a pas de bouton Google sur la page de connexion
Le fournisseur n'est pas activé pour ce tunnel, ou il est défini comme inactif. Vérifiez les deux.