I denne artikkelen
dropdown icon
Enkel pålogging og kontrollhub
    Profiler
    NavnID-format
    EnkeltLogg ut
Integrer Control Hub med ADFS
Last ned Webex-metadataene til ditt lokale system
Installer Webex-metadata i ADFS
Opprette kravsregler for Webex-godkjenning
Importer IdP-metadataene og aktiver enkel pålogging etter en test
Oppdater Webex-tillit fra avhengige parter i ADFS
dropdown icon
ADFS feilsøking
    ADFS-feil i Windows-logger
    Føderasjons-ID
    Tidssynkronisering
Konfigurere enkel pålogging i Control Hub med Active Directory Federation Services (ADFS)
list-menuI denne artikkelen
list-menuTilbakemelding?

Du kan konfigurere en enkel påloggingsintegrasjon (SSO) mellom Control Hub og en distribusjon som bruker Active Directory Federation Services (ADFS 2.x og nyere) som identitetsleverandør (IdP).

Enkel pålogging og kontrollhub

Enkel pålogging (SSO) er en økt- eller brukerautentiseringsprosess som tillater en bruker å oppgi legitimasjon for å få tilgang til ett eller flere applikasjoner. Prosessen autentiserer brukere for alle applikasjonene de får rettigheter til. Det eliminerer ytterligere meldinger når brukere bytter applikasjoner under en bestemt økt.

Security Assertion Markup Language (SAML 2.0) Federation Protocol brukes til å gi SSO-godkjenning mellom Webex-skyen og identitetsleverandøren (IdP).

Profiler

Webex-appen støtter bare nettleserens SSO-profil. I nettleserens SSO-profil støtter Webex App følgende bindinger:

  • SP initierte POST -> POST-binding

  • SP initierte REDIRECT -> POST-binding

NavnID-format

SAML 2.0-protokollen støtter flere NameID-formater for kommunikasjon om en bestemt bruker. Webex App 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:uspesifisert

  • Urn:oasis:names:tc:saml:1.1:nameID-format:e-postadresse

I metadataene du laster inn fra IdP, er den første oppføringen konfigurert for bruk i Webex.

EnkeltLogg ut

Webex-appen støtter enkelt utloggingsprofil. I Webex-appen kan en bruker logge av applikasjonen, som bruker SAML-protokollen for enkel utlogging for å avslutte økten og bekrefte at du logger ut med din IdP. Forsikre deg om at din IdP er konfigurert for SingleLogout.

Integrer Control Hub med ADFS

Konfigurasjonsveiledningene viser et spesifikt eksempel på SSO-integrasjon, men gir ikke uttømmende konfigurasjon for alle muligheter. For eksempel dokumenteres integreringstrinnene for nameid-format URN:oasis:names:tc:saml:2.0:nameID-format:Transient. Andre formater som urn:oasis:names:tc:saml:1.1:nameID-format:unspecified eller urn:oasis:names:tc:saml:1.1:nameID-format:EmailAddress vil fungere for SSO integrering, men er utenfor omfanget av dokumentasjonen vår.

Konfigurer denne integrasjonen for brukere i Webex-organisasjonen (inkludert Webex-appen og andre tjenester som administreres i Control Hub). Webex Meetings Hvis Webex-området ditt er integrert i Control Hub, arver Webex-området brukeradministrasjonen. Hvis du ikke får tilgang Webex Meetings på denne måten, og den ikke administreres i Control Hub, må du gjøre en egen integrasjon for å aktivere SSO forWebex Meetings.

Avhengig av hva som er konfigurert i godkjenningsmekanismene i ADFS, kan integrert Windows-autentisering (IWA) aktiveres som standard. Hvis aktivert, godkjennes programmer som lanseres via Windows (for eksempel Webex App og Cisco Directory Connector) som brukeren som er logget på, uavhengig av hvilken e-postadresse som angis under den første e-postmeldingen.

Last ned Webex-metadataene til ditt lokale system

Last ned Webex-metadataene før du konfigurerer identitetsleverandøren. Denne filen inneholder Webex-tjenesteleverandørinnstillingene for organisasjonen din, og identitetsleverandøren bruker disse innstillingene til å gjenkjenne Webex og sende SAML-påloggingssvar tilbake til riktig sted. Bruk denne metadatafilen når du konfigurerer SAML-programmet i identitetsleverandøren.

1

Logg på Control Hub.

2

Gå til Administrasjon > Sikkerhet > God kjenning.

3

Gå til fanen Identitetsleverand ør og klikk Aktiver SSO.

4

Velg en IdP.

5

