Ondersteuning voor Webex-cloud-Verbonden UC-adreslijstservice

U kunt gebruikers synchroniseren en beheren vanuit de cloud Active Directory (bijvoorbeeld Azure AD) naar op locatie of in de cloud gehoste UC-infrastructuur zoals Cisco Unified Communications Manager (Unified Communications Manager) en Cisco Unity Connection (Unity Connection) met de Webex-cloud-Connected UC-adreslijstservice. Tijdens de synchronisatie importeert het systeem een lijst met gebruikers en bijbehorende gebruikersgegevens uit de Azure Active Directory (of een vergelijkbare Cloud Directory-service) die is gesynchroniseerd in de Webex Common Identity-service. U moet in Control Hub het Unified CM-cluster selecteren dat moet worden gesynchroniseerd, de juiste Unified CM -gebruikers- Id -veldtoewijzing selecteren en vervolgens de vereiste synchronisatieovereenkomst selecteren om de synchronisatie uit te voeren.

Vereiste

Onboard de Unified CM -clusters voor Cloud-Connected UC. Zie Cloud-verbonden UC instellen voor apparaten op locatie
Azure Active Directory -gebruikers synchroniseren met Control Hub
Unified Communications Manager-clusters moeten versie 11.5(1)SU9, 12.5(1)SU4 of 14 en hoger zijn

Adreslijstservice adreslijstservice

U moet de adreslijstservice activeren voor elk cluster in Webex-cloud- Connected UC om synchronisatie en beheer van gebruikers vanuit de cloud naar Unified Communications Manager mogelijk te maken.

Directoryservice is standaard niet ingeschakeld voor alle ingebouwde clusters.

1	Ga vanuit de klantweergave in Control Hub naar Services > Verbonden UC. Klik op de kaart UC-beheer op Inventaris. De lijst met clustergroepen wordt weergegeven met de beschrijving, status, clusters en knooppunten.
2	Klik op Details naast de clustergroep waartoe het knooppunt behoort. De pagina Inventaris wordt weergegeven met de lijst met clusters die bij de geselecteerde clustergroep horen.
3	Klik op Details naast het cluster waartoe het specifieke productknooppunt behoort. De naam van het knooppunt met de versie, het product en de status wordt weergegeven.
4	Klik op het ellipsvormige ⋮-pictogram naast Evenementgeschiedenis en kies Servicebeheer. De pagina Servicebeheer wordt weergegeven met de lijst met services.
5	Gebruik de schakelknop om de Adreslijstservice .
6	Klik op Verzenden.

Adreslijstservice

Gebruik de adreslijstservicekaart om gebruikers uit cloudtelefoonboeken te synchroniseren met Unified Communications Manager.

1	Ga vanuit de klantweergave in Control Hub naar Services > Verbonden UC.
2	Klik op de kaart Adreslijstservice op Clusters weergeven . De pagina Directoryservice wordt weergegeven.

U kunt de lijst met clusterdetails op deze pagina weergeven.

Clusterdetails weergeven

Kies op de pagina Clusterselectie in Adreslijstservice een cluster waarmee u de gebruikersgegevens wilt synchroniseren.

De pagina Clusterselectie bevat ook de clusterdetails, de inrichtingsstatus, de laatste synchronisatiestatus, het gekoppelde product en de eventuele reden voor de fout. U kunt de lokale tijdzone selecteren; standaard is de tijdzone van de browser geselecteerd.


Clusterdetails	Beschrijving
Clusternaam	De naam van het cluster.
Status	Status van synchronisatie.
Laatst gesynchroniseerd	Datum van de laatste synchronisatie.
Product	Details van het product.

Directoryservice-synchronisatie inrichten

Met Webex-cloud-Connected UC-adreslijstservice-synchronisatie kunt u eindgebruiker importeren van Webex Common Identity Service in de Unified Communications Manager-database om deze weer te geven in het venster Configuratie voor eindgebruikers.

Zorg ervoor dat u geen inrichtingsbewerkingen uitvoert tijdens de geplande upgrade van de Webex-cloud-Connected UC-module.

Als u een inrichting uitvoert tijdens de upgrade van de module, kunnen in stap 1, 2 of 3 na een bepaalde periode foutstatussen worden weergegeven en wordt de knop Opnieuw proberen na enige tijd weergegeven. U kunt de inrichting opnieuw starten door de Opnieuw proberen knop. Zorg ervoor dat u de clusterstatus voor het voltooien van de upgrade verifieert voordat u opnieuw probeert in te richten.

