Stöd för Webex molnansluten UC Directory Service för Unified CM

Stöd för Webex molnanslutna UC-katalogtjänster

Du kan synkronisera och hantera användare från molnet Active Directory (till exempel Microsoft Entra ID) till lokal eller molnbaserad UC-infrastruktur som Cisco Unified Communications Manager (Unified Communications Manager) och Cisco Unity Connection (Unity Connection) med Webex Cloud-Connected UC Directory Service. Under synkroniseringen importerar systemet en lista över användare och tillhörande användardata från Entra ID (eller en liknande Cloud Directory-tjänst) som synkroniseras till Webex Common Identity Service. Du måste välja det Unified CM kluster från Control Hub som behöver synkroniseras, välja lämplig fältmappning för Unified CM användar-ID och sedan välja önskat synkroniseringsavtal för att utföra synkronisering.

Förutsättning

Omborda Unified CM klustren till molnansluten UC. Se Konfigurera molnansluten UC för lokala enheter
Synkronisera användare av Entra ID till Control Hub
Unified Communications Manager-kluster måste vara version 11.5 (1) SU9, 12.5 (1) SU4 eller 14 och senare

Aktivera katalogtjänst

Du måste aktivera Directory Service för varje kluster i Webex Cloud-Connected UC för att tillåta synkronisering och hantering av användare från molnet till Unified Communications Manager.

Som standard är katalogtjänsten inte aktiverad för alla inloggade kluster.

1	Från kundvyn i Control Hub går du till Tjänster > Ansluten UC. Klicka på Inventory på UC Management-kortet. Listan över klustergrupper visas med beskrivning, status, kluster och noder.
2	Klicka på Detaljer bredvid klustergruppen som noden tillhör. Sidan Inventering visas och visar listan över kluster som tillhör den valda klustergruppen.
3	Klicka på Detaljer bredvid klustret som den specifika produktnoden tillhör. Nodnamnet med version, produkt och status visas.
4	Klicka på ikonen för ellip sen ∫ bredvid Händelsehistorik och välj Service Management. Sidan Service Management visas med listan över tjänster.
5	Använd växlingsknappen för att aktivera katalogtjänsten.
6	Klicka på Skicka.

Katalogtjänst

Använd katalogtjänstkortet för att synkronisera användare från molnbaserade kataloger till Unified Communications Manager.

1	Från kundvyn i Control Hub går du till Tjänster > Ansluten UC.
2	Klicka på Visa kluster på Katalogtjänstkortet. Sidan Katalogtjänst visas.

Du kan visa listan över klusterdetaljer på den här sidan.

Visa klusterdetaljer

Välj ett kluster som du vill synkronisera användardata med på sidan för val av kluster i katalogtjänsten.

Sidan för val av kluster innehåller också information om klustret, status för etablering, senast synkroniserat tillstånd, den tillhörande produkten och orsaken till felet, om det finns några. Du kan välja den lokala tidszonen. Som standard är webbläsarens tidszon markerad.

Information om kluster	Beskrivning
Klusternamn	Namnet på klustret.
Status	Status för synkronisering.
Senast synkroniserad	Datum för den senaste synkroniseringen.
Produkt	Detaljer om produkten.

Synkronisering av tjänster för tillhandahållande av katalogtjänster

Med Webex Cloud-Connected UC Directory Service-synkronisering kan du importera slutanvändardata från Webex Common Identity Service till Unified Communications Manager-databasen för att visas i fönstret Slutanvändarkonfiguration.

Se till att du inte utför några etableringsåtgärder under den schemalagda Webex Cloud-Connected UC-moduluppgraderingen.

Om du utför provisionering under moduluppgradering kan steg 1, 2 eller 3 visa feltillstånd efter en viss period och knappen Försök igen visas efter någon tid. Du kan starta om etableringen genom att klicka på knappen Försök igen. Se till att du verifierar klusterstatusen för slutförd uppgradering innan du försöker etablera igen.

Välj ett kluster som du vill etablera för att aktivera synkronisering på sidan för val av kluster i Katalogtjänst.

Klicka på Starta provisionering.

