Webex Cloud-Connected UC Directory Service-understøttelse af Unity Connection

Oversigt

Du kan synkronisere og administrere brugere fra cloud Active Directory (f.eks. Microsoft Entra ID) til lokal eller cloudhostet UC-infrastruktur som Cisco Unified Communications Manager (Unified Communications Manager) og Cisco Unity Connection (Unity Connection) med Webex Cloud-Connected UC Directory Service. Under synkroniseringen importerer systemet en liste over brugere og tilknyttede brugerdata fra Entra ID (eller en lignende Cloud Directory-tjeneste), der synkroniseres til Webex Common Identity Service. Du skal vælge den Unity Connection-klynge fra Control Hub, der skal synkroniseres, vælge den relevante Unity Connection User ID-felttilknytning og derefter vælge den nødvendige synkroniseringsaftale for at udføre synkronisering.

Forudsætning

Onboard Unity Connection-klyngerne til Cloud-Connected UC. Se Konfigurere Cloud-Connected UC til enheder i det lokale miljø
Synkroniser Entra ID-brugere til Control Hub
Unity Forbindelsesklynger skal være version 11.5(1)SU9, 12.5(1)SU4 eller 14 og nyere

Aktiver katalogtjeneste

Du skal aktivere Directory Service for hver klynge i Webex Cloud-Connected UC for at tillade synkronisering og administration af brugere fra cloud til Unity Connection.

Som standard er Directory Service ikke aktiveret for alle onboardede klynger.

1	Fra kundevisningen i Control Hub skal du gå til Services > Connected UC. På kortet UC-administration skal du klikke på Lager. Listen over klyngegrupper vises med beskrivelse, status, klynger og noder.
2	Klik på Detaljer ud for den klyngegruppe, som noden tilhører. Siden Lager vises med listen over klynger, der hører til den valgte klyngegruppe.
3	Klik på Detaljer ud for den klynge, som den pågældende produktnode tilhører. Nodenavnet med version, produkt og status vises.
4	Klik på ellipseikonet ud for Hændelseshistorik⋮ og vælg Tjenestestyring. Siden Servicestyring vises med listen over tjenester.
5	Brug til/fra-knappen til at aktivere Directory Service.
6	Klik på Send.

Telefonbogstjeneste

Brug Directory Service-kortet til at synkronisere brugere fra skybaserede telefonbøger i Unity Connection.

1	Fra kundevisningen i Control Hub skal du gå til Services > Connected UC.
2	På kortet Telefonbogstjeneste skal du klikke på Vis klynger. Siden Directory Service vises.

Du kan få vist listen over klyngedetaljer på denne side.

Vis klyngedetaljer

På siden Valg af klynge i Directory Service skal du vælge en klynge, som du vil synkronisere brugerdataene med.

Siden Valg af klynge indeholder også klyngeoplysninger, status for klargøring, seneste synkroniserede tilstand, det tilknyttede produkt og eventuelle årsager til fejl. Du kan vælge den lokale tidszone; Som standard er browserens tidszone valgt.

Klyngedetaljer	Beskrivelse
Klyngenavn	Navnet på klyngen.
Status	Status for synkronisering.
Senest synkroniseret	Dato for seneste synkronisering.
Produkt	Oplysninger om produktet.

Klargør synkronisering af katalogtjeneste

Webex Cloud-Connected UC Directory Service-synkronisering gør det muligt at importere slutbrugerdata fra Webex Common Identity Service til Unity Connection-databasen, så de vises i vinduet End User Configuration.

Sørg for, at du ikke udfører klargøringshandlinger under den planlagte Webex Cloud-Connected UC-modulopgradering.

Hvis du udfører klargøring under modulopgradering, kan trin 1, 2 eller 3 vise fejltilstande efter en bestemt periode, og knappen Prøv igen vises efter et stykke tid. Du kan starte klargøringen igen ved at vælge knappen Prøv igen . Sørg for at kontrollere klyngestatussen for fuldførelse af opgraderingen, før du forsøger at klargøre igen.

På siden Valg af klynge i Directory Service skal du vælge en klynge, som du vil klargøre for at muliggøre synkronisering.

Klik på Start klargøring.