Kies op de pagina Clusterselectie in Adreslijstservice een cluster dat u wilt inrichten voor het inschakelen van synchronisatie.

Klik op Inrichting starten .

Zorg er in het configuratievenster voor dat de toewijzing die is gekozen voor het veld Unified CM -gebruikers- Id de gebruiker binnen het cluster op unieke wijze identificeert nadat u de inrichting hebt gestart.

Kies de juiste Unified CM -gebruikers- Id -veldtoewijzing voor het synchroniseren van de gebruiker vanuit Webex.

Het veld Gebruikers-id in Unified CM wordt toegewezen aan de e-mail-id van de gebruiker in Webex.
Het veld Mail-id in Unified CM wordt toegewezen aan de e-mail-id van de gebruiker in Webex.

Het veld Gebruikers-id in Unified CM wordt toegewezen aan de e-mail-id zonder het domeingedeelte van de gebruiker in Webex.

Er wordt een nieuw gebruikersaccount gemaakt als de toewijzing niet kan worden uitgevoerd voor een bestaand gebruikersaccount in Unified CM. De e-mail-id (of het id-gedeelte van de e-mail-id) van de gebruiker wordt gebruikt als unieke id voor het nieuwe gebruikersaccount.

Klik op Volgende.

Selecteer een overeenkomst in de vervolgkeuzelijst om een nieuwe synchronisatieovereenkomst te maken.

Zodra de nieuwe synchronisatieovereenkomst is gemaakt, worden alle bestaande synchronisatieovereenkomsten verwijderd die naar de adreslijst op locatie. Nadat de nieuwe synchronisatieovereenkomst is gemaakt, kunt u wijzigingen erin aanbrengen.

Bekijk in het gedeelte Voorbeeld van overeenkomst de details van de overeenkomst (bestaande details van de externe LDAP-namenlijst die beschikbaar zijn in Unified Communications Manager) voordat u de synchronisatie start.

U kunt de volgende details bekijken:

Informatie over groep
Groepssjabloon voor toegepaste functies met universele lijn- en apparaatsjablonen
Lijn- en maskergegevens voor gesynchroniseerde telefoonnummers voor ingevoegde gebruikers
Nieuw ingerichte gebruikers en hun toestellen
Het gedeelte Standaardgebruikersvelden die moeten worden gesynchroniseerd
Hostnaam of IP-adres van de adreslijstserver

Klik op Volgende om het groepsfilter te selecteren.

Selecteer in de vervolgkeuzelijst Groepen selecteren de specifieke groep(en) die u wilt synchroniseren. Klik op het selectievakje Alle groepen selecteren als u alle gebruikersgroepen wilt selecteren.

Standaard worden alle gebruikers gesynchroniseerd. Als u geen groep selecteert, worden automatisch alle gebruikers en de bijbehorende gebruikersgegevens gesynchroniseerd.

Voor geneste groepen in een adreslijst moeten gebruikers specifiek de gebruikersgroep in de subset selecteren tijdens het inrichten, omdat deze niet standaard wordt opgenomen in de bovenliggende groep. U moet controleren of er sprake is van herhalend nesten om ervoor te zorgen dat alleen de vereiste gebruikers worden opgenomen tijdens het inrichten.

Wijzigingen in de synchronisatieovereenkomst, bijvoorbeeld het verwijderen van een doelgebruiker of -groep, worden niet doorgegeven tijdens de periodieke synchronisatie. U moet de adreslijstservice voor dat cluster uitschakelen via Control Hub en het cluster vervolgens opnieuw inrichten met de nieuwe of gewijzigde synchronisatieovereenkomst.

Klik op Volgende om het synchronisatieproces voor te bereiden.

Schakel de synchronisatie in het venster Synchronisatie inschakelen in zodra het systeem de gebruikersgegevens in een tijdelijke opslagruimte in Unified CM heeft gekopieerd en er een nieuwe synchronisatieovereenkomst is gemaakt (na stap 1 en 2, zoals in de onderstaande schermafbeelding).

De Rapport downloaden Met de downloadoptie kunt u de resultaten gedeeltelijk weergeven. Als u de volledige rapporten voor het Unified CM-cluster wilt ophalen, voert u de volgende CLI-opdracht uit: bestand ophalen activelog /cm/trace/CIService/log4j/DryRunResults.csv . Hier toont het resultaat van de testrun voor Unified CM het volgende:

