Authentification unique avec Microsoft
Solde requis Tunnels HTTP
Sur cette page 6 sections
Permettez aux visiteurs de se connecter avec un compte professionnel ou scolaire Microsoft Entra ID, ou avec un compte Microsoft personnel, avant de pouvoir ouvrir un tunnel HTTP. Vous enregistrez une application dans Microsoft Entra, 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. Consultez la présentation de l'authentification unique (SSO).
- L'accès au centre d'administration Microsoft Entra avec un rôle autorisé à enregistrer des applications. Microsoft indique Application Developer comme rôle minimal.
- Une décision sur qui peut se connecter : uniquement votre organisation, n'importe quelle organisation, ou aussi les comptes personnels. Elle détermine deux des adresses que vous saisissez dans Localtonet. Consultez Types de comptes et endpoints.
Étapes #
-
Enregistrer une application dans Microsoft Entra #
Les guides de Microsoft sont Register an app in Microsoft Entra ID, Add a redirect URI et Add app credentials. En bref :
- Dans le centre d'administration Microsoft Entra, allez dans Entra ID › App registrations et sélectionnez New registration.
- Saisissez un Name. Les visiteurs le voient lorsqu'ils se connectent.
- Sous Supported account types, choisissez qui peut utiliser l'application, puis sélectionnez Register.
- Sur la page Overview, copiez l'Application (client) ID. Pour une application à locataire unique, copiez aussi le Directory (tenant) ID.
- Sous Manage, ouvrez Authentication, sélectionnez Add Redirect URI, choisissez la plateforme Web, saisissez l'URI de redirection ci-dessous et sélectionnez Configure.
- Ouvrez Certificates & secrets › Client secrets et sélectionnez New client secret. Ajoutez une description, choisissez une expiration et sélectionnez Add. Copiez tout de suite la Value du secret : Microsoft ne l'affiche plus jamais après que vous avez quitté la page.
URI de redirection (plateforme : Web)http://auth.localtonet.com/auth/callbackUn secret client expire. Microsoft limite sa durée de vie à 24 mois. À son expiration, la connexion cesse de fonctionner jusqu'à ce que vous créiez un nouveau secret et l'enregistriez dans le fournisseur Localtonet.
-
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 Microsoft. Vous le voyez dans les paramètres du tunnel.Type de fournisseur Microsoft. 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'Application (client) ID de Microsoft Entra. Client secret La Value du secret, et non le Secret ID. Elle n'est jamais affichée après l'enregistrement. Ouvrez Endpoints et callback. Ces valeurs sont renseignées automatiquement :
Champ Valeur préremplie À modifier ? Endpoint d'autorisation https://login.microsoftonline.com/common/oauth2/v2.0/authorizeRemplacez commonselon le tableau de la section suivante.Endpoint de jeton https://login.microsoftonline.com/common/oauth2/v2.0/tokenRemplacez commonpar la même valeur que ci-dessus.Endpoint d'informations utilisateur https://graph.microsoft.com/oidc/userinfoNon. Il ne contient aucun locataire. Chemin de callback /auth/callback/microsoftNon. Renseignez éventuellement les Règles d'accès par e-mail, puis 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 Microsoft. Sélectionnez Enregistrer.
Les listes sous Qui peut se connecter et les Chemins de connexion sont facultatives. Elles sont expliquées dans la présentation.
-
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 Microsoft, vous êtes renvoyé vers le tunnel et votre service se charge.
Types de comptes et endpoints #
La partie de l'adresse Microsoft située après login.microsoftonline.com/ détermine qui peut se connecter. Elle doit correspondre aux Supported account types de votre application. L'Endpoint d'autorisation et l'Endpoint de jeton reçoivent toujours la même valeur. L'Endpoint d'informations utilisateur ne change jamais.
| Supported account types dans Microsoft Entra | À utiliser à la place de common | Qui peut se connecter |
|---|---|---|
| Single tenant only | Votre Directory (tenant) ID | Les utilisateurs et invités de votre propre locataire. |
| Multiple Entra ID tenants | organizations | Les comptes professionnels ou scolaires de n'importe quelle organisation. |
| Any Entra ID Tenant + Personal Microsoft accounts | Conservez common | Les comptes professionnels ou scolaires et les comptes Microsoft personnels. |
| Personal accounts only | consumers | Les comptes Microsoft personnels. |
Exemple pour une application à locataire unique. Remplacez <TENANT_ID> par votre Directory (tenant) ID :
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoUne application à locataire unique ne fonctionne pas avec common. Microsoft répond par l'erreur AADSTS50194. Mettez votre ID de locataire dans les deux endpoints, ou changez l'application pour un type de compte multilocataire.
Avec un type de compte multilocataire ou personnel, des personnes extérieures à votre organisation peuvent se connecter chez Microsoft. Utilisez Domaines e-mail autorisés sur le fournisseur, ou Qui peut se connecter sur le tunnel, pour n'admettre que les personnes voulues.
Ce que Localtonet lit chez Microsoft #
L'endpoint d'informations utilisateur de Microsoft ne renvoie une adresse e-mail que si le compte en possède une ; un compte sans adresse e-mail peut donc ne pas satisfaire les règles fondées sur l'e-mail.
Dépannage #
AADSTS50011: the reply URL does not match
L'URI de redirection de la requête n'est pas enregistré pour l'application. Le message affiche l'adresse qui a été envoyée. Elle doit être identique à un URI de redirection de la page Authentication de l'enregistrement d'application, sur la plateforme Web, majuscules et minuscules comprises. Enregistrez exactement http://auth.localtonet.com/auth/callback.
AADSTS50194: the application is not configured as a multitenant application
L'application est à locataire unique, mais les endpoints contiennent toujours common. Remplacez common par votre Directory (tenant) ID dans l'Endpoint d'autorisation et l'Endpoint de jeton, puis sélectionnez Enregistrer le fournisseur.
AADSTS700016: the application was not found in the directory
Le Client ID est incorrect, ou les endpoints pointent vers un locataire dans lequel l'application n'existe pas. Vérifiez l'Application (client) ID et l'ID de locataire dans les endpoints.
AADSTS7000215 ou AADSTS7000222 : secret client invalide ou expiré
Créez un nouveau secret client sous Certificates & secrets, collez sa Value dans Client secret dans Localtonet et sélectionnez Enregistrer le fournisseur.
Microsoft demande l'approbation d'un administrateur
Votre locataire ne permet pas aux utilisateurs de consentir eux-mêmes aux applications. Un administrateur du locataire doit accorder le consentement pour l'application dans le centre d'administration Microsoft Entra.
« 403 - Access Denied » après une connexion Microsoft réussie
Une règle Localtonet a refusé le compte. Vérifiez les Règles d'accès par e-mail du fournisseur et Qui peut se connecter sur le tunnel, ainsi que si le compte possède bien une adresse e-mail. Après avoir corrigé une règle, patientez une minute et rechargez la page.