Velg sertifikattype for organisasjonen din:

  • Selvsignert av Cisco —Vi anbefaler dette valget. La oss signere sertifikatet slik at du bare trenger å fornye det en gang hvert femte år.
  • Signert av en offentlig sertifikatmyndighet — Sikrere, men du må oppdatere metadataene ofte.
6

Last ned metadatafilen.

<org-ID>Webex-metadatafilnavnet er idb-meta- -SP.xml.

Installer Webex-metadata i ADFS

Før du begynner

Control Hub støtter ADFS 2.x eller nyere.

Windows 2008 R2 inkluderer bare ADFS 1.0. Du må installere minst ADFS 2.x fra Microsoft.

For SSO- og Webex-tjenester må identitetsleverandører (IDP) overholde følgende SAML 2.0-spesifikasjon:

  • Sett attributtet NameID Format til urn:oasis:names:tc:saml:2.0:nameID-format: transient

  • Konfigurer et krav på IdP for å inkludere uid- attributtnavnet med en verdi som er tilordnet attributtet som er valgt i Cisco Directory Connector eller brukerattributtet som samsvarer med det som er valgt i Webex identitetstjeneste. (Dette attributtet kan for eksempel være e-postadresser eller bruker-hovednavn.) Se informasjonen om egendefinerte attributter i https://www.cisco.com/go/hybrid-services-directory for veiledning.

1

Logg på ADFS-serveren med administratortillatelser.

2

Åpne ADFS-administrasjonskonsollen og gå til Klarerings relasjoner > Pålitelige parters tillit > Legg til tillit fra avhengige parter.

3

Velg Start i vinduet Add Relying Party Trust Wizard.

4

For Velg datakilde velger du Importer data om den avhengige parten fra en fil, bla til Control Hub Metadatafilen du lastet ned, og velg Neste.

5

For Angi visningsnavn oppretter du et visningsnavn for denne pålitelige partens tillit, for eksempel Webex, og velger Neste.

6

For Velg regler for utstedelsesautorisasjon velger du Tillat alle brukere å få tilgang til denne avhengige parten, og velg Neste.

7

For K lar til å legge til klar het velger du Neste og fullfører å legge til tillitsvalget i ADFS.

Opprette kravsregler for Webex-godkjenning

1

Velg klareringsforholdet du opprettet i ADFS-hovedruten, og velg deretter Rediger kravsregler. Velg Legg til regel i kategorien Utstedelsestransformasjonsregler.

2

Velg Send LDAP-attributter som krav i trinnet Velg regeltype, og velg deretter Neste.

  1. Skriv inn et kravsregelnavn.

  2. Velg Active Directorysom attributtbutikk.

  3. Tilordne LDAP-attributtet E-postadresser til uid- utgående kravtype.

    Denne regelen forteller ADFS hvilke felt som skal tilordnes Webex for å identifisere en bruker. Stav de utgående kravtypene nøyaktig som vist.

  4. Lagre endringene dine.

3

Velg Legg til regel igjen, velg Send krav ved hjelp av en egendefinert regel, og velg deretter Neste.

