Aller au contenu
Localtonet Localtonet Tableau de bord

Authentification unique avec Microsoft

Solde requis Tunnels HTTP

Aide pour cette page
Sur cette page 6 sections
  1. Avant de commencer
  2. Étapes
  3. Enregistrer une application dans Microsoft Entra
  4. Ajouter le fournisseur dans Localtonet
  5. L'activer pour un tunnel
  6. Le tester
  7. Types de comptes et endpoints
  8. Ce que Localtonet lit chez Microsoft
  9. Dépannage
  10. Pages associées

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 #

Étapes #

  1. 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 :

    1. Dans le centre d'administration Microsoft Entra, allez dans Entra ID › App registrations et sélectionnez New registration.
    2. Saisissez un Name. Les visiteurs le voient lorsqu'ils se connectent.
    3. Sous Supported account types, choisissez qui peut utiliser l'application, puis sélectionnez Register.
    4. Sur la page Overview, copiez l'Application (client) ID. Pour une application à locataire unique, copiez aussi le Directory (tenant) ID.
    5. Sous Manage, ouvrez Authentication, sélectionnez Add Redirect URI, choisissez la plateforme Web, saisissez l'URI de redirection ci-dessous et sélectionnez Configure.
    6. 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/callback

    Un 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.

  2. 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.

    ChampValeur
    Nom du fournisseurN'importe quel nom, par exemple Company Microsoft. Vous le voyez dans les paramètres du tunnel.
    Type de fournisseurMicrosoft. Changer le type d'un fournisseur enregistré vide Client ID ; saisissez donc à nouveau l'ID client et le secret client.
    ActifActivé
    Client IDL'Application (client) ID de Microsoft Entra.
    Client secretLa 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 :

    ChampValeur préremplieÀ modifier ?
    Endpoint d'autorisationhttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeRemplacez common selon le tableau de la section suivante.
    Endpoint de jetonhttps://login.microsoftonline.com/common/oauth2/v2.0/tokenRemplacez common par la même valeur que ci-dessus.
    Endpoint d'informations utilisateurhttps://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.

  3. 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.

  4. 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 commonQui peut se connecter
Single tenant onlyVotre Directory (tenant) IDLes utilisateurs et invités de votre propre locataire.
Multiple Entra ID tenantsorganizationsLes comptes professionnels ou scolaires de n'importe quelle organisation.
Any Entra ID Tenant + Personal Microsoft accountsConservez commonLes comptes professionnels ou scolaires et les comptes Microsoft personnels.
Personal accounts onlyconsumersLes comptes Microsoft personnels.

Exemple pour une application à locataire unique. Remplacez <TENANT_ID> par votre Directory (tenant) ID :

Locataire unique
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/userinfo

Une 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.

Support