Partager via

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

  • Article

Dans ce tutoriel, vous allez apprendre à intégrer Coda à Microsoft Entra ID. Lorsque vous intégrez Coda à Microsoft Entra ID, vous pouvez :

  • Contrôler dans Microsoft Entra ID qui a accès à Coda.
  • Permettre à vos utilisateurs d'être automatiquement connectés à Coda 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 CODA pour lequel l’authentification unique est activée et l’intégration GDrive est désactivée. Contactez l’équipe du support technique de Coda afin de désactiver l’intégration de GDrive pour votre organisation si elle est actuellement activée.

Description du scénario

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

  • Coda prend en charge l’authentification unique lancée par le fournisseur d’identité.

  • Coda prend en charge l’attribution d’utilisateurs juste-à-temps.

  • Coda prend en charge le provisionnement automatisé des utilisateurs.

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

  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 Coda dans la zone de recherche.
  4. Sélectionnez Coda dans le panneau 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 Coda

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

Pour configurer et tester l'authentification unique Microsoft Entra avec Coda, effectuez les étapes suivantes :

  1. Commencer la configuration de l’authentification unique Coda pour commencer à configurer l’authentification unique dans Coda.
  2. Configurez l’authentification unique Microsoft Entra 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.
  3. Configurer l’authentification unique Coda pour effectuer la configuration des paramètres d’authentification unique dans Coda.
    1. Créer un utilisateur de test Coda – pour avoir dans Coda un équivalent de B.Simon lié à la représentation Microsoft Entra de l'utilisateur.
  4. Tester l’authentification unique pour vérifier si la configuration fonctionne.

Commencer la configuration de l’authentification unique Coda

Suivez ces étapes dans Coda pour commencer.

  1. Dans Coda, ouvrez le panneau Organization settings (Paramètres de l’organisation).

    Open Organization Settings

  2. Vérifiez que l’intégration GDrive est désactivée dans votre organisation. Si elle est activée, contactez l’équipe du support technique de Coda pour vous aider à migrer hors de GDrive.

    GDrive Disabled

  3. Sous Authenticate with SSO (SAML) , sélectionnez l’option Configure SAML.

    Saml Settings

  4. Notez les valeurs Entity ID (ID d’entité) et SAML Response URL (URL de réponse SAML), dont vous aurez besoin lors des étapes suivantes.

    Entity ID and SAML Response URL to use in Azure

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>Coda>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 page Configurer l’authentification unique avec SAML, effectuez les étapes suivantes :

    a. Dans la zone de texte Identificateur, entrez la valeur « Entity ID » obtenue ci-dessus. Elle doit suivre ce modèle : https://coda.io/samlId/<CUSTOMID>

    b. Dans la zone de texte URL de réponse, entrez la valeur « SAML Response URL » obtenue ci-dessus. Elle doit suivre ce modèle : https://coda.io/login/sso/saml/<CUSTOMID>/consume

    Notes

    Vos valeurs seront différentes de celles ci-dessus ; vous les trouverez dans la console « Configure SAML » de Coda. Mettez à jour ces valeurs avec l’identificateur et l’URL de réponse réels.

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

    The Certificate download link

  7. Dans la section Configurer Coda, copiez l’URL 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 à Coda.

  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>Coda.
  3. Dans la page de vue d’ensemble de l’application, recherchez la section Gérer et sélectionnez Utilisateurs et groupes.
  4. Sélectionnez Ajouter un utilisateur, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
  5. 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.
  6. Si vous attendez une valeur de rôle dans l’assertion SAML, dans la boîte de dialogue Sélectionner un rôle, sélectionnez le rôle approprié pour l’utilisateur dans la liste, puis cliquez sur le bouton Sélectionner en bas de l’écran.
  7. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification unique Coda

Pour terminer la configuration, vous allez devoir entrer des valeurs obtenues à partir de Microsoft Entra ID dans le panneau Configurer SAML de Coda.

  1. Dans Coda, ouvrez le panneau Organization settings.
  2. Sous Authenticate with SSO (SAML) , sélectionnez l’option Configure SAML.
  3. Définissez le fournisseur SAML comme étant Microsoft Entra ID.
  4. Dans Identity Provider Login URL (URL de connexion au fournisseur d’identité), collez l’URL de connexion obtenue à partir de la console Azure.
  5. Dans Identity Provider Issuer (Émetteur du fournisseur d'identité), collez l'identificateur Microsoft Entra obtenu à partir de la console Azure.
  6. Dans Identity Provider Public Certificate (Certificat public du fournisseur d’identité), sélectionnez l’option Upload Certificate (Charger le certificat) et sélectionnez le fichier de certificat que vous avez téléchargé.
  7. Sélectionnez Enregistrer.

Cela termine le travail nécessaire pour la configuration de la connexion d’authentification unique SAML.

Créer un utilisateur de test Coda

Dans cette section, un utilisateur appelé Britta Simon est créé dans Coda. Coda prend en charge le provisionnement d’utilisateurs juste-à-temps, option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’existe pas encore d’utilisateur dans Coda, il en est créé un après l’authentification.

Coda prend également en charge le provisionnement automatique des utilisateurs. Vous trouverez ici plus d’informations sur la façon de configurer le provisionnement automatique des utilisateurs.

Tester l’authentification unique (SSO)

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

  • Cliquez sur Tester cette application, ce qui devrait automatiquement vous connecter à l’application Coda pour laquelle vous avez configuré l’authentification unique.

  • Vous pouvez utiliser Mes applications de Microsoft. Quand vous cliquez sur la vignette Coda dans Mes applications, vous devez être connecté automatiquement à l’application Coda pour laquelle vous avez configuré l’authentification unique. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Étapes suivantes

Une fois que vous avez configuré Coda, vous pouvez appliquer le contrôle de session, qui protège contre l’exfiltration et l’infiltration des données sensibles de votre organisation en temps réel. 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.