Understøttelse af Webex Cloud-tilsluttet UC Directory Service til Unity-forbindelse

Oversigt

Du kan synkronisere og administrere brugere fra skyen Active Directory (f.eks. Microsoft Entra ID) til den lokale eller cloud-hostede UC-infrastruktur som f.eks. 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 ønskede synkroniseringsaftale for at udføre synkronisering.

Forudsætning

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

Aktivér katalogtjeneste

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

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

1	Fra kundevisningen i Control Hub skal du gå til Services > Connected UC. Klik på Inventory på UC Management-kortet. Listen over klyngegrupper vises med beskrivelse, status, klynger og noder.
2	Klik på Detaljer ud for den klyngegruppe, som noden tilhører. Siden Inventar vises og viser listen over klynger, der tilhører 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å ikonet for ellipse │ ud for Hændelseshistorik, og vælg Servicestyring. Siden Service Management vises med listen over tjenester.
5	Brug skifteknappen til at aktivere katalogtjenesten.
6	Klik på Send.

Katalogtjeneste

Brug katalogtjenestekortet til at synkronisere brugere fra skybaserede mapper til Unity Connection.

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

Du kan se listen over klyngedetaljer på denne side.

Se klyngedetaljer

Vælg en klynge, som du vil synkronisere brugerdataene med, på siden Klyngevalg i Katalogtjeneste.

Siden Klyngevalg indeholder også klyngedetaljer, status for klargøring, sidst synkroniserede tilstand, det tilknyttede produkt og årsagen til fejlen, hvis der er nogen. Du kan vælge den lokale tidszone; som standard vælges browserens tidszone.

Klyngedetaljer	Beskrivelse
Klyngenavn	Navnet på klyngen.
Status	Status for synkronisering.
Sidst synkroniseret	Dato for den sidste synkronisering.
Produkt	Detaljer om produktet.

Synkronisering af klargøring af katalogtjenester

Webex Cloud-Connected UC Directory Service-synkronisering giver dig mulighed for at importere slutbrugerdata fra Webex Common Identity Service til Unity-forbindelsesdatabasen, der skal vises i vinduet Slutbrugerkonfiguration.

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 genstarte klargøring ved at vælge knappen Prøv igen. Sørg for, at du bekræfter klyngestatus for færdiggørelse af opgraderingen, før du prøver klargøring igen.

Vælg en klynge, som du vil klargøre til aktivering af synkronisering, på siden Klyngevalg i Mappetjeneste.

Klik på Start klargøring.

I konfigurationsvinduet 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øring.

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

Brugerid-felt i Unity Connection knytter sig til e-mail-id for brugeren i Webex.
Feltet Mail ID i Unity Connection knytter sig til e-mail-id for brugeren i Webex.
Brugerid-felt i Unity Connection knytter sig til e-mail-id uden domænedel af brugeren i Webex.

