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 Unity Connection-cluster selecteren dat moet worden gesynchroniseerd, de juiste veldtoewijzing voor Unity Connection-gebruikers- Id selecteren en vervolgens de vereiste synchronisatieovereenkomst selecteren om de synchronisatie uit te voeren.

Vereiste

Onboard de Unity Connection-clusters voor Cloud-Connected UC. Zie Cloud-verbonden UC instellen voor apparaten op locatie
Azure Active Directory -gebruikers synchroniseren met Control Hub
Unity Connection-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 van de cloud naar Unity Connection 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 te synchroniseren vanuit cloudgebaseerde telefoonboeken naar Unity Connection.

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 Unity Connection-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 Gebruikers- Id voor Unity -verbinding de gebruiker binnen het cluster op unieke wijze identificeert nadat u de inrichting hebt gestart.

Kies de juiste Unity Connection-gebruikers- Id -veldtoewijzing voor het synchroniseren van de gebruiker vanuit Webex:

Het veld Gebruikers- Id in Unity Connection wordt toegewezen aan de e-mail- Id van de gebruiker in Webex.
Het veld E-mail- Id in Unity Connection wordt toegewezen aan de e-mail- Id van de gebruiker in Webex.

Het veld Gebruikers- Id in Unity Connection wordt toegewezen aan de e-mail- Id zonder domeingedeelte van de gebruiker in Webex.

Er wordt een nieuw gebruikersaccount gemaakt als de toewijzing niet kan worden uitgevoerd voor een bestaand gebruikersaccount in Unity Connection. 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 gegevens van de externe LDAP-namenlijst die beschikbaar zijn in Unity Connection) 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 in het venster Synchronisatie inschakelen de synchronisatie in zodra het systeem de gebruikersgegevens naar een tijdelijke opslagruimte in Unity Connection heeft gekopieerd en er een nieuwe synchronisatieovereenkomst is gemaakt (na stap 1 en 2, zoals te zien is in de onderstaande schermafbeelding).

De Rapport downloaden Met de downloadoptie kunt u de resultaten gedeeltelijk weergeven. Voer de volgende CLI-opdracht uit om de volledige rapporten voor het Unity Connection-cluster op te halen: bestand ophalen activelog /cm/trace/CIService/log4j/DryRunResults.csv . Hier toont het resultaat van de testrun voor Unity Connection het volgende:

Voor nieuwe Azure AD-implementaties:

Nieuwe gebruikers —Er zijn geen gebruikers aanwezig in de Cisco Unified CM -database op de Unity Connection-server, maar wel in de Webex Identity-service.
Overeenkomende gebruikers —Er zijn gebruikers aanwezig in de Cisco Unified CM -database op de Unity Connection-server en in de Webex Identity-service.
CUC-gematchte gebruikers —Gebruikers die aanwezig zijn op de Webex Identity-service en zijn geïmporteerd in ' Unity Connection-database' op het Unity Connection-knooppunt.
Niet-overeenkomende gebruikers —Gebruikers zijn aanwezig in de Cisco Unified CM -database op de Unity Connection-server en niet in de Webex Identity-service.

Voor on-premises migraties van AD naar Azure AD:

Het veld Gebruikers- Id in Unity Connection wordt toegewezen aan de e-mail- Id van de gebruiker in Webex. Alle testrapportvelden zijn hetzelfde als nieuwe Azure AD-implementaties.
Het veld E-mail- Id in Unity Connection wordt toegewezen aan de e-mail- Id van de gebruiker in Webex. Alle testrapportvelden zijn hetzelfde als nieuwe Azure AD-implementaties.
Het veld Gebruikers- Id in Unity Connection wordt toegewezen aan de e-mail- Id zonder domeingedeelte van de gebruiker in Webex:
- Nieuwe gebruikers —Gebruikers met een gebruikers- Id zonder domeingedeelte zijn niet aanwezig in de Cisco Unified CM -database op de Unity Connection-server, maar wel in de Webex Identity-service.
- Overeenkomende gebruikers —Gebruikers met een gebruikers- Id zonder domeingedeelte zijn aanwezig in de Cisco Unified CM -database op de Unity Connection-server en in de Webex Identity-service.
- CUC-gematchte gebruikers —Gebruikers met een gebruikers- Id zonder domeingedeelte zijn aanwezig in de Webex Identity-service en zijn geïmporteerd in ' Unity Connection-database' op het Unity Connection-knooppunt.
- Niet-overeenkomende gebruikers —Gebruikers met een gebruikers- Id zonder domeingedeelte zijn aanwezig in de Cisco Unified CM -database op de Unity Connection-server en niet in de 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 Unity Connection om u aan te aanmelden bij uw op locatie infrastructuur en wijzigingen aan te brengen in de zojuist gemaakte synchronisatieovereenkomst.