Denne regelen gir ADFS attributtet «spname qualifier» som Webex ellers ikke gir.

  1. Åpne tekstredigeringsprogrammet og kopier følgende innhold.

    c: [Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname «] => problem (Type =" http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier «, Utsteder = c.Utsteder, OriginalIssuer = c.OriginalIssuer, Verdi = c.Verdi, ValueType = c.ValueType, Egenskaper [» http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format «] = «urn:oasis:names:tc:saml:2.0:nameID-format:Transient», Egenskaper [» http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/namequalifier «] =" URL1 «, Egenskaper [» http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/spnamequalifier «] =" URL2 «);

    Erstatt URL1 og URL2 i teksten som følger:

    • URL1 er EntityId fra ADFS-metadatafilen du lastet ned.

      Følgende er for eksempel et eksempel på hva du ser: <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata » entityID= » http://ad0a.identitylab20.ciscolabs.com/adfs/services/trust " ID="_55515dde-8147-4183-8a85-b704d26b5dba">

      Kopier bare EntityID fra ADFS-metadatafilen og lim den inn i tekstfilen for å erstatte URL1

    • URL2 er på den første linjen i Webex-metadatafilen du lastet ned.

      Følgende er for eksempel et eksempel på hva du ser: <EntityDescriptor xmlns="urn:oasis:names:tc:saml:2.0:metadata» entity ID=» https://idbroker.webex.com/35a15b0a-0eg1-4029-9f63-a8c54df5df59 «>

      Kopier bare EntityID fra Webex-metadatafilen og lim den inn i tekstfilen for å erstatte URL2.

  2. Med de oppdaterte URL-adressene kopierer du regelen fra tekstredigeringsprogrammet (starter ved «c:») og limer den inn i den egendefinerte regelboksen på ADFS-serveren.

    Den fullførte regelen skal se slik ut:

  3. Velg Fullfør for å opprette regelen, og avslutt deretter vinduet Rediger kravregler.

4

Velg Pålitelig part Trust i hovedvinduet, og velg deretter Egenskaper i ruten til høyre.

5

Når vinduet Egenskaper vises, blar du til fanen Avansert, SHA-256, og velger deretter OK for å lagre endringene.

6

Bla til følgende URL på den interne ADFS-serveren for å laste ned filen: https: //< AD_FS_Server >/FederationMetadata/2007-06/FederationMetadata.xml

Du må kanskje høyreklikke på siden og vise sidekilden for å få riktig formatert XML-fil.

7

Lagre filen på din lokale maskin.

Hva du skal gjøre videre

Du er klar til å importere ADFS-metadataene tilbake til Webex fra administrasjonsportalen.

Importer IdP-metadataene og aktiver enkel pålogging etter en test

Etter at du har eksportert Webex-metadataene, konfigurert IdP-en og lastet ned IdP-metadataene til det lokale systemet, er du klar til å importere det til Webex-organisasjonen din fra Control Hub.

Før du begynner

Ikke test SSO-integrasjon fra IdP-grensesnittet (Identity Provider). Vi støtter bare tjenesteleverandørinitierte (SP-initierte) flyter, så du må bruke Control Hub SSO-testen for denne integrasjonen.

1

Velg en:

  • Gå tilbake til Control Hub — sertifikatvalgsiden i nettleseren din, og klikk deretter Neste.
  • Åpne Control Hub på nytt hvis den ikke lenger er åpen i nettleserfanen. Gå til Administ rasjon > Sikker het > God kjen ning fra kundevisningen i Control Hub, velg IdP og velg deretter Hand linger > Importer metadata.
2

På siden Importer IdP-metadata kan du enten dra og slippe IdP-metadatafilen til siden eller bruke alternativet for filnettleser til å finne og laste opp metadat afilen. Klikk på Neste.

Du bør bruke alternativet Mer sikker, hvis du kan. Dette er bare mulig hvis din IdP 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, godkjenn med IdP ved å logge på.

Hvis du får en godkjenningsfeil, kan det være et problem med legitimasjonen. Sjekk brukernavnet og passordet, og prøv igjen.

En Webex App-feil betyr vanligvis et problem med SSO-oppsettet. I dette tilfellet går du gjennom trinnene igjen, spesielt trinnene der du kopierer og li mer inn Control Hub-metadataene i IdP-oppsettet.

For å se SSO-påloggingsopplevelsen direkte, kan du også klikke Kopier URL til utklippstavlen fra dette skjermbildet og lime den inn i et privat nettleservindu. Derfra kan du gå gjennom på logging med SSO. Dette trinnet stopper falske positiver på grunn av et til gangstoken som kan være i en eksisterende økt etter at du er logget på.

4

Gå tilbake til kontrollhub-nettleserfanen.

  • Hvis testen var vellykket, velger du Vell ykket test. Slå på SSO og klikk Neste.
  • Hvis testen mislyktes, velger du Mis lykket test. Slå av SSO og klikk Neste.

SSO-konfigurasjonen trer ikke i kraft i organisasjonen med mindre du velger første alternativknapp og aktiverer SSO.

Hva du skal gjøre videre

Bruk prosedyrene i Synkroniser Okta-brukere til Control Hub hvis du vil gjøre brukerklargjøring ut av Okta til Webex-skyen.

Bruk prosedyrene i Synkroniser Microsoft Entra ID-brukere til Control Hub hvis du vil gjøre brukerklargjøring ut av Entra ID til Webex-skyen.

Du kan følge fremgangsmåten i Undertrykk automatiserte e-post meldinger for å deaktivere e-postmeldinger som sendes til nye Webex App-brukere i organisasjonen. Dokumentet inneholder også beste fremgangsmåter for å sende ut kommunikasjon til brukere i organisasjonen.

Oppdater Webex-tillit fra avhengige parter i ADFS

Denne oppgaven handler spesielt om å oppdatere ADFS med nye SAML-metadata fra Webex. Det er relaterte artikler hvis du trenger å konfigurere SSO med ADFS, eller hvis du trenger å oppdatere (en annen) IdP med SAML-metadata for et nytt Webex SSO-sertifikat.

Før du begynner

Du må eksportere SAML-metadatafilen fra Control Hub før du kan oppdatere Webex Relying Party Trust i ADFS.

1

Logg på ADFS-serveren med administratortillatelser.

2

Last opp SAML-metadatafilen fra Webex til en midlertidig lokal mappe på ADFS-serveren, f.eks. //adfs <org-ID>_servernavn/temp/IDB-meta - -SP.xml.

3

Åpne Powershell.

4

Kjør Get-AdfsRelyingParty Trust for å lese alle avhengige partitillit.

Legg merke til parameteren targetName for Webex-tillitspartiet. Vi bruker eksemplet «Webex», men det kan være annerledes i ADFS.

5

<org-ID>Kjør oppdat erings-adfsrelyingPartyTrust -metadataFile «//adfs_servername/temp/idb-meta- -SP.xml" -targetName "Webex".

Sørg for å erstatte filnavnet og målnavnet med de riktige verdiene fra miljøet ditt.

Se https://docs.microsoft.com/powershell/module/adfs/update-adfsrelyingpartytrust.

Hvis du har lastet ned Webex SP 5-årssertifikatet og har Signerings- eller krypteringssertifikattilbakekall slått på, må du kjøre disse to kommandoene: Set-AdfsRelyingPartyTrust -SigningCertificateRevocationCheck None -EncryptionCertificateRevocationCheck None -TargetName "Webex".

6

Logg på Control Hub, og test deretter SSO-integrasjonen:

  1. Gå til Administrasjon > Sikkerhet > God kjenning.

  2. Gå til IdP i kategorien Identitetsleverand ør og klikk More menu.

  3. Velg Test IdP.

  4. Test SSO-tilkoblingen før du aktiverer den. Dette trinnet fungerer som en tørr kjøring og påvirker ikke organisasjonsinnstillingene før du aktiverer SSO i neste trinn.

    For å se SSO-påloggingsopplevelsen direkte, kan du også klikke Kopier URL til utklippstavlen fra dette skjermbildet og lime den inn i et privat nettleservindu. Derfra kan du gå gjennom på logging med SSO. Dette bidrar til å fjerne all informasjon som er lagret i nettleseren din som kan gi et falskt positivt resultat når du tester SSO-konfigurasjonen.

  5. Logg på for å fullføre testen.

ADFS feilsøking

ADFS-feil i Windows-logger

I Windows-loggene kan du se en ADFS-hendelseslogg feilkode 364. Hendelsesdetaljene identifiserer et ugyldig sertifikat. I disse tilfellene tillates ikke ADFS-verten gjennom brannmuren på port 80 å validere sertifikatet.

Det oppstod en feil under et forsøk på å bygge sertifik atkjeden for tillitsparten

Når du oppdaterer SSO-sertifikatet, du kan få denne feilen når du logger på: Ugyldig statuskode som svar.

Hvis du ser denne feilen, må du sjekke hendelsesvisningsloggene på ADFS-serveren og se etter følgende feil: Det oppstod en feil under et forsøk på å bygge sertifikatkjeden for tillitspartens 'https://idbroker.webex.com/' sertifikat identifisert med tommelavtrykk '754B9208F1F75C5CC122740F3675C5D129471D 80'<org-ID>. Mulige årsaker er at sertifikatet ble tilbakekalt, at sertifikatkjeden ikke kunne verifiseres som angitt av til litspartens innstillinger for tilbakekalling av krypteringssertifikat, eller at sertifikatet ikke er innenfor gyldighetsperioden.

<orgID>Hvis denne feilen oppstår, må du kjøre kommandoene Set-AdfsRely ingPartyTrust -TargetIdentifier https://idbroker.webex.com/ -EncryptionCertificateRevocationCheck None

Føderasjons-ID

Føderasjons-ID-en skiller mellom store og små bokstaver. Hvis dette er organisasjonens e-postadresse, angir du den nøyaktig slik ADFS sender den, ellers finner ikke Webex den samsvarende brukeren.

En egendefinert kravsregel kan ikke skrives for å normalisere LDAP-attributtet før det sendes.

Importer metadataene dine fra ADFS-server en du konfigurerer i miljøet.

Du kan bekrefte URL-adressen om nødvendig ved å navigere til Service > Endpoints > Metadata > Type: Federation Met adata i ADFS Management.

Tidssynkronisering

Forsikre deg om at ADFS-serverens systemklokke er synkronisert med en pålitelig Internett-tidskilde som bruker Network Time Protocol (NTP). Bruk følgende PowerShell-kommando til å skru klokken bare for Webex Relying Party Trust-forholdet.

Set-AdfsRelyingPartyTrust -TargetIdentifier "https://idbroker.webex.com/$ENTITY_ID_HEX_VALUE" -NotBeforeSkew 3

Den heksadesimale verdien er unik for miljøet ditt. Erstatt verdien fra SP EntityDescriptor ID-verdien i Webex-metadatafilen. For eksempel:

<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/c0cb726f-a187-4ef6-b89d-46749e1abd7a">

Var denne artikkelen nyttig?
Var denne artikkelen nyttig?