Configurez l'authentification unique ( SSO ) pour votre portail interne
Avant de pouvoir signaler un incident via votre portail interne, les employés doivent se connecter à l'aide du système d'authentification unique ( SSO ) de votre organisation. Cela signifie qu'ils pourront accéder à votre portail interne en utilisant les mêmes identifiants que ceux utilisés pour d'autres applications, comme votre système d'information des ressources humaines (SIRH).
Vous pouvez configurer deux intégrations SSO distinctes avec Case IQ pour :
- Portail interne permettant aux employés de soumettre des dossiers à votre organisation.
- L'application principale Case IQ , où les enquêteurs et les gestionnaires traitent les dossiers et où les administrateurs gèrent les paramètres de l'application.
Cet article explique comment configurer une intégration SSO pour le portail interne des employés de votre application, notamment :
- Configurer une intégration SSO en téléchargeant des métadonnées ou en configurant manuellement tous les paramètres.
- Génération des métadonnées Case IQ .
- Associer les champs de votre fournisseur d'identité aux champs des comptes utilisateurs du portail interne.
Pour gérer vos paramètres SSO pour l'application principale, reportez-vous plutôt à l'article Configurer l'authentification unique ( SSO ) .
Nous utilisons plusieurs termes techniques dans ces instructions pour expliquer le fonctionnement d'une intégration SSO . Consultez le glossaire des principaux termes SSO ci-dessous :
| Terme | Définition |
|---|---|
| Fournisseur d'identité | L'application qui envoie les informations relatives à vos utilisateurs pour les authentifier dans Case IQ . Généralement, les organisations utilisent leur système d'information des ressources humaines (SIRH), Active Directory ou un service de gestion des identités comme fournisseur d'identité pour les intégrations SSO . Vous pouvez utiliser le même fournisseur d'identité pour l'intégration SSO de votre portail interne et de votre application principale. |
| Prestataire de services | L'application qui reçoit les informations concernant vos utilisateurs et à laquelle ces derniers accèdent via une intégration SSO . Dans ce cas précis, Case IQ est le fournisseur de services. |
| Métadonnées | Un fichier XML contenant le certificat du fournisseur et l'URL permettant d'établir une communication SAML entre le fournisseur d'identité et le fournisseur de services. Case IQ peut exploiter les métadonnées de votre fournisseur d'identité et générera des métadonnées en tant que fournisseur de services après l'enregistrement du formulaire d'authentification unique ( SSO ) du portail interne. |
Méthode de téléchargement des métadonnées
Vous pouvez configurer rapidement une intégration SSO en téléchargeant un fichier de métadonnées dans Case IQ . Les métadonnées contiennent le certificat du fournisseur et l'URL au format XML pour faciliter la mise en place d'une communication SAML entre le fournisseur d'identité et le fournisseur de services.
1. Accédez à Paramètres > Accès > Authentification unique du portail interne ( SSO ).

2. Vous pouvez soit télécharger les métadonnées sous forme de fichier .xml, soit saisir l'URL de votre fournisseur d'identité.
Téléversez un fichier de métadonnées au format .xml
1. Cliquez sur Options (
Cliquez sur le bouton ) sur la page d'authentification unique ( SSO ) du portail interne. Ensuite, sélectionnez « Téléverser les métadonnées ».

2. Dans la fenêtre contextuelle « Téléverser un fichier », glissez-déposez un fichier de métadonnées ou utilisez l’explorateur de fichiers pour le téléverser. Vous pouvez télécharger ce fichier auprès de votre fournisseur d’identité ; il s’agira d’un fichier « .xml ». Cliquez sur « Terminé » pour continuer.

Saisissez l'URL du fournisseur d'identité
1. Cliquez sur le bouton Modifier sur la page d'authentification unique ( SSO ) du portail interne.

2. Collez l'URL de votre fournisseur d'identité dans le champ « Point de terminaison du fournisseur d'identité ». L'URL de votre fournisseur d'identité ressemblera à cet exemple : « https://report04.caseiq.com/simplesaml/saml2/idp/metadata.php ».
3. Cliquez sur Télécharger (
) bouton à côté du champ.

