Authentification unique pour les tunnels HTTP
Solde requis Tunnels HTTP
Sur cette page 10 sections
L'authentification unique (SSO) place une page de connexion devant un tunnel HTTP. Les visiteurs se connectent avec un fournisseur d'identité de votre choix, tel que Google, GitHub, Microsoft ou GitLab, ou avec un nom d'utilisateur et un mot de passe que vous définissez, avant que toute requête n'atteigne votre service.
Quand l'utiliser #
Tant que vous ne le protégez pas, un tunnel HTTP est ouvert à toute personne qui connaît son adresse. Le SSO est la bonne protection lorsque des personnes ouvrent le tunnel dans un navigateur et que vous voulez décider qui elles sont : un panneau d'administration, un tableau de bord, un outil interne, un site de préproduction. Votre service ne change pas et ne voit jamais de mot de passe.
Le SSO est conçu pour les navigateurs. Une requête qui ne porte pas le cookie de connexion est redirigée vers la page de connexion, si bien que les scripts, les webhooks et les clients API ne peuvent pas passer. Pour ceux-ci, ne protégez que certains chemins (voir Chemins de connexion) ou utilisez les options de Contrôle d'accès.
Fonctionnement #
- Un visiteur ouvre l'URL du tunnel. Une requête en HTTP est d'abord redirigée vers HTTPS.
- Le visiteur n'est pas encore connecté : le serveur Localtonet redirige donc le navigateur vers la page de connexion sur
auth.localtonet.com. La page porte le titre Sign in to continue et propose les fournisseurs que vous avez activés pour ce tunnel. - Le visiteur choisit un fournisseur et s'y connecte. Pour un fournisseur de type nom d'utilisateur et mot de passe, le formulaire se trouve sur la page de connexion elle-même.
- Localtonet vérifie vos règles d'accès et renvoie le visiteur vers l'adresse qu'il avait demandée. La connexion est conservée dans un cookie lié au nom d'hôte du tunnel. C'est un cookie de session du navigateur, envoyé uniquement en HTTPS.
- À partir de là, les requêtes sont transmises à votre service comme d'habitude. Lorsque la connexion n'est plus valide, le visiteur est de nouveau envoyé vers la page de connexion.
Un visiteur qui se connecte mais que vos règles n'autorisent pas voit 403 - Access Denied avec le texte « You do not have permission to access this tunnel. »
Les chemins sous /.well-known ne sont jamais placés derrière la connexion.
Avant de commencer #
- Un tunnel HTTP. Voir HTTP / HTTPS.
- Du solde sur votre compte. Sans solde, l'enregistrement d'un fournisseur ou l'activation de la connexion échoue avec « Vous devez acheter du solde pour utiliser cette fonctionnalité. » Voir Offres et solde et Tarifs.
- Pour un fournisseur externe : un compte chez celui-ci qui vous permet d'enregistrer une application OAuth.
Le SSO se configure dans votre tableau de bord personnel. Le bouton SSO et le paramètre Fournisseurs SSO ne sont pas affichés pour les tunnels d'équipe.
Fournisseurs #
Ces guides détaillent pas à pas les choix les plus courants :
La liste Type de fournisseur du tableau de bord contient : Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon et Yahoo. Pour tous les types sauf Username-Password et Custom, les endpoints sont préremplis. Pour OpenID Connect, les adresses préremplies sont des exemples que vous remplacez par les endpoints de votre fournisseur.
Configuration #
Il y a deux étapes. Vous ajoutez un fournisseur une seule fois, et il est ensuite disponible pour tous vos tunnels HTTP. Vous l'activez ensuite pour chaque tunnel que vous voulez protéger. Un fournisseur enregistré ne protège rien tant qu'aucun tunnel ne l'utilise.
-
Ajouter un fournisseur #
Ouvrez Mes tunnels › HTTP et sélectionnez SSO en haut de la page (son info-bulle indique Paramètres du fournisseur SSO). La boîte de dialogue Fournisseurs SSO s'ouvre. Sélectionnez Ajouter un fournisseur, remplissez le formulaire et sélectionnez Enregistrer le fournisseur. Chaque fournisseur est enregistré séparément.
Champ Description Remarques Nom du fournisseur Un nom pour identifier ce fournisseur dans les paramètres de vos tunnels. Obligatoire. Par exemple Company Google.Type de fournisseur La méthode de connexion. Un nouveau fournisseur démarre avec Google. Changer le type d'un fournisseur enregistré vide le champ Client ID : saisissez de nouveau le client ID et le client secret. Actif Rend le fournisseur disponible pour les tunnels. Lorsque vous passez un fournisseur à inactif et enregistrez, il est aussi désactivé sur chaque tunnel qui l'utilisait. Client ID L'identifiant de l'application que vous avez enregistrée chez le fournisseur. Obligatoire pour tous les types sauf Username-Password et Custom. Client secret Le secret de cette application. Jamais affiché après l'enregistrement. Laissez le champ vide par la suite pour conserver le secret enregistré. Endpoints et callback Endpoint d'autorisation, Endpoint de jeton, Endpoint d'informations utilisateur et Chemin de callback. Préremplis automatiquement pour les fournisseurs standard. Ne les modifiez que si un guide vous le demande. Règles d'accès par e-mail Domaines e-mail autorisés, Domaines e-mail bloqués et Adresses e-mail bloquées. Facultatif. Voir Règles d'accès. Utilisateurs de connexion Noms d'utilisateur et mots de passe. Uniquement pour les types Username-Password et Custom. Pour supprimer un fournisseur, sélectionnez Supprimer le fournisseur. Cela le retire de votre compte et des paramètres SSO de vos tunnels.
-
L'activer pour un tunnel #
Sous Vos tunnels, sélectionnez Paramètres sur le tunnel. Dans le panneau Paramètres du tunnel, repérez Fournisseurs SSO et sélectionnez Gérer. La boîte de dialogue Authentification unique s'ouvre.
Paramètre Fonction Exiger une connexion Active le SSO pour ce tunnel. Les visiteurs qui ne sont pas connectés sont d'abord envoyés vers la page de connexion. Fournisseurs Un interrupteur pour chacun de vos fournisseurs actifs. Activez-en au moins un. Si plusieurs sont activés, le visiteur choisit sur la page de connexion. Qui peut se connecter Listes facultatives d'Adresses e-mail, de Domaines e-mail et de Noms d'utilisateur pour ce tunnel. Chemins de connexion et de déconnexion Chemins de connexion et Chemin de déconnexion facultatifs. Sélectionnez Enregistrer.
-
Le tester #
Ouvrez l'URL du tunnel dans une fenêtre de navigation privée. Vous devriez arriver sur la page Sign in to continue, puis, après connexion, sur votre service.
L'URI de redirection #
Un fournisseur externe demande où il peut envoyer les personnes après leur connexion. Pour chaque tunnel, il s'agit d'une adresse sur l'hôte de connexion de Localtonet, et non de l'adresse de votre tunnel. Enregistrez exactement cette valeur :
http://auth.localtonet.com/auth/callbackChaque guide de fournisseur indique où la saisir.
| Valeur | Où la saisir |
|---|---|
| L'URI de redirection ci-dessus | Chez le fournisseur : Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Chemin de callback, par exemple /auth/callback/google | Dans Localtonet, sous Endpoints et callback. Il est prérempli. Laissez-le tel quel. |
Le fournisseur compare l'URI de redirection à la valeur enregistrée de manière exacte : copiez-la donc telle qu'elle est affichée ici.
Règles d'accès #
La connexion prouve qui est le visiteur. Les règles décident si cette personne peut ouvrir le tunnel. Il y a deux niveaux, et les deux s'appliquent.
| Où | Liste | Ce qu'indique le tableau de bord |
|---|---|---|
| Fournisseur | Domaines e-mail autorisés | Laissez vide pour ne mettre aucune restriction de domaine. Les caractères génériques dépendent du fournisseur. |
| Fournisseur | Domaines e-mail bloqués | Bloque les connexions depuis ces domaines e-mail. |
| Fournisseur | Adresses e-mail bloquées | Bloque ces adresses e-mail individuelles. |
| Tunnel | Adresses e-mail, Domaines e-mail, Noms d'utilisateur | Laissez une liste vide pour ignorer cette vérification. Les listes s'appliquent à tous les fournisseurs activés pour le tunnel. |
Saisissez un élément par ligne, ou séparez les éléments par des virgules. Un domaine se saisit sans @, par exemple example.com.
Après la modification d'une règle, un visiteur déjà admis peut conserver son accès jusqu'à cinq minutes. Un visiteur refusé est vérifié de nouveau au bout d'une minute.
Chemins de connexion et chemin de déconnexion #
| Paramètre | Comportement | Exemple |
|---|---|---|
| Chemins de connexion | Vide : tous les chemins du tunnel exigent une connexion. Rempli : seules les requêtes dont le chemin commence par l'une des entrées exigent une connexion. | /admin couvre /admin et /admin/users, mais pas /administrator. |
| Chemin de déconnexion | L'ouvrir supprime la connexion pour ce tunnel et envoie le visiteur vers la page d'accueil du tunnel, ou vers l'adresse indiquée dans une valeur de requête returnUrl. | /sso/logout |
Les chemins commencent par une barre oblique. Les majuscules et les minuscules ne font aucune différence.
Une liste de chemins de connexion renseignée laisse tout le reste ouvert. Avec /admin dans la liste, seul /admin est protégé et tous les autres chemins sont accessibles sans connexion. Laissez la liste vide pour protéger tout le tunnel.
Le chemin de déconnexion ne déconnecte le visiteur que du tunnel. Il ne le déconnecte pas de Google, de GitHub ni d'un autre fournisseur d'identité.
Dépannage #
« Vous devez acheter du solde pour utiliser cette fonctionnalité. »
Le SSO nécessite du solde. Ajoutez du solde, puis enregistrez de nouveau. Sans solde, vous pouvez quand même ouvrir la boîte de dialogue et désactiver Exiger une connexion.
« Ajoutez un fournisseur avant d'activer la connexion. »
Vous n'avez pas encore de fournisseur actif. Sélectionnez Ajouter un fournisseur dans la boîte de dialogue, ou utilisez le bouton SSO en haut de la page HTTP.
« Activez au moins un fournisseur, ou désactivez la connexion. »
Exiger une connexion est activé mais aucun interrupteur de fournisseur ne l'est. Un fournisseur que vous passez à inactif est désactivé sur ses tunnels et n'apparaît plus dans la liste.
La page de connexion affiche « No authentication providers are currently configured for this tunnel. »
La connexion est requise, mais aucun fournisseur n'est activé pour ce tunnel. Ouvrez Fournisseurs SSO › Gérer sur le tunnel et activez-en un.
Le tunnel s'ouvre sans demander de connexion
Vérifiez que Exiger une connexion est activé et enregistré. Si Chemins de connexion est renseigné, seuls ces chemins sont protégés. Testez aussi dans une fenêtre privée : votre propre navigateur est peut-être encore connecté.
« 403 - Access Denied » après la connexion
La connexion a réussi, mais une règle a refusé le compte. Vérifiez les Règles d'accès par e-mail du fournisseur et les listes Qui peut se connecter du tunnel. Après avoir corrigé une règle, patientez une minute et rechargez la page.
Un webhook ou un client API reçoit une redirection au lieu d'une réponse
Les requêtes sans le cookie de connexion sont redirigées vers la page de connexion. Ne placez dans Chemins de connexion que les pages destinées aux personnes, ou utilisez un tunnel distinct pour le trafic machine.
Automatisation #
Les fournisseurs et les paramètres SSO des tunnels peuvent aussi être gérés via l'API, sous /api/v2/sso-providers, et via le serveur MCP.