Nieuwe gebruikers —Gebruikers aanwezig op Webex Identity-service en niet aanwezig in Unified CM -database
Overeenkomende gebruikers —Gebruikers aanwezig op Webex Identity-service en in Unified CM -database
Niet-overeenkomende gebruikers —Gebruikers aanwezig in Unified CM -database, maar niet aanwezig in Webex Identity-service

U kunt het rapport bekijken en beslissen of u dezelfde lijst met gebruikers wilt behouden en gebruikers wilt toevoegen of verwijderen. Op basis van de beslissing kunt u het proces stoppen en de inrichtingswijzigingen ongedaan maken.

Alle updates die zijn aangebracht in de gebruikersgegevens in de clouddirectory na adreslijstsynchronisatie, worden bijgewerkt in de volgende synchronisatieperiode. Dit komt omdat de clouddirectory periodiek één keer per dag wordt gesynchroniseerd.

Klik na de verificatie van de synchronisatieovereenkomst op Voorbeeld in Unified CM om u aan te aanmelden bij uw op locatie infrastructuur en wijzigingen aan te brengen in de zojuist gemaakte synchronisatieovereenkomst.

VPN toegang is vereist.

U kunt de groepsgegevens alleen voor Unified CM bewerken. U kunt de overeenkomst niet hernoemen en de details niet wijzigen.

Schakel het selectievakje in om akkoord te gaan met de voorwaarden dat de synchronisatieovereenkomst is gecontroleerd en geverifieerd in Unified CM.

Klik op Synchronisatie inschakelen om de synchronisatie te vervolgen.

U kunt pas weer actie ondernemen als de synchronisatie is voltooid. Zodra de synchronisatie voor een bepaald cluster is voltooid, wordt dit cluster weergegeven op de pagina Directory Service met de status Ingericht. Op dit moment hebt u Azure AD toestemming gegeven om Webex-gebruikers in te richten en deze te synchroniseren in de UC-infrastructuur en hebt u de stappen voor het instellen van de synchronisatie voltooid.

Nadat de eerste inrichting is voltooid, vindt er elke 24 uur een periodieke synchronisatie plaats. Alle wijzigingen die in de clouddirectory zijn aangebracht, worden tijdens deze periode doorgevoerd in de clusters.

U moet de synchronisatie inschakelen binnen 20 uur vanaf het moment dat de nieuwe overeenkomst is gemaakt. Gebruikers die zijn gesynchroniseerd met LDAP, worden inactief en worden na 24 uur inactiviteit verwijderd. Gebruikers kunnen zich niet aanmelden en de Unified CM-services niet gebruiken.

Nadat de Azure AD-inrichting voor een bepaald cluster is voltooid, kunt u geen nieuwe synchronisatieovereenkomsten maken of configuratie-instellingen voor hetzelfde cluster wijzigen, behalve voor de groepsinstellingen. Als u een nieuwe synchronisatieovereenkomst voor hetzelfde cluster wilt maken, gaat u naar de pagina Servicebeheer en schakelt u de adreslijstservice uit. Daarna kunt u een nieuwe overeenkomst voor inrichting maken.

Als de synchronisatie om welke reden dan ook mislukt, worden de nieuwste inrichtingswijzigingen de volgende dag doorgevoerd in de volgende synchronisatieperiode.

Als u na de inrichting Azure IdP gebruikt tijdens de SSO-verificatie, moet u de juiste claims configureren in Azure IdP. Als tijdens het inrichten bijvoorbeeld optie 1 is geselecteerd voor de gebruikers-id-toewijzing, moet u ervoor zorgen dat: user.userprincipalname is ingesteld als de UID in het gedeelte 'Aanvullende claims'.
De volgende kenmerken worden gesynchroniseerd vanuit de Webex Common Identity-service naar Unified Communications Manager: gebruikersnaam, e-mailadressen, naam, displayName, titel, telefoonnummers, afdeling, manager.
Alle updates die zijn aangebracht in de gebruikersgegevens in de clouddirectory na adreslijstsynchronisatie, worden bijgewerkt in de volgende synchronisatieperiode. Dit komt omdat de clouddirectory periodiek één keer per dag wordt gesynchroniseerd.
Eenmalige aanmelding (SSO) moet worden gebruikt voor aanmeldingen. Dit document gaat alleen over de integratie van eenmalige aanmelding (SSO).
Voordat u een cluster opnieuw inricht vanuit Control Hub, raden we u aan de Dirsync-service handmatig te stoppen vanuit de Cisco Unified-services GUI.
Als u na het opnieuw inrichten ziet dat de gebruikers die zijn gemarkeerd als Niet-overeenkomende gebruikers hetzelfde zijn als Nieuwe gebruikers (gebruikers met dezelfde e-mail- Id), raden we u aan maximaal 48 uur te wachten voordat de synchronisatiewijzigingen van kracht worden. Als u de bijgewerkte wijzigingen onmiddellijk wilt zien, moet u het volgende uitvoeren voordat u de inrichting opnieuw inricht:
1. Schakel de . uit Adreslijstservice vanaf de pagina Servicebeheer in Control Hub.
2. Verwijder de Webex Common Identity Service-synchronisatieovereenkomst uit Unified CM.
3. Schakel de . uit Synchroniseren vanaf LDAP server inschakelen op de pagina LDAP -systeemconfiguratie in de gebruikersinterface van Cisco Unified CM-beheer .
4. Verwijder de eindgebruikers uit het venster Eindgebruiker.
5. Schakel de . in Adreslijstservice vanaf de pagina Servicebeheer in Control Hub.

