In dit artikel
dropdown icon
Hub voor eenmalige aanmelding en controle
    Profielen
    NameID-formaat
    Eén keer uitloggen
Integreer de Control Hub met Shibboleth
Download de Webex-metagegevens naar uw lokale systeem
Autorisatie configureren in Shibboleth-bestanden
Componenten van de Shibboleth-serviceprovider configureren voor SAML-bevestiging
Configureer de assertiekenmerken
Importeer de metagegevens van de IdP en schakel eenmalige aanmelding in na een test
Configureer eenmalige aanmelding in de Control Hub met Shibboleth
list-menuIn dit artikel
list-menuFeedback?

U kunt een Single Sign-On (SSO) -integratie configureren tussen Control Hub en een implementatie die Shibboleth als identiteitsprovider (IdP) gebruikt.

Hub voor eenmalige aanmelding en controle

Single sign-on (SSO) is een sessie- of gebruikersauthenticatieproces waarbij een gebruiker inloggegevens kan verstrekken voor toegang tot een of meer toepassingen. Het proces verifieert gebruikers voor alle toepassingen waarvoor ze rechten hebben gekregen. Het elimineert verdere prompts wanneer gebruikers tijdens een bepaalde sessie van toepassing wisselen.

Het Security Assertion Markup Language (SAML 2.0) Federation Protocol wordt gebruikt voor SSO-authenticatie 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 heeft de POST -> POST-binding geïnitieerd

  • SP heeft REDIRECT -> POST-binding geïnitieerd

NameID-formaat

Het SAML 2.0-protocol ondersteunt verschillende NameID-formaten om over een specifieke gebruiker te communiceren. De Webex-app ondersteunt de volgende NameID-formaten.

  • 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 IdP laadt, is de eerste invoer geconfigureerd voor gebruik in Webex.

Eén keer uitloggen

De Webex-app ondersteunt één uitlogprofiel. In de Webex-app kan een gebruiker zich afmelden bij de toepassing, die het SAML-protocol voor eenmalige uitloging gebruikt om de sessie te beëindigen en die uitloggen te bevestigen bij uw IdP. Zorg ervoor dat uw IdP is geconfigureerd voor SingleLogout.

Integreer de Control Hub met Shibboleth

De configuratiehandleidingen geven een specifiek voorbeeld van SSO-integratie, maar bieden geen volledige configuratie voor alle mogelijkheden. De integratiestappen voor nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transientzijn bijvoorbeeld gedocumenteerd. Andere formaten, zoals urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified or urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddressWill, zijn geschikt voor SSO-integratie, maar vallen buiten het bereik van onze documentatie.

Stel deze integratie in voor gebruikers in uw Webex-organisatie (waaronder de Webex-app en andere services die worden beheerd in Control Hub). Webex Meetings Als uw Webex-site is geïntegreerd in Control Hub, neemt de Webex-site het gebruikersbeheer over. Als u op deze manier geen toegang Webex Meetings hebt en dit niet wordt beheerd in de Control Hub, moet u een afzonderlijke integratie uitvoeren om SSO in te schakelen voorWebex Meetings.

De integratiestappen verwijzen naar Shibboleth 2.4.5 in CentOS 7 met Tomcat 7 als webserver.

Voordat u begint

Voor SSO en Control Hub moeten binnenlandse ontheemden voldoen aan de SAML 2.0-specificatie. Bovendien moeten IDP's op de volgende manier worden geconfigureerd:

Download de Webex-metagegevens naar uw lokale systeem

1

Meld u aan bij Control Hub.

2

Ga naar Beheer > Beveiliging > Authenticatie.

3

Ga naar het tabblad Identiteitsprovider en klik op SSO activeren.

4

Selecteer een IdP.

5

Kies het certificaattype voor uw organisatie:

  • Zelf ondertekend door Cisco — We raden deze keuze aan. Laat ons het certificaat ondertekenen, zodat u het maar eens in de vijf jaar hoeft te verlengen.
  • Ondertekend door een openbare certificeringsinstantie — Veiliger, maar u moet de metagegevens regelmatig bijwerken (tenzij uw IdP-leverancier vertrouwensankers ondersteunt).

Vertrouwensankers zijn openbare sleutels die fungeren als een autoriteit om het certificaat van een digitale handtekening te verifiëren. Raadpleeg de documentatie van uw IdP voor meer informatie.

6

Download het bestand met metagegevens.

<org-ID>De bestandsnaam van de Webex-metagegevens is idb-meta--SP.xml.

Autorisatie configureren in Shibboleth-bestanden

Nadat u Shibboleth hebt geïnstalleerd, krijgt u configuratiebestanden met voorbeelden.

1

Ga naar de directory /opt/shibboleth-idp/conf om toegang te krijgen tot de voorbeeldbestanden.

2

Bepaal welke autorisatiemethode u wilt gebruiken, bijvoorbeeld via LDAP-binding. Active Directory

3

Bewerk het bestand handler.xml als volgt:

Geen commentaar

    <!--  Username/password login handler -->
    <ph:LoginHandler xsi:type="ph:UsernamePassword"
                  jaasConfigurationLocation="file:///opt/shibboleth-idp/conf/login.config">  
  <ph:AuthenticationMethod>urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport
