- Start
- /
- Artikel
Hartelijk dank voor uw feedback
In dit artikel
Feedback?U kunt een SSO-integratie (eenmalige aanmelding) configureren tussen een klantorganisatie van Control Hub en een implementatie die Microsoft Entra ID als identiteitsprovider (IdP) gebruikt.
Een single sign-on en Control Hub
Eenmalige aanmelding (SSO) is een sessie- of gebruikersverificatieproces waarbij een gebruiker aanmeldgegevens kan verstrekken om toegang te krijgen tot een of meer toepassingen. Het proces verifieert gebruikers voor alle toepassingen waarvoor ze rechten hebben gekregen. Gebruikers krijgen geen prompts meer te zien wanneer ze tijdens een bepaalde sessie tussen toepassingen schakelen.
Het Security Assertion Markup Language-federatieprotocol (SAML 2.0) wordt gebruikt om SSO-verificatie te bieden tussen de Webex-cloud en uw identiteitsprovider (IdP).
Profielen
De Webex-app ondersteunt alleen het SSO-profiel van de webbrowser. In het SSO-profiel van de webbrowser ondersteunt de Webex-app de volgende bindingen:
-
SP-gestarte POST -> POST-binding
-
SP-gestarte OMLEIDING -> POST-binding
Indeling naam-ID
De SAML 2.0 Protocol ondersteunt verschillende NameID-indelingen voor communicatie over een bepaalde gebruiker. De Webex-app ondersteunt de volgende NameID-indelingen.
-
urn:oasis:names:tc:SAML:2.0:nameid-format:transient -
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified -
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
In de metagegevens die u van uw identiteitsprovider laadt, wordt de eerste invoer geconfigureerd voor gebruik in Webex.
Control Hub integreren met Microsoft Entra ID
Webex ondersteunt slechts één IdP voor elk verificatieverzoek. De verificatiestroom is als volgt: Gebruiker > Webex-verificatie > IdP 1 > Webex-verificatie > Gebruiker. Dit betekent dat, hoewel verschillende gebruikers met verschillende IdP's kunnen verifiëren, een gebruiker tijdens één verificatieproces niet tussen meerdere IdP's kan schakelen. Aanvullende stappen zoals MFA moeten worden geïntegreerd met de enkele IdP die voor dat specifieke verzoek wordt gebruikt.
De configuratiehandleidingen geven een specifiek voorbeeld van SSO-integratie weer, maar bieden geen volledige configuratie voor alle mogelijkheden. De integratiestappen voor bijvoorbeeld nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient zijn gedocumenteerd. Andere indelingen zoals urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress ondersteunen SSO-integratie, maar vallen buiten het bereik van onze documentatie.
Stel deze integratie in voor gebruikers in uw Webex-organisatie (inclusief Webex-app, Webex Meetings en andere services die worden beheerd in Control Hub). Als uw Webex-site is geïntegreerd in Control Hub, wordt het gebruikersbeheer overgenomen door de Webex-site. Als u op deze manier geen toegang hebt tot Webex Meetings en het wordt niet beheerd in Control Hub, moet u een afzonderlijke integratie uitvoeren om SSO voor Webex Meetings in te schakelen.
Voordat u begint
Voor SSO en Control Hub moeten IdP's voldoen aan de SAML-specificatie 2. 0. Daarnaast moeten IdP's op de volgende manier worden geconfigureerd:
- In Entra ID wordt inrichting alleen ondersteund in de handmatige modus. Dit document gaat alleen over de integratie van eenmalige aanmelding (SSO).
- Bestaande Webex-klanten met eerdere federatieconfiguraties kunnen problemen ondervinden met de standaard Entra ID Webex-sjabloon vanwege wijzigingen in SAML-kenmerken. We raden u aan een aangepaste Entra ID-federatie in te stellen om dit op te lossen met uw vorige SAML-instellingen. Zorg ervoor dat u de SSO-test van Control Hub uitvoert om de compatibiliteit toe te staan en eventuele discrepanties aan te pakken.
Download de Webex-metagegevens naar uw lokale systeem
Download de Webex-metagegevens voordat u uw identiteitsprovider configureert. Dit bestand bevat de instellingen van de Webex-serviceprovider voor uw organisatie en uw identiteitsprovider gebruikt deze instellingen om Webex te herkennen en SAML-aanmeldingsreacties terug te sturen naar de juiste plaats. Gebruik dit metagegevensbestand wanneer u de SAML-toepassing configureert in uw identiteitsprovider.
| 1 |
Meld u aan bij Control Hub. |
| 2 |
Ga naar . |
| 3 |
Ga naar het menu Identity provider en klik op Activate SSO. |
| 4 |
Selecteer een IdP. |
| 5 |
Kies het certificaattype voor uw organisatie:
Vertrouwensankers zijn openbare sleutels die optreden als bevoegdheid om het certificaat van een digitale handtekening te verifiëren. Raadpleeg de IdP-documentatie voor meer informatie. |
| 6 |
Download het bestand met metagegevens. De bestandsnaam van de Webex-metagegevens is idb-meta-<org-ID>-SP.xml. |
Instellingen voor SSO-toepassing configureren in Entra ID
Voordat u begint
Voordat u de SAML-toepassing in Entra ID configureert, moet u ervoor zorgen dat uw identiteitsprovider gereed is en dat uw Webex-gebruikers al bestaan. U kunt gebruikers lokaal maken of synchroniseren vanuit uw adreslijst. Houd het Webex-metagegevensbestand dat u hebt gedownload van Control Hub beschikbaar, omdat u het tijdens deze procedure naar de SAML-toepassing uploadt.
Zie De documentatie van Microsoft voor meer achtergrond over de mogelijkheden van Entra ID-identiteitsproviders.
| 1 |
Meld u aan bij het Microsoft Entra-beheercentrum en ga naar . |
| 2 |
Open de Webex-toepassing die u hebt toegevoegd of hebt gemaakt in de toepassingsgalerij. Klik op hier voor meer informatie over het verschil tussen de vooraf ontwikkelde Cisco Webex-toepassing of de aangepaste SCIM-toepassing 2.0.
|
| 3 |
Klik op . 
|
| 4 |
Klik op Upload metadata file en kies het metagegevensbestand dat u hebt gedownload van Control Hub. 
Sommige velden worden automatisch voor u gevuld. |
| 5 |
Voer uw naam en e-mailadres in onder ManageKlik . |
| 6 |
Openen Basic SAML Configuration, kopieer de Reply URL waarde, plak het in Sign on URLen sla uw wijzigingen op.
|
| 7 |
Ga naar en kies de toepasselijke gebruikers en groepen die u toegang wilt verlenen tot de Webex-app. |
| 8 |
Selecteer in het deelvenster Set up Single Sign-On with SAML in het venster SAML Signing Certificate gedeelte op Download om de Federation Metadata XML en sla deze op uw computer op. |
Importeer de IdP-metagegevens en schakel eenmalige aanmelding na een test in
Nadat u de Webex-metagegevens hebt geëxporteerd, uw identiteitsprovider hebt geconfigureerd en de metagegevens van de identiteitsprovider naar uw lokale systeem hebt gedownload, kunt u deze vanuit Control Hub in uw Webex-organisatie importeren.
Voordat u begint
Test de SSO-integratie niet vanuit de interface van de identiteitsprovider (IdP). We ondersteunen alleen door serviceprovider geïnitieerde overdrachts stromen, dus u moet de Control hub gebruiken SSO test voor deze integratie.
| 1 |
Kies een van de opties:
|
| 2 |
Sleep op de pagina Metagegevens van de identiteitsprovider importeren het metagegevensbestand van de identiteitsprovider naar de pagina of gebruik de bestandsbrowser om het metagegevensbestand te zoeken en te uploaden. Klik op Next.
Gebruik dan de More secure optie als dat mogelijk is. Dit is alleen mogelijk als uw IdP een openbare ca heeft gebruikt om de metagegevens te ondertekenen. In alle andere gevallen moet u de Less secure optie. Dit geldt ook als de metagegevens niet zijn ondertekend, zelfonder ondertekend of zijn ondertekend door een privé-CA. Okta ondertekent de metagegevens niet, dus u moet kiezen Less secure voor een Okta SSO-integratie. |
| 3 |
Selecteer Test SSO setup, en wanneer er een nieuw browsertabblad wordt geopend, verifieert u zich met de IdP door u aan te melden. Als u een verificatiefout ontvangt, is er mogelijk een probleem met de aanmeldgegevens. Controleer de gebruikersnaam en het wachtwoord en probeer het opnieuw. Een fout in de Webex-app betekent meestal een probleem met de SSO-setup. In dat geval kunt u de stappen opnieuw doorlopen, vooral de stappen waarbij u de metadata van de Control hub kopieert en plakt in de IdP-instellingen. Als u de SSO-aanmeldingservaring rechtstreeks wilt bekijken, kunt u ook op Copy URL to clipboard vanuit dit scherm en plak het in een venster van een privébrowser. Vanaf daar kunt u het aanmelden met SSO doorlopen. Deze stap stopt met false positives vanwege een toegangs token die mogelijk in een bestaande sessie is van uw aangemelde. |
| 4 |
Keer terug naar het tabblad browser voor Control hub.
De SSO configuratie wordt niet van kracht in uw organisatie, tenzij u eerst keuzerondje activeren en activeren SSO. |
De volgende stappen
Gebruik de procedures in Synchroniseer Okta-gebruikers in Control Hub als u gebruikersvoorzieningen vanuit Okta in de Webex-cloud wilt uitvoeren.
Gebruik de procedures in Synchroniseer Microsoft Entra ID-gebruikers in Control Hub als u de gebruikersinrichting van Entra ID in de Webex-cloud wilt uitvoeren.
U kunt de procedure volgen in Geautomatiseerde e-mails onderdrukken om e-mails uit te schakelen die naar nieuwe gebruikers van de Webex-app in uw organisatie worden verzonden. Het document bevat ook aanbevolen procedures voor het verzenden van communicatie naar gebruikers in uw organisatie.
Problemen met de Entra ID-integratie oplossen
Wanneer u SSO test, gebruikt u Mozilla Firefox met de SAML Tracer-invoegtoepassing om de SAML-verklaring te inspecteren die van Entra ID afkomstig is.
Verifieer in de assertie of de NameID element gebruikt de indeling van de tijdelijke naam-id.
<NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">...</NameID>Controleer ook of de assertie een uid kenmerk en dat de waarde overeenkomt met een gebruiker in de Webex-app.
<Attribute Name="uid">
<AttributeValue>...</AttributeValue>
</Attribute>
