SAML SSO avec Okta

Okta est un fournisseur d’identité (IdP) qui simplifie la gestion des accès utilisateurs en permettant aux utilisateurs de se connecter à plusieurs applications avec un seul ensemble d’identifiants. Cet article montre comment configurer SSO entre Okta et Document360, permettant à vos utilisateurs d’accéder à Document360 en utilisant leurs identifiants Okta. Veuillez noter que seuls les utilisateurs ayant les rôles Propriétaire ou Admin comme Projet peuvent configurer SSO dans Document360.

ASTUCE PRO

Il est recommandé d’ouvrir Document360 et Okta dans deux onglets/fenêtres de navigateur distincts, car configurer SSO dans Document360 vous obligera à basculer plusieurs fois entre Okta et Document360.

Inscrivez-vous à Okta

L’accès à un compte Okta est une condition préalable pour configurer la connexion unique dans Document360 avec Okta. Pour vous inscrire à Okta,

1. Naviguez jusqu’à https://developer.okta.com/signup/ et terminez le processus d’inscription.

2. Après l’inscription, vous recevrez un e-mail avec vos identifiants de connexion et un lien d’activation de compte à votre adresse e-mail enregistrée.

3. Une fois que vous cliquez sur le lien d’activation, vous serez redirigé vers la page de connexion du domaine Okta.

4. Connectez-vous avec vos identifiants.

5. Une fois connecté, vous serez redirigé vers la console développeur Okta.

Ajouter une application dans Okta

Pour créer une configuration SSO Document360 en utilisant Okta, vous devez créer une nouvelle application sur Okta. Pour créer une nouvelle application sur Okta,

1. Connectez-vous à Okta en utilisant les identifiants utilisés lors de la création d’un compte Okta.

2. Passez au rôle d’administrateur utilisateur en cliquant sur Admin en haut à droite à côté de votre nom de profil.

3. Depuis la liste de navigation de gauche, développez le menu déroulant Applications et cliquez sur Applications.

4. Dans la page Applications , cliquez sur le bouton Créer une intégration d’application .

5. Dans la boîte d’intégration Créer une nouvelle application , sélectionnez SAML 2.0 comme méthode de connexion et cliquez sur Suivant.

Création d’une intégration SAML dans Okta

Ensuite, vous serez redirigé vers la page Création d’intégration SAML .

Univers généraux

1. Dans l’onglet Paramètres généraux , saisissez le nom de votre nouvelle application dans le champ Nom de l’application .

2. Parcourez et téléchargez un logo pour votre application dans le champ Ajouter un logo si nécessaire.

3. Ensuite, vous pouvez cocher la case de visibilité de l’application si nécessaire.

4. Cliquez sur le bouton Suivant pour accéder à l’onglet Configurer le SAML.

Configurer le SAML

Dans l’onglet Configurer le SAML, vous aurez besoin des paramètres fournis sur la page Configurer le fournisseur de service (SP) dans Document360.

1. Pour accéder à la page Configurer le fournisseur de services (SP), consultez > Utilisateurs et permissions > Configuration SSO dans Document360.

2. Cliquez sur le bouton Créer SSO , sélectionnez Okta dans la page Choisissez votre fournisseur d’identité (IdP ).

3. Cela vous redirigera vers la page Configurer le fournisseur de service (SP ), qui affichera les paramètres nécessaires pour compléter la configuration SAML sur Okta.

4. Entrez les paramètres de Document360 à Okta en se basant sur le tableau ci-dessous.

   Document360	Okta
   Chemin de rappel	URL de connexion unique
   ID d’entité fournisseur de services	URI d’audience (ID d’entité SP)

5. Sélectionnez Adresse Email dans le menu déroulant du format Identifiant de Nom

6. Sélectionnez Email dans le menu déroulant du nom d’utilisateur de l’application.

NOTE

Les paramètres des e-mails et des noms sont sensibles à la casse.

Retour d’information

La page de retour sert à fournir des informations à Okta sur la façon dont vous configurez l’application. Sélectionnez la case à cocher Ceci est une application interne que nous avons créée et cliquez sur Terminer.

4. Cliquez sur Enregistrer.

Configuration SSO de Document360 vers Okta SAML

Instructions de configuration SAML sur Okta

1. Sur le tableau de bord Okta, cliquez sur le menu déroulant Applications et sélectionnez Applications.

2. Sur la page Applications , sélectionnez l’application active que vous souhaitez configurer sur Document360.

3. Cliquez sur l’onglet Connexion à la connexion.

4. Cliquez sur le bouton Affichage des instructions de configuration SAML

Les paramètres à configurer s’ouvriront sur une nouvelle page web.

Configuration SSO sur Document360

1. Passez à la page Document360 que vous aviez ouverte, affichant la page Configurer le fournisseur de services (SP).

2. Dans le champ Configurer une connexion existante, vous pouvez hériter d’une configuration SSO déjà créée qui a SCIM activé dans le projet parent. En sélectionnant et en héritant de cette connexion, la configuration SSO actuelle sera définie comme la configuration SSO héritée par l’enfant et héritera automatiquement de la configuration SCIM du parent.

 NOTE

Pour plus d’informations sur l’héritage, rendez-vous sur Gestion des utilisateurs et des lecteurs avec SCIM dans Okta

3. Complétez les champs de la page Configurer le fournisseur d’identité (IdP) en utilisant les instructions de configuration d’Okta.