I vinduet Konfiguration af felttilknytning skal du sikre dig, at den tilknytning, der er valgt for feltet Unity Forbindelsesbruger-id, entydigt identificerer brugeren i klyngen, når du har startet klargøringen.

Vælg den relevante Unity Connection User ID -felttilknytning til synkronisering af brugeren fra Webex:

Feltet Bruger-id i Unity Forbindelsen knyttes til brugerens e-mail-id i Webex.
Feltet Mail-id i Unity Forbindelsen knyttes til brugerens e-mail-id i Webex.
Feltet Bruger-id i Unity Forbindelsen knyttes til e-mail-id uden domænedelen af brugeren i Webex.

Der oprettes en ny brugerkonto, hvis tilknytningen ikke kan udføres korrekt for en eksisterende brugerkonto i Unity Connection. Brugerens e-mail-id (eller id-delen af e-mail-id'et) bruges som den entydige identifikator for den nyoprettede brugerkonto.

Klik på Næste.

Vælg en aftale på rullelisten for at oprette en ny synkroniseringsaftale.

Når den nye synkroniseringsaftale er oprettet, slettes alle eksisterende synkroniseringsaftaler, der peger på det lokale katalog. Du kan foretage ændringer i den nye synkroniseringsaftale, når den er oprettet.

Gennemse aftaleoplysningerne (eksisterende eksterne LDAP-mappeoplysninger, der er tilgængelige i Unity-forbindelsen), før du starter synkroniseringen i sektionen Eksempel på aftale.

Du kan se følgende detaljer:

Gruppeoplysninger
Anvendt funktionsgruppeskabelon med universelle linje- og enhedsskabeloner
Linje- og maskedetaljer til synkroniserede telefonnumre for indsatte brugere
Nyligt klargjorte brugere og deres lokalnumre

Afsnittet Standardbrugerfelter, der skal synkroniseres. Følgende brugerfelter synkroniseres fra Webex Common Identity Service til Unity Connection:

Unity Forbindelsesbrugerfelter synkroniseret	Webex Common Identity Service-brugerfelter synkroniseret
Bruger-id	Brugernavn synkroniseres, hvis indstillingen "Bruger-id-felt i Unity Forbindelse knyttes til e-mail-id for brugeren i Webex" vælges.
	Eksisterende bruger-id (e-mail-id i Unity Connection) fra Unity Connection-databasen, der svarer til e-mail-id'et i Webex Common Identity Service, hvis indstillingen "E-mail-id-felt i Unity Connection knyttes til e-mail-id for brugeren i Webex" er valgt.
	Mail-id uden domænedelen, hvis indstillingen "Bruger-id-felt i Unity Forbindelse knyttes til e-mail-id uden domænedel af brugeren i Webex" er valgt.
Fornavn	navn.givetNavn
Efternavn	navn.familienavn
Visningsnavn	displayName
Telefonnummer	phoneNumbers.work
Mobilnummer	phoneNumbers.mobile
E-mail-id	E-mails
Titel	titel

Værtsnavn eller IP-adresse på biblioteksserveren

Klik på Næste for at vælge gruppefilteret.

Vælg de specifikke grupper, du vil synkronisere, på rullelisten Vælg grupper . Klik på afkrydsningsfeltet Vælg alle grupper , hvis du vil markere alle brugergrupperne.

Som standard er alle brugere synkroniseret. Hvis du ikke vælger nogen gruppe, synkroniseres alle brugere og tilknyttede brugerdata automatisk.

For indlejrede grupper i en telefonbog skal brugerne vælge delmængdebrugergruppen specifikt under klargøringen, da de som standard ikke er inkluderet i den overordnede gruppe. Du skal kontrollere for eventuel gentagen indlejring (hvis nogen) for at sikre, at kun de påkrævede brugere medtages under klargøringen.

Eventuelle ændringer af synkroniseringsaftalen, f.eks. fjernelse af en målbruger eller -gruppe, overføres ikke under periodisk synkronisering. Du bør deaktivere katalogtjenesten for den klynge fra Control Hub og derefter klargøre klyngen igen med den nye eller ændrede synkroniseringsaftale.

Klik på Næste for at forberede synkroniseringsprocessen.

I vinduet Aktivér synkronisering skal du aktivere synkroniseringen, når systemet kopierer brugerdataene til en midlertidig lagerplads i Unity Connection, og der oprettes en ny synkroniseringsaftale (efter trin 1 og 2 som vist på nedenstående skærmbillede).

Med indstillingen Download rapportdownload kan du få vist resultaterne delvist. Hvis du vil hente de komplette rapporter for Unity Connection-klyngen, skal du udføre følgende CLI-kommando: file get activelog /CM/trace/CIService/log4j/DryRunResults.CSV. Her viser tørkørselsresultatet for Unity Connection følgende:

For nye Entra ID-installationer:

Nye brugere – Brugere findes ikke i Cisco Unified CM-databasen på Unity Connection-serveren, men findes i Webex Identity Service.
Matchede brugere – brugere findes i Cisco Unified CM-databasen på Unity Connection-serveren og i Webex Identity Service.
CUC-matchede brugere – brugere, der findes på Webex Identity Service og importeres i 'Unity Connection-database' på Unity Connection-noden.
Uoverensstemmende brugere – Brugere findes i Cisco Unified CM-databasen på Unity Connection-serveren og findes ikke i Webex Identity Service.

For lokale AD til Entra ID-overførsler:

CCUC Directory Sync-konfigurationer overføres ikke. Du skal klargøre CCUC-mappesynkroniseringen i destinationsområdet POST-overførslen.

Feltet Bruger-id i Unity Forbindelsen knyttes til brugerens e-mail-id i Webex. Alle tørkørselsrapportfelter er de samme som Fresh Entra ID-installationer.
Feltet Mail-id i Unity Forbindelsen knyttes til brugerens e-mail-id i Webex. Alle tørkørselsrapportfelter er de samme som Fresh Entra ID-installationer.
Feltet Bruger-id i Unity Forbindelsen knyttes til e-mail-id uden domænedelen af brugeren i Webex:
- Nye brugere – Brugere med bruger-id uden domænedel findes ikke i Cisco Unified CM-databasen på Unity Connection-serveren, men findes i Webex Identity Service.
- Matchede brugere – Brugere med bruger-id uden domænedel findes i Cisco Unified CM-databasen på Unity Connection-serveren og i Webex Identity Service.
- CUC-matchede brugere – Brugere med bruger-id uden domænedel findes i identitetstjenesten Webex og importeres i 'Unity Connection-database' på noden Unity Connection.
- Uoverensstemmende brugere – Brugere med bruger-id uden domænedel findes i Cisco Unified CM-databasen på Unity Connection-serveren og findes ikke i Webex Identity Service.

Du kan kontrollere rapporten og beslutte, om du vil beholde den samme liste over brugere og tilføje eller slette brugere. Baseret på beslutningen kan du stoppe processen og fortryde provisioneringsændringerne.

Alle opdateringer, der foretages af brugerdataene i skykataloget efter katalogsynkronisering, opdateres i den næste synkroniseringsperiode. Dette skyldes, at skykataloget synkroniseres periodisk en gang om dagen.

Når bekræftelsen af synkroniseringsaftalen er bekræftet, skal du klikke på Eksempel i Unity Connection for at logge på infrastrukturen i det lokale miljø og foretage ændringer i den nyoprettede synkroniseringsaftale.

VPN adgang er påkrævet.

Markér afkrydsningsfeltet for at acceptere vilkårene for, at synkroniseringsaftalen gennemses og bekræftes i Unity Connection.

Klik på Aktivér synkronisering for at fortsætte med synkroniseringen.

Under synkroniseringen kan du ikke udføre nogen handling, før den er fuldført. Når synkroniseringen er fuldført for en bestemt klynge, viser siden Katalogtjeneste denne klynge med tilstanden Klargjort. På dette tidspunkt har du godkendt Entra ID til at klargøre og synkronisere Webex-brugere til UC-infrastruktur og fuldført trinnene til konfiguration af synkronisering.

Når den indledende klargøring er fuldført, sker der periodisk synkronisering hver 24. time. Alle ændringer, der foretages i skykataloget, overføres til klyngerne i denne periode.

Du skal aktivere synkronisering inden for 20 timer fra det tidspunkt, hvor den nye aftale oprettes. LDAP synkroniserede brugere bliver inaktive og fjernes efter 24 timers inaktivitet. Brugere kan ikke logge på og bruge tjenesterne Unity Connection.

Når Entra ID-klargøringen er fuldført for en bestemt klynge, kan du ikke oprette nye synkroniseringsaftaler eller redigere nogen konfigurationsindstillinger for den samme klynge bortset fra gruppeindstillingerne. Hvis du vil oprette en ny synkroniseringsaftale for den samme klynge, skal du gå til siden Tjenesteadministration og deaktivere katalogtjenesten. Du kan derefter oprette en ny aftale om klargøring.

Hvis synkroniseringen af en eller anden grund mislykkes, afspejles de seneste provisioneringsændringer i den næste synkroniseringsperiode den næste dag.

Hvis du bruger Entra ID IdP under SSO-godkendelse efter vellykket klargøring, skal du sikre dig, at du konfigurerer de rigtige krav i Entra ID IdP. Hvis indstilling 1 f.eks. er valgt for userid-tilknytningen under klargøring, skal du sikre, at user.userprincipalname er angivet som UID i afsnittet "Yderligere krav".

Følgende attributter synkroniseres fra Webex Common Identity Service til Unity Connection:

Unity Forbindelsesbrugerfelter synkroniseret	Webex Common Identity Service-brugerfelter synkroniseret
Bruger-id	Brugernavn synkroniseres, hvis indstillingen "Bruger-id-felt i Unity Forbindelse knyttes til e-mail-id for brugeren i Webex" vælges.
	Eksisterende bruger-id (e-mail-id i Unity Connection) fra Unity Connection-databasen, der stemmer overens med e-mail-id'et i Webex Common Identity Service, hvis indstillingen "E-mail-id-felt i Unity Connection knytter til e-mail-id for brugeren i Webex" er valgt.
	Mail-id uden domænedelen, hvis indstillingen "Bruger-id-felt i Unity Forbindelse knyttes til e-mail-id uden domænedel af brugeren i Webex" er valgt.
Fornavn	navn.givetNavn
Efternavn	navn.familienavn
Visningsnavn	displayName
Telefonnummer	phoneNumbers.work
Mobilnummer	phoneNumbers.mobile
E-mail-id	E-mails
Titel	titel

Alle opdateringer, der foretages af brugerdataene i skykataloget efter katalogsynkronisering, opdateres i den næste synkroniseringsperiode. Dette skyldes, at skykataloget synkroniseres periodisk en gang om dagen.
Single sign-on (SSO) skal bruges til logins. Dette dokument dækker kun integration med enkeltlogon (SSO).
Hvis du efter genklargøringen ser, at de brugere, der er markeret som Uoverensstemmende brugere, er de samme som Nye brugere (brugere, der deler samme e-mail-id), anbefaler vi, at du maksimalt venter 48 timer, mens synkroniseringsændringerne træder i kraft.
1. Deaktiver katalogtjenesten fra siden Tjenesteadministration i Control Hub.
2. Deaktiver afkrydsningsfeltet Aktiver synkronisering fra LDAP-server i LDAP-systemet.
3. Aktivér katalogtjenesten fra siden Tjenesteadministration i Control Hub.

Klargøringsstatus

På dashboardet Katalogtjeneste kan du få vist og spore status for din klynge og gennemse fejl.

Følgende tabel viser klargøringsstatussen, beskrivelsen og de tilsvarende handlinger.

Tabel 1. Klargøringsstatus
Klargøringsstatus	Beskrivelse
Behandler	Klargøringen er i gang.
Handling påkrævet	Tag de nødvendige skridt, hvis der kræves manuelle indgreb for en bestemt klynge. F.eks. Hvis du vil fortsætte eller afbryde synkroniseringen efter tørkørsel. Når den nye aftale er oprettet, skal du kontrollere, om der er meddelelser, og foretage de nødvendige handlinger efter behov.
Fejl	Hvis der kræves nogen handling i guiden 'Aktivér synkronisering', skal du kontrollere dem og om nødvendigt foretage de nødvendige handlinger. I tilfælde af fejl i klargøringsfaserne skal administratoren revidere siden Hændelseshistorik i Cisco Webex Control Hub for tjenesten tjenesten: Katalogtjeneste. Dette hjælper dig med at isolere, fejlfinde og fejlfinde de mulige problemer. Hvis du vil have adgang til hændelser, skal du se Få adgang til hændelseshistorikken for hybridtjenester. Du kan finde flere oplysninger om de forskellige hændelsestyper og deres detaljer i tabellen "Hændelser og mulige løsninger" nedenfor.
Klargjort	Klyngeklargøringen er fuldført.
Ikke klargjort	Klyngeklargøringen er ikke startet endnu.

Tabel 2. Begivenheder og beslutninger
Begivenheder	Handling påkrævet
Periodisk synkronisering mislykkedes	Sørg for at vente på fuldførelsen af næste dags periodiske synkronisering. Kontroller, at synkroniseringen er fuldført. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.
Datakopiering mislykkedes	Klik på knappen Prøv igen for at fortsætte dataoverførslen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.
Synkroniseringsaftale mislykkedes	Klik på knappen Prøv igen for at prøve at oprette synkroniseringsaftalen igen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.
Spring periodisk synkronisering over	Der kræves ingen handling.
Dataoverførsel mislykkedes	Klik på knappen Prøv igen for at fortsætte dataoverførslen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.
Brugersynkronisering uoverensstemmende	Kontroller logfilerne Katalogsynkronisering i Unity Connection for fejl i brugersynkronisering, eller kontakt Cisco TAC support for at få yderligere hjælp.
Brugere, der er klargjort	Der kræves ingen handling.
Periodisk synkronisering af dataoverførsel lykkedes	Der kræves ingen handling.
Kunne ikke hente brugeroplysninger for nogle af de valgte grupper fra Webex Fælles identitet.	Gå til dashboardet , og vælg klyngen for at få oplysninger om de mislykkede grupper ved at klikke på downloadlinket. Kontroller, om brugerne findes i Webex Common Identity, og klik på Prøv igen. Kontakt Cisco TAC support for yderligere hjælp.
Kunne ikke hente brugeroplysninger for alle de valgte grupper fra Webex Common Identity.	Klik på knappen Prøv igen for at fortsætte dataoverførslen. Hvis problemet fortsætter, skal du kontakte Cisco TAC support for yderligere hjælp.

Importer brugere til Unity Connection

Du kan importere Entra ID-brugere manuelt fra Importer brugere i Cisco Unity Connection efter klyngeklargøring er udført fra Control Hub.

Der er følgende to måder at importere brugere på:

Opret Unity Connection-brugere fra Entra ID-data ved hjælp af værktøjet Importer brugere

Udvid Brugere i Cisco Unity Connection Administration, og vælg Importér brugere.

På siden Importer brugere skal du importere Entra ID-brugerkonti for at oprette Unity Connection-brugere.

Vælg mappen LDAP i feltet Find slutbrugere i.
Vælg den skabelon, som den nye bruger er baseret på.
Angiv alias, fornavn eller efternavn på de Entra ID-brugerkonti, du vil importere.
Markér afkrydsningsfelterne ud for de brugerkonti, du vil importere, og vælg Importér valgte.

Opret Unity Connection-brugere fra Entra ID-data ved hjælp af masseadministrationsværktøjet

Udvid Værktøjer i Cisco Unity Connection Administration, og vælg Masseadministrationsværktøj.

Hvis du vil tilføje Unity Connection-brugere, skal du gøre følgende på siden Bulk Administration Tool:

Vælg Eksporter fra Vælg handling.
Fra Vælg objekttype skal du vælge Brugere fra LDAP Directory.
Angiv værdierne i alle obligatoriske felter.
Vælg Send.

Dette opretter en CSV-fil med Entra ID-brugerdata. Åbn filen CSV i et regnearksprogram eller i en teksteditor, og rediger dataene efter behov. Importer nu dataene fra CSV-filen.
Fra Vælg handling skal du vælge Opret.
Fra Vælg objekttype skal du vælge Brugere med postkasse.
Angiv værdierne i alle obligatoriske felter.
Vælg Send.

Når importen er fuldført, skal du gennemse den fil, du har angivet i feltet Filnavn på mislykkede objekter, for at bekræfte, at alle brugere er oprettet korrekt.

Fejlfinding af synkroniseringsproblemer

Dette afsnit indeholder de nødvendige oplysninger og løsninger til at løse nogle af de almindelige problemer, som du kan støde på i de forskellige faser af synkronisering af brugere fra Control Hub til Unity Connection-databasen.

Uoverensstemmende brugere

Hvis du ser uoverensstemmende brugere, skal du aktivere synkronisering inden for 20 timer, efter at den nye aftale er oprettet. De eksisterende brugere markeres som inaktive og slettes fra Unified CM efter 24 timers inaktivitet.

Fejl – datakopiering mislykkedes. Prøv igen

Kommunikationen mellem Cloud-Connected UC og Webex cloud er afbrudt eller kan ikke hente brugerdata fra Webex cloud.

Løsning: For at bekræfte, om din forbindelse til Cisco Cloud, skal du kontrollere status for disse tjenester på: https://status.webex.com/. Klik på Prøv igen.
Kommunikationen mellem Cloud-Connected UC og Unity Connection afbrydes eller kan ikke pushe brugerdata til Unity Connection-databasen.

Løsning:Kontrollér netværksforbindelsen mellem Cloud-Connected UC og Unity Connection, og klik på Prøv igen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.

Fejl – oprettelse af synkroniseringsaftale mislykkedes. Prøv igen

Kommunikationen mellem Cloud-Connected UC og Unity Connection afbrydes eller kan ikke pushe synkroniseringsaftaledataene til Unity Connection-databasen.

Løsning:Kontrollér netværksforbindelsen mellem Cloud-Connected UC og Unity Connection, og klik på Prøv igen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.
Synkroniseringsaftalen blev ikke oprettet.

Fejl – Kunne ikke aktivere katalogsynkronisering. Prøv igen

Kommunikationen mellem Cloud-Connected UC og Unity Connection afbrydes, og Cisco DirSync-tjenesten udløses ikke.

Løsning:Kontrollér netværksforbindelsen mellem Cloud-Connected UC og Unity Connection, og klik på Prøv igen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.

Kunne ikke hente oplysninger om synkroniseringsaftale. Prøv efter et stykke tid.

Kommunikationen mellem Cloud-Connected UC og Unity Connection afbrydes.

Løsning:Kontrollér netværksforbindelsen mellem Cloud-Connected UC og Unity Connection, og klik på Prøv igen. Hvis problemet fortsætter, skal du kontakte Cisco TAC-support.

Kunne ikke hente brugerdata for valgte grupper

Under den første klargøring kan du støde på problemer med at hente brugerdata fra en af de specifikke grupper, du har valgt til synkronisering. På fejlmeddelelsen skal du klikke på downloadlinket for at få vist detaljer om de mislykkede gruppeoplysninger.

Du kan også downloade mislykkede gruppeoplysninger for klynger, der allerede er klargjort fra siden Hændelseshistorik i Cisco Webex Control Hub. Gå til dashboardet , og vælg klyngen for at få oplysninger om de mislykkede grupper ved at klikke på downloadlinket. Kontroller, om brugerne findes i Webex Fælles identitet, og klik på Prøv igen. Kontakt Cisco TAC support for yderligere hjælp.

Kendte problemer og begrænsninger for Unity Connection

Hvis du oplever et problem med denne funktion, skal du kontrollere, om det er noget, vi allerede kender til, og har en anbefalet løsning.

Du kan deaktivere katalogtjenesten for en klynge fra Control Hub og derefter genaktivere klyngen igen. Vi anbefaler, at du venter mindst 60 sekunder, før du aktiverer katalogtjenesten til synkronisering.
Hvis du efter sletningen vil onboarde den samme Unity Connection-klynge i organisationen igen, skal du først deaktivere katalogtjenesten og derefter klargøre den samme klynge igen.
Under klargøringen udfyldes listen med gruppeoplysninger ikke på grund af synkroniseringsproblemer med Webex Common Identity Service. Brugere anbefales at opgive klargøring og prøve igen efter et stykke tid.

Tak for din feedback.