> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/sv/adminhornan/account-and-endpoint-management/scim-guide.md).

# Fälthandbok för SCIM för Entra ID och Okta

En guide för att skapa anpassade SCIM-mappningar mellan Entra ID eller Okta och Zoom

## Översikt

Zooms SCIM2 API exponerar en stor katalog av användarattribut som styr licensiering, produktberättiganden, roller, regioner och tjänstespecifik konfiguration. De färdiga provisioneringsintegreringarna för både Microsoft Entra ID och Okta mappar endast en liten delmängd av dessa — tillräckligt för att skapa, uppdatera och inaktivera användare, men inte tillräckligt för att provisionera Zoom Phone-webbplatser, paket för kontaktcenter, roller för Revenue Accelerator eller något av de dussintals andra attribut som Zoom stöder.

Den här guiden beskriver en metod som kan upprepas för att lägga till *valfritt* SCIM-attribut för Zoom i din etableringskonfiguration. I stället för att dokumentera ett enskilt attribut förklarar den den underliggande modellen, så att administratörer kan slå upp ett attribut i referensen för Zooms SCIM2-API och konfigurera det självständigt, utan att behöva vänta på att en produktspecifik artikel publiceras.

### Så använder du den här guiden

Läs först introduktionen som börjar med [**Förstå SCIM-attribut**](#understanding-scim-attributes) samt de efterföljande avsnitten – förutsättningar, katalogdata, referensscenarier och verifiering på Zoom-sidan. De gäller oavsett vilken identitetsleverantör (IdP) du använder. Gå sedan igenom avsnittet om Microsoft Entra ID eller Okta, beroende på vilken du använder. Vart och ett av dessa avsnitt är komplett, från det första konfigurationssteget till verifiering och genomarbetade exempel. Du behöver inte växla mellan dem.

För grundläggande SSO- och SCIM-begrepp som ligger till grund för den här guiden, se [SSO-fälthandboken](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), [artikeln om Zoom SSO och etablering för Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121), och den [Zoom SSO-artikeln för Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

{% hint style="danger" %}
**Varning**

Felkonfigurerad provisionering påverkar befintliga användare, inklusive borttagning av licenser som redan används. Validera varje ändring mot en enda testanvändare innan du tillämpar den på en skarp miljö.
{% endhint %}

### **Förutsättningar för att använda SCIM**

Allt i den här delen gäller oavsett identitetsleverantör. Läs detta innan du går vidare till dina identitetsleverantörsspecifika instruktioner.

#### Krav som är gemensamma för båda identitetsleverantörerna

* Zoom-konto med Business, utbildning eller Enterprise och en godkänd [Anpassad URL](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540)
* Zoom-kontoägare eller admin-behörigheter
* [enkel inloggning](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) aktiverat på Zoom-kontot
* En [verifierad associerad domän](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) på Zoom-kontot, som matchar e-postdomänen för användarna som ska etableras
* SCIM-provisionering redan etablerad mellan identitetsleverantören och Zoom
* Det Zoom-licens-, plan-, tilläggs- eller konfigurationsobjekt som tilldelas måste redan finnas och vara tillgängligt på Zoom-kontot

Krav som är specifika för respektive identitetsleverantör anges i början av respektive avsnitt.

#### Begränsningar som är gemensamma för båda identitetsleverantörerna

* SCIM tilldelar endast befintliga behörigheter. Det kan inte skapa objekten som det hänvisar till. Se avsnittet [**Innan du försöker med avancerad mappning måste objekten på Zoom-sidan finnas innan SCIM kan referera till dem**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) nedan.
* Vissa attribut accepterar endast ett värde per användare. En Zoom Phone-samtalsplan är ett exempel — tilläggspaket som Customer Engagement Pack kan inte provisioneras via SCIM.
* Den `userType` attributet är enligt Zoom planerat att fasas ut.

## **Introduktion**

### **Förstå SCIM-attribut**

Administratörer som förstår hur ett Zoom SCIM-attribut är uppbyggt kan konfigurera vilket attribut som helst som Zoom stöder. Administratörer som följer ett recept kan endast konfigurera det attribut som receptet beskriver. Det här avsnittet behandlar uppbyggnaden. Att mappa ett attribut till en datakälla kommer senare, i avsnitten om identitetsleverantören.

#### <mark style="color:blå;">Varje attribut har ett namnutrymme, ett namn, en datatyp och ett tillåtet värde</mark>

Låt oss börja med ett komplett, fungerande exempel. Här är identifieraren för att tilldela en användare till en Zoom Phone-plats:

```
urn:ietf:params:scim:schemas:extension:zoom:1.0:användare:zoomPhoneSite
```

Fyra egenskaper hos det här attributet är aktuella. Två av dem syns på raden ovan. De andra två hämtas från API-referensen och anges senare på ett annat ställe i din identitetsleverantör. För vårt omedelbara syfte fokuserar vi på två: den **Namnområde** och den **Namn**.

<table><thead><tr><th width="155.290771484375">Egenskap</th><th>Extraherat från exemplet</th><th>Vad den gör</th></tr></thead><tbody><tr><td><strong>Namnrymd</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:User</code></td><td>Berättar för Zoom vilket schema inställningen tillhör och fungerar som den gemensamma basen för nästan alla Zoom-produkts- och licensattribut. Skickas till Zoom som den första halvan av identifierare.</td></tr><tr><td><strong>Namn</strong></td><td><code>zoomPhoneSite</code></td><td>Identifierar den specifika Zoom-inställning som skrivs — här användarens Zoom Phone-plats. Skickas till Zoom som den andra halvan av identifierare. Skiftlägeskänslig.</td></tr><tr><td><strong>Datatyp</strong></td><td><code>string</code></td><td>Talar om för din identitetsleverantör vilken typ av värde attributet innehåller, så att det lagras och formateras korrekt. Skickas inte som en del av identifieraren, utan deklareras separat som <strong>Typ</strong> i Entra ID, eller <strong>Datatyp</strong> i Okta.</td></tr><tr><td><strong>Tillåtet värde</strong></td><td><code>LON-01</code>, ett platsnamn för Zoom Phone</td><td>Den inställning som faktiskt tillämpas på användaren. Fritext för vissa attribut, en fast uppsättning för andra — <code>Essentials</code>, <code>Premium</code> eller <code>Elite</code> för Zoom kontaktcenter, till exempel. Skickas till Zoom vid provisionering och tillhandahålls av mappningen i stället för identifieraren.</td></tr></tbody></table>

{% hint style="danger" %}
**Varning**

Zoom publicerar mer än ett namnområde för användartillägg. Produktkonfiguration och licensieringsattribut använder `urn:ietf:params:scim:schemas:extension:zoom:1.0:User`, vilket är det namnområde som den här guiden använder genomgående. Standardfält för Enterprise, till exempel `department`, `manager` och `costCenter` använd `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. En tredje, `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`, innehåller information om inloggningstyp som returneras i API-svar i stället för att konfigureras vid provisionering. Ett attribut som bygger på fel namnrymd godtas av din identitetsleverantör och ignoreras utan förvarning av Zoom.
{% endhint %}

#### <mark style="color:blå;">Leta reda på attributet du behöver i SCIM2 API-referensen</mark>

Den [Referens för SCIM2-API](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) är den auktoritativa listan över allt som Zoom accepterar under provisioneringen. Två åtgärder är viktiga: **Skapa en användare** och **Uppdatera en användare**.

Utgå främst från **Uppdatera en användare**. Skapandet sker en gång per person, men attribut ändras kontinuerligt – vid flytt till ett annat kontor, ändring av abonnemang, ändring av roll eller när någon slutar – så det mesta som provisioneringen faktiskt gör över tid är uppdateringar. **Uppdatera en användare** dokumenterar även värden för borttagning som **Skapa en användare** inte har någon anledning att inkludera, till exempel att ange `zoomPhoneCallingPlan` till `-1` för att ta bort alla samtalsplaner från en användare.

För att hitta ett attribut:

* Öppna SCIM2 API-referensen och gå till **Uppdatera en användare**.
* Leta upp följande i begärans innehåll: `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` objekt. Alla attribut som tas upp i den här guiden listas i det.
* Hitta attributet efter namn och spela in dess **datatyp** och dess **tillåtna värden**.
* Läs beskrivningen tillsammans med attributet. Beskrivningarna innehåller information om beteenden som du inte kan härleda från attributnamnet – `zoomPhoneExtNumber` som anges till `0` utlöser automatisk tilldelning av anknytning, `zoomPhoneCallingPlan` som anges till `-1` tar bort alla samtalsabonnemang, och `zoomPhoneNumber` måste hänvisa till ett nummer som redan är otilldelat i Zoom-kontot.

#### <mark style="color:blå;">Sammanställning av identifieraren: förälder, kolon, barn</mark>

Allt som anges inuti den `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` objekt är ett **barn** av det. Själva objektet är **överordnad**. Att skapa en identifierare innebär att ange föräldern, lägga till ett kolon och sedan lägga till barnet:

```
Förälder       urn:ietf:params:scim:schemas:extension:zoom:1.0:användare
Kolon        :
Barn        zoomPhoneSite

identifierare   urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite
```

Det är hela konstruktionen. Det finns ingen uppslagstabell att begära från Zoom och ingenting att generera — identifieraren är två saker du redan har, sammanfogade med ett kolon.

#### <mark style="color:blå;">Föräldern är densamma; bara barnet ändras</mark>

Eftersom den överordnade är fast är det samma åtgärd att konfigurera ett andra, femte eller femtonde attribut, med ett annat underordnat objekt tillagt:

```
Bas (förälder)              urn:ietf:params:scim:schemas:extension:zoom:1.0:användare

Zoom Phone plats            urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite
Zoom Phone-nummer          urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber
Zoom Phone-tillägg       urn:ietf:params:scim:schemas:extension:zoom:1.0:användare:zoomPhoneExtNumber
Zoom Phone samtalsplan  urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneCallingPlan
```

Samma överordnade gäller för alla andra Zoom-produkter. Inget i konstruktionen förändras när produkten gör det:

```
Paket för kontaktcenter     urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomContactCenterPackage
Revenue Accelerator roll   urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole
Arbetsplatspaket           urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace
Zoom Docs                  urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomDocs
```

Du lär dig alltså föräldern en gång. Därefter innebär konfigurering av ett nytt attribut att man bara slår upp tre saker i API-referensen: barnets namn, dess datatyp och dess tillåtna värden.

Om du kan sätta ihop en överordnad och en underordnad, ligger den svåraste delen av den här konfigurationen bakom dig. Det som återstår är att tala om för din identitetsprovider var varje värde ska komma ifrån — vilket behandlas i avsnitten om Entra ID och Okta nedan — och att avgöra vilka attribut du ska ta itu med först, vilket behandlas nästa.

#### <mark style="color:blå;">Två typer av mappning: grundläggande och avancerad</mark>

Inte alla attribut medför samma risk, och det är värt att sortera dem innan du konfigurerar något.

Den här guiden lånar begreppen **basic** och **avancerad** från [SSO-fälthandboken](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), som drar samma gräns för mappning av SAML-svar. Termerna beskriver **vad Zoom gör med värdet när det kommer fram**, inte hur svårt attributet är att konfigurera. Rent tekniskt är de två identiska: båda dokumenteras i samma **Uppdatera en användare** begärandekropp, båda byggs med samma konstruktion med överordnat värde och underordnat värde separerade av kolon, och båda deklareras och mappas genom samma steg i Entra ID och Okta.

* **Basic-mappning** skriver text i en användares profil. Zoom lagrar värdet exakt som det skickas och kontrollerar det aldrig mot något.
* **Avancerad mappning** gör ett anspråk på kontot. Zoom tar värdet och letar efter ett matchande objekt eller en ledig plats i en köpt plan — och den sökningen kan misslyckas.

<table><thead><tr><th width="199.435791015625"></th><th>Basic-mappning</th><th>Avancerad mappning</th></tr></thead><tbody><tr><td><strong>Vad värdet är</strong></td><td>Text som lagras på användarens profil</td><td>En pekare till ett objekt i Zoom, eller ett anspråk på en köpt plats</td></tr><tr><td><strong>Exempel</strong></td><td><code>department</code>, <code>title</code>, <code>costCenter</code></td><td><code>zoomPhoneSite</code>, <code>zoomContactCenterRole</code>, <code>zoomWorkplace</code></td></tr><tr><td><strong>Överordnad</strong></td><td>På toppnivå, eller Enterprise-tillägget</td><td>Zoom-tillägget</td></tr><tr><td><strong>Förhandsvillkor i Zoom</strong></td><td>Inget</td><td>Objektet måste finnas, eller platsen måste vara ledig</td></tr><tr><td><strong>Om värdet är fel</strong></td><td>Fel text visas på en profil</td><td>Attributet avvisas eller ignoreras tyst</td></tr></tbody></table>

Skillnaden ligger till grund för två praktiska beslut. Den avgör **vad du först måste konfigurera i Zoom** — ingenting för grundläggande mappning, potentiellt mycket för avancerad — och den avgör **vad ett misstag kostar**. En felaktig avdelning är ett kosmetiskt fel i en profil. Ett felaktigt platsnamn eller en otillgänglig licensplats innebär att en användare står utan en fungerande telefon eller utan den produkt som hen anställdes för att använda, och i en produktionsmiljö kan det ta ifrån någon en behörighet som personen redan hade.

Den skillnaden i konsekvenser är orsaken till att de två behandlas separat nedan.

#### <mark style="color:blå;">Basic-mappning: profilinformation</mark>

Basic-mappning fyller i de beskrivande fälten på en användares Zoom-profil. Zoom lagrar varje värde exakt som det skickas och validerar det aldrig mot ett befintligt objekt, så det finns inget att bygga i Zoom i förväg och inget som kan gå sönder om ett värde är fel.

**De grundläggande identitetsfälten är vanligtvis redan mappade.** `användarnamn`, `name.givenName`, `name.familyName`, `displayName` och `emails` ligga på den översta nivån i begärandetexten, utan någon överordnad nod, och både Entra ID- och Okta-integreringarna mappar dem direkt. Verifiera dem i stället för att återskapa dem. `title`, `phoneNumbers` och `locale` ligger också på den översta nivån, men kan behöva läggas till.

**Enterprise-fält använder en andra överordnad nod.** Strukturen ändras inte — bara den överordnade noden:

```
Bas (förälder)         urn:ietf:params:scim:schemas:extension:enterprise:2.0:användare

Avdelning            urn:ietf:params:scim:schemas:extension:Enterprise:2.0:användare:department
Kostnadsställe           urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter
Medarbetarnummer       urn:ietf:params:scim:schemas:extension:enterprise:2.0:användare:medarbetareNumber
Organisation          urn:ietf:params:scim:schemas:extension:enterprise:2.0:användare:organisation
Chef               urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
```

Att fylla i avdelning och kostnadsställe via SCIM kräver inte längre SAML-mappning.

{% hint style="info" %}
**Rekommendation**

Mappa först ett grundläggande attribut — `department` är ett bra alternativ och gås igenom som **Scenario 0** i referensscenarierna — och kör det från början till slut för en enda testanvändare innan du konfigurerar något under Zoom-tillägget. Ett `department` värde som visas korrekt i en Zoom-profil bekräftar schemadeklarationen, mappningen, omfånget och din förmåga att läsa provisioneringsloggarna. Varje avancerat attribut som följer skiljer sig bara åt i vad det hänvisar till, inte i hur det konfigureras.
{% endhint %}

#### <mark style="color:blå;">Avancerad mappning: produktkonfiguration och behörigheter</mark>

Avancerad mappning tilldelar det som en användare kan göra: en Zoom Phone-plats och en samtalsplan, en kontaktcenter-roll och ett paket, ett Workplace-paket, ett Revenue Accelerator-segment. Dessa attribut ligger under det överordnade Zoom-tillägget som används genom hela den här guiden.

Den viktiga skillnaden är att dessa värden inte lagras — de **slås upp**. Zoom tar värdet du skickar och söker efter ett matchande objekt eller en tillgänglig licens. Där grundläggande mappning skriver text till en profil gör avancerad mappning ett anspråk på kontots konfiguration och inventering, och det anspråket kan misslyckas.

Det är därför den här guiden ägnar ett helt avsnitt åt förutsättningar. Varje avancerat attribut beror på att något först har byggts eller köpts i Zoom-webbportalen, och felmoder är betydligt mindre förlåtande än en felstavad jobbtitel.

#### <mark style="color:blå;">De tre lager som är gemensamma för varje konfiguration</mark>

Oavsett vilket attribut eller vilken identitetsleverantör det gäller, är arbetet samma tre lager. Endast platsen för varje kontroll skiljer sig.

<table><thead><tr><th width="114.4166259765625">Lager</th><th>Syfte</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. Deklarera</strong></td><td>Berätta för identitetsleverantören att attributet finns i Zoom applikation så att det blir tillgänglig som ett mappningsmål.</td><td>Steg 1</td><td>Steg 1</td></tr><tr><td><strong>2. Mappa</strong></td><td>Definiera var värdet kommer ifrån.</td><td>Steg 2</td><td>Steg 2–3</td></tr><tr><td><strong>3. Omfattning</strong></td><td>Avgör vilka användare konfigurationen gäller för och när den körs.</td><td>Steg 3–5</td><td>Steg 4–5</td></tr></tbody></table>

När detta mönster väl är förstått är det att lägga till ett femte eller femtonde attribut en upprepning av samma tre lager, inte ett nytt projekt.

#### <mark style="color:blå;">Entra och Okta skiljer sig åt i var ett värde kan ha sitt ursprung</mark>

Detta är den enskilt mest betydande arkitekturella skillnaden mellan de två vägarna, och det förklarar varför samma Business-krav ger olika konfigurationer mellan Entra och Okta.

* **Entra ID hämtar endast värden från användarobjektets attribut.** Ett värde måste komma från ett fält på användaren — ett befintligt katalogfält eller ett särskilt utformat tilläggsattribut. Om katalogvärdet och Zoom-värdet inte är samma sträng krävs ett uttryck för att översätta mellan dem.
* **Okta kan hämta värden från antingen användarprofilen eller en grupptilldelning.** Att deklarera ett attribut med **Attributtyp: grupp** gör att värdet kan anges en gång för en grupp och ärvas av varje medlem. När konfigurationen följer organisationsstrukturen eliminerar detta behovet av översättningslogik helt.

Ingen av metoderna är universellt bättre, men de leder till olika konfigurationer.

### **Krav för förkonfiguration på Zoom-sidan**

#### <mark style="color:blå;">Innan du försöker med avancerad mappning måste objekt på Zoom-sidan finnas innan SCIM kan referera till dem</mark>

SCIM är en tilldelningsmekanism, inte en skapandemekanism – den kopplar en användare till konfiguration som redan finns på Zoom-kontot, och den **kan inte** skapa den konfigurationen åt användaren.

En stor andel av de avancerade mappningsattributen är **referenser**: värdet du skickar förväntas motsvara ett objekt som redan finns i Zoom – en plats, en roll, en mall, en köpt plan, ett visst nummer eller en anknytning. En regel gäller för alla:

> Om ett attribut namnger en sak måste den saken redan finnas, måste vara stavad exakt som skickad och — när den hämtar från en begränsad pool — måste ha oanvänd kapacitet.

När ett refererat objekt inte finns skapar SCIM det varken eller köar begäran. Attributet misslyckas antingen direkt, med felet returnerat i provisionsloggen, eller kastas tyst bort — Zoom accepterar nyttolasten, tillämpar ingenting och rapporterar framgång.

Avsnitten nedan går igenom förutsättningarna per produkt, med navigeringsväg och supportartikel för att bygga upp varje del. Läs anteckningarna på kontonivå och därefter avsnittet för varje produkt du tänker provisionera.

#### <mark style="color:blå;">Förutsättningar på kontonivå gäller innan någon produkt kan provisioneras</mark>

Kontokraven som anges i början av den här guiden – anpassad URL, SSO, SCIM-auktorisering och en verifierad kopplad domän – är förutsättningar för alla attribut som följer. Konfigurera säkerhet och SSO under [**Administrationscenter**](https://zoom.com/account) → [**Säkerhet och förtroende**](https://zoom.com/account/setting/security), och hantera kopplade domäner under [**Administrationscenter**](https://zoom.com/account) → **Konto** → [**Kontoprofil**](https://zoom.com/account); se [Konfiguration av SSO/SCIM för Zoom + Microsoft Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121).

Två ytterligare punkter är värda att uttryckligen nämna:

* **Att köpa en licens är inte samma sak som att tilldela den.** SCIM utför tilldelningen, men licensen måste finnas först. Se [Tilldela eller ta bort Zoom-licenser från användare](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911).
* **Licenserna måste tillhöra exakt den plan som efterfrågas.** Om du skickar ett licensattribut när det saknas lediga licenser för just den planen misslyckas det, även om en annan plan på kontot har ledig kapacitet.

#### <mark style="color:blå;">Zoom Phone</mark>

Zoom Phone har den största uppsättningen referensattribut eftersom en telefonanvändare sätts samman av flera delar av förköpt eller förbyggd infrastruktur.

| Attribut                                                                     | Vad som måste finnas redan                                                                                                                                                               | Hur det skapas                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Samma Zoom Phone-licens                                                      | En tillgänglig Zoom Phone-plats — den förutsättande behörigheten innan något nedan kan kopplas på.                                                                                       | Köp i förväg. Se [Köpa och tilldela Zoom Phone-licenser](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `zoomPhoneSite`                                                              | Platsen, namngiven exakt som värdet som skickas. Om attributet utelämnas tilldelas kontots huvudplats, som finns som standard när flera platser har aktiverats.                          | [Administrationscenter](https://zoom.com/account) → Produktkonfiguration → Telefonsystem → [Företagsinformation](https://zoom.com/pbx/page/telephone/settings#/settings) → **Lägg till plats**, eller **Importera** för att skapa flera samtidigt. Se [Hantera flera platser](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                                                          |
| `zoomPhoneNumber`                                                            | Numret, köpt eller portat in på kontot och för närvarande otilldelat. Ett nummer som redan innehas av en annan användare, samtalskö eller automatisk receptionist kan inte återanvändas. | [Administrationscenter](https://zoom.com/account) → Produktkonfiguration → Nummer → [Telefonnummer](https://zoom.com/cpw/page/phoneNumbers#/number-list). Köp eller portera numret här och lämna målnumret otilldelat så att SCIM kan göra anspråk på det. Se [Använda nummerhantering för att hantera telefonnummer](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) och [Hantera telefonnummer](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212).                                                          |
| `zoomPhoneExtNumber` (endast specifika värden)                               | En anknytning på 3–6 siffror som inte redan används. Krävs inte när du skickar `0`, vilket överlåter tilldelningen till Zoom.                                                            | [Administrationscenter](https://zoom.com/account) → Produktkonfiguration → Telefonsystem → [Användare och rum](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → markera objektet som innehåller anknytningen → **Profil** → **Anknytningsnummer** → **Redigera**. Se [Ändra inställningar för telefonanvändare](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338).                                                                                                                                                                |
| `zoomPhoneCallingPlan`                                                       | Samtalsplanen, köpt och med tillgänglig kapacitet, refererad till med sin exakta plankod.                                                                                                | Köp i förväg. Se [Köpa och tilldela Zoom Phone-licenser](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) och [Hantera telefonanvändare](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). Plankoderna finns i [referensen för Zoom Phone-samtalsplaner](https://developers.zoom.us/docs/api/references/phone-calling-plans/), eller returneras som `type` av [Lista samtalsplaner](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API:et tillsammans med antalet tillgängliga platser. |
| `zoomPhoneCallingPlanSubscription` (endast konton med flera prenumerationer) | Den specifika prenumeration som planen ska använda, när konto har fler än en prenumeration för samma plan.                                                                               | Planer och Fakturering → prenumerationshantering.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

**Anknytningsnummerpoolen delas mellan olika objekttyper, inte bara användare.** Samtalsköer, automatiska receptionister, grupper med delad linje och telefoner i gemensamma utrymmen använder alla anknytningsnummer från samma nummerserie. Detta är den vanligaste orsaken till felmeddelandet "extension already in use", eftersom anknytningsnumret ser ledigt ut när en administratör bara kontrollerar användarlistan.

**Ett porterat nummer kan inte tilldelas förrän porteringen är slutförd.** Numret måste både finnas på kontot och vara otilldelat. Att påbörja en portering uppfyller inget av dessa villkor.

**Platser är det vanligaste hindret** eftersom det finns särskilda krav för att skapa dem. Platsadresser valideras mot en databas med verkliga adresser eftersom de ligger till grund för nödsamtal. Påhittade kombinationer av adresser och postnummer avvisas med ett valideringsfel. Vid massimport av platser förväntar sig kolumnen Automatisk receptionist värdet `Yes` i stället för etiketttexten som visas i gränssnittet. Namn för uppringar-ID gäller främst i USA och Kanada och kan lämnas tomt om det orsakar ett valideringsfel.

#### <mark style="color:blå;">Zoom kontaktcenter</mark>

Provisionering av kontaktcenter är roll- och malldriven. Enskilda attribut måste matcha befintliga kontaktcenterobjekt, och mallen innehåller de inställningar som saknar ett eget SCIM-attribut.

| Attribut                        | Vad som måste finnas redan                                                                                                                             | Hur det skapas                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage`      | Paketet – `Essentials`, `Premium`, eller `Elite` – köpt med oanvända platser.                                                                          | Köp i förväg. För Premium kan du behöva kontakta Zoom Support för att först köpa ytterligare paket. Se [Ändra användarinställningar för Zoom kontaktcenter](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                                                             |
| `zoomContactCenterAddonsPlan`   | Planen för tillägg, köpt och med kapacitet.                                                                                                            | Köpa i förväg; kontoplan och faktureringsuppgifter.                                                                                                                                                                                                                                                                                                                                                                  |
| `zoomContactCenterRole`         | Rollen, standard eller anpassad, med exakt angivet namn. Om den utelämnas tilldelas standardrollen Agent, som finns som standard.                      | [Admincenter](https://zoom.com/account) → CX-hantering → Kontaktcenter → [Roller](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Lägg till** → konfigurera behörigheter → **Spara**. Se [Hantera roller i Zoom kontaktcenter](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                                                                            |
| `zoomContactCenterRegion`       | Regionen. Om den utelämnas tilldelas kontots huvudregion, som måste vara konfigurerad.                                                                 | [Admincenter](https://zoom.com/account) → CX-hantering → Kontaktcenter → [Inställningar](https://zoom.com/cci/index/admin#/admin-preferences) → Regioner → **Lägg till region** → ange ett namn och markera en SIP-zon → **Lägg till**. Se [Hantera regioner i Zoom kontaktcenter](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                                                      |
| `zoomContactCenterUserTemplate` | Användarmallen, med exakt angivet namn. Mallar av typen Lägg till tillämpas när användare skapas; mallar av typen Uppdatera tillämpas vid uppdatering. | [Admincenter](https://zoom.com/account) → CX-hantering → Kontaktcenter → Användare → [Mallar](https://zoom.com/cci/index/admin#/admin-agents#templates) → **Lägg till mall** → välj **Lägg till** → konfigurera roller, paket, köer och färdigheter → **Lägg till**. Se [Hantera mallar för användarinställningar i Zoom kontaktcenter](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

{% hint style="danger" %}
**Varning**

Funktioner för kontaktcenterregioner måste aktiveras av Zoom Support innan regioner kan skapas, och varje användare tillhör exakt en region. Eftersom detta är en supportbegäran snarare än en växla via självbetjäning bör du ta upp detta tidigt om en driftsättning i flera regioner planeras.
{% endhint %}

**Inkorgar, köer och färdigheter har inget SCIM-attribut.** För att provisionera dem ska du först skapa dem i [Admincenter](https://zoom.com/account) → CX-hantering → Kontaktcenter, koppla dem till en användarmall och tilldela mallen via `zoomContactCenterUserTemplate`. De blir därmed förutsättningar för *mallen* snarare än för den enskilda användaren – vilket också gör mallen till det enda objekt som behöver underhållas när kraven ändras.

<table><thead><tr><th width="123.2821044921875">Objekt</th><th>Hur det skapas</th></tr></thead><tbody><tr><td>Kö</td><td><a href="https://zoom.com/account">Admincenter</a> → CX-hantering → Kontaktcenter → <a href="https://zoom.com/cci/index/admin#/admin-queues">Köer</a> → <strong>Lägg till kö</strong> → namn, kanal, agenter → <strong>Spara</strong>. Se <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">Hantera köer i Zoom kontaktcenter</a>.</td></tr><tr><td>Kompetens</td><td><a href="https://zoom.com/account">Admincenter</a> → CX-hantering → Kontaktcenter → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">Färdigheter</a> → markera en kategori → <strong>Lägg till färdighet</strong> → namn → <strong>Lägg till</strong>. Se <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">Hantera färdigheter och färdighetskategorier</a>.</td></tr><tr><td>Inkorg</td><td><a href="https://zoom.com/account">Admincenter</a> → CX-hantering → Kontaktcenter → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">Inkorg</a> → <strong>Lägg till inkorg</strong>. Se <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">Hantera inkorgar i Zoom kontaktcenter</a>.</td></tr></tbody></table>

**Om både en mall och enskilda attribut anges har de enskilda värdena företräde.** Om en mall skickas tillsammans med `zoomContactCenterRole` åsidosätter rollattributet mallens rollinställning, så både den angivna rollen och mallen måste finnas.

#### <mark style="color:blå;">Zoom Revenue Accelerator</mark>

| Attribut                                                              | Vad som måste finnas redan                                                                   | Hur det skapas                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` och `zoomRevenueAcceleratorSubscription` | Det köpta ZRA-abonnemanget eller prenumerationen med en tillgänglig plats.                   | Köpa i förväg; kontoplan och faktureringsuppgifter.                                                                                                                                                                                                                                                                                                                         |
| `zoomRevenueAcceleratorRole`                                          | Rollen, standard eller anpassad – till exempel `Försäljning Manager` — med exakt det namnet. | [Admincenter](https://zoom.com/account) → Användare → [Roller](https://zoom.com/role#/) → **Revenue Accelerator** flik → **+ Lägg till roll** → namn och beskrivning → **Lägg till** → konfigurera behörigheter → **Spara ändringar**. Se [Använda rollhantering för Zoom Revenue Accelerator](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                       | Segmentet som användare tillhör.                                                             | Zoom Revenue Accelerator admin-inställningar.                                                                                                                                                                                                                                                                                                                               |
| `zoomRevenueAcceleratorRegion`                                        | Regionen — till exempel, `US`.                                                               | Zoom Revenue Accelerator admin-inställningar.                                                                                                                                                                                                                                                                                                                               |

#### <mark style="color:blå;">Zoom Workplace-licenser och konto-roller</mark>

Utöver de tre produkterna ovan bär standardanvändareposten roll- och licensreferenser som följer samma regel.

| Attribut                                                                                                                                                                                                                                                           | Vad som måste finnas redan                                                     | Hur det skapas                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles[]` (`value` / `visa`)                                                                                                                                                                                                                                       | Kontorollen, namngiven exakt. Roller refereras av SCIM, aldrig skapade av det. | [Admincenter](https://zoom.com/account) → Användare → [Roller](https://zoom.com/role#/) → **Lägg till roll** → namn och beskrivning → konfigurera behörigheter. Se [Använda rollhantering](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` och andra licens- eller tilläggsattribut – whiteboard, Scheduler, Clips Plus, översatta undertexter, Workforce Management (WFM), kvalitetsstyrning, efterlevnadshantering, CX Insights, AI Sales Assist och deras `...Subscription` motsvarigheter | Det motsvarande paketet eller tillägget, köpt med oanvända platser.            | Planer och fakturering → Planhantering → redigera planen → öka antalet licenser. Se [Uppgradera ditt konto och dina tillägg](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                               |
| `loginType` (`sso` / `workEmail`), under `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                                                                                                                         | SSO konfigurerat på kontot, för SSO-inloggningstypen.                          | [Admincenter](https://zoom.com/account) → Säkerhet och tillförlitlighet → [enkel inloggning](https://zoom.com/account/sso/saml).                                                                                                                                        |

För ett licens- eller tilläggsattribut finns det inget objekt att namnge, men förutsättningen är identisk i praktiken: utan en tillgänglig plats i just den poolen misslyckas tilldelningen.

#### <mark style="color:blå;">Attribut utan förutsättning</mark>

Alla attribut för grundläggande mappning omfattas, enligt beskrivningen under **Grundläggande mappning: profilinformation** — Zoom lagrar dessa värden exakt som de anges och validerar dem aldrig mot ett befintligt objekt. Två attribut i Zoom-tillägget fungerar på samma sätt:

* **Värden som delegeras automatiskt** — `zoomPhoneExtNumber` skickas som `0`, där Zoom tilldelar anknytningen.
* **Anpassade kontoattribut** — fältet `{customAttribute}` som innehåller valfri sträng du skickar.

**Referenser med standardvärden** är ett mellanting: om du utelämnar `zoomPhoneSite`, `zoomContactCenterRole`, eller `zoomContactCenterRegion` faller tillbaka på huvudplatsen, standardrollen Agent och huvudregionen, respektive. Dessa standardvärden måste själva finnas, vilket de gör som standard.

**Grupper är ett partiellt undantag.** När grupptilldelning är aktiverad skapar SCIM en Zoom-grupp som ännu inte finns, med exakt det namn som angetts för källgruppen. Ingen produktkonfiguration tillämpas på gruppen – den skapas med medlemmar och inget annat. Zoom Phone-policyer, samtalsbehörigheter och andra inställningar på gruppnivå måste fortfarande konfigureras under [Administrationscenter](https://zoom.com/account) → Användare → [Grupper](https://zoom.com/account/group#/) när gruppen har skapats.

{% hint style="info" %}
**Rekommendation**

Se till att utbyggnaden på Zoom-sidan betraktas som en förberedande fas med eget godkännande, som slutförs och verifieras innan arbetet med attributmappning börjar. Platser, nummer, planer, roller och mallar ägs ofta av ett annat team än konfigurationen av identitetsleverantören, och att upptäcka ett saknat objekt under provisioneringstester kostar betydligt mer än att bekräfta dess existens i förväg.
{% endhint %}

### **Förbereder dina katalogdata**

SCIM överför allt som källan innehåller. Det validerar, normaliserar eller korrigerar inte. Innan du mappar ett attribut, bekräfta tre saker om den avsedda källan:

* **Det är ifyllt för varje användare inom omfattningen.** Ett tomt fält skickar ingenting eller skickar det konfigurerade standardvärdet.
* **Värdena har konsekvent format och versalisering.** Jämförelselogiken i båda identitetsleverantörerna är exakt.
* **Dess värden överensstämmer exakt med de värden som Zoom förväntar sig.** Zoom gör ingen ungefärlig matchning av platsnamn, rollnamn eller planvärden.

När ett befintligt fält inte kan uppfylla alla tre villkoren är ett särskilt utformad attribut som fylls i medvetet för den här integreringar mer hållbart än att återanvända ett fält som även andra system skriver till.

{% hint style="info" %}
**Rekommendation**

Bestäm sanningskällan innan du rör konfigurationen för identitetsleverantören. De flesta misslyckade SCIM-driftsättningar är katalogdataproblem som framställs som provisioneringsproblem.
{% endhint %}

### **Referensscenarier**

Fyra scenarier används genom hela denna guide. Deras affärskrav och förutsättningar på Zoom-sidan är identiska oavsett identitetsleverantör, så de definieras en gång här. Varje avsnitt som är specifikt för en identitetsleverantör avslutas med att visa hur man implementerar alla fyra i den plattformen.

#### <mark style="color:blå;">Scenario 0: Avdelning, som en första Basic-mappning</mark>

Avdelningen för en användare bör visas på hens Zoom-profil, hämtad från katalogen. Detta är den Basic-mappning som rekommenderades tidigare som ett första end-to-end-test, och den ingår här så att proceduren gås igenom i båda avsnitten för identitetsleverantörer.

**Förutsättning på Zoom-sidan.** Inga. Zoom lagrar värdet exakt som det skickas och validerar det aldrig mot ett befintligt objekt.

**Attribut.** Observera att det överordnade objektet skiljer sig från de tre scenarierna nedan — `department` finns under Enterprise-tillägget, inte Zoom-tillägget.

| Attribut                                                                | Typ    | Anteckningar                                                                                                                  |
| ----------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | sträng | Fritext. Båda identitetsleverantörerna har redan ett `department` fält i användarprofilen, så inget nytt källattribut behövs. |

**Varför börja här.** Att ett avdelningsvärde visas korrekt i en Zoom-profil bekräftar schemadefinitionen, mappningen, omfattningen och din möjlighet att läsa etableringsloggarna – utan att riskera en licens eller en telefonkonfiguration. Varje avancerat scenario nedan skiljer sig bara åt genom vad attributet pekar på.

**Kontrollera först om det redan är mappat.** Standardmappningarna skiljer sig mellan Entra ID och Okta, och de ändras när båda leverantörerna uppdaterar sina Zoom-integreringar. Granska den befintliga listan under **Etablering** → **Mappningar** i Entra, eller **Attributmappningar för Zoom** med **Visa omappade attribut** aktiverat i Okta. Om `department` redan är mappat ska du verifiera det i stället för att deklarera en dubblett – och om du i stället vill konfigurera ett attribut från grunden, `costCenter`, `organisation`, och `employeeNumber` ligger under samma överordnade plats och fungerar identiskt.

#### <mark style="color:blå;">Scenario 1: Zoom Phone-plats och automatisk tilldelning av anknytningsnummer</mark>

Användare ska placeras på rätt Zoom Phone-plats baserat på sitt kontor och få ett anknytningsnummer utan administrativ inblandning.

**Förutsättning på Zoom-sidan** Platserna måste redan finnas. Skapa dem under [**Administrationscenter**](https://zoom.com/account) → **Produktkonfiguration** → **telefonsystem** → [**Företagsinformation**](https://zoom.com/pbx/page/telephone/settings#/settings) → **Lägg till plats**, eller flera åt gången via **Importera**. Platsadresser valideras mot en databas med verkliga adresser eftersom de används för nödsamtalstjänster. Därför misslyckas valideringen för fiktiva kombinationer av adresser och postnummer.

**Attribut.** Båda använder namnrymden `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:` följt av namnet.

| Attribut             | Typ    | Anteckningar                                    |
| -------------------- | ------ | ----------------------------------------------- |
| `zoomPhoneSite`      | sträng | Måste matcha Zoom-platsnamnet tecken för tecken |
| `zoomPhoneExtNumber` | sträng | `0` utlöser automatisk tilldelning              |

**Varför värdet `0` är viktigt.** Zoom är det enda system som vet vilka anknytningar som redan används – inklusive anknytningar som tilldelats samtalsköer och automatiska receptionister i stället för användare. Genom att låta Zoom sköta tilldelningen elimineras en hel kategori av etableringsfel. Att i stället hämta anknytningar från katalogen passar vid en migrering, när det är viktigt att bevara befintliga anknytningsnummer, men mappningen bör ändras till `0` när migreringen är klar, så att framtida medlemmar inte är beroende av att katalogdata underhålls på obestämd tid.

{% hint style="info" %}
**Obs**

Standardplatsen på ett Zoom Phone-konto har vanligtvis exakt namnet `Huvudplats`, synlig under [**Administrationscenter**](https://zoom.com/account) → **Produktkonfiguration** → **telefonsystem** → [**Företagsinformation**](https://zoom.com/pbx/page/telephone/settings#/settings). Bekräfta namnet på det specifika kontot innan du använder det, eftersom det kan bytas namn.
{% endhint %}

#### <mark style="color:blå;">Scenario 2: Zoom Phone-samtalsplan som varierar beroende på land</mark>

En multinationell organisation har köpt fristående Zoom Phone-samtalsplaner och behöver att varje användare får den plan som motsvarar sitt land.

**Förutsättning på Zoom-sidan.** Samtalsplanerna måste redan vara köpta och tillgängliga på kontot. Planvärdena beskrivs i [referensen för samtalsplaner i Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/).

**Attribut.** `zoomPhoneCallingPlan` (sträng).

**Så här hittar du rätt plankod.** `zoomPhoneCallingPlan` tar planens numeriska kod, inte ett plannamn. Det säkraste sättet att få fram den är att använda [Lista samtalsabonnemang](https://developers.zoom.us/docs/api/references/phone-calling-plans/) API, som returnerar varje plans `name`, dess `type` — koden som du mappar — och dess `subscribed` och `tillgänglig` antal licenser. Ett anrop bekräftar därför att planen finns, ger dig värdet du ska skicka och verifierar att det finns kapacitet att tilldela den.

Zoom-webbportalen visar bara visningsnamn, aldrig koder, så en administratör som enbart arbetar i portalen måste översätta visningsnamnet med hjälp av [referensen för samtalsplaner i Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — där till exempel `UNLIMITED_PLAN_US_CA` är `200` och `UNLIMITED_PLAN_GB_IE` är `202`. Referensen listar konstantnamn i stället för portalens formuleringar, så kontrollera att planen stämmer utifrån dess egenskaper — region och om den är uppmätt eller obegränsad — snarare än den exakta texten.

Separat visar Zooms SCIM2 API-referens ett namn på en faktureringsplan, till exempel `phone_calling_usca_monthly_unlimited` i exempelnyttolasten. Den identifieraren används för att *köpa* en prenumeration, inte för att tilldela en plan till en användare. Om du behöver ange vilken prenumeration en plan hämtar sin täckning från ska det anges i `zoomPhoneCallingPlanSubscription`.

**Varför `-1` används som reservvärde.** SCIM2-referensen dokumenterar `-1` som värdet som tar bort alla samtalsplaner. Om det används för användare som inte matchar något ger det ett deterministiskt och synligt resultat — ingen plan tilldelas — i stället för tvetydigheten i att inte skicka något värde alls. Det ger också ett enkelt sätt att ta bort samtalsbehörigheter utan att radera användaren.

#### <mark style="color:blå;">Scenario 3: Zoom kontaktcenter-paket, roll och region</mark>

Kontaktcenteragenter bör provisioneras med rätt ZCC-paket och roll vid introduktionen, i stället för att konfigureras manuellt i efterhand. Det här scenariot visar att metoden är produktaoberoende — inget i proceduren ändras, bara attributnamnen och de tillåtna värdena.

| Attribut                   | Typ    | Tillåtna värden                                                                   |
| -------------------------- | ------ | --------------------------------------------------------------------------------- |
| `zoomContactCenterPackage` | sträng | `Essentials`, `Premium`, `Elite`                                                  |
| `zoomContactCenterRole`    | sträng | Valfritt ZCC-rollnamn. Standardvärdet är `Agent` om inget anges.                  |
| `zoomContactCenterRegion`  | sträng | Valfri konfigurerad ZCC-region. Standardvärdet är huvudregionen om det utelämnas. |

**Om att medvetet utelämna attribut.** Lämna `zoomContactCenterRegion` omappad i driftsättningar med en enda region, där Zooms dokumenterade standardvärde redan är korrekt. Om standardvärdet för ett attribut är rätt är det bättre att utelämna det än att mappa det – varje mappning innebär ett underhållsansvar.

**Driftsmeddelande.** SCIM2-referensen dokumenterar också `zoomContactCenterUserTemplate`, som tillämpar en färdig ZCC-mall. Mallar av tilläggstyp tillämpas när en användare skapas och mallar av uppdateringstyp vid uppdatering. Om både en mall och individuella attributvärden anges i samma begäran har de individuella värdena företräde. Mallar kan vara värda att överväga när ZCC-konfigurationen är så komplex att det blir ohanterligt att underhålla den genom många individuella attributmappningar.

### **Verifiering på Zoom-sidan och vanliga fel**

Varje identitetsleverantör har sin egen logg, vilket behandlas i steg 6 för varje identitetsleverantör. Loggen på Zoom-sidan nedan är identisk för båda och är den definitiva spela in av vad Zoom faktiskt tog emot.

#### <mark style="color:blå;">Zoom App Marketplace samtalsloggar visar hela begäran- och svarsutbytet</mark>

1. Logga in på Zoom-webbportalen som kontoägare.
2. Navigera till [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Hantera** → **Appar på kontot**.
3. Markera applikationen som representerar anslutningen till identitetsleverantören. För Entra heter den vanligtvis **Azure Identity** eller liknande.
4. Öppna fliken **Samtalsloggar** .
5. Använd **Sök efter ändpunkt**, eller filtren för datumintervall, metod och status, för att hitta det relevanta samtalet.
6. Markera raden för att expandera den.
7. Granska `requestBody` för att se exakt vad som skickades, och `response` för att se exakt vad Zoom returnerade, inklusive det genererade Zoom-användar-ID:t, `httpStatus`, och den resulterande attributuppsättningen.

Zoom behåller de senaste 100 API-begärandeloggarna, så undersök ett fel omgående snarare än efter att ytterligare provisioneringsaktivitet har trängt undan det.

#### <mark style="color:blå;">Vanliga provisioneringsfel och deras orsaker</mark>

<table><thead><tr><th width="99.69622802734375">Kod</th><th>Meddelande</th><th>Orsak och lösning</th></tr></thead><tbody><tr><td>400</td><td>Detta konto har inte aktiverat enkel inloggning.</td><td>SSO är en förutsättning för SCIM. Aktivera och konfigurera SSO på Zoom-konto först.</td></tr><tr><td>400</td><td>användare är inaktiv eller låst.</td><td>Den berörda Zoom-användaren kan inte uppdateras i sitt nuvarande tillstånd. Åtgärda konto-statusen i Zoom-webbportal.</td></tr><tr><td>403</td><td>Begäran nekades på grund av otillräckliga behörigheter: "användare:Redigera".</td><td>Autentiseringsuppgifterna för SCIM-anslutningen saknar det nödvändiga omfånget. Auktorisera anslutningen igen med ett ägare- eller admin-konto.</td></tr><tr><td>404</td><td>användare finns inte.</td><td>Identitetsleverantören kopplade inte användare till en befintlig Zoom-användare. Kontrollera matchningsattributet och formatet för användarnamn.</td></tr><tr><td>409</td><td>e-post-domänen matchar inte den associerade domänen för konto.</td><td>användare:s e-post-domän är inte associerad med Zoom-konto. Associera och verifiera domänen före etableringen.</td></tr><tr><td>409</td><td>Det går inte att lägga till betalande användare.</td><td>Ingen licens av den begärda typen är tillgänglig. Fri kapacitet på kontot, eller provisionera användaren som Basic.</td></tr><tr><td>409</td><td>Kan inte skapa fler användare med [bundelnamn].</td><td>Det specifika paketet har inga återstående platser. Gäller Workplace Business Plus, Enterprise Premier, Pro Plus och motsvarigheterna för utbildning.</td></tr><tr><td>429</td><td>För många begäranden.</td><td>Provisioneringen har överskridit Zooms frekvensgränser. Undersök om det kvarstår mellan cykler.</td></tr></tbody></table>

#### <mark style="color:blå;">Ett felläge ger inget felmeddelande alls</mark>

Ett värde som Zoom accepterar men som inte motsvarar någonting — ett platsnamn med ett avslutande mellanslag, eller ett rollnamn som sedan har bytt namn i Zoom — kan accepteras syntaktiskt och tillämpas på ingenting. Ingen loggpost markerar att detta inträffar. Plattformsspecifika varianter av samma problem behandlas i steg 6.

{% hint style="info" %}
**Obs**

När Zoom och identitetsleverantören inte är överens om en användares konfiguration ska identitetsleverantören betraktas som auktoritativ och värdet korrigeras där. Att redigera direkt i Zoom-webbportalen skapar ett tillstånd som nästa provisioneringsevenemang skriver över, vilket gör det underliggande problemet svårare att diagnostisera.
{% endhint %}

## **Konfigurera SCIM med Entra ID**

#### <mark style="color:blå;">Ytterligare krav för Entra ID</mark>

* Entra ID-administratörsbehörigheter med åtkomst till Enterprise-program
* Den e-postdomän som används av dina användare, verifierad som en anpassad domän i Entra ID-klienten

#### <mark style="color:blå;">Ytterligare begränsningar i Entra ID</mark>

* Attributmappningar hämtas uteslutande från Entras *användarobjekt* attribut. Säkerhetsgrupper kan inte tillhandahålla ett värde direkt till ett Zoom-attribut; grupptillhörighet styr omfånget, inte värdet.
* Inkrementella provisioneringscykler körs ungefär var 40:e minut. Ändringar sker inte omedelbart när provisionering har aktiverats.
* Värdet `Collaboration` för `userType` stöds inte med Entra ID på grund av en Microsoft-specifik begränsning.

{% hint style="info" %}
**Obs**

Standardkonfigurationen för etablering kan utföras antingen från `entra.microsoft.com` eller `portal.azure.com`. Schemaredigeraren som används i steg 1 är dock endast tillgänglig via Azure Portal-URL:en med parametern `forceSchemaEditorEnabled` tillagd. Den här flaggan har ingen effekt på `entra.microsoft.com`. Använd Azure Portal-länken i steg 1 för alla steg i den här delen, så att du slipper växla portal mitt under konfigurationen.
{% endhint %}

### Steg 1: Deklarera attributet i Zoom-applikationsschemat

Att deklarera ett attribut är en engångsåtgärd per attribut. Deklarera varje attribut du tänker använda innan du konfigurerar några mappningar, så att alla mål är tillgängliga i Steg 2.

1. Logga in på Azure Portal med URL:en till schemaredigeraren: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. Under **Azure-tjänster**, markera **Microsoft Entra ID**.
3. I den vänstra navigeringsmenyn, under **Hantera**, klicka på **Enterprise-applikationer**.
4. Klicka på din Zoom-applikation i listan över applikationer.\
   **Obs**: Applikationsnamnet anges av Entra-administratören när applikationen skapas. Namnet är ofta **Zoom** eller **Zoom SSO**, men kan vara annorlunda i din klientorganisation.
5. I den vänstra navigeringsmenyn, under **Hantera**, klicka på **Etablering**.\
   **Obs**: Azure visar för närvarande en av två layouter. I den äldre upplevelsen markerar du **Redigera attributmappningar** under **Hantera etablering**. I den nyare upplevelsen öppnas sidan på fliken **Översikt** ; markera **Etablering** igen i menyn till vänster. Båda vägarna leder till samma plats.
6. Klicka på **Mappningar** rullgardinsmenyn och klicka sedan **Etablera användare i Microsoft Entra ID**.\
   **Obs**: I klientorganisationer där äldre benämningar fortfarande visas visas det här alternativet som **Etablera Azure Active Directory-användare**.
7. I det nedre vänstra hörnet markerar du **Visa avancerade alternativ** kryssruta.
8. Klicka **Redigera attributlista för Zoom**.
9. Bläddra till den första tomma raden och slutför följande:
   * **Namn**: Ange hela attributsträngen, till exempel `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Typ**: Markera **Sträng** eller **Booleskt värde**, som matchar datatypen som dokumenteras i SCIM2 API-referensen.
10. Upprepa steg 9 för varje ytterligare attribut.
11. Klicka på **Spara**.

{% hint style="warning" %}
**Observera**

Attributnamn är skiftlägeskänsliga och måste exakt matcha API-referensen. `zoomPhoneSite` är giltigt; `zoomphonesite` och `ZoomPhoneSite` är det inte. Ett attribut med felaktigt skiftläge godkänns av schemaredigeraren utan felmeddelande, men misslyckas i tysthet vid anrop till Zoom API.

För attribut som dokumenteras som `boolean`, **Sträng** är även giltigt, förutsatt att den mappade källan tillhandahåller den bokstavliga texten `true` eller `false`. Att välja **Sträng** är ofta mer praktiskt när källan är ett Entra-tilläggsattribut som lagrar text.
{% endhint %}

### Steg 2: Mappa en katalogkälla till attributet

Entra ID erbjuder tre mappningstyper, och valet mellan dem är det mest avgörande beslutet i konfigurationen.

<table><thead><tr><th width="133.376708984375">Mappningstyp</th><th>Använd när</th><th>Beteende</th></tr></thead><tbody><tr><td><strong>Direkt</strong></td><td>Ett Entra-fält innehåller redan det exakta värde som Zoom förväntar sig.</td><td>Skickar källvärdet vidare oförändrat.</td></tr><tr><td><strong>Konstant</strong></td><td>Varje användare inom omfattningen ska få samma värde.</td><td>Skickar ett fast värde till varje provisionerad användare.</td></tr><tr><td><strong>Uttryck</strong></td><td>Värdet måste härledas, översättas eller varieras efter användarattribut.</td><td>Utvärderar ett uttryck mot källfälten och skickar resultatet.</td></tr></tbody></table>

**För att skapa mappningen:**

1. Gå tillbaka till **Etablering** → **Mappningar** → **Etablera Microsoft Entra ID-användare**.
2. Klicka i det nedre vänstra hörnet på **Lägg till ny mappning**.
3. Konfigurera mappningen enligt den valda typen — se vägledningen nedan.
4. Klicka på **Målattribut** rullgardinsmenyn och markera attributet som deklarerades i steg 1.
5. Klicka på **Matcha objekt med det här attributet** rullgardinsmeny och markera **Nej**.\
   **Obs**: Anpassade Zoom-attribut är konfigurationsvärden, inte nycklar för identitetsmatchning. Endast det attribut som kopplar samman Entra-användare med Zoom-användare – vanligtvis `användarnamn` — ska ställas in på **Ja**.
6. Klicka på **Tillämpa den här mappningen** rullgardinsmeny och markera **Alltid**, så värdet gäller både när attributet skapas och vid efterföljande uppdateringar.
7. Klicka på **OK**.
8. Upprepa för varje attribut och klicka sedan på **Spara** högst upp på sidan **Attributmappning** .

#### <mark style="color:blå;">Direkt mappning skickar igenom ett befintligt fält utan transformation</mark>

* **Mappningstyp**: **Direkt**
* **Källattribut**: Ett Entra-fält vars värde redan exakt motsvarar det Zoom förväntar sig, tecken för tecken
* **Standardvärde om null (valfri)**: Ett reservvärde som används när källfältet är tomt

Direkt mappning är det minst sköra alternativet och bör föredras när katalogdata tillåter det. Om `physicalDeliveryOfficeName` — visas som **Kontorsplats** i Entra-användarprofilen – innehåller redan värden som exakt matchar platsnamnen i Zoom Phone, så en direkt mappning kräver ingen logik alls.

{% hint style="info" icon="lightbulb" %}
**Tips**

Fyll i **Standardvärde om null** när ett saknat källvärde skulle orsaka ett fel eller ett oavsiktligt resultat. Ett standardvärde på `Huvudplats` En platsmappning säkerställer att användare utan kontorsplats ändå etableras korrekt i stället för att hamna i ett odefinierat tillstånd.
{% endhint %}

#### <mark style="color:blå;">Konstantmappning tillämpar ett värde på hela populationen inom omfånget</mark>

* **Mappningstyp**: **Konstant**
* **Konstant värde**: Det fasta värde som ska skickas

Konstant mappning passar distributioner med en enda konfiguration och är också mekanismen bakom flera Zoom-specifika beteenden. Om du ställer in `zoomPhoneExtNumber` till ett konstant värde på `0` instrueras Zoom att tilldela nästa tillgängliga anknytning på användarens plats, vilket helt eliminerar konflikter mellan anknytningar.

#### <mark style="color:blå;">Uttrycksmappning översätter eller härleder ett värde vid provisioneringstillfället</mark>

* **Mappningstyp**: **Uttryck**
* **Uttryck**: En nästlad `IIF()` -instruktion som utvärderar ett eller flera källattribut

Uttrycksmappning krävs när katalogvärdet och Zoom-värdet inte är samma sträng:

```
IIF([officeLocation]="London","LON-01",
IIF([officeLocation]="Manchester","MAN-01",
"Huvudplats"))
```

{% hint style="danger" %}
**Varning**

Uttryck jämför text exakt som den skrivs, inklusive skiftläget. `GB` och `gb` är olika värden, liksom `United Kingdom` och `united kingdom`. En jämförelse som misslyckas genererar inget fel – den går vidare till standardgrenen, och användaren etableras med fel konfiguration utan att det märks.
{% endhint %}

Omslut källvärden med `ToUpper()` och jämför med versala bokstavsvärden för att neutralisera inkonsekvent skiftläge:

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
"-1"))
```

#### <mark style="color:blå;">Källfältets format varierar beroende på hur Entra-användaren skapades</mark>

Detta är den vanligaste orsaken till uttrycksmappningar som ser korrekta ut men beter sig inkonsekvent över en population.

* **Användningsplats** måste enligt Microsoft alltid innehålla en giltig ISO 3166-1 alfa-2-kod, till exempel `GB`, eftersom den styr tillgängligheten för licenser och funktioner. Det här fältet är tillförlitligt.
* **Land eller region** omfattas inte av samma krav, och innehållet beror på hur användaren skapades. Användare som skapats via det grafiska gränssnittet i Entra adminportal väljer från en rullgardinsmeny med fullständiga landsnamn, så fältet innehåller vanligtvis `United Kingdom`. Användare som skapats genom CSV-import eller PowerShell har vanligtvis värdet `GB` – enligt konvention, inte enligt något krav.

I alla klientorganisationer där användare har skapats på mer än ett sätt har `country` inte ett konsekvent format. Standardisera fältet innan du skapar uttrycket, eller testa uttryckligen för båda formaten enligt exemplet ovan.

### Steg 3: Ta med användare och grupper i provisioneringsomfånget

Tilldelning avgör vilka användare konfigurationen påverkar. Användare utanför applikationens tilldelningsomfång påverkas aldrig av någon mappning, vilket gör tilldelning till den primära säkerhetskontrollen under utrullningen.

1. Gå till **Microsoft Entra ID** → **Enterprise-applikationer** → din Zoom-applikation → **Användare och grupper**.
2. Klicka på **Lägg till användare/grupp**.
3. Under **Användare och grupper**, markerar du den avsedda användaren eller säkerhetsgruppen.
4. Under **Välj en roll**, väljer du lämplig roll.
5. Klicka på **Tilldela**.

I praktiken är det bara två rollvärden som spelar någon roll. Andra alternativ, till exempel **Corp** och **Pro** är antingen äldre benämningar som håller på att fasas ut eller avsedda för ovanliga scenarier.

<table><thead><tr><th width="157.5225830078125">Roll</th><th>Effekt</th></tr></thead><tbody><tr><td><strong>Basic</strong></td><td>Provisionerar användaren utan en betald licens för möte. Markera detta när ett anpassat attribut — till exempel en Zoom Phone-samtalsplan — ansvarar för att tilldela den betalda rättigheten.</td></tr><tr><td><strong>Licenserad</strong></td><td>Tilldelar Zoom-kontots <em>standard</em> licensplan, till exempel Zoom Workplace Enterprise Plus. På den här skärmen går det inte att välja ett specifikt paket; standardvärdet konfigureras på Zooms sida.</td></tr></tbody></table>

Detta rollval tillämpas en gång per användare eller grupp som lagts till i applikationen, oavsett hur många anpassade attribut som provisioneras.

**Så här etablerar du Entra-grupper som Zoom-grupper**, vilket är inaktiverat som standard:

1. Gå till **Etablering** → **Mappningar** och markera **Etablera Microsoft Entra ID-grupper**.
2. Växla **Aktiverad** till **Ja**.
3. Bekräfta att standardmappningarna finns på plats: `displayName` → `displayName`och `members` → `members`.
4. Klicka på **Spara**.
5. Gå tillbaka till **Användare och grupper** och bekräfta att själva gruppen har tilldelats applikationen, inte bara dess enskilda medlemmar. Grupprincipering bearbetar endast grupper som tilldelats direkt.

{% hint style="warning" %}
**Observera: Vad SCIM gör och inte gör med grupper**

Om det inte redan finns en Zoom-grupp med motsvarande namn skapar SCIM en med Entra-gruppens `displayName` exakt som det har skrivits. Gruppen skapas med medlemmar men **utan någon produktkonfiguration**. En administratör måste fortfarande öppna [**Administrationscenter**](https://zoom.com/account) → **Användare** → [**Grupper**](https://zoom.com/account/group#/) i Zoom-webbportalen och tillämpa de avsedda inställningarna — Zoom Phone-principer på gruppnivå, samtalsbehörigheter eller annan produktkonfiguration. SCIM etablerar gruppens existens och medlemskap; det definierar inte vad gruppen gör i Zoom.
{% endhint %}

### Steg 4: Validera med Provision on Demand

**Etablera på begäran** körs oberoende av växlingsknappen **Etableringsstatus** , vilket är precis varför det är rätt verktyg för validering. Alla steg fram till denna punkt — inklusive detta — kan slutföras medan etablering fortfarande är avstängd.

1. Gå till **Etablering** → **Översikt över etablering**.
2. Klicka på **Etablera på begäran**.
3. Sök efter och markera en enskild testanvändare och klicka sedan på **Etablera**.
4. Granska resultatet. Entra rapporterar de fyra stegen som körs för varje etableringsevenemang — **Importera**, **Avgör om inom omfånget**, **Matcha**, och **Etablera** — vart och ett kan expanderas separat.
5. Bekräfta att de visade attributvärdena stämmer överens med din avsikt.
6. Logga in på Zoom-webbportalen och bekräfta att konfigurationen tillämpades.

{% hint style="info" %}
**Rekommendation**

Validera mot en användare som representerar *det svåraste* fallet i din population — en användare utomlands, en användare som skapats på ett annat sätt eller en användare vars källfält är tomt. Ett test som bara omfattar det enkla fallet avslöjar inte de feltyper som beskrivs i steg 2.
{% endhint %}

### Steg 5: Aktivera löpande provisionering

Att aktivera provisionering gör att konfigurationen börjar gälla i skarpt läge för varje användare inom omfånget. Slutför och verifiera steg 1 till 4 först.

1. Gå till **Microsoft Entra ID** → **Enterprise-applikationer** → din Zoom-applikation → **Provisionering** → **Provisionering**.
2. Växla **Provisioneringsstatus** till **På**.
3. Klicka på **Spara**.

Den första cykeln kan ta upp till cirka 40 minuter. Efterföljande inkrementella cykler körs med ungefär 40 minuters intervall. Nya användare, attributändringar och avaktiveringar synkroniseras enligt det schemat i stället för omedelbart.

### Steg 6: Verifiera med Entra-provisioneringsloggar

1. Gå till **Microsoft Entra ID** → **Enterprise-program** → din Zoom-applikation → **Övervaka** → **Etableringsloggar**.
2. Sök efter eller filtrera på testanvändaren och markera sedan relevant evenemang. Detaljvyn öppnas med fyra flikar: **Steg**, **Felsökning och rekommendationer**, **Ändrade egenskaper**, och **Sammanfattning**.
3. Granska **Sammanfattning** för att bekräfta om åtgärden lyckades eller misslyckades.
4. Om den misslyckades öppnar du **Felsökning och rekommendationer**, där åtgärden som utfördes och den berörda användarens UPN visas, samt – under **Information** — felkoden och det fullständiga felmeddelandet som returneras av Zooms API.

Det här är mer tillförlitligt än att granska mappningsskärmen, eftersom det visar de faktiska värdena som skickas i stället för vad mappningen var avsedd att ge. Om Entra-loggen inte ger något entydigt svar kan du gå vidare till samtalsloggarna i Zoom App Marketplace, som beskrivs under **Verifiering på Zoom-sidan och vanliga fel**, som visar det råa utbytet mellan begäran och svar.

#### <mark style="color:blå;">Beteende vid introduktion och avslut i Entra ID</mark>

* Omfång är den primära säkerhetskontrollen. Användare utanför applikationens tilldelningsomfång ändras aldrig av någon mappning i den här konfigurationen.
* Att avaktivera en användare i Entra, eller ta bort dem från omfånget, återställer provisioneringen automatiskt och stänger avvecklingsloopen.
* Varje fel genererar en motsvarande loggpost — med förbehållet om tysta fel som nämns ovan.

### Steg 7: Tillämpa referensscenarierna i Entra ID

Scenarierna, förutsättningarna och attributdefinitionerna finns i [**Referensscenarier**](#reference-scenarios) avsnitt. Här anges endast Entra-mappningarna.

**Scenario 0 — Avdelning.** I steg 1 deklarerar du `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` som **Sträng**, och var noga med att använda Enterprise-namnområdet i stället för Zoom-namnområdet. Mappa det som **Direkt** från Entra- `department` fältet. Inget **Standardvärde om null** behövs – ett tomt källfält skickar helt enkelt ingenting, och det behöver inte finnas något objekt på Zoom-sidan.

**Scenario 1 – Zoom Phone-plats och automatisk anknytning.** Mappa `zoomPhoneSite` som **Direkt** från `physicalDeliveryOfficeName`, med **Standardvärde om null** inställt på `Main plats`. Mappa `zoomPhoneExtNumber` som **Konstant** med värdet `0` såvida du inte migrerar en befintlig konfiguration av anknytningar. Om kontorets platsvärden inte exakt motsvarar Zoom-platsnamnen ersätter du dem med en **Uttryck** mappning i det format som visas i steg 2.

**Scenario 2 – Samtalsplanen varierar beroende på land.** Eftersom Entra inte kan hämta ett värde från en grupp krävs ett uttryck. Utöka det med fler `IIF()` lager per land och ta hänsyn till både alpha-2-formatet och formatet med fullständigt landsnamn enligt beskrivningen i steg 2:

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
IIF(ToUpper([country])="US","200",
IIF(ToUpper([country])="UNITED STATES","200",
"-1"))))
```

När attributet för samtalsplan tilldelar den betalda behörigheten markerar du **Basic** i stället för **licensierad** i steg 3. Om du markerar **licensierad** tillämpas dessutom kontots standardlicens, vilket kanske inte ger det avsedda kommersiella utfallet.

**Scenario 3 — paket, roll och region för kontaktcenter.** Mappa `zoomContactCenterPackage` med ett **uttryck** som styrs av ett katalogfält som skiljer mellan agentnivåer, och `zoomContactCenterRole` som **direkt** från ett fält som innehåller rollnamnet. Lämna `zoomContactCenterRegion` omappad i distributioner med en region.

## **Konfigurera SCIM med Okta**

#### <mark style="color:blå;">Ytterligare krav för Okta</mark>

* Okta-administratörsbehörighet med åtkomst till profilredigeraren

#### <mark style="color:blå;">Ytterligare begränsningar i Okta</mark>

* När en användare tillhör flera grupper som tillhandahåller motstridiga värden för samma attribut överförs endast värdet från gruppen med högst prioritet. Se steg 5.

{% hint style="warning" %}
**Obs: Två profiler, två syften**

Okta har två separata profiler som är relevanta här. Om du förstår skillnaden mellan dem undviker du det mesta av den initiala förvirringen. Den **Okta-användarprofilen** är där ett värde *lagras* för en person i katalogen. Profilen för **Zoom-användarapplikationen** är där ett värde *skickas* till Zoom, och dess attribut innehåller det externa SCIM-namnet och namnrymden. En konfiguration per användare behöver båda, samt en mappning som kopplar ihop dem. En konfiguration på gruppnivå behöver bara applikationsprofilattributet, med värdet inställt på grupptilldelningen.
{% endhint %}

### Steg 1: Deklarera attributet på Zoom-applikationens användarprofil

Detta är det attribut som faktiskt överför ett värde till Zoom. Att deklarera det är en engångsåtgärd per attribut.

1. Logga in i Okta-adminkonsol.
2. Klicka på **Applikationer**, i den vänstra navigeringsmenyn och klicka sedan på **Applikationer**.
3. Under **STATUS**, klicka på **AKTIV**.
4. Klicka på **Zoom** applikationen.\
   **Obs**: Applikationens namn anges av Okta-administratören när applikationen skapas. Den heter ofta **Zoom**, men kan skilja sig åt i din klientorganisation.
5. Klicka på fliken  **Provisioning** .
6. Under **Zoom-attributmappningar**, klicka på  **Gå till profilredigeraren**.
7. Under **Attribut**, klicka på **+ Lägg till attribut**.
8. Fyll i följande:
   * **Datatyp**: Markera **string** eller **boolean**, enligt SCIM2 API-referensen.
   * **Visningsnamn**: Ange attributnamnet, till exempel `zoomPhoneSite`.
   * **Variabelnamn**: Ange samma namn.
   * **Externt namn**: Ange attributnamnet exakt så som det är dokumenterat av Zoom, till exempel `zoomPhoneSite`.
   * **Externt namnrymd**: Ange `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Beskrivning** (valfri): Spela in varför attributet finns och var dess värden kommer ifrån.
   * **Attributtyp**: Markera **Personlig** för ett värde per användare, eller **Grupp** för ett värde som ärvs via grupptillhörighet.
9. Klicka på **Spara**, eller **Spara och lägg till en till**.

{% hint style="danger" %}
**Varning**

Det externa namnet och det externa namnområdet måste båda vara korrekta. Zooms publicerade vägledning anger att det externa namnområdet ska vara det fullständiga URN:et *inklusive* attributnamnet – till exempel `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` — snarare än enbart namnområdet. Detta skiljer sig från den generiska SCIM-konventionen. Följ formatet ovan, eftersom det motsvarar den konfiguration som Zoom dokumenterar som fungerande.

Attributnamn är skiftlägeskänsliga genomgående. Ett attribut med fel skiftläge accepteras av Profile Editor utan fel och misslyckas tyst i Zoom API.
{% endhint %}

### Steg 2: Skapa ett källattribut på Okta-användarprofilen

Slutför detta steg där värdet hålls per användare. Hoppa över det om värdet är identiskt för varje användare, eller om det i stället kommer att tillhandahållas på gruppnivå.

1. Klicka på i den vänstra navigeringsmenyn **Katalog**, klicka sedan **Profilredigerare**.
2. Klicka på **Användare** flik.
3. I **Användare** rutan, under **Filter**, klickar du på **Alla**.
4. Till höger om **Okta**, klicka på **Användare** profilen.
5. Under **Attribut**, klicka på **+ Lägg till attribut**.
6. Fyll i följande:
   * **Datatyp**: Matcha Zoom-attributet som deklarerades i steg 1.
   * **Visningsnamn** och **Variabelnamn**: Ange ett namn, till exempel `zoomPhoneSite`.
   * **Uppräkning** (valfri): markera **Definiera en uppräknad lista med värden** där Zoom-attributet endast accepterar en fast uppsättning värden.
   * **Attribut krävs** (valfri): markera **Ja** där varje användare inom omfånget måste ha ett värde.
7. Klicka på **Spara**.

{% hint style="info" icon="lightbulb" %}
**Tips**

Använd samma namn för Okta-användarprofilattributet och Zoom-applikationsprofilattributet. Okta kräver inte detta, men matchande namn gör mappningslistan självförklarande och minskar felsökningstiden avsevärt i takt med att antalet attribut växer.
{% endhint %}

Använd **Uppräkning** alternativ där Zoom dokumenterar en fast uppsättning värden – paket för kontaktcenter, Workplace-paketkoder och planvärden för Revenue Accelerator. Om du begränsar fältet där värdet anges förhindrar du att ett stavfel leder till ett oupptäckt provisioneringsfel som visar sig flera veckor senare som en saknad behörighet.

### Steg 3: Mappa källattributet till Zoom-attributet

1. Gå till **Applikationer** → **Applikationer** → **AKTIV** → **Zoom** applikation.
2. Klicka på fliken  **Provisioning** .
3. Under **Zoom-attributmappningar**, leta reda på attributet som deklarerades i steg 1 och klicka på redigeringsikonen till höger om det.\
   **Obs**: Om attributet inte visas klickar du på **Visa omappade attribut**.
4. Klicka på **Attributvärde** rullgardinsmenyn och markera **Mappa från Okta-profil**.
5. Klicka på källans rullgardinsmeny – där visas `login | string` som standard – och markera attributet för Okta-användarprofilen som skapades i steg 2.
6. Markera **Skapa och uppdatera**.\
   **Obs!**: **Skapa endast** tillämpar värdet när Zoom-användaren etableras för första gången och aldrig därefter. Markera det medvetet för värden som inte ska skrivas över efter den första tilldelningen; markera **Skapa och uppdatera** i alla andra fall så att ändringar i katalogen förs vidare.
7. Klicka på **Spara**.
8. Upprepa för varje attribut.

{% hint style="warning" %}
**Observera: Att härleda eller översätta ett värde**

När Okta-värdet och Zoom-värdet inte är samma sträng accepterar fältet **Attributvärde** även Oktas uttrycksspråk, som stöder villkorslogik och strängfunktioner. Uttryckssyntaxen och vilken funktionalitet som är tillgänglig varierar mellan olika versioner av Okta. Validera varje uttryck mot en enskild testanvändare med hjälp av **Förhandsgranska** innan du tillämpar den i större omfattning och läs Oktas aktuella dokumentation för uttrycksspråket för information om vilka funktioner som stöds.

När översättningen är enkel och värdeuppsättningen liten är det vanligtvis mer underhållbart än ett uttryck att definiera Zoom-värdet direkt på Okta-attributet som en uppräknad lista — eller att använda ett attribut på gruppnivå, som i steg 5 —.
{% endhint %}

### Steg 4: Aktivera provisionering för applikation

Attributmappningar har ingen effekt förrän de motsvarande provisioneringsåtgärderna har aktiverats. Aktivera dem innan du tilldelar värden i steg 5.

1. Gå till **Applikationer** → **Applikationer** → **AKTIV** → **Zoom** applikation.
2. Klicka på fliken  **Provisioning** .
3. Under **Provisionering till app**, klicka på **Redigera**.
4. Aktivera inställningarna som beskrivs nedan och klicka sedan på **Spara**.

| Inställning                        | Effekt                                                                                                                                                                           |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Skapa användare**                | Skapar eller länkar en användare i Zoom när applikationen tilldelas en användare i Okta.                                                                                         |
| **Uppdatera användarens attribut** | Uppdaterar attributen för en användare i Zoom när applikationen tilldelas. Efterföljande ändringar i Okta-användarprofilen skriver automatiskt över motsvarande värde i Zoom.    |
| **Avaktivera användare**           | Avaktiverar Zoom-kontot när applikationen inte längre är tilldelad i Okta, eller när Okta-kontot avaktiveras. Konton kan återaktiveras genom att tilldela applikationen på nytt. |

{% hint style="danger" %}
**Varning**

**Uppdatera användarattribut** är det som gör att anpassade attributmappningar börjar gälla för befintliga användare. Utan den här inställningen tillämpas mappningarna bara när användaren skapas, och efterföljande ändringar i Okta når inte Zoom.
{% endhint %}

### Steg 5: Tilldela värden till användare eller grupper

**För att tilldela ett värde till en enskild användare:**

1. Gå till **Katalog** → **Personer** och klicka på användarens namn.
2. Klicka på fliken **Profil** och klicka sedan på **Redigera**.
3. Fyll attributet som skapades i steg 2 med det värde som Zoom förväntar sig.
4. Klicka på **Spara**.

Värdet skickas omedelbart. Bekräfta resultatet i Zoom-webbportal innan du tillämpar samma ändring mer brett.

**Så här tilldelar du ett värde till en grupp** — det mer skalbara mönstret där konfigurationen följer organisationsstrukturen:

1. Bekräfta att attributet deklarerades i steg 1 med **Attributtyp: grupp**. Om det deklarerades som **Personlig**, deklarerar du en motsvarande variant på gruppnivå genom att upprepa steg 1 för **Zoom-användarens** profil under **Katalog** → **Profilredigerare** → **Användare** → **Alla**, och väljer **Grupp** som attributtyp.
2. Gå till **Katalog** → **Grupper** → fliken **Alla** , klicka sedan på **Lägg till grupp**.
3. Ange ett **Namn** och valfri **Beskrivning**, klicka sedan på **Spara**.
4. Öppna gruppen och klicka på fliken **Applikationer** .
5. Klicka på **Tilldela applikation**, klicka sedan på **Tilldela** till höger om applikationen **Zoom** .
6. Fyll i attributen på gruppnivå med de värden som ska gälla för varje medlem.
7. Klicka på **Spara och gå tillbaka**, klicka sedan på **Klart**.
8. Klicka på gruppens flik **Personer** , klicka sedan på **Tilldela personer**.
9. Sök efter användare med förnamn, primär e-postadress eller användarnamn, och klicka på knappen Lägg till bredvid var och en.
10. Klicka på **Klart**.

Medlemmar ärver gruppens attributvärden automatiskt. Användare som läggs till senare ärver dem när de ansluter, vilket gör detta mönster hållbart för löpande introduktion snarare än en engångsmigrering.

#### <mark style="color:blå;">Gruppprioritet löser motstridiga värden när en användare tillhör flera grupper</mark>

Om en användare är medlem i mer än en grupp som tillhandahåller ett värde för samma attribut, skickar Okta värdet från gruppen med högst prioritet.

1. Gå till **Applikationer** → **Applikationer** → **AKTIV** → **Zoom** applikation.
2. Klicka på fliken **Uppgifter** flik.
3. Under **Filter**, klicka på **Grupper**.
4. Dra och släpp grupperna i önskad ordning.

{% hint style="info" %}
**Rekommendation**

Ordna grupper från mest specifik till mest allmän, så att en grupp med snävt omfång — en viss plats eller roll — har företräde framför en bred allmän grupp. Om denna ordning vänds kommer den allmänna gruppen att åsidosätta varje specifik grupp, vilket vanligtvis visar sig som att hela populationen får samma oavsiktliga konfiguration.
{% endhint %}

### Steg 6: Verifiera med hjälp av Okta-systemloggen

1. Gå till **Rapporter** → **Systemlogg**.
2. Filtrera efter målanvändaren eller efter Zoom-applikationen, och begränsa tidsintervallet till provisioneringsförsöket.
3. Öppna det relevanta evenemanget och granska detaljerna, som innehåller resultatet och eventuella fel som returnerats av nedströmsapplikationen.

Olösta provisioneringsfel visas även på Zoom-applikationens **Provisionering** -flik. Om Okta-loggen inte ger något tydligt svar kan du gå vidare till anropsloggarna i Zoom App Marketplace som beskrivs under **Verifiering på Zoom-sidan och vanliga fel**, där den råa begäran och svarsväxlingen visas.

{% hint style="warning" %}
**Observera: det Okta-specifika tysta felet**

Ett attribut som har deklarerats i Zoom-användarprofilen men aldrig mappats, eller mappats utan att **Uppdatera användarattribut** är aktiverat i steg 4, skickar ingenting trots att det fortfarande visas i mappningslistan. Inget fel utlöses. Om ett värde inte når Zoom och Systemlogg inte visar något motsvarande evenemang alls bör du kontrollera mappningen och inställningarna för provisionering innan du undersöker vidare.
{% endhint %}

#### <mark style="color:blå;">Beteende vid introduktion och offboarding i Okta</mark>

* Omfång är den primära säkerhetskontrollen. Användare som inte tilldelats Zoom-applikationen i Okta ändras aldrig av någon mappning i den här konfigurationen.
* Med **Inaktivera användare** aktiverat, avregistrering av applikationen eller inaktivering av Okta-kontot inaktiverar Zoom-kontot automatiskt.
* Att tilldela applikationen på nytt återaktiverar ett tidigare inaktiverat Zoom-konto, vilket gör gruppmedlemskap till en fungerande mekanism för att hantera personer som slutar och återvänder.

### Steg 7: Tillämpa referensscenarierna i Okta

Scenarierna, förutsättningarna och attributdefinitionerna finns i avsnittet [**Referensscenarier**](#reference-scenarios) . Här beskrivs endast Okta-konfigurationen.

**Scenario 0 – Avdelning.** I steg 1 deklarerar du attributet med **Visningsnamn** och **Variabelnamn** `department`, **Externt namn** `department` och **Externt namnområde** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. Använd **Attributtyp: Personlig**. Okta:s grundläggande användarprofil innehåller redan en `department` attributet, så steg 2 kan hoppas över — mappa direkt från det i steg 3 genom att välja **Skapa och uppdatera**.

{% hint style="warning" %}
**Observera: Namnrymdsformat för attribut i enterprise-tillägget**

VARNINGEN i steg 1 beskriver Zooms konvention att lägga till attributnamnet i External-namnrymden. Den vägledningen är dokumenterad för attribut under Zoom-tillägget. `department` tillhör standardtillägget för SCIM Enterprise, där Okta normalt håller namnrymden och det externa namnet i separata fält, som visas ovan. Om värdet inte når Zoom kan du prova den tillagda formen — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` — och bekräfta i samtalsloggen i Marketplace vilket formulär som lyckades.
{% endhint %}

**Alternativ om `department` är redan mappad.** Alla följande fungerar på samma sätt, ligger under samma överordnade element och saknar förvillkor – byt ut attributnamnet i båda **Externt namn** och namnrymden, och lägg till ett matchande källattribut i steg 2 om Okta-profilen inte redan har ett:

| Attribut         | Anteckningar                                                                                                                                                                              |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `costCenter`     | Business-fält, varierar mellan användare så att ett felaktigt värde syns                                                                                                                  |
| `organisation`   | Ofta identiskt för alla användare, vilket gör ett misstag svårare att upptäcka                                                                                                            |
| `employeeNumber` | Ofta redan mappad som identitetsfält — kontrollera innan du deklarerar                                                                                                                    |
| `pronouns`       | Finns under tillägget **Zoom** snarare än Enterprise-tillägget och använder därför samma namnrymd som alla andra scenarier i den här guiden. Därmed undviks frågan om formatet ovan helt. |

**Scenario 1 – Zoom Phone-plats och automatisk anknytning.** Deklarera `zoomPhoneSite` med **Attributtyp: Grupp** och ange dess värde för varje plats Okta-grupp. Då avgör gruppmedlemskapet platsen direkt och ingen översättningslogik behövs. Deklarera `zoomPhoneExtNumber` som ett personligt attribut med standardvärdet `0` såvida du inte migrerar en befintlig konfiguration av anknytningar.

**Scenario 2 – Samtalsplan som varierar beroende på land.** Deklarera `zoomPhoneCallingPlan` med **Attributtyp: Grupp** och skapa en grupp per samtalsplansregion. Ange planvärdet i varje grupps tilldelning av Zoom-applikationen. Användarna ärver rätt plan genom sitt medlemskap, och värdet som lagras i Okta är exakt det värde som Zoom förväntar sig. Detta gör också konfigurationen synlig och granskningsbar från fliken **Tilldelningar** och gör den okänslig för inkonsekvenser i hur den underliggande kataloginformationen har fyllts i. En grupp med `-1` ger ett enkelt sätt att avveckla samtalsbehörigheter utan att ta bort användaren.

**Scenario 3 – Paket, roll och region för kontaktcenter.** Deklarera `zoomContactCenterPackage` som ett uppräknat attribut begränsat till de tre tillåtna värdena, så att ett ogiltigt paket aldrig kan anges. Deklarera `zoomContactCenterRole` som ett attribut på gruppnivå, eftersom rollen i allmänhet följer teamstrukturen. Lämna `zoomContactCenterRegion` omappat i driftsättningar med en enda region.

## Felsökning

### Fel

#### <mark style="color:blå;">Användaren finns inte eller tillhör inte det här kontot</mark>

Det här felet uppstår när det inte går att provisionera en användares e-postadress eftersom ett konto redan finns. Zoom-administratörer uppmanas att kontakta användaren direkt och bjuda in användaren till kontot manuellt.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exempel på ett provisioningfel.</p></figcaption></figure></div>

#### <mark style="color:blå;">Du kan inte lägga till betalda användare</mark>

Det här felet uppstår när SCIM försöker provisionera en användare trots att det inte finns tillräckligt många licenser på kontot. För att lösa felet måste användaren provisioneras som en Basic-användare, eller så måste en licens göras tillgänglig för provisionering.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>Exempel på ett provisioningfel.</p></figcaption></figure></div>

### Använda SCIM-loggar för att felsöka användarprovisionering

Zoom tillhandahåller de 100 senaste API-begärandeloggarna på [Zoom Marketplace](https://marketplace.zoom.us/). En Zoom-administratör kan använda loggarna för att bekräfta vilken information som skickas och tas emot via provisioning-API:er. Logga in på Zoom Marketplace som Zoom-administratör och klicka på **Hantera**. På nästa sida markerar du **Samtalsloggar** under **Hantering av personliga appar**. Klicka sedan på en post för att expandera API-loggarna och granska innehållet.

Följande bild visar ett exempel på en SCIM-begäran om användarprovisionering, där användarens identitets- och licensieringsattribut har markerats som referens.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIxosFPBR8E4f1hj0vZQ7_nxnRd_isIqJYhKTQbocw4UfXlCBCkscqx8bGvY8JwuazgtRROPJm9PCZfZ4hJ5GQBqBzJA-PgS-mXkptGa0xq82SMXjl9Ip-faCDk3OQuLUXK0iobQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>Exempel på en SCIM-begäran om användarprovisionering.</p></figcaption></figure></div>

Precis som vid svarsmappning kan Zoom endast tillämpa information som skickas från identitetsleverantören i provisioning-begäran. Använd loggarna för att bekräfta att identitets- och licensieringsattribut för användaren skickas från identitetsleverantören. Om förväntad information saknas i dessa attribut ska du kontakta din identitetsleverantör för support.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/sv/adminhornan/account-and-endpoint-management/scim-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
