- Hjem
- /
- Artikel
Du kan konfigurere en integration med enkeltlogon (SSO) mellem en Control Hub-kundeorganisation og en installation, der bruger Microsoft Entra ID som identitetsudbyder (IdP).
Single sign-on og Control Hub
Single sign-on (SSO) er en sessions- eller brugergodkendelsesproces, der giver en bruger tilladelse til at angive legitimationsoplysninger for at få adgang til et eller flere programmer. Processen godkender brugere til alle de programmer, de har fået rettigheder til. Det eliminerer behovet for yderligere godkendelser, når brugere skifter program under en bestemt session.
Security Assertion Markup Language (SAML 2.0) Federation-protokollen bruges til at levere SSO-bekræftelse mellem Webex Cloud og din identitetsudbyder (IdP).
Profiler
Webex-appen understøtter kun webbrowserens SSO profil. I webbrowseren til SSO, understøtter Webex-appen følgende bindinger:
-
SP-initieret POST -> POST-binding
-
SP-initieret OMDIRIGERING -> POST-binding
NameID-format
SAML 2.0-protokollen understøtter flere NameID-formater til kommunikation om en bestemt bruger. Webex-appen understøtter følgende NameID-formater.
-
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
I metadata, som du indlæser fra din IdP, konfigureres den første post til brug i Webex.
Integrer Control Hub med Microsoft Entra ID
Webex understøtter kun én IdP for hver godkendelsesanmodning. Godkendelsesprocesforløbet er som følger: Bruger > Webex-godkendelse > IdP 1 > Webex-godkendelse > Bruger. Det betyder, at selvom forskellige brugere kan godkende ved hjælp af forskellige IdP'er, kan en bruger ikke skifte mellem flere IdP'er under en enkelt godkendelsesproces. Eventuelle yderligere trin, såsom MFA, skal integreres med den enkelte IdP, der bruges til den pågældende anmodning.
Konfigurationsvejledningerne viser et specifikt eksempel på SSO-integration, men giver ikke udtømmende vejledning om alle konfigurationsmuligheder. For eksempel er integrationstrinnene for nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient dokumenteret. Andre formater som f.eks. urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress fungerer også til SSO-integration, men er uden for rammerne af vores dokumentation.
Opsæt denne integration for brugere i din Webex-organisation ( herunder Webex-app, Webex Meetingsog andre tjenester, der administreres i Control Hub). Hvis dit Webex-websted er integreret i Control Hub, så overtager Webex-webstedet brugeradministrationen. Hvis du ikke kan få adgang til Webex Meetings på denne måde, og det ikke administreres i Control Hub, skal du udføre en separat integration for at aktivere SSO for Webex Meetings.
Før du begynder
For SSO og Control Hub skal IdP'er være i overensstemmelse med SAML 2.0-specifikationen. Derudover skal IdP'er konfigureres på følgende måde:
- I Entra ID understøttes klargøring kun i manuel tilstand. Dette dokument omhandler kun integration af single sign-on (SSO).
- Eksisterende Webex-kunder med tidligere Federation-konfigurationer kan støde på problemer med standard Entra ID Webex-skabelonen på grund af ændringer i SAML-attributter. Vi anbefaler at oprette en brugerdefineret Entra ID-føderation for at løse dette ved hjælp af dine tidligere SAML-indstillinger. Sørg for at udføre Control Hub SSO-testen for at sikre kompatibilitet og adressere eventuelle uoverensstemmelser.
Download Webex-metadata til dit lokale system
Download Webex-metadataene, før du konfigurerer din identitetsudbyder. Denne fil indeholder Webex-udbyderindstillingerne for din organisation, og din identitetsudbyder bruger disse indstillinger til at genkende Webex og sende SAML-loginsvar tilbage til det korrekte sted. Brug denne metadatafil, når du konfigurerer SAML-applikationen i din identitetsudbyder.
| 1 | |
| 2 |
Gå til . |
| 3 |
Gå til fanen Identitetsudbyder og klik på Aktiver SSO. |
| 4 |
Vælg en IdP. |
| 5 |
Vælg certifikattypen for din organisation:
Tillidsankre er offentlige nøgler, der fungerer som en myndighed til at bekræfte en digital underskrifts certifikat. Få yderligere oplysninger i din IdP-dokumentation. |
| 6 |
Download metadatafilen. Webex-metadatafilnavnet er idb-meta-<org-ID>-SP.xml. |
Konfigurer SSO-applikationsindstillinger i Entra ID
Før du begynder
Før du konfigurerer SAML-applikationen i Entra ID, skal du sørge for, at din identitetsudbyder er klar, og at dine Webex-brugere allerede findes. Du kan oprette brugere lokalt eller synkronisere dem fra din mappe. Hold Webex-metadatafilen, som du downloadede fra Control Hub, tilgængelig, da du uploader den til SAML-applikationen under denne procedure.
For mere baggrund om Entra ID-identitetsudbyderens funktioner, se Microsofts dokumentation.
| 1 |
Log ind på Microsoft Entra administrationscenter og gå til . |
| 2 |
Åbn den Webex-applikation, du tilføjede eller oprettede i applikationsgalleriet. Klik her for at få flere oplysninger om forskellen mellem den præbyggede Cisco Webex-applikation og den brugerdefinerede SCIM 2.0-applikation.
|
| 3 |
Klik på . |
| 4 |
Klik på Upload metadatafil, og vælg derefter den metadatafil, du downloadede fra Control Hub. Nogle felter udfyldes automatisk for dig. |
| 5 |
Under Administrerskal du klikke på . |
| 6 |
Åbn Grundlæggende SAML-konfiguration, kopier værdien Svar-URL, indsæt den i Log ind-URL, og gem dine ændringer.
|
| 7 |
Gå til og vælg de relevante brugere og grupper, som du vil give adgang til Webex-appen. |
| 8 |
På siden Opsætning af enkelt login med SAML , i afsnittet SAML signeringscertifikat, skal du klikke på Download for at downloade Federation Metadata XML og gemme den på din computer. |
Importer IdP-metadata, og single sign-on efter en test
Når du har eksporteret Webex-metadata , konfigureret din IdP og downloade IdP-metadata til dit lokale system, er du klar til at importere dem i din Webex-organisation fra Control Hub.
Før du begynder
Test ikke SSO-integration fra identitetsudbyderens (IdP) grænseflade. Vi understøtter kun Tjenesteudbyder-initierede (SP-startet) strømme, så du skal bruge Control hub SSO-testen til denne integration.
| 1 |
Vælg én:
|
| 2 |
På siden Importer IdP-metadata skal du enten trække og slippe IdP-metadatafilen over på siden eller bruge filbrowseren til at finde og uploade metadatafilen. Klik på Næste.
Du bør bruge valgmuligheden Mere sikker , hvis du kan. Dette er kun muligt, hvis din IdP brugte en offentlig CA til at underskrive dens metadata. I alle andre tilfælde skal du bruge valgmuligheden Mindre sikker. Dette omfatter, hvis metadataene ikke er signeret, selv underskrevet eller underskrevet af en privat CA. Okta underskriver ikke metadata, så du skal vælge Mindre sikker for en Okta SSO integration. |
| 3 |
Vælg Test SSO-opsætning, og når en ny browserfane åbnes, skal du godkende med IdP'en ved at logge ind. Hvis du får en godkendelsesfejl, kan der være et problem med legitimationsoplysningerne. Kontrollér brugernavnet og adgangskoden, og prøv igen. En Webex App-fejl betyder som regel et problem med SSO opsætning. I dette tilfælde skal du gennemgå trinnene igen, særligt de trin, hvor du kopierer og indsætter Control Hub-metadataene i IdP-opsætningen. Hvis du vil se SSO-loginprocessen direkte, kan du også klikke på Kopiér URL-adresse til udklipsholder fra denne skærm og indsætte den i et privat browservindue. Derfra kan du gå igennem og logge ind med SSO. Dette trin stopper falske positiver, som følge af et adgangstoken, som kan være i en eksisterende session, hvor du er logget ind. |
| 4 |
Vend tilbage til Control Hub-browserfanen.
Konfigurationen SSO træder ikke i kraft i din organisation, medmindre du først vælger valgknap og aktiverer SSO. |
Hvad er næste trin?
Brug procedurerne i Synkroniser Okta-brugere til Control Hub, hvis du vil udføre brugerklargøring fra Okta til Webex Cloud.
Brug procedurerne i Synkroniser Microsoft Entra ID-brugere med Control Hub, hvis du vil udføre brugerklargøring fra Entra ID til Webex Cloud.
Du kan følge proceduren i Undertryk automatiserede e-mails for at deaktivere e-mails, der sendes til nye Webex-appbrugere i din organisation. Dokumentet indeholder også bedste praksis for afsendelse af meddelelser til brugere i din organisation.
Fejlfinding af Entra ID-integration
Når du tester SSO, skal du bruge Mozilla Firefox med tilføjelsesprogrammet SAML Tracer til at inspicere den SAML-påstand, der kommer fra Entra ID.
I påstanden skal du kontrollere, at NameID -elementet bruger det midlertidige navn-ID-format.
... Bekræft også, at påstanden indeholder en uid -attribut, og at værdien matcher en bruger i Webex-appen.
...