Inrichtingsstatus

Op het Directory Service-dashboard kunt u de status van uw cluster weergeven en volgen en fouten bekijken.

De volgende tabel bevat de inrichtingsstatus, beschrijving en de bijbehorende acties.

Tabel 1. Inrichtingsstatus
Inrichtingsstatus	Beschrijving
Verwerken	De inrichting wordt bezig.
Vereiste actie	Voer de nodige stappen uit als er handmatige tussenkomst is vereist voor een bepaald cluster. Bijvoorbeeld: Als u wilt doorgaan of de synchronisatie wilt afbreken na een testuitvoering. Nadat de nieuwe overeenkomst is gemaakt, controleert u of er meldingen zijn en onderneemt u de eventuele benodigde acties.
Fout	Als er vereiste actie in de wizard 'Synchronisatie inschakelen', vinkt u deze aan en voert u indien nodig de nodige acties uit. In het geval van fouten tijdens de inrichtingsfasen, moet de beheerder de Gebeurtenisgeschiedenis pagina in Cisco Webex Control Hub voor de service: Adreslijstservice . Dit helpt u bij het isoleren, opsporen en oplossen van mogelijke problemen. Zie voor toegang tot gebeurtenissen Toegang tot de gebeurtenisgeschiedenis voor hybride services . Zie de tabel 'Gebeurtenissen en mogelijke oplossingen' hieronder voor meer informatie over de verschillende gebeurtenistypen en hun details.
Beschikbaar	Het inrichten van het cluster is voltooid.
Niet ingericht	Het inrichten van het cluster is nog niet begonnen.

Tabel 2. Gebeurtenissen en resoluties
Gebeurtenissen	Vereiste actie
Periodieke synchronisatie mislukt	Zorg ervoor dat u wacht tot de periodieke synchronisatie van de volgende dag is voltooid. Controleer of de synchronisatie is voltooid. Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.
Fout bij kopiëren van gegevens	Klik op Opnieuw proberen om de gegevensoverdracht voort te zetten. Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.
Synchronisatieovereenkomst mislukt	Klik op Opnieuw proberen om de synchronisatieovereenkomst opnieuw te maken. Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.
Periodieke synchronisatie overslaan	Geen actie vereist.
Gegevensoverdracht is mislukt	Klik op Opnieuw proberen om de gegevensoverdracht voort te zetten. Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.
Gebruikerssynchronisatie komt niet overeen	Controleer de logboeken voor adreslijstsynchronisatie in Unified CM op fouten in de gebruikerssynchronisatie of neem contact op met Cisco TAC ondersteuning voor meer hulp.
Gebruikers zijn ingericht	Geen actie vereist.
Gegevensoverdracht periodieke synchronisatie is geslaagd	Geen actie vereist.
Kan gebruikersgegevens van sommige geselecteerde groepen niet ophalen uit Webex Common Identity.	Navigeer naar de Dashboard en selecteer het cluster om de details van de mislukte groepen op te halen door op de meegeleverde downloadkoppeling te klikken. Controleer of de gebruikers aanwezig zijn in Webex Common Identity en klik op Opnieuw proberen . Neem contact op met Cisco TAC ondersteuning voor meer hulp.
Kan gebruikersgegevens van alle geselecteerde groepen niet ophalen uit Webex Common Identity.	Klik op Opnieuw proberen om de gegevensoverdracht voort te zetten. Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning voor verdere hulp.

