Utiliser le SSO Microsoft Entra ID (Azure AD) pour se connecter à Bob! Desk (SAML 2.0)

Ce guide décrit la procédure à suivre pour connecter votre environnement Microsoft Entra ID (anciennement Azure Active Directory) à Bob! Desk via SAML 2.0. L'objectif est de permettre à vos utilisateurs de se connecter à la plateforme en utilisant leurs identifiants Microsoft d'entreprise.

Environnements : production et test (staging)

Bob! Desk dispose d'un environnement de test (staging) distinct de la production. Pour valider la connexion SSO avant de l'activer pour vos utilisateurs, créez une application SAML dans Entra ID avec les valeurs de la colonne « Staging », puis une seconde application avec celles de la colonne « Production » le moment venu.

Les étapes ci-dessous utilisent les valeurs de production.

Étapes à effectuer dans Entra ID (Azure AD)

Étape 1 — Accéder à la gestion des applications

1. Connectez-vous au portail Azure avec un compte administrateur.
2. Accédez à Azure Active Directory → Enterprise applications.
3. Cliquez sur « + New application ».

Étape 2 — Créer une application SAML personnalisée

1. Choisissez « Create your own application ».
2. Donnez-lui un nom clair, par exemple : SSO - [Nom de votre entreprise] vers Bob! Desk.
3. Sélectionnez « Integrate any other application you don't find in the gallery (Non-gallery application) ».
4. Cliquez sur Create.

Étape 3 — Configurer l'authentification SAML

Une fois l'application créée :

1. Dans la section « Single sign-on », sélectionnez SAML comme méthode.
2. Renseignez les champs suivants :

Étape 4 — Configurer les attributs utilisateur (claims)

Dans la section « User Attributes & Claims », vérifiez que les champs suivants sont configurés :

Étape 5 — Télécharger les métadonnées IdP

Sur la même page, sous la section « SAML Signing Certificate » :

1. Cliquez sur Download Metadata XML. Le fichier téléchargé contient l'IdP Entity ID, la SSO URL et le certificat X.509 public.
2. Conservez ce fichier, vous devrez nous l'envoyer.

Étape 6 — Attribuer les utilisateurs ou groupes autorisés

1. Dans le menu latéral, ouvrez « Users and groups ».
2. Cliquez sur Add user/group.
3. Sélectionnez les utilisateurs ou groupes qui auront accès à Bob! Desk.
4. Cliquez sur Assign.

Informations à nous transmettre

Une fois la configuration terminée, envoyez un email à tech@bob-desk.fr (cliquer pour un email prérempli) contenant :

1. Le fichier XML de métadonnées téléchargé à l'étape 5 (ou, à défaut, les valeurs suivantes extraites de ce fichier) :
   • IdP Entity ID : ex. https://sts.windows.net/{tenant-id}/
   • SSO URL (Login URL) : ex. https://login.microsoftonline.com/{tenant-id}/saml2
   • Certificat X.509 (contenu dans le XML)
2. Le ou les domaines email de vos utilisateurs devant se connecter en SSO (ex. entreprise.com). Le domaine est la partie de l'adresse email qui suit l'arobase ; s'il y en a plusieurs, merci de tous nous les préciser.
3. L'environnement concerné : production ou staging.

Nous utiliserons ces données pour activer la connexion SSO côté Bob! Desk et valider l'intégration.

Vérification du SSO

Une fois l'intégration effectuée par nos équipes :

1. Rendez-vous sur la page de connexion SSO de Bob! Desk : https://app.bob-desk.com/sso-login (ou https://staging.bob-desk.com/sso-login pour l'environnement de test).
2. Saisissez votre adresse email d'entreprise.
3. Vous serez redirigé vers la page de connexion Microsoft de votre organisation.
4. Après authentification, vous êtes automatiquement redirigé et connecté à Bob! Desk.

Pour plus d'informations ou pour approfondir la configuration du SSO SAML 2.0 avec Supabase, sur lequel s'appuie l'authentification de Bob! Desk, vous pouvez également consulter la documentation officielle de Supabase : https://supabase.com/docs/guides/auth/enterprise-sso/auth-sso-saml