3. Cliquez sur Confirmer dans la fenêtre contextuelle « Télécharger les métadonnées ? ». Les champs « Certificat du fournisseur d’identité », « Point de terminaison du fournisseur d’identité » et « Format de l’identifiant » seront renseignés dans le formulaire, mais vos paramètres de configuration ne seront pas encore enregistrés.
4. Remplissez les champs suivants :
- Association des identifiants : indiquez le champ de données obligatoire pour la création de comptes Case IQ , comme l’adresse e-mail ou le prénom. Le champ choisi indiquera Case IQ comment associer les informations du fournisseur d’identité aux profils utilisateur Case IQ et rechercher les profils utilisateur existants.
- Association des données d'identification : choisissez l'attribut du fournisseur d'identité à associer au champ de données sélectionné dans « Association des identifiants ». Par exemple, si vous sélectionnez « Adresse e-mail », saisissez la valeur de l'attribut correspondant dans votre fournisseur d'identité. L'exemple d'attribut d'association de données d'identité suivant a été utilisé dans la vidéo de captures d'écran ci-dessous pour l'adresse e-mail : « http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress ».
- Activé : définissez cette option sur « Oui » pour activer votre intégration SSO .

5. Cliquez sur le bouton Enregistrer pour activer l'intégration SSO de votre portail interne. Pour associer des données supplémentaires de votre fournisseur d'identité aux champs Case IQ , consultez la section « Mappage des utilisateurs » de cet article.

Méthode de configuration manuelle
Au lieu de télécharger des métadonnées, vous pouvez renseigner manuellement tous les champs de la page « Authentification unique ( SSO ) du portail interne ». Vous pouvez également effectuer ces mêmes réglages dans Paramètres > Système > Système > Options (voir les détails dans Options ).
1. Accédez à Paramètres > Accès > Authentification unique ( SSO ) du portail interne. Cliquez sur le bouton Modifier .

2. Définissez le champ « Activé » sur « Oui ». Vous ne pourrez plus modifier les paramètres de protocole, de provisionnement automatique des utilisateurs ni de repli des rôles utilisateur.
3. Renseignez les champs suivants dans la section Fournisseur d'identité (IdP). Vous trouverez ces informations dans les paramètres de votre application fournisseur d'identité.
- Point de terminaison du fournisseur d'identité : collez ou saisissez l'URL de votre fournisseur d'identité dans la zone de texte, ce qui indiquera Case IQ de quelle source accepter les informations d'authentification.
- L'URL de votre fournisseur d'identité ressemblera à cet exemple d'URL : « https://report04.caseiqlab.com/simplesaml/saml2/idp/metadata.php ».
- Certificat du fournisseur d'identité : copiez votre certificat depuis les paramètres de votre application de fournisseur d'identité et collez-le dans le champ « Certificat du fournisseur d'identité ». Le certificat apparaîtra sous forme de plusieurs lignes de caractères alphanumériques aléatoires.
- Le certificat est échangé entre le fournisseur d'identité et Case IQ . Case IQ doit posséder ce certificat pour confirmer que les informations envoyées par votre fournisseur d'identité proviennent d'une source fiable.

