Partager via

Tutoriel : Intégration de l'authentification unique (SSO) Microsoft Entra avec KnowledgeOwl

  • Article

Dans ce didacticiel, vous apprendrez comment intégrer KnowledgeOwl à Microsoft Entra ID. Lorsque vous intégrez KnowledgeOwl à Microsoft Entra ID, vous pouvez :

  • Contrôlez dans Microsoft Entra ID qui a accès à KnowledgeOwl.
  • Permettez à vos utilisateurs d'être automatiquement connectés à KnowledgeOwl avec leurs comptes Microsoft Entra.
  • Gérer vos comptes à partir d’un emplacement central.

Prérequis

Pour commencer, vous devez disposer de ce qui suit :

  • Un abonnement Microsoft Entra. Si vous ne disposez d’aucun abonnement, vous pouvez obtenir un compte gratuit.
  • Un abonnement KnowledgeOwl pour lequel l’authentification unique est activée

Description du scénario

Dans ce tutoriel, vous configurez et testez Microsoft Entra SSO dans un environnement de test.

  • KnowledgeOwl prend en charge l’authentification unique lancée par le fournisseur de services et le fournisseur d’identité.
  • KnowledgeOwl prend en charge le provisionnement d’utilisateurs Juste-à-temps.

Pour configurer l'intégration de KnowledgeOwl dans Microsoft Entra ID, vous devez ajouter KnowledgeOwl depuis la galerie à votre liste d'applications SaaS gérées.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Accédez à Identité>Applications>Applications d’entreprise>Nouvelle application.
  3. Dans la section Ajouter à partir de la galerie, tapez KnowledgeOwl dans la zone de recherche.
  4. Sélectionnez KnowledgeOwl dans le volet de résultats, puis ajoutez l’application. Patientez quelques secondes pendant que l’application est ajoutée à votre locataire.

Vous pouvez également utiliser l’assistant Entreprise App Configuration. Dans cet assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application, attribuer des rôles, mais également parcourir la configuration de l’authentification unique. En savoir plus sur les assistants Microsoft 365.

Configurer et tester Microsoft Entra SSO pour KnowledgeOwl

Configurez et testez Microsoft Entra SSO avec KnowledgeOwl à l'aide d'un utilisateur test appelé B.Simon. Pour que SSO fonctionne, vous devez établir une relation de lien entre un utilisateur Microsoft Entra et l'utilisateur associé dans KnowledgeOwl.

Pour configurer et tester Microsoft Entra SSO avec KnowledgeOwl, effectuez les étapes suivantes :

  1. Configurer Microsoft Entra SSO – pour permettre à vos utilisateurs d'utiliser cette fonctionnalité.
    1. Créez un utilisateur de test Microsoft Entra pour tester l’authentification unique Microsoft Entra avec B.Simon.
    2. Attribuer l’utilisateur test Microsoft Entra – pour permettre à B.Simon d’utiliser l’authentification unique Microsoft Entra.
  2. Configurer l’authentification unique KnowledgeOwl pour configurer les paramètres de l’authentification unique côté application.
    1. Créez un utilisateur de test KnowledgeOwl – pour avoir un homologue de B.Simon dans KnowledgeOwl qui est lié à la représentation Microsoft Entra de l'utilisateur.
  3. Tester l’authentification unique pour vérifier si la configuration fonctionne.

Configurer Microsoft Entra SSO

Effectuez ces étapes pour activer l’authentification unique Microsoft Entra.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

  2. Accédez à Identité>Applications>Applications d’entreprise>KnowledgeOwl>Authentification unique.

  3. Dans la page Sélectionner une méthode d’authentification unique, sélectionnez SAML.

  4. Dans la page Configurer l’authentification unique avec SAML, cliquez sur l’icône de crayon de Configuration SAML de base afin de modifier les paramètres.

    Edit Basic SAML Configuration

  5. Dans la section Configuration SAML de base, si vous souhaitez configurer l’application en mode Initié par le fournisseur d’identité, entrez les valeurs pour les champs suivants :

    a. Dans la zone de texte Identificateur, tapez l’URL en utilisant l’un des modèles suivants :

    https://app.knowledgeowl.com/sp
