Configurer le fournisseur de services

Conditions préalables : Préparation.

Cette section décrit comment configurer le fournisseur de services (SP) ALM en exécutant l’étape Paramètres du fournisseur de services.

Une fois cette étape terminée, vous trouverez le fichier de configuration SP dans le référentiel ALM suivant : {ALM repository}\sa\DomsInfo\osp\basic.properties.

Propriétés

Dans l’onglet Paramètres du fournisseur de services > Propriétés, effectuer les configurations suivantes :

Champ (* obligatoire) Description
*Nom d’hôte du fournisseur de services

  • Si aucun proxy ou répartiteur de charge n’est utilisé, le nom d’hôte de SP doit être le même que le nom du domaine du serveur ALM, car SP est déployé par défaut sur le serveur ALM.

  • Si un proxy ou un répartiteur de charge est déjà défini pour le serveur ALM, saisir le nom de domaine du proxy ou du répartiteur de charge.
*Port du fournisseur de services
  • Si aucun proxy ou répartiteur de charge n’est utilisé, le numéro de port du SP doit être le même que celui du serveur ALM.
  • Si un proxy ou un répartiteur de charge est déjà défini pour le serveur ALM, saisir le numéro de port du proxy ou du répartiteur de charge. Vous pouvez trouver le numéro de port dans le journal du serveur. Pour plus de détails sur la façon de voir les journaux SSO, voir FAQ.
*Fournisseur de services compatible https

  • Si aucun proxy ou répartiteur de charge n’est utilisé, activer HTTPs pour SP si le serveur ALM active HTTPs, et désactiver HTTPs pour SP si le serveur ALM désactive HTTPs.

  • Si un nœud de proxy ou de répartiteur de charge est déjà défini pour le serveur ALM, activer HTTPs pour SP si le proxy ou le répartiteur de charge active HTTPs, et désactiver HTTPs pour SP si le proxy ou le répartiteur de charge désactive HTTPs.
*Activer l’authentification locale

Cette option détermine si les utilisateurs ALM définis comme utilisateurs locaux peuvent se connecter à ALM localement lorsque ALM s’exécute en mode SSO.

  • Non. Lorsqu’ALM fonctionne en mode SSO, ALM ne prend pas en charge l’authentification locale. Seuls les utilisateurs disposant d’ID IdP réels peuvent accéder à ALM.

  • Oui. Lorsqu’ALM fonctionne en mode SSO, ALM prend également en charge l’authentification locale. Les utilisateurs locaux et les utilisateurs avec des ID IdP réels peuvent accéder à ALM.

Pour plus de détails sur la configuration de l’ID IdP et de la clé d’identité de l’utilisateur, voir Mettre à jour les détails de l’utilisateur.

Remarque : L’onglet Mon profil fournit un raccourci pour configurer votre ID IdP et votre clé d’identité. Voir Définir votre profil.
*Secret du jeton SSO

Le secret du jeton SSO est un justificatif d’identité accordé par ALM SP à ALM et sa valeur doit être réservée à l’avance dans ALM SP.

ALM est tenu de porter ce justificatif d’identité lorsqu’il envoie des demandes à son SP pour la génération de jetons SSO.

Retour en haut

Certificat SSO

Le certificat SSO est utilisé pour crypter et décrypter les requêtes SAML et les réponses entre SP ALM et les IdP.

Présentation

Vous pouvez fournir le certificat soit en téléchargeant le fichier de magasin de clés, soit en saisissant les informations du certificat manuellement. Après avoir téléchargé le certificat, vous pouvez afficher ses détails ou télécharger un autre certificat.

Note : Pour plus de détails sur la façon de créer un certificat SAML pour ALM, voir FAQ.

Télécharger un fichier du magasin de clés

Pour fournir votre certificat en téléchargeant un fichier de magasin de clés :

  1. Ouvrir Paramètres du fournisseur de services > Certificat SSO.
  2. Dans le champ Type de soumission de certificat, sélectionnez Télécharger le fichier du magasin de clés.

  3. Dans le champ Choisir un fichier à télécharger, sélectionnez le fichier de magasin de clés qui contient le certificat.

    Assurez-vous que le certificat dans le fichier de magasin de clés contient à la fois la clé privée et la clé publique.

    Le tableau suivant répertorie les types de magasin de clés pris en charge et les extensions de fichier magasin de clés correspondantes.

    Types de magasin de clés pris en charge Extensions de fichiers prises en charge
    JKS

    • .jks

    • .ks
    JCEKS

    • .jce
    PKCS12

    • .p12

    • .pfx
  4. Entrer le magasin de clés et le mot de passe de la clé.
  5. Saisissez l’alias du certificat utilisé dans le fichier du magasin de clés téléchargé.
  6. Cliquez sur Enregistrer.

