Instructions de configuration SAML OKTA / Expédition

Okta est un service d’authentification tiers qui fournit une intégration SAML pour les entreprises. L2L Expédition peut facilement être ajoutée à Okta en tant qu’application afin de fournir une fonctionnalité SSO aux utilisateurs de Dispatch qui possèdent des comptes Okta. Lorsque l’authentification SAML pour Expédition est activée, la page de connexion de l’expédition comporte un bouton que l’utilisateur peut utiliser pour lancer l’authentification SSO, ou les utilisateurs peuvent utiliser leur page d’accueil Okta pour accéder à leurs applications configurées.

Ce document explique comment configurer Expédition et Okta pour interagir à l’aide de SAML pour l’authentification. Dans les exemples, le serveur d’Expédition sera acme.leading2lean.com, et Acme-L2L-Dispatch sera le nom de l’application Okta que nous créerons.

Vous devez disposer d’un accès administratif à Expédition et à votre compte Okta pour effectuer ces étapes. Vos utilisateurs doivent déjà avoir des comptes dans Okta et vous devrez leur attribuer cette nouvelle application.

Étape 1 : Créer la configuration SAML d’Expédition

Nous allons d’abord créer une nouvelle configuration SAML qui définit la relation de confiance SAML entre Expédition et l’application Okta. Connectez-vous à acme.leading2lean.com, puis accédez à Configuration -> Configuration informatique -> Configuration SSO SAML à l’adresse https://acme.leading2lean.com/setup/samlconfig/. Cliquez sur le lien Ajouter nouveau.

Sur la page Ajouter une nouvelle configuration SAML, nous saisirons les informations suivantes :

• Code : celui-ci doit être un code unique parmi toutes les configurations SAML d’Expédition et est utilisé dans les URL SAML d’Expédition. Pour cet exemple, nous utiliserons le code acme-okta-sso.
• Nom d’affichage : il s’agit du texte visible par l’utilisateur sur la page de connexion d’Expédition – pour cet exemple, nous utiliserons Dispatch ACME Okta SSO.
• Attribut de nommage des utilisateurs de l’IdP : vous devez choisir la manière dont les utilisateurs se connecteront à Expédition. Le choix de email exige que les comptes utilisateurs d’Expédition aient leurs adresses e-mail définies sur la même adresse e-mail que celle définie dans les comptes Okta des utilisateurs, tandis que le choix de username exige que le nom d’utilisateur d’Expédition corresponde au nom d’utilisateur Okta.

Laissez tous les autres champs vides pour le moment et cliquez sur Enregistrer. Cliquez maintenant à nouveau sur la nouvelle configuration SAML et copiez l’ID d’entité SP ainsi que les URL d’initiation SP, car nous utiliserons ces deux URL à l’étape suivante.

Étape 2 : créer l’application Okta

Nous allons maintenant créer une nouvelle application dans notre compte Okta. Procédez comme suit pour créer une nouvelle application :

• Connectez-vous à Okta en tant qu’administrateur
• Cliquez sur le lien d’en-tête Applications
• Cliquez sur le bouton Ajouter une application
• Cliquez sur le lien Créer une nouvelle application
• Dans la boîte de dialogue Créer une nouvelle intégration d’application, définissez la Plateforme sur Web et choisissez SAML 2.0 comme méthode de connexion, puis cliquez sur le bouton Créer.
• Choisissez un nom d’application – pour cet exemple, nous utiliserons Acme-L2L-Dispatch, puis cliquez sur Suivant.

Maintenant, à l’étape Configure SAML, définissez les paramètres suivants après avoir décidé si vous souhaitez que vos utilisateurs se connectent à Expédition avec leur nom d’utilisateur Okta ou leur adresse e-mail :

• URL de connexion unique – Définissez-la sur l’URL SSO du fournisseur de services de la configuration SAML d’Expédition
  • Utiliser ceci pour l’URL du destinataire et l’URL de destination - Coché
• URI d’audience – Définissez-la sur l’ID d’entité du fournisseur de services de la configuration SAML d’Expédition
• Format de l’ID de nom – Définissez-le sur Adresse e-mail si vous utilisez des adresses e-mail, sinon laissez-le sur non spécifié
• Nom d’utilisateur de l’application – Définissez-le sur E-mail si vous utilisez des adresses e-mail, ou choisissez l’une des options de nom d’utilisateur.

Tous les autres champs peuvent rester vides ou conserver leurs valeurs par défaut. Cliquez maintenant sur Suivant. À l’étape 3, indiquez que vous êtes un client ajoutant une application interne et aucun autre champ ne doit être défini. Cliquez sur Terminer pour enregistrer l’application, puis cliquez sur le lien Afficher les instructions de configuration. Cette nouvelle page contient les informations que nous devons enregistrer dans la configuration SAML d’Expédition.

Étape 3 : Mettre à jour la configuration SAML d’Expédition

Maintenant, dans votre session web Expédition, affichez la configuration SAML acme-okta-sso que nous avons créée précédemment. Nous allons maintenant renseigner les champs suivants :

• Définissez le champ IdP Entity Id sur la valeur Identity Provider Issuer de l’application Okta.
• Définissez IdP SSO URL sur l’Identity Provider Single Sign-On URL de l’application Okta.
• Copiez la chaîne du certificat X.509 de l’application Okta et enregistrez-la dans le champ IdP Certificate Information  de la configuration SAML d’Expédition en tant que certificat public x509 au format PEM.

Cliquez maintenant sur le bouton Enregistrer de la configuration SAML d’Expédition. Votre configuration SAML est maintenant prête à être utilisée.

Étape 4 : Migrer les comptes d’Expédition pour utiliser l’authentification SAML

Si vous devez migrer la plupart ou la totalité de vos comptes d’Expédition afin d’utiliser l’authentification SAML, des outils d’Expédition sont disponibles pour vous faciliter la tâche. Chaque configuration SAML d’Expédition comporte un bouton Migrer les comptes qui vous permet d’effectuer une migration groupée des utilisateurs vers la configuration SAML. Cliquez simplement sur le bouton et suivez les instructions pour permettre à vos comptes utilisateur de s’authentifier à l’aide de SAML.