4. Remplissez les champs suivants dans la section Fournisseur de services (SP) pour indiquer Case IQ comment utiliser les données de votre fournisseur d'identité.
- Association des identifiants : choisissez le champ de données requis pour la création de comptes Case IQ , comme l’adresse e-mail ou le prénom. Le champ choisi indiquera au système comment :
- Case IQ devrait connecter les informations du fournisseur d'identité à un profil utilisateur Case IQ .
- Case IQ devrait rechercher les profils d'utilisateurs existants.
- Association des identifiants : saisissez l’attribut du fournisseur d’identité à associer au champ de données sélectionné dans « Association des identifiants ». Par exemple, si vous sélectionnez « Adresse e-mail », saisissez la valeur de l’attribut correspondant dans votre fournisseur d’identité.
- L'attribut de mappage de données de votre fournisseur d'identité ressemblera à l'exemple d'attribut suivant : « http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress ».
- Format de l’identifiant : indiquez comment les informations du fournisseur d’identité seront associées aux comptes utilisateur Case IQ via l’intégration SSO . Vous pouvez sélectionner l’une des options par défaut de la liste déroulante « Format de l’identifiant ». Vous pouvez également saisir un format personnalisé et appuyer sur Entrée .
- Exiger la signature des assertions par le fournisseur d'identité : choisissez si le fournisseur d'identité doit signer chaque assertion. Les assertions sont des messages du fournisseur d'identité contenant les informations d'authentification de l'utilisateur. Par défaut, l'option « Exiger la signature des assertions par le fournisseur d'identité » est activée, car il s'agit de l'option de signature par défaut pour la plupart des fournisseurs d'identité. Vous pouvez désactiver cette option si votre fournisseur d'identité n'exige pas la signature des assertions.
- Exiger la signature de la réponse d'authentification complète par le fournisseur d'identité : indiquez si le fournisseur d'identité doit signer la réponse SAML au niveau supérieur, c'est-à-dire si la signature doit apparaître en dehors du bloc d'assertion. Par défaut, cette option est désactivée. Activez-la si votre fournisseur d'identité doit signer la réponse SAML au niveau supérieur.
- Contexte d'authentification de la demande : choisissez si vous souhaitez fournir un contexte d'authentification pour indiquer quelles informations le fournisseur d'identité enverra à Case IQ dans l'assertion SAML afin de prendre une décision éclairée en matière d'autorisation.
- Si vous sélectionnez « Oui », le champ « Contexte d’authentification » s’affichera. Le contexte par défaut du système sera déjà renseigné, mais vous pouvez en sélectionner un autre ou en saisir un autre.

5. Cliquez sur le bouton Enregistrer pour activer l'intégration SSO de votre portail interne. Pour associer des données supplémentaires de votre fournisseur d'identité aux champs Case IQ , consultez la section « Mappage des utilisateurs » de cet article.

Métadonnées du fournisseur de services
Si votre fournisseur d'identité a besoin d'informations supplémentaires de Case IQ pour la communication SAML, vous pouvez consulter les champs suivants sur la page d'authentification unique ( SSO ) du portail interne, qui sont générés automatiquement :
- ID de l'entité du fournisseur de services : un nom unique pour Case IQ en tant que fournisseur de services, qui par défaut correspond à l'URL des métadonnées.
- URL du consommateur du fournisseur de services de portail interne : Case IQ utilisera le format suivant : « [URL de votre application]/authd/internal-portal-saml ».

Après avoir configuré et activé l'intégration SSO dans Case IQ , vous pouvez également prévisualiser et télécharger les métadonnées du fournisseur de services depuis Case IQ . Cliquez sur Options (
) pour afficher les options « Télécharger » et « Aperçu XML », afin de pouvoir enregistrer le fichier XML de métadonnées ou l’afficher dans une fenêtre contextuelle.

Cartographie des utilisateurs
Une fois votre intégration SSO configurée, vous pouvez utiliser la section Mappage des utilisateurs pour définir précisément comment les informations envoyées par le fournisseur d'identité seront utilisées dans Case IQ .
Tous les éléments de cartographie utilisateur sont numérotés dans la capture d'écran ci-dessous et des descriptions sont fournies après l'image.