</ph:AuthenticationMethod>
    </ph:LoginHandler>

Commentaar

<ph:LoginHandler xsi:type="ph:RemoteUser"> 
<ph:AuthenticationMethod>urn:oasis:names:tc:SAML:2.0:ac:classes:unspecified</ph:AuthenticationMethod>
    </ph:LoginHandler>
4

Vul uw gegevens in Active Directory om de authenticatie mogelijk te maken. Geef de configuratie van het bestand login.config.

ShibUserPassAuth {
   edu.vt.middleware.ldap.jaas.LdapLoginModule required
      ldapUrl="ldap://ad0a.cisco.net:389"
      ssl="false"
      tls="false"
      baseDn="cn=Users,dc=cisco,dc=net"
      subtreeSearch="true"
      userFilter="sAMAccountName={0}"
      bindDn="cn=Administrator,cn=Users,dc=cisco,dc=net"
      bindCredential="ThePassword";
};

Componenten van de Shibboleth-serviceprovider configureren voor SAML-bevestiging

1

Voeg het bestand dat u hebt gedownload van de Webex SP toe aan de map /opt/shibboleth-idp/metadata.

2

Bewerk het bestand relying-party.xml; voeg na de DefaulteLyingParty-tag de gegevens van de SAML-bevestiging voor Webex toe.

 <rp:RelyingParty id="https://idbroker.webex.com/ea7c1420-711d-4916-95f8-
22de53230d1e"
              provider="https://shib9a.cisco.net/idp/shibboleth"
              defaultSigningCredentialRef="IdPCredential">
            <rp:ProfileConfiguration xsi:type="saml:SAML2SSOProfile"
                includeAttributeStatement="true"
                assertionLifetime="PT5M" assertionProxyCount="0"
                signResponses="never" signAssertions="always"
                encryptAssertions="conditional" encryptNameIds="never"
                includeConditionsNotBefore="true"/>
        </rp:RelyingParty>

Voor id moet u de EntityID-waarde uit het Webex-metagegevensbestand gebruiken. Vervang de ID van het voorbeeld door de EntityID van uw organisatie.

3

Voeg in de tag Metadata:MetadataProvider de locatie van het bestand toe:

 <metadata:MetadataProvider id="ShibbolethMetadata" xsi:type="metadata:Chaini
ngMetadataProvider">
        <metadata:MetadataProvider id="IdPMD" xsi:type="metadata:FilesystemMetad
ataProvider" metadataFile="/opt/shibboleth-idp/metadata/idp-metadata.xml" maxRefreshDelay="P1D" />
    <!--     Cisco UCXN Configuration               -->
   <metadata:MetadataProvider xsi:type="FilesystemMetadataProvider" xmlns="urn:m
ace:shibboleth:2.0:metadata" id="ucxn9a" metadataFile="/opt/shibboleth-idp/metad
ata/ucxn9a-single-agreement.xml" />
    <!--     Cisco CUCM Configuration               -->
   <metadata:MetadataProvider xsi:type="FilesystemMetadataProvider" xmlns="urn:m
ace:shibboleth:2.0:metadata" id="cucm9a" metadataFile="/opt/shibboleth-idp/metad
ata/cucm9a.cisco.net-single-agreement.xml" />
    <!--     Cisco CI Configuration               
   <metadata:MetadataProvider xsi:type="FilesystemMetadataProvider" xmlns="urn:m
ace:shibboleth:2.0:metadata" id="CI" metadataFile="/opt/shibboleth-idp/metadata/
idb-meta-ea7c1420-711d-4916-95f8-22de53230d1e-SP.xml" />
    </metadata:MetadataProvider>

De SP-metagegevens zijn afkomstig van een bestand in het Shibboleth-bestandssysteem, op de locatie waar u de metagegevens voor uw Webex-organisatie hebt geüpload.

Configureer de assertiekenmerken

1

Geef in de sectie Data Connector aan waar u de kenmerken van uw gebruikers kunt ophalen.

Active Directory, met een id van myLDAP.

<resolver:DataConnector id="MyLDAP" xsi:type="dc:LDAPDirectory"
      ldapURL="ldap://ad0a.cisco.net:389"
      baseDN="cn=Users,dc=cisco,dc=net"
      principal="Administrator@cisco.net"
      principalCredential="ThePassword">
        <dc:FilterTemplate>
            <![CDATA[
                (sAMAccountName=$requestContext.principalName)
            ]]>
        </dc:FilterTemplate>
    </resolver:DataConnector>

2

Bewaar in de sectie Attribuutdefinitie wat al in de configuratie voor TransientID staat.

3

Voeg het extra attribuut toe dat de SP verwacht, en bepaal in de attribuutbron waarnaar het wordt toegewezen.

Koppel het kenmerk mail (e-mailadres, attribuut inActive Directory) aan uid (UserID in Webex).

<resolver:AttributeDefinition id="mail-attr" xsi:type="ad:Simple" 
sourceAttributeID="mail">
        <resolver:Dependency ref="MyLDAP" />
        <resolver:AttributeEncoder xsi:type="enc:SAML2String" name="uid" />
     </resolver:AttributeDefinition>

