Skip to main content

Guide d’installation de BriefCam

SAML – ADFS Configuration de la partie utilisatrice pour les exigences de BriefCam

Last Updated: 4 minute read
Version2024r2
LangueFrançais

  1. Pour utiliser ADFS pour vous connecter à votre instance BriefCam , vous avez besoin des composants suivants :

    • Une instance Active Directory.

    • Ce guide utilise des captures d’écran du serveur 2012R2, mais des étapes similaires devraient être possibles sur d’autres versions.

    • Un certificat SSL pour signer votre page de connexion ADFS et l’empreinte de ce certificat.

    • Une fois que vous avez rempli ces conditions de base, vous devez installer ADFS sur votre serveur. La configuration et l’installation d’ADFS dépassent le cadre de ce guide, mais sont détaillées dans un article de Microsoft KB.

    Note

    BriefCam utilise l’adresse e-mail de l’utilisateur fournie par ADFS dans le cadre des assertions SAML afin d’identifier l’utilisateur.

  2. Lorsque vous avez terminé l’installation d’ADFS, notez la valeur de l'URL SAML 2.0/W-Federation dans la section ADFS Endpoints (Points de terminaison ADFS). Si vous avez choisi les valeurs par défaut pour l’installation, celle-ci sera '/adfs/ls/'.

Étape 1 : Ajouter un Relying Party Trust (partie utilisatrice de confiance)

  1. À ce stade, vous devez être prêt à établir la connexion ADFS avec votre instance BriefCam . La connexion entre ADFS et BriefCam est définie à l’aide d’un Relying Party Trust (RPT).

  2. Sélectionnez le dossier Relying Party Trusts (Partie utilisatrice de confiance) depuis ADFS Management, et ajoutez un nouveau Standard Relying Party Trust (Partie utilisatrice de confiance) depuis la barre latérale Actions. Cela lance l’assistant de configuration d’une nouvelle approbation.

    SAML welcome.png

  3. Dans l'écran Sélectionner une source de données, sélectionnez la dernière option, Saisir manuellement les données sur la partie utilisatrice.

    SAML select source.png

  4. Sur l’écran suivant, saisissez un nom d’affichage que vous reconnaîtrez à l’avenir, ainsi que les notes que vous souhaitez ajouter.

    SAML display name.png

  5. Sur l’écran suivant, sélectionnez le bouton radio profil AD FS.

    SAML AD FS profile.png

  6. Sur l’écran suivant, laissez les paramètres du certificat avec leurs valeurs par défaut.

    SAML configure certificate.png

  7. Sur l’écran suivant, cochez la case Enable Support for the SAML 2.0 WebSSO protocol. L’URL du service sera : https://<WebServices>/ProWebApi/AuthenticationApi/AuthenticateSaml

    Remplacez <WebServices> par l’adresse de votre BriefCam WebServices Windows. Notez qu’il n’y a pas de barre oblique à la fin de l’URL.

    SAML Enable support for protocol.png

  8. Sur l’écran suivant, ajoutez un Relying party trust identifier (identifiant d’approbation de la partie utilisatrice).

    https://<WebServices>/prowebapi doit correspondre à l’adresse exacte de prowebapi dans les paramètres (sensible à la casse).

    Remplacez <WebServices> par l’adresse de votre BriefCam de services Web Windows.

    SAML relying identifier.png

    HTTPS est obligatoire dans l’adresse.

  9. Sur l’écran suivant, vous pouvez configurer l’authentification multifacteur, mais cela dépasse le cadre de ce guide.

    SAML multi-factor.png

  10. Sur l’écran suivant, sélectionnez le bouton radio Autoriser tous les utilisateurs à accéder à cette partie utilisatrice.

    SAML permit all.png

  11. Sur les deux écrans suivants, l’assistant affichera une vue d’ensemble de vos paramètres. Sur le dernier écran, utilisez le bouton Fermer pour quitter et ouvrir l'éditeur des règles de claims.

    SAML claim rules.png

