- Start
- /
- Artikel
Du kan konfigurera en SSO (Single Sign-on) -integration mellan en Control Hub-kundorganisation och en distribution som använder Microsoft Entra ID som identitetsleverantör (IdP).
Enkel inloggning och kontrollnav
Single sign-on (SSO) är en session eller användarautentiseringsprocess som tillåter en användare att ange autentiseringsuppgifter för att komma åt ett eller flera program. Processen autentiserar användare för alla applikationer som de ges rättigheter till. Det eliminerar ytterligare uppmaningar när användare byter program under en viss session.
Federationsprotokollet SAML 2.0 (Security Assertion Markup Language) används för att tillhandahålla SSO-autentisering mellan Webex-molnet och din identitetsleverantör (IdP).
Profiler
Webex-appen stöder endast webbläsarens SSO-profil. I webbläsarens SSO-profil stöder Webex App följande bindningar:
-
SP initierade POST -> POST-bindning
-
SP initierade OMDIRIGERING -> POST-bindning
NamnID-format
SAML 2.0-protokollet stöder flera NameID-format för kommunikation om en specifik användare. Webex App stöder följande NameID-format.
-
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 laddar från din IdP konfigureras den första posten för användning i Webex.
Integrera Control Hub med Microsoft Entra ID
Webex stöder endast en IdP för varje autentiseringsbegäran. Autentiseringsflödet är som följer: Användare > Webex-autentisering > IdP 1 > Webex-autentisering > Användare. Det innebär att även om olika användare kan autentisera med olika IDP, kan en användare inte växla mellan flera IDP under en enda autentiseringsprocess. Eventuella ytterligare steg som makroekonomiskt bistånd måste integreras med den enda IdP som används för just den begäran.
Konfigurationsguiderna visar ett specifikt exempel på SSO-integration men ger inte uttömmande konfiguration för alla möjligheter. Till exempel dokumenteras integrationsstegen för nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient. Andra format som urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddresskommer att fungera för SSO-integration men ligger utanför omfattningen av vår dokumentation.
Ställ in den här integrationen för användare i din Webex-organisation (inklusive Webex-appen och andra tjänster som administreras i Control Hub). Webex Meetings Om din Webex-webbplats är integrerad i Control Hub ärver Webex-webbplatsen användarhanteringen. Om du inte kan komma Webex Meetings åt på det här sättet och det inte hanteras i Control Hub måste du göra en separat integration för att aktivera SSO förWebex Meetings.
Innan du börjar
För SSO och Control Hub måste IDP:er uppfylla SAML 2.0-specifikationen. Dessutom måste IDP:er konfigureras på följande sätt:
- I Entra ID stöds provisionering endast i manuellt läge. Detta dokument omfattar endast integration med enkel inloggning (SSO).
- Befintliga Webex-kunder med tidigare federationskonfigurationer kan stöta på problem med Webex- standardmallen Entra ID på grund av ändringar i SAML-attribut. Vi rekommenderar att du konfigurerar en anpassad Entra ID-federation för att lösa detta med dina tidigare SAML-inställningar. Se till att du utför Control Hub SSO-testet för att möjliggöra kompatibilitet och åtgärda eventuella avvikelser.
Ladda ner Webex-metadata till ditt lokala system
Ladda ner Webex-metadata innan du konfigurerar din identitetsleverantör. Den här filen innehåller inställningarna för Webex-tjänsteleverantören för din organisation, och din identitetsleverantör använder dessa inställningar för att känna igen Webex och skicka SAML-inloggningssvar tillbaka till rätt plats. Använd den här metadatafilen när du konfigurerar SAML-programmet i identitetsleverantören.
| 1 |
Logga in på Control Hub. |
| 2 |
Gå till Han . |
| 3 |
Gå till fliken Identitetsleverant ör och klicka på Aktivera SSO. |
| 4 |
Välj en IdP. |
| 5 |
Välj certifikattyp för din organisation:
Förtroendeankare är offentliga nycklar som fungerar som en auktoritet för att verifiera en digital signaturs certifikat. Mer information finns i IdP-dokumentationen. |
| 6 |
Ladda ner metadatafilen. <org-ID>Filnamnet för Webex metadata är idb-meta- -SP.xml. |
Konfigurera inställningar för SSO-program i Entra ID
Innan du börjar
Innan du konfigurerar SAML-programmet i Entra ID, kontrollera att identitetsleverantören är redo och att dina Webex-användare redan finns. Du kan skapa användare lokalt eller synkronisera dem från din katalog. Håll Webex-metadatafilen som du hämtade från Control Hub tillgänglig, eftersom du laddar upp den till SAML-programmet under den här proceduren.
Mer bakgrund om Entra ID-identitetsleverantörens funktioner finns i Microsofts dokumentation.
| 1 |
Logga in på administratörscentret för Microsoft Entra och gå till . |
| 2 |
Öppna Webex-programmet som du har lagt till eller skapat i applik ationsgalleriet. Klicka här för mer information om skillnaden
mellan den förbyggda Cisco Webex applikationen eller den anpassade SCIM 2.0-applikationen.
|
| 3 |
Klicka på .
|
| 4 |
Klicka på Ladda upp metadatafil och välj sedan metadatafilen som du hämtade från Control Hub.
Vissa fält fylls automatiskt i åt dig. |
| 5 |
Under klickar du på Konfigurera enkel inloggning med SAML > Redigera. |
| 6 |
Öppna Grundläggande SAML-konfiguration, kopiera värdet Svara URL, klistra in det i Logga in URL och spara ändr ingarna.
|
| 7 |
Gå till och välj tillämpliga användare och grupper som du vill ge åtkomst till Webex-appen. |
| 8 |
På sidan Konfigurera enkel inloggning med SAML i avsnittet SAML- signeringsc ertifik at klickar du på Hämta för att hämta Federation Metadata XML och spara den på datorn. |
Importera IdP-metadata och aktivera enkel inloggning efter ett test
När du har exporterat Webex-metadata, konfigurerat din IdP och hämtat IdP-metadata till ditt lokala system är du redo att importera det till din Webex-organisation från Control Hub.
Innan du börjar
Testa inte SSO-integrationen från IdP-gränssnittet (Identity Provider). Vi stöder endast Service Provider-initierade (SP-initierade) flöden, så du måste använda Control Hub SSO-testet för denna integrering.
| 1 |
Välj en:
|
| 2 |
På sidan Importera IdP-metadata kan du antingen dra och släppa IdP-metadatafilen på sidan eller använda alternativet för filbläddrare för att hitta och ladda upp metadat afilen. Klicka på Nästa.
Du bör använda alternativet Säkr are, om du kan. Detta är bara möjligt om din IdP använde en offentlig certifikatutfärdare för att signera sina metadata. I alla andra fall måste du använda alternativet Mindre säkert. Detta gäller även om metadata inte är signerade, självsignerade eller signerade av en privat certifikatutfärdare. Okta signerar inte metadata, så du måste välja Mindre säker för en Okta SSO-integration. |
| 3 |
Välj Test SSO setup och när en ny webbläsarflik öppnas autentiserar du med IdP genom att logga in. Om du får ett autentiseringsfel kan det vara ett problem med autenti seringsuppgifterna. Kontrollera användarnamnet och lösenordet och försök igen. Ett Webex-appfel innebär vanligtvis ett problem med SSO-installationen. I det här fallet går du igenom stegen igen, särskilt stegen där du kopierar och kli strar in Control Hub-metadata i IdP-inställningen. För att se SSO-inloggningsupplevelsen direkt kan du också klicka på Kopiera URL till Urklipp från den här skärmen och kli stra in den i ett privat webbläsarfönster. Därifrån kan du gå igenom inlogg ningen med SSO. Det här steget stoppar falska positiva resultat på grund av en åtkomsttoken som kan finnas i en befintlig session från att du är inloggad. |
| 4 |
Återgå till webbläsarfliken Control Hub.
SSO-konfigurationen träder inte i kraft i organisationen om du inte väljer första alternativknappen och aktiverar SSO. |
Vad du ska göra härnäst
Använd procedurerna i Synkronisera Okta-användare till Control Hub om du vill göra användarprovisionering från Okta till Webex-molnet.
Använd procedurerna i Synkronisera Microsoft Entra ID-användare till Control Hub om du vill göra användarprovisionering från Entra ID till Webex-molnet.
Du kan följa proceduren i Undertryck automatiska e-postmeddelanden för att inaktivera e-postmeddelanden som skickas till nya Webex App-användare i din organisation. Dokumentet innehåller också bästa praxis för att skicka ut kommunikation till användare i organisationen.
Felsöka integrering av Entra ID
När du testar SSO använder du Mozilla Firefox med SAML Tracer- tillägget för att inspektera SAML-påståendet som kommer från Entra ID.
Kontrollera i påståendet att NameIDelementet använder det transienta namn-ID-formatet.
<NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">...</NameID>
Kontrollera också att påståendet innehåller ett uidattribut och att värdet matchar en användare i Webex-appen.
<Attribute Name="uid">
<AttributeValue>...</AttributeValue>
</Attribute>