4

Definieer in het bestand attribute-filter.xml welk kenmerk aan elke SP-overeenkomst moet worden toegevoegd.

Geef Webex het uid-kenmerk dat wordt toegewezen aan het e-mailadres van de gebruiker.

Geef de kenmerk-uid vrij voor de SP-overeenkomst met Webex.

<!--  Release the attributes to cisco CI Cloud  -->
    <afp:AttributeFilterPolicy id="ReleaseToCI">
        <afp:PolicyRequirementRule xsi:type="basic:AttributeRequesterString" 
value="https://idbroker.webex.com/ea7c1420-711d-4916-95f8-22de53230d1e" />
        <afp:AttributeRule attributeID="transientId">
            <afp:PermitValueRule xsi:type="basic:ANY"/>
        </afp:AttributeRule>
        <afp:AttributeRule attributeID="mail-attr">
            <afp:PermitValueRule xsi:type="basic:ANY" />
        </afp:AttributeRule>
    </afp:AttributeFilterPolicy>

De regel die u in attribute-resolver.xml hebt gemaakt, moet een beleid bevatten om het kenmerk mail-attr vrij te geven aan de EntityID die overeenkomt met Webex.

5

Download het metagegevensbestand van de Shibboleth-server in /opt/shibboleth-idp/metadata. De bestandsnaam is idp-metadata.xml.

Importeer de metagegevens van de IdP en schakel eenmalige aanmelding in na een test

Nadat u de Webex-metagegevens hebt geëxporteerd, uw IdP hebt geconfigureerd en de IdP-metagegevens naar uw lokale systeem hebt gedownload, bent u klaar om deze via Control Hub in uw Webex-organisatie te importeren.

Voordat u begint

Test de SSO-integratie niet via de interface van de identiteitsprovider (IdP). We ondersteunen alleen door Service Providers geïnitieerde (door de SP geïnitieerde) flows, dus u moet voor deze integratie de Control Hub SSO-test gebruiken.

1

Kies er een:

  • Ga terug naar de selectiepagina van Control Hub — certificaten in uw browser en klik vervolgens op Next.
  • Open de Control Hub opnieuw als deze niet meer geopend is op het tabblad van uw browser. Ga vanuit de klantenweergave in Control Hub naar Beheer > Beveiliging > Authenticatie, selecteer de IdP en kies vervolgens Acties > Metagegevens importeren.
2

Op de pagina Metagegevens van IdP importeren sleept u het metagegevensbestand van de IdP naar de pagina of gebruikt u de optie Bestandsbrowser om het metagegevensbestand te vinden en te uploaden. Klik op Volgende.

Als u kunt, moet u de optie Veiliger gebruiken. Dit is alleen mogelijk als uw IdP een openbare CA heeft gebruikt om de metagegevens te ondertekenen.

In alle andere gevallen moet u de optie Minder veilig gebruiken. Dit geldt ook als de metagegevens niet zijn ondertekend, zelf ondertekend of ondertekend door een particuliere CA.

Okta ondertekent de metagegevens niet, dus moet u Less secure kiezen voor een Okta SSO-integratie.

3

Selecteer SSO-instellingen testen en als er een nieuw browsertabblad wordt geopend, verifieer u dan met de IdP door u aan te melden.

Als u een authenticatiefout krijgt, is er mogelijk een probleem met de inloggegevens. Controleer de gebruikersnaam en het wachtwoord en probeer het opnieuw.

Een fout in de Webex-app betekent meestal een probleem met de SSO-installatie. Doorloop in dat geval de stappen opnieuw, vooral de stappen waarbij u de metagegevens van de Control Hub kopieert en plakt in de IdP-configuratie.

Om de SSO-aanmeldingservaring rechtstreeks te zien, kunt u in dit scherm ook op URL naar klembord kopiëren klikken en deze in een privébrowservenster plakken. Van daaruit kunt u het inloggen met SSO doorlopen. Deze stap stopt valse positieven vanwege een toegangstoken dat zich mogelijk in een bestaande sessie bevindt nadat u zich hebt aangemeld.

4

Ga terug naar het tabblad van de Control Hub-browser.

  • Als de test succesvol was, selecteer dan Succesvolle test. Zet SSO aan en klik op Volgende.
  • Als de test niet succesvol was, selecteer dan Mislukte test. Schakel SSO uit en klik op Next.

De SSO-configuratie wordt niet van kracht in uw organisatie, tenzij u het eerste keuzerondje kiest en SSO activeert.

Wat nu te doen

Gebruik de procedures in Okta-gebruikers synchroniseren Cisco Webex Control Hub als u gebruikers vanuit Okta naar de Webex-cloud wilt inrichten.

Gebruik de procedures in Microsoft Entra ID-gebruikers synchroniseren naar Cisco Webex Control Hub als u gebruikers vanuit Entra ID naar de Webex-cloud wilt inrichten.

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 de beste praktijken voor het verzenden van communicatie naar gebruikers in uw organisatie.

Vond u dit artikel nuttig?
Vond u dit artikel nuttig?