I konfigurationsfönstret Fältmappning kontrollerar du att den mappning som valts för fältet Unified CM Användar-ID identifierar användaren i klustret på ett unikt sätt när du har startat etableringen.

Välj lämplig Unified CM användar-ID-fältmappning för att synkronisera användaren från Webex.

Användar-ID-fält i Unified CM mappar till e-postID för användaren i Webex.
Mail-ID-fält i Unified CM mappar till e-postID för användaren i Webex.
Användar-ID-fält i Unified CM mappar till e-post-ID utan domändel av användaren i Webex.

Nytt användarkonto skapas om mappningen inte kan göras framgångsrikt för ett befintligt användarkonto iUnified CM. E-post-ID (eller ID-delen av E-post-ID) för användaren kommer att användas som unik identifierare för det nyskapade användarkontot.

Klicka på Nästa.

Välj ett avtal i listrutan för att skapa ett nytt synkroniseringsavtal.

När det nya synkroniseringsavtalet har skapats tas alla befintliga synkroniseringsavtal som pekar på den lokala katalogen bort. Du kan göra ändringar i det nya synkroniseringsavtalet när det har skapats.

]

I avsnittet Förhandsgranskning av avtal granskar du avtalsinformationen (befintlig extern LDAP-kataloginformation som finns tillgänglig i Unified Communications Manager) innan du startar synkroniseringen.

Du kan visa följande detaljer:

Gruppinformation
Tillämpad funktionsgruppsmall med universella linje- och enhetsmallar
Linje- och maskinformation för synkroniserade telefonnummer för infogade användare
Nyetablerade användare och deras tillägg

Standardanvändarfält som ska synkroniseras avsnitt. Följande användarfält synkroniseras från Webex Common Identity Service till Unified Communications Manager:

Användarfält för enhetlig kommunikation synkroniserade	Användarfält för Webex Common Identity Service synkroniserade
Användar-ID	Användarnamn synkroniseras om alternativet ”Användar-ID-fält Unified CM i mappar till e-postID för användaren i Webex” väljs.
	Befintligt användar-ID (Mail ID inUnified CM) från Unified Communications Manager-databasen som matchar med Mail ID i Webex Common Identity Service om alternativet ”Mail ID Unified CM i mappar till e-postID för användaren i Webex” är valt.
	E-post-ID utan domändelen om alternativet ”Användar-ID i Unified CM mappar till e-post-ID utan domändel av användaren i Webex” är valt.
Förnamn	Namn.givennamn
Efternamn	Namn.familjenamn
Visningsnamn	Visningsnamn
Telefonnummer	Telefonnummer.Work
Mobilnummer	Telefonnummer.mobil
E-postnummer	e-postmeddelanden
Titel	titel

Värdnamn eller IP-adress för katalogservern

Klicka på Nästa för att välja gruppfiltret.

Välj den eller de specifika grupper som du vill synkronisera i listrutan Välj grupper. Klicka på kryssrutan Markera alla grupper om du vill markera alla användargrupper.

Som standard synkroniseras alla användare. Om du inte väljer någon grupp synkroniseras alla användare och tillhörande användardata automatiskt.

För kapslade grupper i en katalog måste användarna välja användargruppen för undergruppen specifikt under etableringen eftersom de inte ingår som standard i den överordnade gruppen. Du måste kontrollera om det finns någon repetitiv kapsling (om någon) för att säkerställa att endast de användare som krävs inkluderas under etableringen.

Eventuella ändringar av synkroniseringsavtalet, till exempel borttagning av en målanvändare eller målgrupp, kommer inte att spridas under periodisk synkronisering. Du bör inaktivera katalogtjänsten för det klustret från Control Hub och sedan konfigurera klustret igen med det nya eller ändrade synkroniseringsavtalet.

Klicka på Nästa för att förbereda synkroniseringsprocessen.

Aktivera synkroniseringen i fönstret Aktivera synkronisering när systemet har kopierat användardata till ett tillfälligt lagringsutrymme Unified CM och ett nytt synkroniseringsavtal har skapats (efter steg 1 och 2 som visas i skärmdumpen nedan).

