- Hjem
- /
- Artikkel
Konfigurer enkel pålogging i Control Hub med SimpleSAML
Du kan konfigurere en integrering med enkel pålogging (SSO) mellom Control Hub og en distribusjon som bruker SimpleSAML som identitetsleverandør (IdP).
Enkel pålogging og kontrollhub
Enkeltpålogging (SSO) er en økt- eller brukerautentiseringsprosess som lar en bruker oppgi påloggingsinformasjon for å få tilgang til ett eller flere applikasjoner. Prosessen autentiserer brukere for alle applikasjonene de har fått rettigheter til. Det eliminerer ytterligere spørsmål når brukere bytter applikasjoner i løpet av en bestemt økt.
Security Assertion Markup Language (SAML 2.0) Federation Protocol brukes til å gi SSO-autentisering mellom Webex Cloud og identitetsleverandøren din (IdP).
Profiler
Webex-appen støtter bare nettleserens SSO-profil. I nettleserens SSO-profil støtter Webex-appen følgende bindinger:
-
SP initierte POST -> POST-binding
-
SP initierte OMDIREKTER -> POST-binding
NavnID-format
SAML 2.0-protokollen støtter flere NameID-formater for kommunikasjon om en bestemt bruker. Webex-appen stø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 metadataene du laster inn fra IdP-en din, er den første oppføringen konfigurert for bruk i Webex.
Enkeltlogging
Webex-appen støtter profilen for enkelt utlogging. I Webex-appen kan en bruker logge seg ut av applikasjonen, som bruker SAML-protokollen for enkel utlogging for å avslutte økten og bekrefte utloggingen med IdP-en din. Sørg for at IdP-en din er konfigurert for SingleLogout.
Integrer kontrollhub med SimpleSAML
Konfigurasjonsveiledningene viser et spesifikt eksempel på SSO-integrasjon, men gir ikke uttømmende konfigurasjon for alle muligheter. For eksempel er integrasjonstrinnene for nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient
dokumentert. Andre formater som urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
vil fungere for SSO-integrasjon, men er utenfor omfanget av dokumentasjonen vår.
Konfigurer denne integrasjonen for brukere i Webex-organisasjonen din (inkludert Webex-appen, Webex Meetings og andre tjenester som administreres i Control Hub). Hvis Webex-nettstedet ditt er integrert i Control Hub, arver Webex-nettstedet brukeradministrasjonen. Hvis du ikke får tilgang til Webex Meetings på denne måten, og det ikke administreres i Control Hub, må du gjøre en separat integrasjon for å aktivere SSO for Webex Meetings.
Før du begynner
For SSO og Control Hub må IdP-er være i samsvar med SAML 2.0-spesifikasjonen. I tillegg må IdP-er konfigureres på følgende måte:
Last ned Webex-metadataene til ditt lokale system
1 |
Logg inn på Kontrollhub. |
2 |
Gå til . |
3 |
Gå til fanen Identitetsleverandør og klikk på Aktiver SSO. |
4 |
Velg en IdP. |
5 |
Velg sertifikattypen for organisasjonen din:
Tillitsankere er offentlige nøkler som fungerer som en autoritet for å verifisere sertifikatet til en digital signatur. Hvis du vil ha mer informasjon, kan du se IdP-dokumentasjonen din. |
6 |
Last ned metadatafilen. Filnavnet for Webex-metadata er idb-meta-<org-ID>-SP.xml. |
Konverter metadata
1 |
Åpne den eksporterte Webex-metadatafilen i et tekstredigeringsprogram. |
2 |
Åpne simpleSAML-hjemmesiden i nettleseren din og logg inn med administratorlegitimasjonen din. Plasseringen av hjemmesiden varierer, men ligner vanligvis på denne eksempel-URL-en: https://yourcompany.yourdomain.com/simplesaml. |
3 |
Fra hovedsiden klikker du på Føderasjon. |
4 |
Under verktøy, utfør en XML til Simple SAML XML-konvertering. |
5 |
Kopier Webex-metadataene fra tekstredigeringsprogrammet, og lim dem deretter inn i XML-konverteringsfeltet. |
6 |
Klikk på Parse. De konverterte metadataene vises. Du legger til disse dataene i den eksterne SP-tekstfilen. |
Opprett metadatafil for ekstern tjenesteleverandør
Disse trinnene er ment som et eksempel. Metadatakatalogen og IdP-verten varierer avhengig av klientoppsettet ditt.
Før du begynner
Vær oppmerksom på attributtene du må sende, og tilordne dem deretter ved å redigere metadatafilen saml20-idp-hosted.php
. (For eksempel uid, post, e-post og så videre). Se eksempelmetadataene:
'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 |
I SimpleSAML-konfigurasjonen på verten går du til metadatakatalogen. |
2 |
Bruk en teksteditor til å lime inn de analyserte dataene på slutten av saml20-sp-remote.php og lagre filen. |
3 |
Gå tilbake til SimpleSAML-forsiden, klikk på Federation, og vis deretter metadata for identitetsleverandøren. |
4 |
Lim inn dataene i en ny tekstfil. |
5 |
Lagre den oppdaterte filen på skrivebordet med et meningsfullt navn, for eksempel simplesaml-metadata.xml. |
Importer IdP-metadataene og aktiver enkel pålogging etter en test
Etter at du har eksportert Webex-metadataene, konfigurert IdP-en din og lastet ned IdP-metadataene til det lokale systemet ditt, er du klar til å importere dem til Webex-organisasjonen din fra Control Hub.
Før du begynner
Ikke test SSO-integrasjon fra identitetsleverandørgrensesnittet (IdP). Vi støtter bare tjenesteleverandørinitierte (SP-initierte) flyter, så du må bruke Control Hub SSO-testen for denne integrasjonen.
1 |
Velg én:
|
2 |
På siden Importer IdP-metadata, dra og slipp IdP-metadatafilen til siden eller bruk filutforskeralternativet til å finne og laste opp metadatafilen. Klikk på Neste.
Du bør bruke alternativet Sikrere hvis du kan. Dette er bare mulig hvis IdP-en din brukte en offentlig CA til å signere metadataene sine. I alle andre tilfeller må du bruke alternativet Mindre sikkert. Dette inkluderer hvis metadataene ikke er signert, selvsignert eller signert av en privat CA. Okta signerer ikke metadataene, så du må velge Mindre sikker for en Okta SSO-integrasjon. |
3 |
Velg Test SSO-oppsett, og når en ny nettleserfane åpnes, autentiser med IdP-en ved å logge på. Hvis du får en autentiseringsfeil, kan det være et problem med påloggingsinformasjonen. Sjekk brukernavn og passord og prøv på nytt. En Webex-appfeil betyr vanligvis et problem med SSO-oppsettet. I dette tilfellet går du gjennom trinnene på nytt, spesielt trinnene der du kopierer og limer inn Control Hub-metadataene i IdP-oppsettet. For å se SSO-påloggingsopplevelsen direkte, kan du også klikke på Kopier URL til utklippstavlen fra denne skjermen og lime den inn i et privat nettleservindu. Derfra kan du gå gjennom påloggingen med SSO. Dette trinnet stopper falske positiver på grunn av et tilgangstoken som kan være i en eksisterende økt fra deg som er logget på. |
4 |
Gå tilbake til nettleserfanen i Control Hub.
SSO-konfigurasjonen trer ikke i kraft i organisasjonen din med mindre du velger den første alternativknappen og aktiverer SSO. |
Hva du skal gjøre nå
Bruk prosedyrene i Synkroniser Okta-brukere med Cisco Webex Control Hub hvis du vil utføre brukerklargjøring fra Okta til Webex-skyen.
Bruk prosedyrene i Synkroniser Azure Active Directory-brukere med Cisco Webex Control Hub hvis du vil utføre brukerklargjøring fra Azure AD til Webex-skyen.
Du kan følge prosedyren i Undertrykk automatiserte e-poster for å deaktivere e-poster som sendes til nye Webex-appbrukere i organisasjonen din. Dokumentet inneholder også beste praksis for å sende ut kommunikasjon til brukere i organisasjonen din.