https://app.knowledgeowl.com/sp/id/<unique ID>

    b. Dans la zone de texte URL de réponse, tapez l’URL en utilisant l’un des modèles suivants :

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

  6. Si vous souhaitez configurer l’application en mode démarré par le fournisseur de services, cliquez sur Définir des URL supplémentaires, puis effectuez les étapes suivantes :

    Dans la zone de texte URL de connexion, tapez l’URL en utilisant un des modèles suivants :

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

    Notes

    Il ne s’agit pas de valeurs réelles. Vous devez changer cette valeur pour l’identificateur, l’URL de réponse et l’URL de connexion réels. Ceci est expliqué plus loin dans le tutoriel.

  7. L’application KnowledgeOwl attend les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à votre configuration d’attributs de jetons SAML. La capture d’écran suivante montre la liste des attributs par défaut.

    image

  8. En plus de ce qui précède, l’application KnowledgeOwl s’attend à ce que quelques attributs supplémentaires soient repassés dans la réponse SAML. Ces attributs sont également préremplis, mais vous pouvez les examiner pour voir s’ils répondent à vos besoins.

    Nom Attribut source Espace de noms
    ssoid user.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims

  9. Dans la page Configurer l’authentification unique avec SAML, dans la section Certificat de signature SAML, recherchez Certificat (brut), puis sélectionnez Télécharger pour télécharger le certificat et l’enregistrer sur votre ordinateur.

    The Certificate download link

  10. Dans la section Configurer KnowledgeOwl, copiez la ou les URL appropriées en fonction de vos besoins.

    Copy configuration URLs

Créer un utilisateur de test Microsoft Entra

Dans cette section, vous allez créer un utilisateur de test appelé B.Simon.

  1. Connectez-vous au Centre d’administration de Microsoft Entra en tant qu’Administrateur de l’utilisateur.
  2. Accédez à Identité>Utilisateurs>Tous les utilisateurs.
  3. Sélectionnez Nouvel utilisateur>Créer un utilisateur dans la partie supérieure de l’écran.
  4. Dans les propriétés Utilisateur, effectuez les étapes suivantes :
    1. Dans le champ Nom d’affichage, entrez B.Simon.
    2. Dans le champ Nom d’utilisateur principal, entrez username@companydomain.extension. Par exemple : B.Simon@contoso.com.
    3. Cochez la case Afficher le mot de passe, puis notez la valeur affichée dans le champ Mot de passe.
    4. Sélectionnez Revoir + créer.
  5. Sélectionnez Create (Créer).

Attribuer l’utilisateur test Microsoft Entra