- La colonne de menus déroulants, indiquée par (1) dans la capture d'écran ci-dessus, correspond aux champs du profil utilisateur Case IQ . Les champs suivants s'affichent par défaut dans ces menus : « Adresse e-mail », « Identifiant utilisateur », « Prénom », « Nom », « Langue », « Rôle utilisateur » et « Thème ».
- Les zones de texte, identifiées par (2) dans la capture d'écran ci-dessus, correspondent à des champs de données envoyés par votre fournisseur d'identité. Pour les champs Case IQ « Adresse e-mail », « ID utilisateur », « Prénom » et « Nom », les valeurs d'attribut utilisées par Microsoft Azure Active Directory sont renseignées par défaut dans les champs de données du fournisseur d'identité, car ces valeurs sont couramment utilisées pour le mappage des utilisateurs. Pour modifier la valeur d'un attribut, saisissez la valeur correspondante de votre fournisseur d'identité.
- Lorsque vous cliquez sur le bouton « + » à côté d’un champ (3), vous pouvez ajouter des valeurs par défaut pour le champ de profil utilisateur ou configurer un schéma de mappage de valeurs personnalisé s’il existe plusieurs valeurs de fournisseur d’identité à associer à un seul champ de profil utilisateur Case IQ . Pour en savoir plus, consultez les sections suivantes : « Valeurs par défaut du profil utilisateur » et « Valeurs personnalisées ».
- Cliquez sur le bouton Supprimer (4) pour supprimer la ligne du champ de profil utilisateur si votre fournisseur d'identité ne contient pas de champ correspondant. Vous pouvez également laisser le champ d'attribut du fournisseur d'identité vide.
- Ajoutez d'autres champs du formulaire de profil utilisateur en cliquant sur le bouton « + Mappage utilisateur » (5). La liste déroulante « Champs de recherche » qui s'affiche contient tous les champs du formulaire de profil utilisateur, y compris les champs dynamiques ajoutés via le générateur de formulaires (voir Modifier une mise en page de formulaire standard ).
Valeurs par défaut du profil utilisateur
Vous pouvez définir une valeur par défaut pour un champ en cliquant sur le bouton Plus de la ligne correspondante. Ainsi, tous les comptes utilisateurs créés par cette intégration SSO auront la valeur par défaut que vous avez sélectionnée pour ce champ.
1. Cliquez sur le bouton Modifier sur la page d'authentification unique ( SSO ) du portail interne.
2. Faites défiler vers le bas jusqu'à la section « Mappage des utilisateurs ». Cliquez sur le bouton « + » de la ligne « Mappage des utilisateurs ».

3. Dans la fenêtre contextuelle « Ajouter des valeurs », sélectionnez une option dans la liste déroulante « Valeur par défaut ». Cette liste déroulante comprend toutes les options disponibles dans la liste de sélection du champ correspondant du profil utilisateur Case IQ .
4. Cliquez sur Enregistrer dans la fenêtre contextuelle « Ajouter des valeurs » pour enregistrer la valeur par défaut de ce champ. Ensuite, enregistrez les paramètres SSO de votre portail interne.

Valeurs personnalisées
Si le champ correspondant dans votre fournisseur d'identité comporte plus de valeurs que le champ du profil utilisateur Case IQ , vous pouvez créer un schéma de mappage personnalisé en suivant les étapes suivantes.
1. Cliquez sur le bouton Modifier sur la page d'authentification unique ( SSO ) du portail interne.
2. Faites défiler vers le bas jusqu'à la section « Mappage des utilisateurs ». Cliquez sur le bouton « + » de la ligne « Mappage des utilisateurs ».

3. Dans la section Valeurs personnalisées de la fenêtre contextuelle Ajouter des valeurs, cliquez sur le bouton « + Valeur ».

4. Choisissez une valeur pour le champ du profil utilisateur dans la liste déroulante « Sélectionner ».
5. Saisissez la valeur dans votre fournisseur d'identité pour la faire correspondre à la valeur du profil utilisateur.

6. Vous pouvez ajouter d'autres valeurs personnalisées en cliquant à nouveau sur le bouton « + Valeur ».
7. Cliquez sur Enregistrer pour soumettre votre schéma de mappage de valeurs personnalisé, qui s'affichera désormais dans le champ Fournisseur d'identité de la section Mappage utilisateur. Ensuite, enregistrez les paramètres SSO de votre portail interne.