Med alternativet Ladda ner rapport kan du visa resultaten delvis. För att hämta de fullständiga rapporterna för Unified CM klustret, kör följande CLI-kommando:. file get activelog /cm/trace/CIService/log4j/DryRunResults.csv Här Unified CM visar torrkörningsresultatet för följande:

Nya användare — Användare som finns på Webex Identity Service och inte finns i databasen Unified CM
Användare matchade —Användare som finns på Webex Identity Service såväl som i databasen Unified CM
Felaktiga användare — Använ dare som finns i Unified CM databasen men inte finns i Webex Identity Service

Du kan kontrollera rapporten och bestämma om du vill behålla samma lista med användare och lägga till eller ta bort användare. Baserat på beslutet kan du stoppa processen och återställa provisioneringsändringarna.

Alla uppdateringar som görs av användardata i molnkatalogen efter katalogsynkronisering uppdateras under nästa synkroniseringsperiod. Detta beror på att molnkatalogen synkroniseras regelbundet en gång om dagen.

Efter verifieringen av synkroniseringsavtalet klickar du på Förhandsgranska Unified CM för att logga in på den lokala infrastrukturen och göra ändringar i det nyskapade synkroniseringsavtalet.

VPN-åtkomst krävs.

Du kan bara redigera gruppinformationen förUnified CM. Du kan inte byta namn på avtalet eller ändra någon av detaljerna.

Markera kryssrutan för att godkänna villkoren som synkroniseringsavtalet granskas och verifieras iUnified CM.

Klicka på Aktivera synkronisering för att fortsätta synkroniseringen.

Under synkroniseringen kommer du inte att kunna utföra några åtgärder förrän du har slutfört den. När synkroniseringen har slutförts för ett visst kluster listar sidan Katalogtjänst detta kluster med ett Provisionerat tillstånd. För närvarande har du godkänt Entra ID att tillhandahålla och synkronisera Webex-användare till UC-infrastruktur och slutfört stegen för att konfigurera synkronisering.

När den första provisioneringen är klar sker periodisk synkronisering var 24:e timme. Eventuella ändringar som görs i molnkatalogen kommer att spridas till klustren under denna period.

Du måste aktivera synkronisering inom 20 timmar från det att det nya avtalet har skapats. LDAP-synkroniserade användare blir inaktiva och tas bort efter 24 timmars inaktivitet. Användare kommer inte att kunna logga in och använda Unified CM tjänsterna.

När etableringen av Entra ID har slutförts för ett visst kluster kan du inte skapa några nya synkroniseringsavtal eller ändra några konfigurationsinställningar för samma kluster förutom gruppinställningarna. Om du vill skapa ett nytt synkroniseringsavtal för samma kluster bör du gå till sidan Service Management och inaktivera katalogtjänsten. Du kan sedan skapa ett nytt avtal för provisionering.

Om synkroniseringen av någon anledning misslyckas kommer de senaste ändringarna i etableringen att återspeglas i nästa synkroniseringsperiod nästa dag.

Om du använder Entra ID IdP under SSO-autentisering efter framgångsrik etablering kontrollerar du att du konfigurerar rätt Anspråk i Entra ID IdP. Om till exempel alternativ 1 är valt för användarid-mappningen under etablering, se till att det user.userprincipalnameär inställt som UID i avsnittet ”Ytterligare anspråk”.

Följande attribut synkroniseras från Webex Common Identity Service till Unified Communications Manager:

Användarfält för enhetlig kommunikation synkroniserade	Användarfält för Webex Common Identity Service synkroniserade
Användar-ID	Användarnamn synkroniseras om alternativet ”Användar-ID-fält Unified CM i mappar till e-postID för användaren i Webex” väljs.
	Befintligt användar-ID (Mail ID inUnified CM) från Unified Communications Manager-databasen som matchar med Mail ID i Webex Common Identity Service om alternativet ”Mail ID Unified CM i mappar till e-postID för användaren i Webex” är valt.
	E-post-ID utan domändelen om alternativet ”Användar-ID i Unified CM mappar till e-post-ID utan domändel av användaren i Webex” är valt.
Förnamn	Namn.givennamn
Efternamn	Namn.familjenamn
Visningsnamn	Visningsnamn
Telefonnummer	Telefonnummer.Work
Mobilnummer	Telefonnummer.mobil
E-postnummer	e-postmeddelanden
Titel	titel