Synchronisatieproblemen oplossen

Dit gedeelte bevat de noodzakelijke informatie en oplossingen voor enkele veelvoorkomende problemen die u kunt tegenkomen in de verschillende fasen van het synchroniseren van gebruikers van Control Hub naar de Unified Communications Manager-database.

Niet-overeenkomende gebruikers

Als u niet-overeenkomende gebruikers ziet, schakelt u synchronisatie in binnen 20 uur nadat de nieuwe overeenkomst is gemaakt. De bestaande gebruikers worden gemarkeerd als inactief en worden na 24 uur inactiviteit verwijderd uit Unified CM.

Fout: gegevens kopiëren is mislukt. Probeer het opnieuw.

De communicatie tussen de met de cloud verbonden UC en de Webex -cloud is onderbroken of kan geen gebruikersgegevens ophalen uit de Webex -cloud.

Oplossing: Als u wilt controleren of uw verbinding met Cisco Cloud is gelukt, controleert u de status van deze services op: https://status.webex.com/. Klik op Opnieuw proberen .
De communicatie tussen Cloud-Connected UC en Unified CM is onderbroken of kan geen gebruikersgegevens naar de Unified CM -database pushen.

Oplossing: Controleer de netwerkconnectiviteit tussen Cloud-Connected UC en Unified CM en klik op Opnieuw proberen . Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.

Fout: kan de synchronisatieovereenkomst niet maken. Probeer het opnieuw.

De communicatie tussen Cloud-Connected UC en Unified CM is onderbroken of kan de gegevens van de synchronisatieovereenkomst niet naar de Unified CM -database pushen.

Oplossing: Controleer de netwerkconnectiviteit tussen Cloud-Connected UC en Unified CM en klik op Opnieuw proberen . Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.
De synchronisatieovereenkomst is niet gemaakt.

Fout: kan adreslijstsynchronisatie niet inschakelen. Probeer het opnieuw.

De communicatie tussen Cloud-Connected UC en Unified CM is onderbroken en de Cisco DirSync-service wordt niet geactiveerd.

Oplossing: Controleer de netwerkconnectiviteit tussen Cloud-Connected UC en Unified CM en klik op Opnieuw proberen . Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.

Kan de details van de synchronisatieovereenkomst niet ophalen. Probeer het over enige tijd opnieuw.

De communicatie tussen Cloud-Connected UC en Unified CM is onderbroken.

Oplossing: Controleer de netwerkconnectiviteit tussen Cloud-Connected UC en Unified CM en klik op Opnieuw proberen . Als het probleem zich blijft voordoen, neemt u contact op met Cisco TAC ondersteuning.

Kan gebruikersgegevens voor geselecteerde groepen niet ophalen

Tijdens de eerste inrichting kunt u problemen ondervinden bij het downloaden van gebruikersgegevens uit de specifieke groep(en) die u hebt geselecteerd voor synchronisatie. Klik in het foutmelding op de downloadkoppeling om details van de mislukte groepsinformatie weer te geven.

U kunt ook informatie over mislukte groepen downloaden voor clusters die al zijn ingericht via de Gebeurtenisgeschiedenis pagina in Cisco Webex Control Hub. Navigeer naar de Dashboard en selecteer het cluster om de details van de mislukte groepen op te halen door op de meegeleverde downloadkoppeling te klikken. Controleer of de gebruikers aanwezig zijn in Webex Common Identity en klik op Opnieuw proberen . Neem contact op met Cisco TAC ondersteuning voor meer hulp.

Bekende problemen en beperkingen voor synchronisatie van Webex-cloud-Connected UC adreslijstservice

Als u een probleem met deze functie ondervindt, controleert u of het een bekend probleem is en of we een aanbevolen tijdelijke oplossing hebben.

U kunt de adreslijstservice voor een cluster uitschakelen via Control Hub en vervolgens de cluster opnieuw inschakelen. We raden u aan ten minste 60 seconden te wachten voordat u de adreslijstservice activeert voor synchronisatie.
Als u na het verwijderen hetzelfde Unified CM-cluster opnieuw wilt inschakelen voor de organisatie, moet u eerst de adreslijstservice uitschakelen en vervolgens hetzelfde cluster opnieuw inrichten.
Tijdens het inrichten wordt de lijst met groepsgegevens niet ingevuld vanwege synchronisatieproblemen met de Webex Common Identity-service. Gebruikers wordt aangeraden de inrichting af te breken en het na enige tijd opnieuw te proberen.