Étape 2 : Créer des règles de revendication

Une fois que l’approbation de la partie utilisatrice a été créée, vous pouvez créer les règles de revendication.

  1. Pour créer une nouvelle règle, cliquez sur Ajouter une règle. Créez une règle Envoyer les attributs LDAP en tant que revendications.

    SAML claim rule template.png

  2. Sur l’écran suivant, en utilisant Active Directory comme magasin d’attributs, procédez comme suit :

    • Dans la colonne Attribut LDAP, sélectionnez Adresses e-mail.

    • Dans Type de revendication sortante , sélectionnez Adresse e-mail.

      SAML configure rule.png

  3. Répétez l’étape pour UPN.

  4. Cliquez sur OK pour enregistrer la nouvelle règle.

Étape 3 : Configuration BriefCam

  1. Après avoir configuré ADFS, vous devez configurer votre instance BriefCam pour vous authentifier à l’aide de SAML.

  2. Vous utiliserez l’URL complète de votre serveur ADFS avec le endpoint SAML comme URL SSO.

  3. L’empreinte digitale sera celle du certificat de signature de token installé dans votre instance ADFS. Dans l’utilitaire de certificat de Windows, cette fonction est également appelée empreinte SHA-1.

  4. Exportez le certificat de signature du jeton ADFS (sur le serveur ADFS) dans PowerShell en tant qu’admin :

    $certRefs=Get-AdfsCertificate -CertificateType Token-Signing

    $certBytes=$certRefs[0].Certificate.Export([System.Security.Cryptography.X509Certificates.X509ContentType]::Cert)

    [System.IO.File]::WriteAllBytes(« c:\foo.cer », $certBytes)

  5. Copiez les c:\foo.cer sur le BriefCam d’enregistrement.

  6. Lancez mmc.

  7. Fichier -> ajoutez et supprimez les snap ins.

  8. Certificats -> ajouter -> compte d’ordinateur -> ordinateur local.

  9. Allez dans Certificates -> Personal -> Certificates.

  10. Faites un clic droit sur Certificats et sélectionnez Toutes les tâches -> Importerfoo.cer.

    SAML import certificate.png

  11. Double-cliquez sur le nouveau certificat, allez dans l’onglet détails et copiez l’empreinte du certificat.

  12. Collez l’empreinte dans un éditeur de texte, supprimez les espaces, puis copiez et collez-la dans la section ProWebAPI dans le champ Web admin > Settings SamlCertificate (Paramètres SamlCertificate).

  13. Configurez les champs suivants dans les paramètres d’environnement du BriefCam Administrator Console:

    • SamlLoginUrl = https:// <ADFS Server address>/adfs/ls/idpinitiatedsignon

    • SamlLogoutUrl = URL de déconnexion du serveur ADFS

    • SamlCertificate = <Certificat SAML>

    Note

    Ne modifiez pas les paramètres d’environnement ProWebApiAddress et ProWebClientAddress (conservez les valeurs par défaut).

  14. Dans le gestionnaire IIS sur l’ordinateur WebServices, accédez à BriefCam Web Services > Liaisons > Ajouter, dans le menu déroulant Type, sélectionnez https et cliquez sur OK.

    SAML Add binding.png

  15. Redémarrez les services IIS (en ouvrant les services Windows, en cliquant avec le bouton droit de la souris sur World Wide Web Publishing Service et en cliquant sur Restart).

  16. Vous devriez maintenant être configuré et prêt à partir. Pour tester, exécutez : https://localhost/authenticationApi/RequestAuthenticationRoute

Si vous avez été redirigé vers la page de connexion, que vous vous êtes connecté et que vous avez reçu un retour valide (identifiant de session et nom d’utilisateur), félicitations, vous avez survécu à ce guide.

Sinon, assurez-vous d’avoir suivi toutes les étapes correctement.