4. Téléchargez le certificat X.509 depuis Okta et joignez le fichier okta_cert téléchargé dans le champ du certificat SAML sur Document360.

   Document360	Okta
   URL de connexion	URL de connexion unique du fournisseur d’identité
   Identifiant d’entité	Fournisseur d’identité Émetteur
   Certificat SAML	Certificat X.509

5. Ensuite, activez/désactivez le bouton Permettre la connexion initiée par l’IdP selon les exigences de votre projet.

6. Une fois terminé, cliquez sur le bouton Suivant pour accéder à la page de provisionnement SCIM .

Provisionnement SCIM avec Okta

Si le provisionnement SCIM est nécessaire,

1. Activez le bouton Activer le provisionnement SCIM .

2. Une boîte de dialogue de confirmation apparaîtra détaillant les conditions pour activer le SCIM. Consultez les conditions, sélectionnez la case à cocher, puis cliquez sur Accepter.

3. Les paramètres nécessaires pour compléter la configuration SCIM dans Okta seront alors affichés.

Naviguez vers Okta pour activer le provisionnement SCIM

1. Dans la console d’administration Okta, déplacez le menu déroulant Applications depuis la barre de navigation de gauche et cliquez sur Applications.

2. Sélectionnez l’application où vous souhaitez activer le provisionnement SCIM.

3. Accédez à l’onglet Général et cliquez sur Modifier dans Paramètres de l’application.

4. Sélectionnez le bouton SCIM Provisioning et cliquez sur Enregistrer.

SCIM de provision dans Okta avec Document360

1. Allez dans l’onglet Provisionnement et dansla section Connexion SCIM , cliquez sur Modifier. 

2. Entrez l’URL de base SCIM de Document360 dans le champ URL de base du connecteur SCIM d’Okta.

3. Dans le champ Identifiant unique pour les utilisateurs, saisissez Nom d’utilisateur.

4. Dans la section Actions de provisionnement supportées, sélectionnez uniquement les options prises en charge par Document360 :

   1. Pousser les nouveaux utilisateurs

   2. Groupes poussés

5. Dans la liste déroulante du mode d’authentification , choisissez HTTP Header.

6. Allez sur Document360, et dans la page de provisionnement SCIM , copiez le jeton secret principal.

7. Collez le jeton secret principal dans le champ d’autorisation HTTP Header .

 NOTE

Les jetons primaires et secondaires sont générés une seule fois et affichés uniquement au moment de la création. Vous pouvez choisir de copier le jeton secret principal ou secondaire. Assurez-vous de les copier et de les stocker dans un lieu sécurisé avant de sauvegarder la configuration. Une fois la configuration SSO sauvegardée, les jetons apparaîtront masqués lorsque vous revenez pour l’éditer et ne pourront pas être récupérés. Pour obtenir un nouveau jeton, vous devez le régénérer. Régénérer un jeton invalide l’existant, vous devrez mettre à jour le nouveau jeton dans votre configuration Okta pour continuer la synchronisation sans interruption.

 NOTE

Ne cliquez pas encore sur Configuration de Tester le connecteur. À ce stade, le provisionnement SCIM ne fonctionnera pas avec Document360 car la configuration SSO configurée dans Document360 n’est pas terminée.

Naviguez vers Document360 pour attribuer le rôle par défaut

1. Allez sur la page de provisionnement SCIM dans Document360 et activez le bouton Activer la synchronisation de groupe si nécessaire. Cela assigne automatiquement les utilisateurs et lecteurs en fonction de vos correspondances de groupes IdP.

2. Dans le champ de rôle par défaut , le rôle est défini par défaut sur Contributeur . Vous pouvez changer cela depuis le menu déroulant si besoin.

3. Dans les champs Groupes d’utilisateurs et Groupes de lecteurs , sélectionnez les groupes que vous souhaitez ajouter. Plusieurs groupes peuvent être ajoutés, et ils hériteront du rôle par défaut que vous avez sélectionné plus tôt.

4. Cliquez sur Suivant pour accéder à la page Paramètres supplémentaires .

Plus de réglages

Pour personnaliser les paramètres SSO, suivez les étapes ci-dessous,

1. Dans la page Autres paramètres , saisissez un nom pour votre configuration SSO dans le champ SSO name.

2. Saisissez le texte que vous souhaitez afficher sur le bouton de connexion dans le champ texte du bouton Personnaliser la connexion .

3. Activez la déconnexion de l’utilisateur SSO inactif si nécessaire, et définissez la durée après laquelle un utilisateur SSO inactif sera automatiquement déconnecté.

4. Choisissez d’inviter tous les utilisateurs ou certains utilisateurs en utilisant les boutons radio SSO Convertir les comptes d’équipe et de lecteurs existants .

Naviguez vers Okta pour compléter le provisionnement SCIM avec Document360

Après la création réussie de la configuration SSO dans Document360, le provisionnement SCIM peut désormais être effectué dans Okta.

1. Retournez à la console d’administration d’Okta, assurez-vous que toutes les informations nécessaires ont été remplies.

2. Ensuite, cliquez sur Configuration du connecteur de test pour vérifier la connexion entre Okta et Document360.

3. Une boîte de dialogue de confirmation apparaîtra, indiquant que le test a réussi.

4. Cliquez sur Enregistrer pour finaliser la configuration.

 NOTE

Pour plus de détails sur la façon d’ajouter les groupes d’utilisateurs, de lecteurs, et d’utilisateurs et de lecteurs, rendez-vous sur Gérer les utilisateurs et groupes avec SCIM dans Okta.

La configuration SSO basée sur le protocole SAML a été configurée avec succès avec Okta .

FAQ