Entrer manuellement les informations du certificat

Pour fournir votre certificat en saisissant les informations du certificat manuellement :

  1. Cliquer sur Paramètres du fournisseur de services > Certificat SSO.
  2. Dans le champ Type de soumission de certificat, sélectionnez Saisir manuellement.
  3. Saisissez les mots de passe du magasin de clés et du certificat, la chaîne de certificats et la clé privée.
  4. Cliquez sur Enregistrer.

Télécharger un autre certificat

Après avoir téléchargé le certificat, vous pouvez afficher ses détails ou télécharger un autre certificat.

L’onglet Certificat SSO affiche l’alias et la date d’expiration du certificat. Pour afficher plus de détails, cliquez sur le lien Afficher le certificat.

Pour télécharger un certificat différent :

  1. Supprimer le certificat actuel.

    Supprimer le certificat à l’aide de l’assistant

    Pour supprimer le certificat actuel à l’aide de l’Assistant de configuration SSO :

    1. Dans l’onglet Paramètres du fournisseur de services > Certificat SSO, cliquer sur Supprimer.

    2. Dans la boîte de dialogue Supprimer le certificat, fournir les mots de passe du magasin de clés et du certificat, puis cliquer sur Supprimer.

    3. Actualiser la page.
    Supprimer le certificat du référentiel ALM

    Supprimer le certificat actuel du répertoire suivant :

    {ALM Deploy Directory}\ALM\repository\sa\DomsInfo\osp\.
  2. Téléchargez le nouveau certificat.
  3. Redémarrez le serveur ALM. Si ALM est déployé dans un environnement de cluster, redémarrer chaque nœud.
  4. Si vous avez partagé des métadonnées de SP ALM avec votre IdP, procurez-vous les métadonnées de SP mises à jour et partagez-les à nouveau avec votre IdP.

Retour en haut

FAQ

R : Nous vous recommandons d’obtenir le certificat SSO auprès d’une organisation autorisée afin d’obtenir un certificat plus sûr. Mais si votre organisation n’exige pas de politiques de sécurité très élevées, vous pouvez créer un certificat SAML par vous-même.

Pour générer un certificat SSL auto-signé à l’aide de la commande keytool sous Windows, Mac ou Linux :

  1. Ouvrez une invite de commande ou un terminal et exécutez cette commande :

    keytool-genkey-keyalgRSA -alias <alias> -keystoreselfsigned.jks-validity <days> -keysize2048

    où <alias> indique le nom du certificat ;<jours> indique le nombre de jours pendant lesquels le certificat sera valide.

  2. Saisissez un mot de passe pour le fichier de magasin de clés. Notez ce mot de passe car vous en aurez besoin lors de la configuration du serveur.

  3. Lorsque vous êtes invité à indiquer le prénom et le nom, entrez le nom de domaine du serveur. Par exemple, myserver ou myserver.mycompany.com.

  4. Saisissez les autres détails, tels que l’unité organisationnelle, l’organisation, la ville, l’État et le pays.

  5. Confirmez que les informations saisies sont correctes.

  6. Lorsque l’on vous demande le mot de passe « Saisissez la clé » pour <tomcat>, appuyez sur Entrée pour utiliser le même mot de passe que celui du fichier de magasin de clés.

  7. Exécutez cette commande pour vérifier le contenu du fichier de magasin de clés :

    keytool-list -v -keystoreselfsigned.jks

  8. Lorsque vous y êtes invité, saisissez le mot de passe du fichier de magasin de clés.

Le certificat que vous générez est nommé selfsigned.jks. Ne modifiez pas son nom d’extension. Vérifiez que le « Propriétaire » et « l’Émetteur » sont les mêmes. Conservez l’alias, le mot de passe de la clé et le mot de passe du fichier de magasin de clés dans un endroit sûr, car vous en aurez besoin dans l’outil de configuration SSO pour télécharger ou supprimer le certificat.

R : Suivre les étapes ci-dessous pour obtenir les journaux SSO :

  1. Ouvrez le fichier de configuration du SP dans le référentiel ALM : {ALM repository}\sa\DomsInfo\osp\basic.properties.
  2. Définissez « logging.level=ALL ».

  3. Redémarrez ALM et reconnectez-vous à ALM.

  4. Vérifiez le répertoire de java.io.tmpdir dans le journal du serveur. Tous les fichiers osp-* de ce répertoire sont des fichiers journaux SSO.

Retour en haut

Étapes suivantes :