Skip to main content

Ajouter un fournisseur de services SAML entrant

SAML est une norme d'authentification utilisée par de nombreux systèmes Blackboard, notamment pour authentifier une signature sur demande. Le service SAML entrant nécessite de configurer deux adaptateurs dans Blackboard : le fournisseur de services SAML SP et l’adaptateur entrant du redirecteur SAML. Ils seront ensuite connectés à l’adaptateur SAML sortant.

Le fournisseur de services SAML SP contient les informations de configuration nécessaires pour traiter l’assertion SAML envoyée par le fournisseur d’identité configuré pour le fournisseur de services SAML UAS.

L’adaptateur entrant du redirecteur SAML reçoit l’assertion SAML du fournisseur d’identité et la transmet au fournisseur de services SAML SP pour traitement.

Voici un exemple de flux de connexion utilisant ce service via UAS :

Schéma illustrant le flux de connexion du fournisseur de services SAML via UAS. Le flux passe du redirecteur SAML UAS au fournisseur d’identité, puis au fournisseur de services SAML UAS, puis aux adaptateurs sortants SAML UAS, jusqu’au fournisseur SAML Blackboard.

Lorsque vous configurez l’UAS pour utiliser le service SAML, configurez les adaptateurs UAS dans l’ordre suivant.

Adaptateur sortant UAS SAML

Commencez par configurer l’adaptateur SAML sortant, puis le fournisseur SAML Blackboard. Vous trouverez les étapes dans la section Ajouter l’adaptateur SAML sortant.

Service SAML

Dans l'écran des paramètres UAS, sélectionnez Ajouter un adaptateur d'authentification. Renseignez les champs comme suit :

Champ

Description

Alias

Il s’agit d’un nom unique pour l’adaptateur, utilisé dans les URL. L’alias est enregistré en minuscules et ne doit pas contenir de caractères spéciaux d’URL.

Activé

Ce bouton permet de déterminer si l’adaptateur peut être utilisé.

Type d’authentification

Service SAML

Clé privée

La clé privée X.509. La valeur n’est visible qu’au moment de créer l’adaptateur. Pour en savoir plus sur la création de la clé privée, consultez Générer des clés publiques et privées .

Clé publique

La clé publique X.509. Cette clé sera partagée avec le fournisseur de services SAML via les données générées. Pour en savoir plus sur la création de la clé privée, consultez Générer des clés publiques et privées .

Métadonnées IdP

Saisissez les métadonnées SAML fournies par votre fournisseur d’identité.

ID de l’entité

Saisissez un identifiant d’entité qui identifie votre service de manière unique. Cette valeur doit correspondre à celle configurée dans votre IDP.

Attribut d’identification du nom

Saisissez le nom de l’attribut dans la réponse d’authentification SAML qui identifie le nom d’utilisateur. Si aucune valeur n’est saisie, le système utilise le NameID fourni dans la réponse.

Expression d’attribut d’identifiant de nom

Saisissez l’expression régulière, si nécessaire, utilisée pour analyser l’attribut username d’un principal. Si vous ne le renseignez pas, le système utilisera directement le NameID défini dans le mappage.

Correspondance de l’expression de l’attribut « Name »

Saisissez le numéro du groupe de correspondance d’expressions régulières pour l’attribut Name ID Expression regular expression. Si vous ne le renseignez pas, le système utilisera la première correspondance (index 0).

Attribut d’adresse e-mail

Saisissez le nom de l’attribut dans la réponse d’authentification SAML qui identifie l’adresse e-mail de l’utilisateur.

Expression d’attribut d’e-mail

Saisissez l’expression régulière à utiliser pour extraire l’attribut e-mail à partir de la valeur fournie dans l’attribut Email. Si vous ne le renseignez pas, le système utilisera directement l’adresse e-mail indiquée dans le mappage.

Correspondance des expressions d’attributs d’e-mail

Saisissez le numéro du groupe de capture pour l’expression régulière de l’attribut Email. Si vous ne le renseignez pas, le système utilisera la première correspondance (index 0).

Attribut « Prénom »

Saisissez le nom de l’attribut dans la réponse d’authentification SAML qui identifie le prénom de l’utilisateur.

Attribut « Nom de famille »

Saisissez le nom de l’attribut dans la réponse d’authentification SAML qui identifie le nom de famille de l’utilisateur.

Méthode de recherche des utilisateurs

Sélectionnez Nom d’utilisateur ou identifiant batch. Ce paramètre définit comment les utilisateurs seront associés dans Blackboard. Si « Nom d’utilisateur » est sélectionné, Blackboard recherche dans la base de données Blackboard un nom d’utilisateur correspondant à la valeur de l’attribut Name ID. Si l’option Identifiant batch est sélectionnée, Blackboard recherchera les identifiants batch correspondant à la valeur saisie, et non le nom d’utilisateur.

Sélectionnez Enregistrer pour enregistrer votre configuration.

Adaptateur entrant de redirection SAML

Dans l'écran des paramètres UAS, sélectionnez Ajouter un adaptateur d'authentification. Renseignez les champs comme suit :

Champ

Description

Alias

Il s’agit d’un nom unique pour l’adaptateur, utilisé dans les URL. L’alias est enregistré en minuscules et ne doit pas contenir de caractères spéciaux d’URL.

Activé

Ce bouton permet de déterminer si l’adaptateur peut être utilisé.

Type d’authentification

REDIRECTEUR

Utiliser un adaptateur de sortie

Sélectionnez l’adaptateur d’authentification à utiliser pour l’authentification sortante vers le système externe. Si vous laissez ce champ vide, le système utilisera l’adaptateur sortant configuré par défaut.

Débogage activé

Cette option détermine si des informations de débogage sont enregistrées dans les journaux pour faciliter le dépannage.

Service

Sécurisez cet adaptateur à l’aide d’un adaptateur de fournisseur de services SAML afin que seuls les utilisateurs authentifiés par l’IdP configuré puissent y accéder. En général, sélectionnez le fournisseur de services SAML que vous avez configuré lors des étapes précédentes.

Générer des métadonnées

Si vous effectuez la configuration initiale, vous ne pourrez pas générer les métadonnées tant que la configuration n’aura pas été enregistrée.

Une fois la configuration enregistrée, revenez à l’écran des paramètres de l’UAS et sélectionnez cette configuration pour la modifier. Cliquez sur le bouton Générer des métadonnées pour générer les métadonnées du fournisseur de services. Vous pouvez transmettre ces métadonnées à l’IDP pour finaliser cette configuration.

Sélectionnez Enregistrer pour enregistrer votre configuration.

L'URL de l'adaptateur configuré est https://{region}.extensions.blackboard.com/api/v2/authadapters/sites/{siteId}/auth/{alias}.