Keyprod peut s'appuyer sur votre annuaire Microsoft Entra ID (anciennement Azure AD) pour l'authentification : vos utilisateurs se connectent à Keyprod avec leur compte Microsoft professionnel, sans mot de passe supplémentaire. Ce guide explique comment relier votre annuaire à Keyprod.
Avant de commencer
- Le SSO doit être activé sur votre espace Keyprod. Cette option est activée par Keyprod : contactez votre interlocuteur Keyprod ou notre support pour en faire la demande. Tant qu'elle n'est pas activée, l'onglet SSO n'apparaît pas dans vos paramètres.
- Vous disposez d'un compte administrateur Keyprod.
- Vous disposez d'un accès au portail Microsoft Entra ID de votre organisation, avec les droits nécessaires pour inscrire une application et accorder le consentement administrateur. Si ce n'est pas votre cas, faites-vous accompagner par votre service informatique.
La configuration se fait en allers-retours entre Keyprod et le portail Microsoft Entra ID : gardez les deux ouverts.
Comptez environ 15 minutes.
1. Copier l'URL de redirection dans Keyprod
Dans Keyprod, ouvrez Paramètres / Organisation / Intégrations.
Dans l'onglet SSO, bloc Microsoft Entra ID, cliquez sur Copier l'URL à droite du champ URL de redirection. Vous en aurez besoin à l'étape suivante.
Important : l'URL de redirection déclarée dans Microsoft Entra ID doit être strictement identique à celle affichée dans Keyprod. Utilisez toujours le bouton Copier l'URL plutôt qu'une saisie manuelle.
2. Inscrire Keyprod dans Microsoft Entra ID
Dans le portail Microsoft Entra ID de votre organisation :
2.1 Créer l'inscription d'application
- Ouvrez Inscriptions d'applications, puis cliquez sur Nouvelle inscription.
- Donnez un nom à l'application (par exemple Keyprod).
- Dans URL de redirection, choisissez la plateforme Web, puis collez l'URL copiée depuis Keyprod.
- Validez l'inscription.
2.2 Ajouter les informations transmises à Keyprod
- Ouvrez Configuration du jeton, puis cliquez sur Ajouter une revendication facultative.
- Type de jeton : ID.
- Cochez family_name, given_name et email, puis ajoutez.
Ces informations permettent à Keyprod de reconnaître chaque utilisateur (nom, prénom et adresse e-mail).
2.3 Accorder le consentement administrateur
Ouvrez API autorisées et cliquez sur Accorder un consentement d'administrateur pour votre organisation.
2.4 Créer un secret client
- Ouvrez Certificats et secrets, puis créez un nouveau secret client et choisissez sa durée de validité.
- Copiez immédiatement la Valeur du secret : Microsoft ne l'affiche qu'une seule fois, juste après sa création.
- Notez sa date d'expiration.
Attention : copiez bien la colonne Valeur, et non l'ID de secret. C'est l'erreur la plus fréquente.
3. Déclarer votre annuaire dans Keyprod
De retour dans Keyprod (Paramètres → Organisation → Intégrations, onglet SSO), cliquez sur Déclarer l'annuaire, puis renseignez les champs :
| Champ Keyprod | Où trouver l'information dans Microsoft Entra ID |
|---|---|
| ID annuaire | Page Vue d'ensemble de l'application inscrite : ID de l'annuaire (locataire) ou Tenant ID |
| ID d'application | Page Vue d'ensemble de l'application inscrite : ID d'application (client) ou Client ID |
| Secret client | Certificats et secrets : colonne Valeur du secret créé à l'étape 2.5 |
| Date d'expiration | Date d'expiration de ce secret |
3.1 Option « Accepter les comptes externes »
Cette option détermine si vos utilisateurs peuvent encore se connecter avec un mot de passe Keyprod :
- Cochée : les utilisateurs peuvent toujours se connecter avec leur mot de passe Keyprod, en plus du SSO.
- Décochée : seuls les administrateurs conservent un mot de passe Keyprod. Tous les autres utilisateurs se connectent uniquement via votre annuaire Microsoft, et leur mot de passe Keyprod est supprimé.
Si vous déployez le SSO progressivement, laissez l'option cochée le temps de vérifier que tout le monde peut se connecter, puis décochez-la.
3.2 Tester puis sauvegarder
- Cliquez sur Tester la connexion. Le message « L'annuaire a accepté ces identifiants. » confirme que la configuration est correcte.
- Cliquez sur Sauvegarder.
Les identifiants sont toujours vérifiés auprès de votre annuaire avant d'être enregistrés : une saisie erronée ne bloque donc personne.
4. Vérifier la configuration
Le bloc Microsoft Entra ID affiche désormais la date de la dernière vérification réussie ainsi que les informations déclarées. Vos utilisateurs peuvent se connecter à Keyprod avec leur compte Microsoft.
Les boutons Modifier et Supprimer permettent de mettre à jour ou de retirer la configuration.
5. Renouveler le secret client
À sa date d'expiration, le secret client cesse de fonctionner et la connexion SSO n'est plus possible. Avant cette date :
- Dans Microsoft Entra ID, créez un nouveau secret client (étape 2.5).
- Dans Keyprod, cliquez sur Modifier, saisissez la nouvelle valeur et la nouvelle date d'expiration, testez puis sauvegardez.
En cas de problème
- L'onglet SSO n'apparaît pas dans Intégrations : l'option SSO n'est pas encore activée sur votre espace. Contactez le support Keyprod.
- Le test de connexion échoue : vérifiez que vous avez copié la Valeur du secret (et non son ID), que les deux identifiants ne sont pas inversés, et que le consentement administrateur a bien été accordé (étape 2.4).
- Un utilisateur obtient une erreur de redirection en se connectant : l'URL de redirection déclarée dans Microsoft Entra ID ne correspond pas exactement à celle de Keyprod.
Copiez-la à nouveau avec le bouton Copier l'URL. - La connexion SSO ne fonctionne plus du jour au lendemain : le secret client a probablement expiré. Renouvelez-le (voir ci-dessus).
Besoin d'aide ? Contactez le support Keyprod.