Ny brugerkonto oprettes, hvis kortlægningen ikke kan udføres med succes for en eksisterende brugerkonto i Unity Connection. E-mail-id (eller ID-delen af e-mail-id'et) for brugeren vil blive brugt som entydig 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å mappen i det lokale miljø. Du kan foretage ændringer i den nye synkroniseringsaftale, når den er oprettet.

I afsnittet Eksempel på aftale skal du gennemse aftaledetaljerne (eksisterende eksterne LDAP-mappeoplysninger, der er tilgængelige i Unity-forbindelsen), før du starter synkroniseringen.

Du kan se følgende detaljer:

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

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

Brugerfelter til Unity Connection synkroniseret	Webex Common Identity Service Brugerfelter synkroniseret
Bruger-ID	Brugernavn synkroniseres, hvis indstillingen „Bruger-id i Unity Connection knytter til e-mail-id for brugeren i Webex“ er valgt.
	Eksisterende bruger-id (Mail ID i Unity Connection) fra Unity-forbindelsesdatabasen, der matcher mail-id'et i Webex Common Identity Service, hvis indstillingen „Mail ID i Unity Connection knytter til e-mail-id for brugeren i Webex“ er valgt.
	Mail-id uden domænedelen, hvis indstillingen „Bruger-id i Unity Connection knytter til e-mail-id uden domænedel af brugeren i Webex“ er valgt.
Fornavn	Navn.givennavn
Efternavn	Navn.Efternavn
Visningsnavn	Visningsnavn
Telefonnummer	Telefonnummer.Work
Mobilnummer	Telefonnummer.mobil
E-mail-id	e-mails
Titel	titel

Værtsnavn eller IP-adresse på katalogserveren

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

Vælg den eller 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 synkroniseres alle brugere. Hvis du ikke vælger nogen gruppe, synkroniseres alle brugere og tilknyttede brugerdata automatisk.

For indlejrede grupper i en mappe skal brugerne vælge undergruppens brugergruppe specifikt under klargøring, da de ikke er inkluderet som standard i den overordnede gruppe. Du skal kontrollere eventuelle gentagne indlejringer (hvis der er nogen) for at sikre, at kun de nødvendige brugere er inkluderet under klargøring.

Eventuelle ændringer af synkroniseringsaftalen, f.eks. fjernelse af en målbruger eller gruppe, vil ikke blive udbredt under periodisk synkronisering. Du skal deaktivere katalogtjenesten for den pågældende klynge fra Control Hub og derefter genoprette 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 med succes kopierer brugerdataene til en midlertidig lagerplads i Unity Connection, og der oprettes en ny synkroniseringsaftale (efter trin 1 og 2 som vist i nedenstående skærmbillede).

Inds tillingen Download rapport giver dig mulighed for at se resultaterne delvist. For at hente de komplette rapporter for Unity Connection-klyngen skal du udføre følgende CLI-kommando: file get acti velog /cm/trace/CIService/log4j/DryRunResults.csv. Her viser tørløbsresultatet for Unity Connection følgende:

Til udrulninger af Fresh Entra ID:

Nye brugere —Bru gere er ikke til stede i Cisco Unified CM databasen på Unity Connection-serveren, men findes i Webex Identity Service.
Matchede brugere —Brugere er til stede i Cisco Unified CM databasen på Unity Connection-server og i Webex Identity Service.
CUC Matchede brugere —Bru gere, der er til stede på Webex Identity Service og importeret i"Unity Connection Database“ på Unity Connection node.
Ikke-matchede brugere —Brugere er til stede i Cisco Unified CM databasen på Unity Connection-serveren og er ikke til stede i Webex Identity Service.

For migreringer af AD til Entra ID i det lokale miljø:

Konfigurationer af CCUC Directory Sync overføres ikke. Du skal klargøre CCUC Directory Sync i destinationsområdet efter overførslen.

Brugerid-felt i Unity Connection knytter sig til e-mail-id for brugeren i Webex. Alle tørløbsrapportfelter er de samme som Fresh Entra ID-implementeringer.
Feltet Mail ID i Unity Connection knytter sig til e-mail-id for brugeren i Webex. Alle tørløbsrapportfelter er de samme som Fresh Entra ID-implementeringer.
Brugerid-felt i Unity Connection knytter sig til e-mail-id uden domænedel af brugeren i Webex:
- Nye brugere —Bru gere med bruger-id uden domænedel er ikke til stede i Cisco Unified CM databasen på Unity Connection-serveren, men findes i Webex Identity Service.
- Matchede brugere —Brugere med bruger-id uden domænedel er til stede i Cisco Unified CM databasen på Unity Connection-server og i Webex Identity Service.
- CUC-matchede brugere — Bru gere med bruger-id uden domænedel er til stede på Webex Identity Service og importeret i"Unity Connection Database“ på Unity Connection-noden.
- Ikke-matchede brugere —Brugere med bruger-id uden domænedel er til stede i Cisco Unified CM databasen på Unity Connection-serveren og er ikke til stede 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 tilbageføre klargøringsændringerne.

Eventuelle opdateringer, der foretages til brugerdataene i skybiblioteket efter katalogsynkronisering, opdateres i den næste synkroniseringsperiode. Dette skyldes, at skykataloget synkroniseres med jævne mellemrum en gang om dagen.

Efter bekræftelsen af synkroniseringsaftalen skal du klikke på Eksempel i Unity Connec tion for at logge på din lokale infrastruktur og foretage ændringer i den nyoprettede synkroniseringsaftale.

VPN-adgang er påkrævet.

Marker afkrydsningsfeltet for at acceptere betingelserne for, at synkroniseringsaftalen gennemgås 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 du er færdig. Når synkroniseringen er afsluttet for en bestemt klynge, viser siden Katalogtjeneste denne klynge med en klargjort tilstand. På dette tidspunkt har du med succes autoriseret Entra ID til at klargøre og synkronisere Webex-brugere i UC-infrastruktur og gennemført trinene for at konfigurere synkronisering.

Når den første klargøring er afsluttet, sker periodisk synkronisering hver 24. time. Eventuelle ændringer, der foretages i skybiblioteket, vil blive udbredt 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 ind og bruge Unity Connection-tjenesterne.

Når klareringen af Entra ID er fuldført for en bestemt klynge, kan du ikke oprette nye synkroniseringsaftaler eller ændre konfigurationsindstillinger for den samme klynge undtagen gruppeindstillingerne. Hvis du vil oprette en ny synkroniseringsaftale for den samme klynge, skal du gå til siden Service Management og deaktivere katalogtjenesten. Du kan derefter oprette en ny aftale til klargøring.

Hvis synkroniseringen mislykkes af en eller anden grund, afspejles de seneste klargøringsæ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'en. Hvis valgmulighed 1 f.eks. er valgt til brugerid-tilknytningen under klargøring, skal du sikre dig, at user .userprincipalname er angivet som UID i afsnittet „Yderligere krav“.

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

Brugerfelter til Unity Connection synkroniseret	Webex Common Identity Service Brugerfelter synkroniseret
Bruger-ID	Brugernavn synkroniseres, hvis indstillingen „Bruger-id i Unity Connection knytter til e-mail-id for brugeren i Webex“ er valgt.
	Eksisterende bruger-id (Mail ID i Unity Connection) fra Unity-forbindelsesdatabasen, der matcher mail-id'et i Webex Common Identity Service, hvis indstillingen „Mail ID i Unity Connection knytter til e-mail-id for brugeren i Webex“ er valgt.
	Mail-id uden domænedelen, hvis indstillingen „Bruger-id i Unity Connection knytter til e-mail-id uden domænedel af brugeren i Webex“ er valgt.
Fornavn	Navn.givennavn
Efternavn	Navn.Efternavn
Visningsnavn	Visningsnavn
Telefonnummer	Telefonnummer.Work
Mobilnummer	Telefonnummer.mobil
E-mail-id	e-mails
Titel	titel

Eventuelle opdateringer, der foretages til brugerdataene i skybiblioteket efter katalogsynkronisering, opdateres i den næste synkroniseringsperiode. Dette skyldes, at skykataloget synkroniseres med jævne mellemrum en gang om dagen.
Single sign-on (SSO) skal bruges til logins. Dette dokument dækker kun integration af single sign-on (SSO).
Hvis du efter genklargøring ser, at de brugere, der er markeret som Ikke-matchede brugere, er de samme som Nye brugere (brugere, der deler det samme mail-id), anbefaler vi, at du venter i højst 48 timer, før synkroniseringsændringerne træder i kraft.
1. Deaktiver katalogtjenesten fra siden Service Management i Control Hub.
2. Deaktiver af krydsningsfeltet Aktivér synkronisering fra LDAP-server i LDAP-systemet.
3. Aktivér katalogtjenesten fra siden Service Management i Control Hub.

Tilvejebringelsesstatus

På instrumentbrættet for katalogtjeneste kan du se og spore status for din klynge og gennemse fejl.

Følgende tabel viser klareringsstatus, beskrivelse og de tilsvarende handlinger.

Tabel 1. Tilvejebringelsesstatus
Tilvejebringelsesstatus	Beskrivelse
Forarbejdning	Tilvejebringelsen er i gang.
Handling påkrævet	Tag de nødvendige skridt, hvis der kræves manuel indgriben til en bestemt klynge. For eksempel Hvis du vil fortsætte eller opgive synkronisering 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 et hvilket som helst trin i klargøringen, skal administratoren kontrollere siden H ændelses Cisco Webex Control Hub historik for tjenesten: Katalogtjeneste. Dette hjælper dig med at isolere, fejlsøge og foretage fejlfinding af mulige problemer. For at få adgang til begivenheder, se Få adgang til begivenhedsoversigten for hybridtjenester. For mere information om de forskellige begivenhedstyper og deres detaljer, se tabellen 'Begivenheder og mulige løsninger' nedenfor.
Tilvejebragt	Klyngeklarbejdelsen er fuldført.
Ikke klargjort	Klyngeforsyningen er ikke startet endnu.

Tabel 2. Begivenheder og resolutioner
Begivenheder	Handling påkrævet
Periodisk synkronisering mislykkedes	Sørg for, at du venter på færdiggørelsen af næste dags periodiske synkronisering. Kontroller, at synkroniseringen er gennemført korrekt. Hvis problemet fortsætter, skal du kontakte Cisco TAC support.
Datakopieringsfejl	Klik på Prøv igen knappen for at fortsætte dataoverførslen. Hvis problemet fortsætter, skal du kontakte Cisco TAC support.
Fejl i synkroniseringsaftalen	Klik på knappen Prøv igen for at forsøge at oprette synkroniseringsaftalen igen. Hvis problemet fortsætter, skal du kontakte Cisco TAC support.
Spring over periodisk synkronisering	Ingen handling kræves.
Dataoverførslen mislykkedes	Klik på Prøv igen knappen for at fortsætte dataoverførslen. Hvis problemet fortsætter, skal du kontakte Cisco TAC support.
Brugersynkronisering uoverensstemmende	Kontroller katalogsynkroniseringslogfilerne i Unity Connection for fejl i brugersynkronisering, eller kontakt Cisco TAC support for yderligere hjælp.
Brugere klargjort med succes	Ingen handling kræves.
Periodisk synkronisering af dataoverførsel er vellykket	Ingen handling kræves.
Kunne ikke hente brugeroplysninger om nogle af de valgte grupper fra Webex Common Identity.	Naviger til instrumentbræ ttet, og vælg klyngen for at få oplysninger om de mislykkede grupper ved at klikke på det medfølgende downloadlink. Kontroller, om brugerne er til stede 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å Prøv igen knappen 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 ind, når kl Cisco Unity Connection yngeklargøring er udført fra Control Hub.

To måder at importere brugere på er som følger:

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

Udvid Bru gere i Cisco Unity Connection Administration og vælg Importer brugere.

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

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

Opret Unity Connection-brugere fra Entra ID-data ved hjælp af Bulk Administration værktøj

I Cisco Unity Connection Administration skal du udvide Værktø jer og vælge Bulk Administration Tool.

Hvis du vil tilføje Unity Connection-brugere, skal du udføre følgende trin på siden Masseadministrationsværktøj:

Vælg Ek sporter fra Vælg operation.
Vælg Brugere fra LDAP-mappe under Vælg objekttype.
Indtast værdierne i alle de krævede felter.
Vælg Send.

Dette opretter en CSV-fil med brugerdataene til Entra ID. Åbn CSV-filen i et regnearksprogram eller i en teksteditor, og rediger dataene efter behov. Importer nu dataene fra CSV-filen.
Vælg Opret fra Vælg operation.
Vælg Brugere med postkasse fra Vælg objekt type.
Indtast værdierne i alle de krævede felter.
Vælg Send.

Når importen er fuldført, skal du gennemse den fil, du har angivet i feltet Filnavn for mislykkede objekter, for at kontrollere, 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 muligvis står over for i de forskellige faser af synkronisering af brugere fra Control Hub til Unity Connection-databasen.

Ikke-matchede brugere

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

Fejl — Datakopiering mislykkedes. Prøv igen

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

Løsning: For at bekræfte, om din forbindelse er vellykketCisco 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 er afbrudt eller kan ikke sende brugerdata til Unity Connection-databasen.

Løsning: Kontroller 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 — Det lykkedes ikke at oprette synkroniseringsaftale. Prøv igen

Kommunikationen mellem Cloud-Connected UC og Unity Connection er afbrudt eller kan ikke skubbe synkroniseringsaftalens data ind i Unity Connection-databasen.

Løsning: Kontroller 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 med succes.

Fejl — Det lykkedes ikke at aktivere mappesynkronisering. Prøv igen

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

Løsning: Kontroller 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.

Kan ikke hente oplysninger om synkroniseringsaftalen. Prøv venligst efter et stykke tid.

Kommunikationen mellem Cloud-Connected UC og Unity Connection er afbrudt.

Løsning: Kontroller 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 førstegangstildeling kan du støde på problemer med at downloade brugerdata fra en eller flere af de specifikke grupper, du har valgt til synkronisering. Klik på downloadlinket i fejlmeddelelsen for at få vist oplysninger om de mislykkede gruppeoplysninger.

Du kan også downloade mislykkede gruppeoplysninger for klynger, der allerede er klargjort, fra siden Hændelses historik iCisco Webex Control Hub. Naviger til instrumentbræ ttet, og vælg klyngen for at få oplysninger om de mislykkede grupper ved at klikke på det medfølgende downloadlink. Kontroller, om brugerne er til stede i Webex Common Identity, 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 i mindst 60 sekunder, før du aktiverer katalogtjenesten til synkronisering.
Efter sletning, hvis du vil integrere den samme Unity Connection-klynge til organisationen igen, skal du først deaktivere katalogtjenesten og derefter genoprette den samme klynge.
Under klargøring udfyldes listen over 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.

Cisco AI Assistant

Tak for din feedback.