Alla uppdateringar som görs av användardata i molnkatalogen efter katalogsynkronisering uppdateras under nästa synkroniseringsperiod. Detta beror på att molnkatalogen synkroniseras regelbundet en gång om dagen.
Single sign-on (SSO) måste användas för inloggningar. Detta dokument omfattar endast integration med enkel inloggning (SSO).
Innan du installerar om ett kluster från Control Hub rekommenderar vi att du manuellt stoppar Dirsync-tjänsten från det grafiska gränssnittet. Cisco Unified Serviceability
Om du ser att användarna som är markerade som Mismatchade användare är desamma som Nya användare (användare som delar samma e-postID), rekommenderar vi att du väntar i högst 48 timmar innan synkroniseringsändringarna träder i kraft. Om du vill se de uppdaterade ändringarna omedelbart kontrollerar du att du utför följande innan du installerar om:
1. Inaktivera katalogtjänsten från sidan Service Management i Control Hub.
2. Ta bort Webex Common Identity Service-synkroniseringsavtalet frånUnified CM.
3. Inaktivera krys srutan Aktivera synkronisering från LDAP-server på sidan LDAP-systemkonfiguration i Cisco Unified CM Administration användargränssnittet.
4. Ta bort slutanvändarna från fönstret Slutanvändare.
5. Aktivera katalogtjänsten från sidan Service Management i Control Hub.

Avsättningsstatus

På instrumentpanelen för katalogtjänst kan du visa och spåra klustrets status och granska fel.

I följande tabell visas provisionsstatus, beskrivning och motsvarande åtgärder.

Tabell 1. Tilldelningsstatus
Avsättningsstatus	Beskrivning
Bearbetning	Tillhandahållandet pågår.
Åtgärd krävs	Vidta nödvändiga åtgärder om det krävs någon manuell intervention för ett visst kluster. Till exempel Om du vill fortsätta eller överge synkroniseringen efter torrkörning. När det nya avtalet har skapats kontrollerar du om det finns aviseringar och vidtar nödvändiga åtgärder efter behov.
Fel	Om det krävs några åtgärder i guiden Aktivera synkronisering kontrollerar du dem och vidtar vid behov nödvändiga åtgärder. I händelse av fel i något skede av etableringen bör administratören granska sidan Händelsehistorik Cisco Webex Control Hub för tjänsten: Katalogtjänst. Detta hjälper dig att isolera, felsöka och felsöka eventuella problem. För att komma åt händelser, se Å tkomst till händelsehistoriken för hybridtjänster. För mer information om de olika händelsetyperna och deras detaljer, se tabellen ”Händelser och möjliga lösningar” nedan.
Tillhandahålls	Klusterprovisioneringen är klar.
Ej tillhandahållet	Klusterprovisioneringen har inte påbörjats än.

Tabell 2. Händelser och resolutioner
Händelser	Åtgärd krävs
Periodisk synkronisering misslyckades	Se till att du väntar på slutförandet av nästa dags periodiska synkronisering. Kontrollera att synkroniseringen har slutförts. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.
Datakopieringsfel	Klicka på Försök igen knappen för att fortsätta dataöverföringen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.
Synkroniseringsavtal misslyckades	Klicka på knappen Försök igen för att försöka skapa synkroniseringsavtalet igen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.
Hoppa över periodisk synkronisering	Ingen åtgärd krävs.
Dataöverföringen misslyckades	Klicka på Försök igen knappen för att fortsätta dataöverföringen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.
Användarsynkronisering matchar inte	Kontrollera katalogsynkroniseringsinlogg Unified CM ningarna för fel i användarsynkroniseringen eller kontakta Cisco TAC supporten för ytterligare hjälp.
Användare som har etablerats framgångsrikt	Ingen åtgärd krävs.
Periodisk synkronisering av dataöverföring har lyckats	Ingen åtgärd krävs.
Det gick inte att hämta användarinformation för några av de valda grupperna från Webex Common Identity.	Navigera till instrument panelen och välj klustret för att få information om de misslyckade grupperna genom att klicka på nedladdningslänken. Kontrollera om användarna finns i Webex Common Identity och klicka på Försök igen. Kontakta Cisco TAC support för ytterligare hjälp.
Det gick inte att hämta användarinformation för alla valda grupper från Webex Common Identity.	Klicka på Försök igen knappen för att fortsätta dataöverföringen. Om problemet kvarstår, kontakta Cisco TAC supporten för ytterligare hjälp.