VPN toegang is vereist.

Schakel het selectievakje in om akkoord te gaan met de voorwaarden dat de synchronisatieovereenkomst wordt gecontroleerd en geverifieerd in Unity Connection.

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 Unity Connection-services 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 Unity Connection: 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).
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.
1. Schakel de . uit Adreslijstservice vanaf de pagina Servicebeheer in Control Hub.
2. Schakel de . uit Synchroniseren vanaf LDAP server inschakelen selectievakje in het LDAP -systeem.
3. 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 Unity Connection 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.

Gebruikers importeren voor Unity Connection

Nadat het cluster is ingericht vanuit Control Hub, kunt u Azure AD-gebruikers handmatig importeren vanuit Gebruikers importeren in Cisco Unity Connection.

Er zijn twee manieren om gebruikers te importeren:

Unity Connection-gebruikers maken op basis van Azure AD-gegevens met het hulpprogramma Gebruikers importeren

Vouw in Cisco Unity Connection-beheer Gebruikers uit en selecteer Gebruikers importeren.

Importeer op de pagina Gebruikers importeren de Azure AD-gebruikersaccounts om Unity Connection-gebruikers te maken.

Selecteer LDAP Directory in het veld Eindgebruikers zoeken in.
Selecteer de sjabloon waarop de nieuwe gebruiker is gebaseerd.
Geef de . op Alias , Voornaam , of Achternaam van de Azure AD-gebruikersaccounts die u wilt importeren.
Schakel de selectievakjes in voor de gebruikersaccounts die u wilt importeren en selecteer Geselecteerde importeren.

Unity Connection-gebruikers maken op basis van Azure AD-gegevens met het hulpprogramma voor Bulkbeheer

Vouw in Cisco Unity Connection-beheer Tools uit en selecteer Bulkbeheertool.

Voer op de pagina Bulkbeheertool de volgende stappen uit om Unity Connection-gebruikers toe te voegen:

Selecteer bij Bewerking selecteren de optie Exporteren.
Selecteer bij Objecttype selecteren de optie Gebruikers vanuit LDAP Directory.
Voer de waarden in alle verplichte velden in.
Selecteer Verzenden.

Hiermee wordt een CSV-bestand met de Azure AD-gebruikersgegevens. Open het CSV-bestand in een spreadsheettoepassing of in een teksteditor en bewerk de gegevens naar behoefte. Importeer nu de gegevens uit het CSV-bestand.
Selecteer bij Bewerking selecteren de optie Maken.
Selecteer bij Objecttype selecteren de optie Gebruikers met postvak.
Voer de waarden in alle verplichte velden in.
Selecteer Verzenden.

Controleer na het importeren het bestand dat u hebt opgegeven in het veld Bestandsnaam mislukte objecten om te verifiëren of alle gebruikers zijn gemaakt.

Synchronisatieproblemen oplossen

In dit gedeelte vindt u de benodigde informatie en oplossingen om een aantal veelvoorkomende problemen op te lossen die u kunt tegenkomen tijdens de verschillende fasen van het synchroniseren van gebruikers van Control Hub naar de Unity Connection-database.

Niet-overeenkomende gebruikers

Schakel synchronisatie binnen 20 uur na het maken van de nieuwe overeenkomst in. De bestaande gebruikers worden gemarkeerd als inactief en worden na 24 uur inactiviteit verwijderd uit Unity Connection.

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.
De communicatie tussen Cloud-Connected UC en Unity Connection is onderbroken of kan geen gebruikersgegevens naar de Unity Connection-database pushen.
Gebruikersgegevens worden niet gekopieerd naar de tijdelijke opslaglocatie.

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

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

Fout: kan adreslijstsynchronisatie niet inschakelen. Probeer het opnieuw.

De communicatie tussen Cloud-Connected UC en Unity Connection is onderbroken en de Cisco DirSync-service wordt niet geactiveerd.
Cisco DirSync-service is geactiveerd maar niet voltooid.

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

De communicatie tussen Cloud-Connected UC en Unity Connection is onderbroken.

Bekende problemen en beperkingen voor Unity Connection

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 Unity -verbindingscluster opnieuw aan de organisatie wilt toevoegen, 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.