Dans cette section, vous allez permettre à B.Simon d’utiliser l’authentification unique en accordant l’accès à KnowledgeOwl.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Accédez à Identité>Applications>Applications d’entreprise>KnowledgeOwl.
  3. Dans la page de présentation de l’application, sélectionnez Utilisateurs et groupes.
  4. Sélectionnez Ajouter un utilisateur/groupe, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
    1. Dans la boîte de dialogue Utilisateurs et groupes, sélectionnez B. Simon dans la liste Utilisateurs, puis cliquez sur le bouton Sélectionner au bas de l’écran.
    2. Si vous attendez qu’un rôle soit attribué aux utilisateurs, vous pouvez le sélectionner dans la liste déroulante Sélectionner un rôle . Si aucun rôle n’a été configuré pour cette application, vous voyez le rôle « Accès par défaut » sélectionné.
    3. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification unique KnowledgeOwl

  1. Dans une autre fenêtre de navigateur web, connectez-vous à votre site d’entreprise KnowledgeOwl en tant qu’administrateur.

  2. Cliquez sur Paramètres, puis sélectionnez Authentification unique.

    Screenshot shows SSO selected from the Settings menu.

  3. Dans le menu déroulant jusqu’à l’onglet Paramètres SAML, procédez comme suit :

    Screenshot shows SAML S S O Integration where you can make the changes described here.

    a. Sélectionnez Enable SAML SSO (Activer l’authentification unique SAML).

    b. Copiez la valeur ID d’entité du fournisseur de services et collez-la dans la zone de texte Identificateur (ID d’entité) de la section Configuration SAML de base du Portail Azure.

    c. Copiez la valeur de l’URL de connexion SP et collez-la dans la zone de texte URL de connexion et URL de réponse de la section Configuration SAML de base du Portail Azure.

    d. Dans la zone de texte IdP entityID, collez la valeur Microsoft Entra Identifier que vous avez copiée précédemment.

    e. Dans la zone de texte URL de connexion du fournisseur d’identité, collez la valeur de URL de connexion que vous avez copiée précédemment.

    f. Dans la zone de texte URL de déconnexion du fournisseur d’identité, collez la valeur de URL de déconnexion que vous avez copiée précédemment.

    g. Chargez le certificat téléchargé à partir du Portail Azure en cliquant sur le lien Charger sous Certificat IdP.

    h. Cliquez sur Enregistrer au bas de la page.

    Screenshot shows the Save button.

    i. Ouvrez l’onglet Mappage d’attributs SAML pour mapper les attributs, puis procédez comme suit :

    Screenshot shows Map SAML Attributes where you can make the changes described here.

    • Saisissez http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid dans la zone de texte ID de l’authentification unique.
    • Dans la zone de texte Username/Email (Nom d’utilisateur/E-mail), tapez http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress.
    • Dans la zone de texte First Name (Prénom), tapez http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname.
    • Dans la zone de texte Last Name (Prénom), tapez http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname.

    j. Cliquez sur Enregistrer au bas de la page.

    Screenshot shows the Save button1.

Créer un utilisateur de test KnowledgeOwl

Dans cette section, un utilisateur appelé B.Simon est créé dans KnowledgeOwl. KnowledgeOwl prend en charge l’attribution d’utilisateurs juste-à-temps, une option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. Si l’utilisateur souhaité n’existe pas déjà dans KnowledgeOwl, il est créé après l’authentification.

Notes

Si vous devez créer un utilisateur manuellement, contactez l’équipe de support KnowledgeOwl.

Tester l’authentification unique (SSO)

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra avec les options suivantes.

Lancée par le fournisseur de services

  • Cliquez sur Tester cette application. Vous êtes alors redirigé vers l’URL d’authentification de KnowledgeOwl, à partir de laquelle vous pouvez lancer le flux de connexion.

  • Accédez directement à l’URL de connexion KnowledgeOwl et lancez le flux de connexion.

Lancée par le fournisseur d’identité

  • Cliquez sur Tester cette application dans le portail Azure. Vous êtes alors normalement connecté automatiquement à l’instance de KnowledgeOwl pour laquelle vous avez configuré l’authentification unique.

Vous pouvez aussi utiliser le portail Mes applications de Microsoft pour tester l’application dans n’importe quel mode. Si, quand vous cliquez sur la mosaïque KnowledgeOwl dans le portail Mes applications, le mode Fournisseur de services est configuré, vous êtes redirigé vers la page de connexion de l’application pour lancer le flux de connexion ; s’il s’agit du mode Fournisseur d’identité, vous êtes automatiquement connecté à l’application KnowledgeOwl pour laquelle vous avez configuré l’authentification unique. Pour plus d’informations sur le portail Mes applications, consultez Introduction à Mes applications.

Étapes suivantes

Après avoir configuré KnowledgeOwl, vous pouvez appliquer le contrôle de session, qui protège en temps réel contre l’exfiltration et l’infiltration des données sensibles de votre organisation. Le contrôle de session est étendu à partir de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Defender for Cloud Apps.