- Accueil
- /
- Article
Merci pour votre commentaire.
Configurer l'authentification unique dans Control Hub avec SimpleSAML
Dans cet article
Un commentaire ?Vous pouvez configurer une intégration d'authentification unique (SSO) entre Control Hub et un déploiement utilisant SimpleSAML comme fournisseur d'identité (IdP).
Authentification unique et Control Hub
L'authentification unique (SSO) est un processus d'authentification de session ou d'utilisateur qui permet à un utilisateur de fournir des informations d'identification pour accéder à une ou plusieurs applications. Le processus authentifie les utilisateurs pour toutes les applications pour lesquelles ils ont des droits. Cela élimine les autres demandes lorsque les utilisateurs changent d'application au cours d'une session en particulier.
Le protocole de fédération SAML 2.0 (Security Assertion Markup Language) est utilisé pour fournir une authentification SSO entre le cloud Webex et votre fournisseur d'identité (IdP).
Profils
L'application Webex ne prend en charge que le profil SSO du navigateur Web. Dans le profil SSO du navigateur Web, l'application Webex prend en charge les liaisons suivantes :
-
Liaison POST -> POST initiée par SP
-
Liaison REDIRECT -> POST initiée par SP
Format NameID
Le protocole SAML 2.0 prend en charge plusieurs formats NameID pour communiquer au sujet d'un utilisateur en particulier. L'application Webex prend en charge les formats NameID suivants.
-
urn:Oasis:Names:TC:SAML:2.0:NameID-Format : Transient -
urn:Oasis:Names:TC:SAML:1.1 : NameID-Format : non spécifié -
urn:Oasis:Names : TC:SAML:1.1 : NameID-Format : adresse e-mail
Dans les métadonnées que vous chargez depuis votre IdP, la première entrée est configurée pour être utilisée dans Webex.
Déconnexion unique
L'application Webex prend en charge le profil de déconnexion unique. Dans l'application Webex, un utilisateur peut se déconnecter de l'application, qui utilise le protocole de déconnexion unique SAML pour mettre fin à la session et confirmer sa déconnexion auprès de votre IdP. Assurez-vous que votre IdP est configuré pour SingleLogout.
Intégrez Control Hub à SimpleSAML
Les guides de configuration fournissent un exemple précis d'intégration du SSO mais ne fournissent pas de configuration exhaustive pour toutes les possibilités. Par exemple, les étapes d'intégration pour le format nameid urn:oasis:names:tc:SAML:2.0:Nameid-Format:Transient sont documentées. D'autres formats tels que urn:oasis:names:tc:saml:1.1:nameid-format:unspecified ou urn:oasis:names:tc:saml:1.1:nameid-format:EmailAddress fonctionneront pour l'intégration SSO mais ne sont pas inclus dans notre documentation.
Configurez cette intégration pour les utilisateurs de votre organisation Webex (y compris l'application Webex et d'autres services gérés dans Control Hub). Webex Meetings Si votre site Webex est intégré à Control Hub, il hérite de la gestion des utilisateurs. Si vous ne pouvez pas y accéder Webex Meetings de cette façon et que cela n'est pas géré dans Control Hub, vous devez effectuer une intégration séparée pour activer le SSO pourWebex Meetings.
Avant de commencer
Pour le SSO et le Control Hub, les IdP doivent se conformer à la spécification SAML 2.0. De plus, les IdP doivent être configurés de la manière suivante :
Téléchargez les métadonnées Webex sur votre système local
| 1 |
Connectez-vous à Control Hub. |
| 2 |
Accédez à . |
| 3 |
Accédez à l'onglet Fournisseur d'identité et cliquez sur Activer le SSO. |
| 4 |
Sélectionnez un IdP. |
| 5 |
Choisissez le type de certificat pour votre organisation :
Les ancres de confiance sont des clés publiques qui font office d' autorité pour vérifier le certificat de signature numérique. Pour plus d'informations, consultez la documentation de votre IdP. |
| 6 |
Téléchargez le fichier de métadonnées. <org-ID>Le nom du fichier de métadonnées Webex est idb-meta - -SP.xml. |
Convertir les métadonnées
| 1 |
Ouvrez le fichier de métadonnées Webex exporté dans un éditeur de texte. |
| 2 |
Dans votre navigateur, ouvrez la page d'accueil de SimpleSAML et connectez-vous avec vos informations d'administrateur. L'emplacement de la page d'accueil varie, mais il est généralement similaire à cet exemple d'URL : https://yourcompany.yourdomain.com/simplesaml. |
| 3 |
Sur la page principale, cliquez sur Fédération. |
| 4 |
Dans la section Outils, effectuez une conversion de XML en XML SAML simple. |
| 5 |
Copiez les métadonnées Webex depuis votre éditeur de texte, puis collez-les dans le champ de conversion XML. |
| 6 |
Cliquez sur Analyser. Les métadonnées converties apparaissent. Vous ajouterez ces données au fichier texte du SP distant. |
Créer un fichier de métadonnées pour les fournisseurs de services à distance
Ces étapes sont données à titre d'exemple. Le répertoire de métadonnées et l'hôte de l'IdP varient en fonction de la configuration de votre client.
Avant de commencer
Soyez consciente des attributs que vous devez transmettre et mappez en conséquence en modifiant le fichier de
métadonnées saml20-idp-hosted.php. (Par exemple, identifiant, mail,
e-mail, etc.) Voir les exemples de métadonnées :
'authproc' => array(
// Convert LDAP names to oids.
3 => array(
'class' => 'saml:AttributeNameID',
'attribute' => 'mail',
'Format' => 'urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified',
),
50 => array(
'class' => 'core:AttributeMap',
'attribute' => 'mail',
'mail' => array('uid', 'email', 'mail'),
'sn' => 'lastname',
'givenName' => 'firstname',
),
),| 1 |
Dans la configuration SimpleSAML de l'hôte, accédez au répertoire des métadonnées. |
| 2 |
À l'aide d'un éditeur de texte, collez les données analysées à la fin du fichier saml20-sp-remote.php et enregistrez le fichier. |
| 3 |
Retournez à la page d'accueil de SimpleSAML, cliquez sur Fédération, puis affichez les métadonnées du fournisseur d'identité. |
| 4 |
Collez les données dans un nouveau fichier texte. |
| 5 |
Enregistrez le fichier mis à jour sur votre bureau sous un nom significatif, tel que simplesaml-metadata.xml. |
Importez les métadonnées de l'IdP et activez l'authentification unique après un test
Après avoir exporté les métadonnées Webex, configuré votre IdP et téléchargé les métadonnées IdP sur votre système local, vous êtes prête à les importer dans votre organisation Webex depuis Control Hub.
Avant de commencer
Ne testez pas l'intégration du SSO depuis l'interface du fournisseur d'identité (IdP). Nous ne prenons en charge que les flux initiés par les fournisseurs de services (initiés par le SP). Vous devez donc utiliser le test SSO de Control Hub pour cette intégration.
| 1 |
Choisissez l'une d'entre elles :
|
| 2 |
Sur la page Importer les métadonnées de l'IdP, faites glisser et déposez le fichier de métadonnées de l'IdP sur la page ou utilisez l'option du navigateur de fichiers pour localiser et télécharger le fichier de métadonnées . Cliquez sur Suivant.
Vous devriez utiliser l'option la plus sécurisée, si possible. Cela n'est possible que si votre IdP a utilisé une autorité de certification publique pour signer ses métadonnées. Dans tous les autres cas, vous devez utiliser l' option Moins sécurisée. Cela inclut si les métadonnées ne sont pas signées, autosignées ou signées par une autorité de certification privée. Okta ne signe pas les métadonnées. Vous devez donc choisir Moins sécurisé pour intégrer Okta SSO. |
| 3 |
Sélectionnez Tester la configuration SSO, et lorsqu'un nouvel onglet de navigateur s'ouvre, authentifiez-vous auprès de l'IdP en vous connectant. Si vous recevez une erreur d'authentification, il y a peut-être un problème avec les informations d'identification. Vérifiez le nom d'utilisateur et le mot de passe, puis réessayez. Une erreur dans l'application Webex est généralement due à un problème de configuration du SSO. Dans ce cas, resuivez les étapes, en particulier celles qui consistent à copier-coller les métadonnées de Control Hub dans la configuration de l'IdP. Pour voir directement l'expérience de connexion SSO, vous pouvez également cliquer sur Copier l'URL dans le presse-papiers depuis cet écran et la coller dans une fenêtre de navigateur privé. À partir de là, vous pouvez vous connecter par SSO. Cette étape permet d'éviter les faux positifs causés par un jeton d' accès qui se trouve peut-être dans une session existante alors que vous êtes connectée. |
| 4 |
Retournez à l'onglet du navigateur Control Hub.
La configuration SSO ne prend pas effet dans votre organisation à moins que vous n'appuyiez sur le premier bouton radio et que vous n'activiez le SSO. |
Que faire ensuite
Suivez les procédures décrites dans Synchroniser les utilisateurs d'Okta Cisco Webex Control Hub si vous souhaitez effectuer le provisionnement des utilisateurs depuis Okta vers le cloud Webex.
Suivez les procédures décrites dans Synchroniser les utilisateurs de Microsoft Entra ID Cisco Webex Control Hub si vous souhaitez effectuer le provisionnement des utilisateurs depuis Entra ID vers le cloud Webex.
Vous pouvez suivre la procédure décrite dans Supprimer les e-mails automatisés pour désactiver les e-mails envoyés aux nouveaux utilisateurs de l'application Webex au sein de votre organisation. Le document contient également les meilleures pratiques pour envoyer des communications aux utilisateurs de votre organisation.