Felsökning av synkroniseringsproblem

Det här avsnittet innehåller nödvändig information och lösningar för att lösa några av de vanliga problemen som du kan stöta på under de olika stadierna av synkronisering av användare från Control Hub till Unified Communications Manager-databasen.

Felaktiga användare

Om du ser användare som inte matchar aktiverar du synkronisering inom 20 timmar efter det att det nya avtalet har skapats. Befintliga användare markeras som inaktiva och raderas Unified CM efter 24 timmars inaktivitet.

Fel — datakopieringen misslyckades. Vänligen försök igen

Kommunikationen mellan molnansluten UC och Webex-molnet störs eller det går inte att hämta användardata från Webex-molnet.

Lösning: Kontrollera statusen för Cisco Cloud dessa tjänster på: https://status.webex.com/ för att bekräfta om anslutningen fungerar. Klicka på Försök igen.
Kommunikation mellan molnansluten UC och Unified CM störs eller kan inte skicka användardata till Unified CM databasen.

Lösning: Kontrollera nätverksanslutningen mellan molnansluten UC Unified CM och klicka på Försök igen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.

Fel — Det gick inte att skapa synkroniseringsavtal. Vänligen försök igen

Kommunikation mellan molnansluten UC och Unified CM störs eller kan inte skicka synkroniseringsavtalsdata till Unified CM databasen.

Lösning: Kontrollera nätverksanslutningen mellan molnansluten UC Unified CM och klicka på Försök igen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.
Synkroniseringsavtalet skapades inte framgångsrikt.

Fel — Det gick inte att aktivera katalogsynkronisering. Vänligen försök igen

Kommunikationen mellan molnansluten UC och Unified CM störs, och Cisco DirSync-tjänsten utlöses inte.

Lösning: Kontrollera nätverksanslutningen mellan molnansluten UC Unified CM och klicka på Försök igen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.

Det gick inte att hämta information om synkroniseringsavtalet. Vänligen försök efter en tid.

Kommunikation mellan molnansluten UC och Unified CM störs.

Lösning: Kontrollera nätverksanslutningen mellan molnansluten UC Unified CM och klicka på Försök igen. Om problemet kvarstår kontaktar du suppor Cisco TAC ten.

Det gick inte att hämta användardata för valda grupper

Under första etableringen kan det hända att du får problem med att hämta användardata från någon av de specifika grupperna som du har valt för synkronisering. Klicka på nedladdningslänken i felmeddelandet om du vill visa information om den misslyckade gruppinformationen.

Du kan också hämta information om misslyckade grupper för kluster som redan är etablerade från sidan Händelsehistorik iCisco Webex Control Hub. Navigera till instrument panelen och välj klustret för att få information om de misslyckade grupperna genom att klicka på nedladdningslänken. Kontrollera om användarna finns i Webex Common Identity och klicka på Försök igen. Kontakta Cisco TAC support för ytterligare hjälp.

Kända problem och begränsningar för Webex Cloud-Connected UC-katalogtjänstsynkronisering

Om du upplever ett problem med den här funktionen, kontrollera om det är något som vi redan känner till och har en rekommenderad lösning.

Du kan inaktivera katalogtjänsten för ett kluster från Control Hub och sedan återaktivera klustret igen. Vi rekommenderar att du väntar i minst 60 sekunder innan du aktiverar katalogtjänsten för synkronisering.
Om du vill integrera samma Unified CM kluster till organisationen igen efter borttagning måste du först inaktivera katalogtjänsten och sedan återupprätta samma kluster.
Under etableringen fylls inte gruppinformationslistan på grund av synkroniseringsproblem med Webex Common Identity Service. Användare rekommenderas att avbryta etableringen och försöka igen efter en tid.

Cisco AI Assistant

Tack för din feedback.