> 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/tr/yonetici-kosesi/account-and-endpoint-management/scim-guide.md).

# Entra ID ve Okta için SCIM Saha Kılavuzu

Entra ID veya Okta ile Zoom arasında özel SCIM eşlemeleri oluşturma kılavuzu

## Genel Bakış

Zoom'un SCIM2 API'si, lisanslamayı, ürün yetkilendirmelerini, rolleri, bölgeleri ve hizmet başına yapılandırmayı kontrol eden geniş bir kullanıcı öznitelikleri kataloğunu ortaya çıkarır. Hem Microsoft Entra ID hem de Okta için kutudan çıktığı haliyle sunulan sağlama entegrasyonları bu özniteliklerin yalnızca küçük bir alt kümesini eşler — kullanıcıları oluşturmak, güncellemek ve devre dışı bırakmak için yeterli olan, ancak Zoom Phone sitelerini, iletişim merkezi paketlerini, Revenue Accelerator rollerini veya Zoom'un desteklediği diğer düzinelerce özniteliği sağlamak için yeterli olmayan bir alt kümesini.

Bu kılavuz, ekleme için tekrarlanabilir yöntemi öğretir *herhangi bir* Zoom SCIM özniteliğini sağlama yapılandırmanıza ekleme. Tek bir özniteliği tek başına belgelemek yerine, yöneticilerin Zoom SCIM2 API başvurusunda bir özniteliği bulup ürüne özel bir makalenin yayımlanmasını beklemeden bağımsız olarak yapılandırabilmeleri için temel modeli açıklar.

### Bu kılavuz nasıl kullanılır

Önce şu ifadeyle başlayan Giriş bölümünü okuyun: [**SCIM özniteliklerini anlama**](#understanding-scim-attributes) ve ardından gelen ön koşullar, dizin verileri, başvuru senaryoları ve Zoom tarafında Doğrulama bölümlerini de okuyun. Bunlar, hangi kimlik sağlayıcısını (IdP) kullanırsanız kullanın geçerlidir. Ardından kullandığınız sağlayıcıya göre Microsoft Entra ID veya Okta bölümünü inceleyin. Bu bölümlerin her biri ilk yapılandırma adımından Doğrulama ve uygulamalı örneklere kadar eksiksizdir; bölümler arasında gidip gelmeniz gerekmez.

Bu kılavuzun temelindeki SSO ve SCIM kavramları hakkında bilgi edinmek için şu kaynağa başvurun: [SSO Alan Kılavuzu](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), şu kaynağa da başvurun: [Entra ID için Zoom SSO ve sağlama makalesi](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121) ve [Okta için Zoom SSO makalesi](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

{% hint style="danger" %}
**Uyarı**

Yanlış yapılandırılmış provizyonlama, kullanımda olan lisansların kaldırılması da dahil olmak üzere mevcut kullanıcıları etkiler. Bunu canlı bir kullanıcı kitlesine uygulamadan önce her değişikliği tek bir test kullanıcısı üzerinde doğrulayın.
{% endhint %}

### **SCIM Kullanmak için Önkoşullar**

Bu bölümdeki her şey, kimlik sağlayıcısından bağımsız olarak geçerlidir. Kimlik sağlayıcınıza özgü talimatlara ilerlemeden önce bunu okuyun.

#### Her iki kimlik sağlayıcı için ortak gereksinimler

* onaylanmış bir [Gösterim URL'si](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540)
* Zoom hesabı sahibi veya yönetici ayrıcalıkları
* [Çoklu Oturum Açma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) özelliğinin Zoom hesabında etkinleştirilmiş olması gerekir
* Bir [doğrulanmış ilişkili alan adı](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) kullanıcıların e-posta alan adıyla eşleşen ve Zoom hesabında bulunan
* Kimlik sağlayıcı ile Zoom arasında SCIM sağlama işlemi zaten kurulmuştur
* Atanan Zoom lisansı, planı, eklentisi veya yapılandırma nesnesi, Zoom hesabı üzerinde zaten mevcut ve Uygun olmalıdır

Kimlik sağlayıcıya özgü gereksinimler, ilgili her bölümün başında listelenir.

#### Her iki kimlik sağlayıcısı için ortak sınırlamalar

* SCIM yalnızca mevcut yetkileri atar; başvurduğu nesneleri oluşturamaz. Bölüme bakın [**Gelişmiş eşlemeyi denemeden önce, SCIM'in başvurabilmesi için Zoom tarafındaki nesnelerin mevcut olması gerekir.**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) aşağıda.
* Bazı öznitelikler kullanıcı başına yalnızca bir değer kabul eder. Bir Zoom Phone çağrı planı buna bir örnektir — Customer Engagement Pack gibi eklenti paketleri SCIM üzerinden sağlanamaz.
* &#x20; `userType` özniteliğinin kullanımdan kaldırılmasının planlandığı Zoom tarafından belgelenmiştir.

## **Giriş**

### **SCIM özniteliklerini Anlama**

Bir Zoom SCIM özniteliğinin nasıl oluşturulduğunu anlayan yöneticiler, Zoom'un desteklediği herhangi bir özniteliği Yapılandırabilir. Bir tarifi izleyen yöneticiler yalnızca o tarifin tanımladığı özniteliği Yapılandırabilir. Bu bölüm, oluşturma sürecini kapsar. Bir özniteliği bir veri kaynağına eşleme işlemi daha sonra, kimlik sağlayıcı bölümlerinde ele alınır.

#### <mark style="color:mavi;">Her özniteliğin bir ad alanı, bir adı, bir veri türü ve izin verilen bir değeri vardır</mark>

Tam ve çalışan bir örnekle başlayalım. Bir kullanıcıyı bir Zoom Phone tesisine atamak için tanımlayıcı burada:

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

Bu özniteliğin dört özelliği söz konusu. Bunlardan ikisi yukarıdaki satırda görünür. Diğer ikisi API başvuru belgesinden alınır ve daha sonra kimlik sağlayıcınızda başka bir yere girilir. Şimdilik iki özelliğe odaklanıyoruz:  **Ad alanı** ve **Ad**.

<table><thead><tr><th width="155.290771484375">Özellik</th><th>Örnekten çıkarıldı</th><th>Ne işe yarar</th></tr></thead><tbody><tr><td><strong>Ad alanı</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:User</code></td><td>Zoom'a ayarın hangi şemaya ait olduğunu söyler ve neredeyse her Zoom ürünü ve lisanslama özniteliği için ortak temel görevi görür. Zoom'a tanımlayıcının ilk yarısı olarak iletilir.</td></tr><tr><td><strong>Ad</strong></td><td><code>zoomPhoneSite</code></td><td>Yazılan belirli Zoom ayarını tanımlar — burada, kullanıcının Zoom Phone tesisi. Zoom'a tanımlayıcının ikinci yarısı olarak iletilir. Büyük/küçük harf duyarlıdır.</td></tr><tr><td><strong>Veri türü</strong></td><td><code>string</code></td><td>Kimlik sağlayıcınıza, öznitelik değerinin doğru şekilde depolanıp biçimlendirilmesi için ne tür bir değer içerdiğini bildirir. Tanımlayıcının parçası olarak iletilmez; ayrı olarak şu şekilde tanımlanır: <strong>Tür</strong> Entra ID'de veya <strong>Veri türü</strong> Okta'da.</td></tr><tr><td><strong>İzin verilen değer</strong></td><td><code>LON-01</code>, bir Zoom Phone tesis adı</td><td>Kullanıcıya gerçekten uygulanan ayar. Bazı öznitelikler için serbest metin, diğerleri için sabit bir seçenek kümesi — <code>Essentials</code>, <code>Premium</code>, veya <code>Elit</code> örneğin Zoom İletişim Merkezi için. Sağlama sırasında Zoom’a iletilir; tanımlayıcı yerine eşleme tarafından sağlanır.</td></tr></tbody></table>

{% hint style="danger" %}
**Uyarı**

Zoom birden fazla kullanıcı uzantısı ad alanı yayımlar. Ürün yapılandırması ve lisanslama özellikleri şunu kullanır `urn:ietf:params:scim:schemas:extension:Zoom:1.0:kullanıcı`, bu kılavuz boyunca kullanılan ad alanıdır. Kurumsal alanlar gibi `department`, `manager`, ve `costCenter` kullan `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. Üçüncüsü, `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`, sağlama sırasında yapılandırılmak yerine API yanıtlarında döndürülen oturum açma türü bilgilerini taşır. Yanlış ad alanında oluşturulan bir öznitelik, kimlik sağlayıcınız tarafından kabul edilir ve Zoom tarafından sessizce yok sayılır.
{% endhint %}

#### <mark style="color:mavi;">İhtiyacınız olan özniteliği SCIM2 API referansında bulun</mark>

Bu [SCIM2 API başvuru kılavuzu](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) sağlama sırasında Zoom’un kabul ettiği her şeyin yetkili listesidir. İki işlem önemlidir: **Kullanıcı oluştur** ve **Kullanıcıyı güncelle**.

Öncelikle şunları kullanın: **Kullanıcıyı güncelle**. Oluşturma kişi başına bir kez gerçekleşir, ancak öznitelik değişiklikleri sürekli olur: ofis değişikliği, plan değişikliği, Rol değişikliği, işten ayrılma. Bu nedenle, sağlama işleminin zaman içinde gerçekte yaptığı işlerin çoğu güncellemelerdir. **Kullanıcıyı güncelle** ayrıca şu öğenin içermesine gerek olmayan kaldırma değerlerini de belgeler: **Kullanıcı oluştur** örneğin şu değerin ayarlanması: `zoomPhoneCallingPlan` için `-1` bir kullanıcının tüm arama planlarını kaldırmak için.

Bir özniteliği bulmak için:

* SCIM2 API başvuru kaynağını açın ve şu bölüme gidin **Bir kullanıcıyı güncelle**.
* İstek gövdesinde şu öğeyi bulun: `urn:ietf:params:scim:schemas:extension:Zoom:1.0:kullanıcı` nesnesi. Bu kılavuzda ele alınan tüm öznitelikler bu nesnenin içinde listelenmiştir.
* Özniteliğinizi adına göre bulun ve değerini kaydedin. **veri türü** ve onun **izin verilen değerler**.
* Yanındaki açıklamayı okuyun. Açıklamalar, öznitelik adından çıkaramayacağınız davranışları belirtir — `zoomPhoneExtNumber` olarak ayarlanması `0` otomatik dahili numara atamasını tetikler, `zoomPhoneCallingPlan` olarak ayarlanması `-1` tüm arama planlarını kaldırır ve `zoomPhoneNumber` Zoom hesabında hâlihazırda atanmamış olan bir numarayı belirtmelidir.

#### <mark style="color:mavi;">Tanımlayıcıyı oluşturma: ebeveyn, iki nokta, çocuk</mark>

Bunun içinde listelenen her şey `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` nesne bir **alt öğe** ondan. Nesnenin kendisi **üst öğe**. Bir tanımlayıcı oluşturmak için önce üst öğeyi adlandırın, ardından iki nokta üst üste koyup alt öğeyi ekleyin:

```
Ebeveyn       urn:ietf:params:scim:schemas:extension:zoom:1.0:kullanıcı
İki nokta        :
Çocuk        zoomPhoneSite

Tanımlayıcı   urn:ietf:params:scim:schemas:extension:zoom:1.0:Kullanıcı:zoomPhoneSite
```

Bu, tüm yapıdır. Zoom'dan istenecek bir arama tablosu yok ve oluşturulacak hiçbir şey yok — tanımlayıcı, zaten elinizde olan iki şeyin iki nokta üst üste ile birleştirilmiş hâlidir.

#### <mark style="color:mavi;">Üst öğe aynı kalır; yalnızca alt öğe değişir</mark>

Üst öğe sabit olduğundan, ikinci, beşinci veya on beşinci bir özniteliği yapılandırmak, sonuna farklı bir alt öğe eklenmiş aynı işlemdir:

```
Temel (üst öğe)              urn:ietf:params:scim:schemas:extension:zoom:1.0:User

Zoom Phone tesis            urn:ietf:params:scim:schemas:extension:zoom:1.0:kullanıcı:zoomPhoneSite
Zoom Phone numarası          urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber
Zoom Phone uzantısı       urn:ietf:params:scim:schemas:extension:zoom:1.0:kullanıcı:zoomPhoneExtNumber
Zoom Phone çağrı planı      urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneCallingPlan
```

Aynı ana şirket, diğer tüm Zoom ürünlerini taşır. Ürün değiştiğinde, yapı Hakkında hiçbir şey değişmez:

```
iletişim merkezi Paket     urn:ietf:params:scim:schemas:extension:zoom:1.0:kullanıcı:zoomContactCenterPackage
Gelir Hızlandırıcı Rol   urn:ietf:params:scim:schemas:extension:zoom:1.0:kullanıcı:zoomRevenueAcceleratorRol
Çalışma alanı paketi           urn:ietf:params:scim:schemas:extension:zoom:1.0:kullanıcı:zoomWorkplace
Zoom Docs                  urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomDocs
```

Bu nedenle üst öğeyi bir kez öğrenirsiniz. Bundan sonra, yeni bir öznitelik yapılandırmak, API başvurusunda yalnızca üç şeyi aramak anlamına gelir: alt öğe adı, veri türü ve izin verilen değerleri.

Bir üst öğe ile bir alt öğe oluşturabiliyorsanız, bu yapılandırmanın en zor kısmını geride bırakmışsınız demektir. Geriye kalan, kimlik sağlayıcınıza her değerin nereden gelmesi gerektiğini söylemektir — bunu izleyen Entra ID ve Okta bölümlerinde ele alınıyor — ve hangi özniteliklerin önce ele alınacağına karar vermektir; Sonraki bölümde ele alınıyor.

#### <mark style="color:mavi;">İki tür eşleme: Temel ve gelişmiş</mark>

Her özellik aynı riski taşımaz ve herhangi bir şeyi yapılandırmadan önce bunları sıralamak faydalıdır.

Bu kılavuz, terimleri ...'dan alır **Temel** ve **gelişmiş** ...’dan [SSO Alan Kılavuzu](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), SAML yanıt eşlemesi için de aynı ayrımı yapar. Terimler şunu açıklar: **Zoom, değer geldiğinde onunla ne yapar**, özniteliğin yapılandırılmasının ne kadar zor olduğunu değil. Teknik açıdan ikisi aynıdır: her ikisi de aynı **Kullanıcıyı güncelle** istek gövdesinde belgelenir, aynı üst öğe:alt öğe yapısıyla oluşturulur ve Entra ID ile Okta’da aynı adımlarla tanımlanıp eşlenir.

* **Temel eşleme** kullanıcı profilindeki bir alana metin yazar. Zoom değeri gönderildiği gibi saklar ve hiçbir şeyle karşılaştırıp doğrulamaz.
* **Gelişmiş eşleme** hesap için bir talepte bulunur. Zoom, değeri alır ve eşleşen bir nesne ya da satın alınmış bir planda boş bir koltuk arar; bu arama başarısız olabilir.

<table><thead><tr><th width="199.435791015625"></th><th>Temel eşleme</th><th>Gelişmiş eşleme</th></tr></thead><tbody><tr><td><strong>Değerin ne olduğu</strong></td><td>Kullanıcının profilinde depolanan metin</td><td>Zoom'da bir nesneye işaretçi ya da satın alınmış bir koltuk üzerindeki hak talebi</td></tr><tr><td><strong>Örnekler</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>Üst öğe</strong></td><td>Üst düzey ya da Kurumsal uzantı</td><td>Zoom uzantısı</td></tr><tr><td><strong>Zoom'da önkoşullar</strong></td><td>Yok</td><td>Nesne mevcut olmalı ya da koltuk boş olmalı</td></tr><tr><td><strong>Değer yanlışsa</strong></td><td>Bir profilde yanlış metin görünür</td><td>Öznitelik reddedilir veya sessizce yok sayılır</td></tr></tbody></table>

Bu ayrım, uygulamada iki kararı belirler. Şunları belirler: **Önce Zoom’da ne oluşturmanız gerektiğini** — temel eşleme için hiçbir şey, gelişmiş eşleme için ise muhtemelen epeyce şey — ve ayrıca şunu belirler **bir hatanın bedeli**. Yanlış departman, profilde kozmetik bir hatadır. Yanlış tesis adı veya kullanılamayan bir lisans koltuğu, kullanıcıyı çalışan bir telefondan ya da işe alınırken kullanması için kendisine sağlanan üründen mahrum bırakır ve canlı bir dağıtımda, bu hakka zaten sahip olan bir kişinin hakkını elinden alabilir.

Sonuçtaki bu fark, aşağıda ikisinin neden ayrı ele alındığının sebebidir.

#### <mark style="color:mavi;">Temel eşleştirme: profil bilgileri</mark>

Temel eşleştirme, bir kullanıcının Zoom profilindeki açıklayıcı alanları doldurur. Zoom her değeri gönderildiği gibi saklar ve onu var olan bir nesneyle asla doğrulamaz; bu nedenle önceden Zoom'da oluşturulacak hiçbir şey yoktur ve bir değer yanlışsa bozulacak hiçbir şey de yoktur.

**Temel kimlik alanları genellikle zaten eşlenmiştir.** `Kullanıcı Adı`, `name.givenName`, `name.familyName`, `displayName` ve `emails` İstek gövdesinin en üst düzeyinde, herhangi bir üst öğe olmadan yer alırlar ve hem Entra ID hem de Okta entegrasyonları bunları varsayılan olarak eşler. Bunları yeniden oluşturmaktansa doğrulayın. `title`, `phoneNumbers` ve `locale` da üst düzey alanlardır, ancak eklenmeleri gerekebilir.

**Kurumsal alanlar ikinci bir üst öğe kullanır.** Yapı değişmez; yalnızca üst öğe değişir:

```
Temel (üst öğe)         urn:ietf:params:scim:schemas:extension:Kurumsal:2.0:kullanıcı

Departman            urn:ietf:params:scim:schemas:extension:Kurumsal:2.0:kullanıcı:departman
Maliyet merkezi           urn:ietf:params:scim:schemas:extension:Kurumsal:2.0:kullanıcı:maliyetMerkezi
Çalışan numarası       urn:ietf:params:scim:schemas:extension:Kurumsal:2.0:kullanıcı:çalışanNumarası
Organizasyon          urn:ietf:params:scim:schemas:extension:Kurumsal:2.0:kullanıcı:Organizasyon
Yönetici               urn:ietf:params:scim:schemas:extension:Kurumsal:2.0:kullanıcı:yönetici
```

SCIM aracılığıyla Departman ve Maliyet Merkezi'ni doldurmak artık SAML eşlemesi gerektirmez.

{% hint style="info" %}
**Öneri**

Önce temel bir özniteliği eşleyin — `department` iyi bir adaydır ve şu şekilde ele alınır: **Senaryo 0** başvuru senaryolarında — ve Zoom uzantısı altında herhangi bir yapılandırma yapmadan önce tek bir test kullanıcısı için uçtan uca çalıştırın. Bir `department` değerin Zoom profilinde doğru görünmesi; şema bildirimini, eşlemeyi, kapsamı ve sağlama günlüklerini okuyabilme becerinizi doğrular. Sonraki gelişmiş özniteliklerin her biri yalnızca işaret ettiği şey bakımından farklıdır; yapılandırılma biçimi bakımından değil.
{% endhint %}

#### <mark style="color:mavi;">Gelişmiş eşleme: ürün yapılandırması ve haklar</mark>

Gelişmiş eşleme, kullanıcının yapabileceği şeyleri atar: bir Zoom Phone tesisi ve çağrı planı, bir iletişim merkezi Rolü ve Paketi, bir Workplace paketi, bir Revenue Accelerator segmenti. Bu öznitelikler, bu kılavuz boyunca kullanılan Zoom uzantısı üst öğesi altında yer alır.

Önemli fark, bu değerlerin depolanmaması, **çözümlenmesidir**. Zoom, gönderdiğiniz değeri alır ve eşleşen bir nesne ya da uygun bir koltuk arar. Temel eşleme metni bir profile yazarken, gelişmiş eşleme hesap yapılandırması ve envanteri üzerinde bir talepte bulunur; bu talep başarısız olabilir.

Bu nedenle bu kılavuz, önkoşullara ayrı bir bölüm ayırır. Her gelişmiş öznitelik, önce Zoom web portalı'nda bir şeyin oluşturulmuş ya da satın alınmış olmasına bağlıdır ve hata durumları yanlış yazılmış bir iş unvanından çok daha az toleranslıdır.

#### <mark style="color:mavi;">Her yapılandırmaya ortak olan üç katman</mark>

Hangi öznitelik ya da hangi kimlik sağlayıcı olursa olsun, iş aynıdır: üç katman. Yalnızca her denetimin Konumu farklıdır.

<table><thead><tr><th width="114.4166259765625">Katman</th><th>Amaç</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. Bildir</strong></td><td>Kimlik sağlayıcıya, özniteliğin Zoom uygulamasında bulunduğunu söyleyin; böylece eşleme hedefi olarak Uygun olur.</td><td>Adım 1</td><td>Adım 1</td></tr><tr><td><strong>2. Eşle</strong></td><td>Değerin nereden geldiğini tanımlayın.</td><td>Adım 2</td><td>2–3. Adımlar</td></tr><tr><td><strong>3. Kapsam</strong></td><td>Yapılandırmanın hangi kullanıcılara uygulandığını ve ne zaman çalıştığını belirleyin.</td><td>3–5. Adımlar</td><td>4–5. Adımlar</td></tr></tbody></table>

Bu desen anlaşıldıktan sonra, beşinci veya on beşinci bir öznitelik eklemek aynı üç katmanın tekrarıdır, yeni bir proje değil.

#### <mark style="color:mavi;">Entra ve Okta, bir değerin nereden kaynaklanabileceği konusunda farklılık gösterir</mark>

Bu, iki yol arasındaki tek ve en önemli mimari farktır ve aynı İşletme gereksiniminin Entra ve Okta'da neden farklı yapılandırmalar oluşturduğunu açıklar.

* **Entra ID, değerleri yalnızca kullanıcı nesnesi özniteliklerinden alır.** Bir değer, kullanıcıya ait bir alandan (mevcut bir dizin alanından veya özel üretim bir uzantı özniteliğinden) gelmelidir. Dizin değeriyle Zoom değeri aynı metin değilse, aralarında dönüşüm yapmak için bir ifade gerekir.
* **Okta, değerleri kullanıcı profilinden veya grup atamasından alabilir.** Şu özniteliği bildirmek **Öznitelik türü: Grup** değerin bir grupta bir kez ayarlanmasına ve her Üye tarafından devralınmasına olanak tanır. Yapılandırma kuruluş yapısını izlediğinde, bu sayede çeviri mantığına olan ihtiyaç tamamen ortadan kalkar.

Hiçbir yaklaşım evrensel olarak daha iyi değildir, ancak farklı yapılandırmalara yol açarlar.

### **Zoom tarafı Ön yapılandırma gereksinimleri**

#### <mark style="color:mavi;">Gelişmiş eşlemeyi denemeden önce, SCIM bunlara başvurabilmeden önce Zoom tarafındaki nesneler mevcut olmalıdır</mark>

SCIM bir atama mekanizmasıdır, oluşturma mekanizması değil. Bir kullanıcıyı Zoom hesabında zaten bulunan yapılandırmaya bağlar ve bunu **yapamaz** kullanıcı adına oluşturamaz.

Gelişmiş eşleme özelliklerinin büyük bir bölümü **referanstır**: gönderdiğiniz değerin Zoom'da zaten mevcut olan bir nesneye (tesis, Rol, şablon, satın alınmış plan, belirli bir numara veya dahili numara) karşılık gelmesi beklenir. Hepsi için geçerli olan tek bir kural vardır:

> Bir öznitelik bir şeyi adlandırıyorsa, o şey zaten var olmalı, gönderildiği biçimde tam olarak yazılmalı ve — sonlu bir havuzdan yararlandığı yerlerde — kullanılmamış kapasiteye sahip olmalıdır.

Başvurulan nesne mevcut olmadığında, SCIM ne onu oluşturur ne de isteği kuyruğa alır. Öznitelik ya doğrudan başarısız olur; hata sağlama günlüğünde döndürülür ya da sessizce atılır — Zoom yükü kabul eder, hiçbir şey uygulamaz ve başarı bildirir.

Aşağıdaki bölümler, ön koşulları ürün bazında ayırır; her birini oluşturmak için gezinme yolu ve Destek makalesi de yer alır. Hesap düzeyi notlarını okuyun, ardından sağlamayı planladığınız her ürün için ilgili bölüme geçin.

#### <mark style="color:mavi;">Hesap düzeyindeki ön koşullar, herhangi bir ürün sağlanmadan önce geçerlidir</mark>

Bu kılavuzun başında listelenen hesap gereksinimleri (gösterim URL'si, SSO, SCIM yetkilendirmesi ve doğrulanmış ilişkili bir etki alanı), devamında ele alınan her özellik için ön koşuldur. Güvenlik ve SSO ayarlarını şu bölümden Yapılandırın: [**Yönetici merkezi**](https://zoom.com/account) → [**Güvenlik ve güven**](https://zoom.com/account/setting/security), ve ilişkili etki alanlarını şu bölümden yönetin: [**Yönetici merkezi**](https://zoom.com/account) → **Hesap** → [**Hesap profili**](https://zoom.com/account); bkz. [Zoom + Microsoft Entra ID SSO/SCIM yapılandırması](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121).

Ayrıca açıkça belirtilmesi gereken iki nokta daha var:

* **Bir koltuk satın almak, onu atamakla aynı şey değildir.** Atamayı SCIM yapar, ancak önce koltuğun mevcut olması gerekir. Bkz. [Kullanıcılara Zoom lisansı atama veya lisansları kaldırma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911).
* **Koltuklar, istenen planın tam olarak kendisine ait olmalıdır.** Belirli bir planda boş lisans yokken lisans özelliği göndermek, hesapta başka bir planın kullanılabilir kapasitesi görünse bile başarısız olur.

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

Zoom Phone, en geniş referans öznitelik kümesine sahiptir; çünkü bir telefon kullanıcısı, önceden satın alınmış veya önceden oluşturulmuş altyapının birkaç parçasından bir araya getirilir.

| Öznitelik                                                                               | Önceden neyin mevcut olması gerekir                                                                                                                                                                | Nasıl oluşturulur                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Zoom Phone lisansının kendisi                                                           | Uygun bir Zoom Phone koltuğu — aşağıdakilerden herhangi birinin bağlanabilmesi için gerekli önkoşul hak.                                                                                           | Önceden satın al. Bkz. [Zoom Phone lisanslarını satın alma ve atama](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `zoomPhoneSite`                                                                         | Gönderilen değerle tam olarak aynı adla belirtilen tesis. Özniteliğin belirtilmemesi, Birden fazla site etkinleştirildiğinde varsayılan olarak mevcut olan hesabın ana tesisini atar.              | [Yönetici Merkezi](https://zoom.com/account) → Ürün yapılandırması → Telefon Sistemi → [Şirket bilgileri](https://zoom.com/pbx/page/telephone/settings#/settings) → **Tesis Ekle**, veya **İçe aktar** toplu oluşturma için. Bkz. [Birden fazla siteyi yönetme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                                                                                                                    |
| `zoomPhoneNumber`                                                                       | Hesaba satın alınmış veya taşınmış ve şu anda atanmamış numara. Başka bir kullanıcı, çağrı kuyruğu veya otomatik resepsiyonist tarafından zaten kullanılıyor olan bir numara yeniden kullanılamaz. | [Yönetici Merkezi](https://zoom.com/account) → Ürün yapılandırması → Numaralar → [Telefon Numaraları](https://zoom.com/cpw/page/phoneNumbers#/number-list). Buradan satın alın veya numarayı taşıyın ve SCIM'in numarayı alabilmesi için hedef numarayı atanmamış durumda bırakın. Bkz. [Telefon numaralarını yönetmek için Numara Yönetimi'ni kullanma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) ve [Telefon numaralarını yönetme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212).                                                             |
| `zoomPhoneExtNumber` (yalnızca belirli değerler)                                        | Daha önce kullanılmamış, 3–6 basamaklı bir dahili numara. Gönderirken gerekli değildir `0`, atamayı Zoom'a devreder.                                                                               | [Yönetici Merkezi](https://zoom.com/account) → Ürün yapılandırması → Telefon Sistemi → [Kullanıcılar ve Odalar](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → dahili numaranın atanacağı nesneyi Seç → **Profil** → **Dahili numara** → **Düzenle**. Bkz. [Telefon kullanıcısı Ayarlarını değiştirme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338).                                                                                                                                                                                                                   |
| `zoomPhoneCallingPlan`                                                                  | Satın alınmış ve Uygun kapasiteye sahip çağrı planı, tam plan koduyla belirtilir.                                                                                                                  | Önceden satın al. Bkz. [Zoom Phone lisanslarını satın alma ve atama](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) ve [Telefon kullanıcılarını yönetme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). Plan kodları  [Zoom Phone çağrı planı referansı](https://developers.zoom.us/docs/api/references/phone-calling-plans/) bölümünde listelenir veya  `type`  olarak  [Çağrı planlarını listeleme](https://developers.zoom.us/docs/api/references/phone-calling-plans/)  API'si tarafından kullanılabilir koltuk sayılarıyla birlikte döndürülür. |
| `zoomPhoneCallingPlanSubscription` (yalnızca birden fazla aboneliği olan hesaplar için) | Hesap aynı plan için birden fazla aboneliğe sahipse, planın kullanması gereken belirli abonelik.                                                                                                   | Planlar ve Faturalama → abonelik yönetimi.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

**Dahili numara havuzu yalnızca kullanıcılar arasında değil, farklı nesne türleri arasında da paylaşılır.** Çağrı kuyrukları, otomatik resepsiyonistler, paylaşılan hat grupları ve ortak alan telefonlarının tümü aynı aralıktan dahili numara kullanır. Yönetici yalnızca kullanıcı listesini kontrol ettiğinde dahili numara boş göründüğü için bu, "dahili numara zaten kullanımda" hatalarının en yaygın nedenidir.

**Taşınan bir numara, taşıma işlemi tamamlanana kadar atanamaz.** Numaranın hem hesapta sergilenmesi hem de atanmamış olması gerekir; taşıma işlemini başlatmak bu koşulların hiçbirini karşılamaz.

**En yaygın engel tesislerdir** çünkü tesis oluşturmanın kendine özgü gereksinimleri vardır. Tesis adresleri, acil durum çağrısı hizmetlerinin temelini oluşturdukları için gerçek adreslerden oluşan bir veri tabanında doğrulanır; uydurma adres ve posta kodu kombinasyonları doğrulama hatasıyla reddedilir. Tesisler toplu olarak içe aktarılırken Otomatik resepsiyonist sütunu, arayüzde gösterilen etiket metni yerine  `Yes`  değerini bekler. Arayan kimliği adı ise esas olarak ABD ve Kanada için geçerlidir ve doğrulama hatasına neden olursa boş bırakılabilir.

#### <mark style="color:mavi;">Zoom iletişim merkezi</mark>

İletişim Merkezi sağlama işlemi rol ve şablon odaklıdır. Tek tek özniteliklerin mevcut İletişim Merkezi nesnelerine çözümlenmesi gerekir ve şablon, kendilerine ait özel bir SCIM özniteliği olmayan Ayarlar'ı içerir.

| Öznitelik                       | Önceden neyin mevcut olması gerekir                                                                                                                      | Nasıl oluşturulur                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `zoomContactCenterPackage`      | Paket — `Essentials`, `Premium` veya `Elite` — satın alınmış olmalı ve kullanılmamış koltukları bulunmalıdır.                                            | Önceden satın al; Premium için önce ek Paket satın almak üzere Zoom Destek ile iletişime geçmek gerekebilir. Bkz. [Zoom İletişim Merkezi kullanıcı Ayarlarını değiştirme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                                                         |
| `zoomContactCenterAddonsPlan`   | Eklenti planı, satın alınmış ve kapasitesi mevcut.                                                                                                       | Önceden satın al; hesap planı ve Faturalama Bilgileri.                                                                                                                                                                                                                                                                                                                                                                         |
| `zoomContactCenterRole`         | Rol, Standart veya özel, tam adıyla. Atlanması, varsayılan olarak mevcut olan varsayılan Temsilci Rolü'nü Ata.                                           | [Yönetici merkezi](https://zoom.com/account) → CX yönetimi → İletişim merkezi → [Roller](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Ekle** → izinleri Yapılandır → **Kaydet**. Bkz. [Zoom İletişim Merkezi rollerini yönetme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                                                                                  |
| `zoomContactCenterRegion`       | Bölge. Atlanması, Yapılandırılması gereken hesabın ana bölgesini Ata.                                                                                    | [Yönetici merkezi](https://zoom.com/account) → CX yönetimi → İletişim merkezi → [Tercihler](https://zoom.com/cci/index/admin#/admin-preferences) → Bölgeler → **Bölge Ekle** → bir ad girin ve bir SIP Bölgesi seçin → **Ekle**. Bkz. [Zoom İletişim Merkezi bölgelerini yönetme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                                                                 |
| `zoomContactCenterUserTemplate` | Tam adıyla belirtilen kullanıcı şablonu. Ekle türündeki şablonlar kullanıcı oluşturulurken; Güncelle türündeki şablonlar güncelleme sırasında uygulanır. | [Yönetici merkezi](https://zoom.com/account) → CX yönetimi → İletişim Merkezi → Kullanıcılar → [Şablonlar](https://zoom.com/cci/index/admin#/admin-agents#templates) → **Şablon Ekle** → seçin **Ekle** → rolleri, paketleri, kuyrukları ve becerileri yapılandırın → **Ekle**. Bkz. [Zoom İletişim Merkezi kullanıcı ayarları şablonunu yönetme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

{% hint style="danger" %}
**Uyarı**

İletişim Merkezi bölgeleri Özellikler'i, bölgeler oluşturulmadan önce Zoom Destek tarafından etkinleştirilmelidir ve her kullanıcı tam olarak bir bölgeye aittir. Bu, kendi kendine hizmet Aç/Kapat seçeneği yerine bir Destek talebi olduğundan, çok bölgeli bir dağıtım planlanıyorsa bunu erkenden bildirin.
{% endhint %}

**Gelen kutuları, kuyruklar ve beceriler için SCIM özniteliği yoktur.** Bunları sağlamak için önceden [Yönetici merkezi](https://zoom.com/account) → CX yönetimi → İletişim Merkezi bölümünde oluşturun, bir kullanıcı şablonuna ekleyin ve bu şablonu `zoomContactCenterUserTemplate`aracılığıyla atayın. Bu nedenle bunlar, gereksinimler değiştikçe yönetilmesi gereken tek nesne olan şablonun *şablonun* değil, tek tek kullanıcıların ön koşulları hâline gelir.

<table><thead><tr><th width="123.2821044921875">Nesne</th><th>Nasıl oluşturulur</th></tr></thead><tbody><tr><td>Kuyruk</td><td><a href="https://zoom.com/account">Yönetici merkezi</a> → CX yönetimi → İletişim Merkezi → <a href="https://zoom.com/cci/index/admin#/admin-queues">Kuyruklar</a> → <strong>Kuyruk Ekle</strong> → ad, kanal, temsilciler → <strong>Kaydet</strong>. Bkz. <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">Zoom İletişim Merkezi kuyruklarını yönetme</a>.</td></tr><tr><td>Beceri</td><td><a href="https://zoom.com/account">Yönetici merkezi</a> → CX yönetimi → İletişim Merkezi → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">Beceriler</a> → bir kategori seçin → <strong>Beceri Ekle</strong> → ad → <strong>Ekle</strong>. Bkz. <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">Becerileri ve beceri kategorilerini yönetme</a>.</td></tr><tr><td>Gelen Kutusu</td><td><a href="https://zoom.com/account">Yönetici merkezi</a> → CX yönetimi → İletişim Merkezi → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">Gelen kutusu</a> → <strong>Gelen Kutusu Ekle</strong>. Bkz. <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">Zoom İletişim Merkezi gelen kutularını yönetme</a>.</td></tr></tbody></table>

**Hem bir şablon hem de ayrı öznitelikler sağlandığında, ayrı değerler önceliklidir.** Bir şablonun `zoomContactCenterRole` ile birlikte gönderilmesi, Rol özniteliğinin şablonun Rol ayarını geçersiz kıldığı anlamına gelir; bu nedenle hem başvurulan Rol hem de şablon mevcut olmalıdır.

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

| Öznitelik                                                            | Önceden neyin mevcut olması gerekir                                   | Nasıl oluşturulur                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` ve `zoomRevenueAcceleratorSubscription` | Uygun koltuğu olan satın alınmış ZRA planı veya aboneliği.            | Önceden satın al; hesap planı ve Faturalama Bilgileri.                                                                                                                                                                                                                                                                                                               |
| `zoomRevenueAcceleratorRole`                                         | Standart veya özel Rol; örneğin `Satış Manager` — tam olarak bu adla. | [Yönetici merkezi](https://zoom.com/account) → Kullanıcılar → [Roller](https://zoom.com/role#/) → **Revenue Accelerator** sekme → **+ Rol Ekle** → ad ve açıklama → **Ekle** → izinleri Yapılandır → **Değişiklikleri Kaydet**. Bkz. [Zoom Revenue Accelerator rol yönetimini kullanma](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                      | Kullanıcının ait olduğu segment.                                      | Revenue Accelerator yönetici Ayarlar.                                                                                                                                                                                                                                                                                                                                |
| `zoomRevenueAcceleratorRegion`                                       | Bölge — örneğin, `US`.                                                | Revenue Accelerator yönetici Ayarlar.                                                                                                                                                                                                                                                                                                                                |

#### <mark style="color:mavi;">Zoom Workplace lisansları ve hesap rolleri</mark>

Yukarıdaki üç ürünün ötesinde, Standart kullanıcı kaydı aynı kuralı izleyen Rol ve lisans başvurularını içerir.

| Öznitelik                                                                                                                                                                                                                                                 | Önceden neyin mevcut olması gerekir                                                                                                | Nasıl oluşturulur                                                                                                                                                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles[]` (`value` / `göster`)                                                                                                                                                                                                                            | Tam olarak bu şekilde adlandırılmış hesap Rolü. Roller SCIM tarafından referans alınır, hiçbir zaman onun tarafından oluşturulmaz. | [yönetici merkezi](https://zoom.com/account) → Kullanıcılar → [Roller](https://zoom.com/role#/) → **Rol Ekle** → ad ve açıklama → izinleri Yapılandır. Bkz. [Rol Yönetimi kullanımı](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` ve diğer lisans veya eklenti öznitelikleri — beyaz tahta, Scheduler, Clips Plus, tercüme edilmiş alt yazı, İş Gücü Yönetimi, Kalite Yönetimi, uyumluluk Yönetimi, CX Insights, AI Satış Assist ve bunların `...Subscription` karşılıkları | Kullanılmamış koltuklarla satın alınmış karşılık gelen paket veya eklenti.                                                         | Planlar ve Faturalama → Plan Yönetimi → planı düzenle → lisans sayısını artır. Bkz. [Hesabınızı ve eklentileri yükseltme](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                            |
| `loginType` (`sso` / `workEmail`), altında `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                                                                                                              | SSO, SSO giriş türü için hesap üzerinde yapılandırılmıştır.                                                                        | [Yönetim merkezi](https://zoom.com/account) → Güvenlik ve güven → [Çoklu Oturum Açma](https://zoom.com/account/sso/saml).                                                                                                                                         |

Bir lisans veya eklenti özniteliği için adlandırılacak bir nesne yoktur, ancak önkoşul etki bakımından aynıdır: o belirli havuzda Uygun bir koltuk olmadan atama başarısız olur.

#### <mark style="color:mavi;">Önkoşulu olmayan öznitelikler</mark>

şu bölümde ele alınan tüm temel eşleme öznitelikleri için geçerlidir: **Temel eşleme: profil bilgileri** — Zoom bu değerleri olduğu gibi saklar ve mevcut bir nesneye göre hiçbir zaman doğrulamaz. Zoom uzantısındaki iki öznitelik de aynı şekilde davranır:

* **Otomatik devredilen değerler** — `zoomPhoneExtNumber` şu şekilde gönderilir: `0`, burada dahili numarayı Zoom kendisi atar.
* **Hesap özel öznitelikleri** — `{customAttribute}` alanı; gönderdiğiniz herhangi bir metin değerini tutar.

**Varsayılan değerli referanslar** ara bir durumdur: atlanması `zoomPhoneSite`, `zoomContactCenterRole`, veya `zoomContactCenterRegion` sırasıyla ana tesise, varsayılan Temsilci Rolüne ve ana bölgeye geri döner. Bu varsayılanların da mevcut olması gerekir ve bunlar varsayılan olarak mevcuttur.

**Gruplar kısmi bir istisnadır.** Grup sağlama etkinleştirildiğinde SCIM, henüz mevcut olmayan bir Zoom grubu oluşturur ve kaynak grubun adını tam olarak yazıldığı şekilde kullanır. Bu gruba herhangi bir ürün yapılandırması uygulamaz; grup yalnızca üyeleriyle oluşturulur. Zoom Phone politikaları, arama izinleri ve grup düzeyindeki diğer Ayarlar için [Yönetici merkezi](https://zoom.com/account) → Kullanıcılar → [Gruplar](https://zoom.com/account/group#/) bölümünde grup göründükten sonra yapılandırma yapılması gerekir.

{% hint style="info" %}
**Öneri**

Zoom tarafındaki kurulumı, kendi onayı olan bir ön koşul aşaması olarak ele alın; öznitelik eşleme çalışması başlamadan önce tamamlanmış ve doğrulanmış olsun. Tesisler, numaralar, planlar, Roller ve şablonlar çoğu zaman kimlik sağlayıcı yapılandırmasından farklı bir ekibe aittir ve sağlama testleri sırasında eksik bir nesneyi keşfetmek, varlığını önceden doğrulamaktan çok daha fazla maliyet çıkarır.
{% endhint %}

### **Dizin verilerinizi hazırlama**

SCIM, kaynağın içerdiği ne varsa onu aktarır. Doğrulamaz, normalleştirmez veya düzeltmez. Herhangi bir özniteliği eşleştirmeden önce, amaçlanan kaynak hakkında üç şeyi doğrulayın:

* **Kapsamdaki her kullanıcı için doldurulur.** Boş bir alan hiçbir şey göndermez veya yapılandırılmış varsayılanı gönderir.
* **Değerleri, biçim ve büyük/küçük harf kullanımı açısından tutarlıdır.** Her iki kimlik sağlayıcıdaki karşılaştırma mantığı da birebir eşleşmeye dayanır.
* **Değerleri, Zoom'un beklediği değerlerle tam olarak eşleşir.** Zoom, tesis adları, Rol adları veya plan değerleri için yaklaşık eşleştirme yapmaz.

Mevcut bir alan üç koşulu da karşılayamıyorsa, bu Entegrasyonlar için kasıtlı olarak doldurulmuş özel üretim bir öznitelik, başka sistemlerin de yazdığı bir alanı yeniden amaçlandırmaktan daha sürdürülebilirdir.

{% hint style="info" %}
**Öneri**

Kimlik sağlayıcı yapılandırmasına dokunmadan önce tek doğru kaynağı belirleyin. Başarısız SCIM dağıtımlarının çoğu, sağlama sorunları olarak sunulan dizin verisi sorunlarıdır.
{% endhint %}

### **Referans Senaryoları**

Bu kılavuz boyunca dört senaryo kullanılır. İşletme gereksinimleri ve Zoom tarafındaki önkoşullar, kimlik sağlayıcısından bağımsız olarak aynıdır; bu yüzden burada bir kez tanımlanmışlardır. Kimlik sağlayıcıya özgü her bölüm, o platformda dördünün tümünün nasıl uygulanacağını göstererek sona erer.

#### <mark style="color:mavi;">Senaryo 0: Departman, ilk Temel eşleme olarak</mark>

Bir kullanıcının departmanı, dizinden alınarak Zoom profilinde görünmelidir. Bu, daha önce ilk uçtan uca test olarak önerilen Temel eşleştirmedir ve prosedürün hem kimlik sağlayıcı bölümlerinde de ele alınması için buraya eklenmiştir.

**Zoom tarafındaki ön koşul.** Yok. Zoom, değeri gönderildiği şekilde aynen saklar ve hiçbir zaman mevcut bir nesneye göre doğrulamaz.

**Öznitelik.** Üst öğenin aşağıdaki üç senaryodan farklı olduğunu unutmayın — `department` Zoom uzantısının değil, Kurumsal uzantısının altında yer alır.

| Öznitelik                                                               | Tür  | Notlar                                                                                                                                                  |
| ----------------------------------------------------------------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | dize | Serbest metin. Her iki kimlik sağlayıcısının kullanıcı profilinde zaten bir `department` alanı bulunduğundan yeni bir kaynak özniteliğine gerek yoktur. |

**Neden buradan başlamalı?** Bir departman değerinin Zoom profilinde doğru görünmesi; lisans veya telefon yapılandırmasını riske atmadan şema bildirimini, eşlemeyi, kapsamı ve sağlama günlüklerini okuyabildiğinizi doğrular. Aşağıdaki gelişmiş senaryoların her biri yalnızca özniteliğin neyi işaret ettiği bakımından farklıdır.

**Önce zaten eşlenip eşlenmediğini kontrol edin.** Varsayılan eşlemeler Entra ID ile Okta arasında farklılık gösterir ve her iki sağlayıcı Zoom entegrasyonlarını güncelledikçe değişir. Mevcut listeyi şu bölümde inceleyin: **Sağlama** → **Eşlemeler** Entra'da veya **Zoom Öznitelik Eşlemeleri** ile **Eşlenmemiş Öznitelikleri Göster** Okta'da etkinleştirilmiş. Eğer `department` zaten eşlenmişse, yinelenen olarak belirtmek yerine bunu doğrulayın — bir özniteliği sıfırdan yapılandırmak istiyorsanız, `costCenter`, `Organizasyon`, ve `employeeNumber` aynı üst öğenin altında bulunur ve aynı şekilde davranırlar.

#### <mark style="color:mavi;">Senaryo 1: Zoom Phone tesisi ve otomatik dahili numara ataması</mark>

Kullanıcılar, ofislerine göre doğru Zoom Phone tesisine yerleştirilmeli ve idari müdahale olmadan bir dahili numara almalıdır.

**Zoom tarafındaki ön koşul** Tesisler önceden oluşturulmuş olmalıdır. Bunları şu bölümde oluşturun: [**Yönetim Merkezi**](https://zoom.com/account) → **Ürün yapılandırması** → **telefon sistemi** → [**Şirket bilgileri**](https://zoom.com/pbx/page/telephone/settings#/settings) → **Tesis Ekle**veya toplu olarak şu yolla **İçe aktar**. Tesis adresleri, acil durum çağrısı hizmetlerini destekledikleri için gerçek dünyadaki bir adres veritabanına göre doğrulanır; bu nedenle kurgusal adres ve posta kodu kombinasyonları doğrulamadan geçemez.

**Öznitelikler.** Her ikisi de ad alanını alır `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:` ardından ad gelir.

| Öznitelik            | Tür  | Notlar                                           |
| -------------------- | ---- | ------------------------------------------------ |
| `zoomPhoneSite`      | dize | Zoom tesis adıyla karakter karakter eşleşmelidir |
| `zoomPhoneExtNumber` | dize | `0` otomatik atamayı tetikler                    |

**Değer neden `0` önemlidir.** Kullanımda olan uzantıları (kullanıcılara değil, çağrı kuyruklarına ve otomatik resepsiyonistlere atanmış uzantılar da dâhil) hangi sistemin bildiği tek yer Zoom’dur. Atama işini Zoom’a devretmek, sağlama hatalarının tüm bir kategorisini ortadan kaldırır. Uzantıları bunun yerine dizinden almak, mevcut uzantı numaralarını korumanın önemli olduğu bir geçiş sırasında uygundur; ancak eşleme şu noktaya geçmelidir `0` gelecekte katılanların dizin verilerinin süresiz olarak güncel tutulmasına bağımlı olmaması için geçiş tamamlandıktan sonra.

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

Bir Zoom Phone hesabındaki varsayılan tesisin adı genellikle tam olarak `Ana tesis`, altında görünür [**Yönetici Merkezi**](https://zoom.com/account) → **Ürün yapılandırması** → **telefon sistemi** → [**Şirket Bilgileri**](https://zoom.com/pbx/page/telephone/settings#/settings). Yeniden adlandırılabileceğinden, kullanmadan önce ilgili hesaptaki adı doğrulayın.
{% endhint %}

#### <mark style="color:mavi;">Senaryo 2: Ülkeye göre değişen Zoom Phone çağrı planı</mark>

Çok uluslu bir Organizasyon, bağımsız Zoom Phone çağrı planları satın aldı ve her kullanıcının ülkesine uygun planı alması gerekiyor.

**Zoom tarafındaki ön koşul.** Çağrı planları önceden satın alınmış ve hesapta kullanılabilir durumda olmalıdır. Plan değerleri şu belgede açıklanmıştır: [Zoom Phone çağrı planı referansı](https://developers.zoom.us/docs/api/references/phone-calling-plans/).

**Öznitelik.** `zoomPhoneCallingPlan` (string).

**Doğru plan kodunu alma.** `zoomPhoneCallingPlan` plan adını değil, sayısal plan kodunu alır. Bunu edinmenin en güvenilir yolu [Arama planlarını listele](https://developers.zoom.us/docs/api/references/phone-calling-plans/) Her planın değerini döndüren API `name`, onun `type` — eşlediğiniz kod — ve onun `subscribed` ve `Uygun` koltuk sayıları. Böylece tek bir çağrı planın mevcut olduğunu doğrular, göndermeniz gereken değeri verir ve planı atamak için kapasite bulunduğunu teyit eder.

Zoom web portalı yalnızca görünen adları gösterir, kodları göstermez. Bu nedenle yalnızca portalı kullanarak işlem yapan bir yöneticinin, görünen adı şu kaynağı kullanarak çevirmesi gerekir: [Zoom Phone çağrı planı başvurusu](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — örneğin, `UNLIMITED_PLAN_US_CA` şudur: `200` ve `UNLIMITED_PLAN_GB_IE` şudur: `202`. Başvuruda portalın kullandığı ifadeler değil, sabit adları listelenir. Bu nedenle tam metin eşleşmesine değil; bölge ve ölçümlü ya da sınırsız olması gibi plan özelliklerine göre eşleşmeyi doğrulayın.

Ayrı olarak, Zoom'un SCIM2 API başvurusunda aşağıdaki gibi bir faturalama planı adı gösterilir: `phone_calling_usca_monthly_unlimited` örnek yükünde. Bu tanımlayıcı, bir abonelik *satın al* için kullanılır; bir kullanıcıya plan atamak için değil. Bir planın hangi aboneliği kullanacağını belirtmeniz gerekiyorsa, bu bilgi `zoomPhoneCallingPlanSubscription`.

**Neden `-1` yedek değer olarak kullanılıyor?** SCIM2 başvuru belgesi, `-1` değerini tüm arama planlarını kaldıran değer olarak belgeler. Bu değeri eşleşmeyen kullanıcılar için kullanmak, hiç değer göndermemenin belirsizliği yerine belirgin ve öngörülebilir bir sonuç sağlar: atanmış plan yok. Ayrıca kullanıcıyı silmeden arama yetkilerini kaldırmanın kolay bir yolunu sunar.

#### <mark style="color:mavi;">Senaryo 3: Zoom iletişim merkezi Paketi, Rolü ve bölgesi</mark>

İletişim merkezi temsilcileri, Katılım aşamasında doğru ZCC Paketi ve Rolü ile sağlanmalıdır; sonradan elle yapılandırılmak yerine. Bu senaryo, yöntemin üründen bağımsız olduğunu gösterir — prosedürde hiçbir şey değişmez, yalnızca öznitelik adları ve izin verilen değerler değişir.

| Öznitelik                  | Tür  | İzin verilen değerler                                                         |
| -------------------------- | ---- | ----------------------------------------------------------------------------- |
| `zoomContactCenterPackage` | dize | `Essentials`, `Premium`, `Elite`                                              |
| `zoomContactCenterRole`    | dize | Herhangi bir ZCC rol adı. Belirtilmezse varsayılan olarak `Agent` kullanılır. |
| `zoomContactCenterRegion`  | dize | Yapılandırılmış herhangi bir ZCC bölgesi. Atlanırsa ana bölge varsayılandır.  |

**Öznitelikleri bilerek belirtmemek hakkında.** Ayrıl `zoomContactCenterRegion` Zoom'un belgelenmiş varsayılanının zaten doğru olduğu tek bölgeli dağıtımlarda eşlenmemiş bırakın. Varsayılanı doğru olan bir özniteliği eşlemek yerine belirtmemek tercih edilir; her eşleme bir bakım yükümlülüğüdür.

**Operasyonel not.** SCIM2 referansı ayrıca şunları da belgeler `zoomContactCenterUserTemplate`, önceden oluşturulmuş bir ZCC şablonunu uygular. Ekleme türündeki şablonlar kullanıcı oluşturulurken, güncelleme türündekiler ise güncelleme sırasında uygulanır; aynı istekte hem bir şablon hem de tek tek öznitelik değerleri sağlanırsa öncelik tek tek değerlere verilir. ZCC yapılandırması, çok sayıda tekil öznitelik eşlemesi üzerinden yönetilmesi zorlaşacak kadar karmaşıksa şablonları değerlendirmeye değer.

### **Zoom tarafındaki Doğrulama ve yaygın hatalar**

Her kimlik sağlayıcının kendi günlüğü vardır; bu, her kimlik sağlayıcının 6. Adımında ele alınır. Aşağıdaki Zoom tarafındaki günlük her ikisi için de aynıdır ve Zoom'un gerçekte ne aldığının nihai kaydetmekidir.

#### <mark style="color:mavi;">Zoom App Marketplace çağrı günlükleri, tam istek ve yanıt alışverişini Göster</mark>

1. Hesap sahibi olarak Zoom web portalına Giriş yapın.
2. Şuraya gidin: [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Yönet** → **Hesaptaki uygulamalar**.
3. Kimlik sağlayıcı bağlantısını temsil eden uygulamayı Seç. Entra için bunun adı genellikle **Azure Kimliği** veya benzeri.
4. Açın **Çağrı günlükleri** sekmesini.
5. İlgili çağrıyı bulmak için **Uç noktaya göre ara**, ya da tarih aralığı, yöntem ve durum filtrelerini kullanın.
6. Genişletmek için satırı Seç.
7. Gönderilen içeriği tam olarak görmek için `requestBody` alanını, Zoom'un döndürdüğü içeriği tam olarak görmek için ise `response` alanını inceleyin. Bu içerik, oluşturulan Zoom kullanıcı kimliğini, `httpStatus`değerini ve ortaya çıkan öznitelik kümesini de içerir.

Zoom en son 100 API istek günlüğünü saklar; bu nedenle, başarısızlığı daha fazla sağlama etkinliği onu yerinden etmeden önce, vakit kaybetmeden inceleyin.

#### <mark style="color:mavi;">Yaygın sağlama hataları ve nedenleri</mark>

<table><thead><tr><th width="99.69622802734375">Kod</th><th>Mesaj</th><th>Neden ve çözüm</th></tr></thead><tbody><tr><td>400</td><td>Hesapta Çoklu Oturum Açma etkinleştirilmemiştir.</td><td>Çoklu Oturum Açma, SCIM için bir ön koşuldur. Önce Zoom hesabı için SSO'yu Etkinleştir ve Yapılandır.</td></tr><tr><td>400</td><td>Kullanıcı etkin değil veya kilitli.</td><td>Hedef Zoom kullanıcı, mevcut durumunda güncellenemez. hesap durumunu Zoom web portalı üzerinden çözün.</td></tr><tr><td>403</td><td>İstek, yetersiz izinler nedeniyle reddedildi: "Kullanıcı:Düzenle".</td><td>SCIM bağlantısının kimlik bilgileri gerekli kapsama sahip değil. Bağlantıyı Sahip veya yönetici olan bir hesap kullanarak yeniden yetkilendirin.</td></tr><tr><td>404</td><td>Kullanıcı mevcut değil.</td><td>Kimlik sağlayıcısı, kullanıcıyı mevcut bir Zoom kullanıcı ile eşleştirmedi. Eşleşen özniteliği ve Kullanıcı Adı biçimini doğrulayın.</td></tr><tr><td>409</td><td>e-posta alan adı, hesap ile ilişkili alan adıyla eşleşmiyor.</td><td>Kullanıcının e-posta alan adı Zoom hesabı ile ilişkili değil. Sağlama işleminden önce alan adını ilişkilendirin ve doğrulayın.</td></tr><tr><td>409</td><td>Ücretli kullanıcıları Ekleme mümkün değil.</td><td>İstenen türde Uygun bir lisans yok. hesapta kapasite boşaltın veya kullanıcıyı Temel olarak sağlayın.</td></tr><tr><td>409</td><td>[paket adı] ile daha fazla kullanıcı oluşturulamaz.</td><td>Belirtilen pakette kalan kontenjan yok. İşletme Plus, Kurumsal Premier, Pro Plus ve Eğitim eşdeğerleri için geçerlidir.</td></tr><tr><td>429</td><td>Çok Fazla İstek.</td><td>Sağlama, Zoom'un hız sınırlarını aştı. Döngüler boyunca devam ederse inceleyin.</td></tr></tbody></table>

#### <mark style="color:mavi;">Bir hata modu hiç hata oluşturmaz</mark>

Zoom'un kabul ettiği ancak herhangi bir şeye karşılık gelmeyen bir değer — sonunda boşluk bulunan bir tesis adı veya Zoom'da sonradan yeniden adlandırılmış bir Rol adı — söz dizimi açısından kabul edilebilir ve hiçbir şeye uygulanmayabilir. Hiçbir günlük girdisi bu durumu işaretlemez. Aynı sorunun platform özelindeki varyasyonları 6. Adımda ele alınmaktadır.

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

Zoom ile kimlik sağlayıcısı bir kullanıcının yapılandırması konusunda anlaşamadığında, kimlik sağlayıcısını yetkili kabul edin ve değeri orada düzeltin. Doğrudan Zoom web portalı üzerinde düzenleme yapmak, sonraki sağlama Etkinlik tarafından üzerine yazılan bir durum oluşturur; bu da altta yatan sorunun teşhisini zorlaştırır.
{% endhint %}

## **Entra ID ile SCIM yapılandırması**

#### <mark style="color:mavi;">Entra ID için ek gereksinimler</mark>

* Kurumsal Uygulamalara Access'e sahip Entra ID yönetici ayrıcalıkları
* Kullanıcılarınızın kullandığı ve Entra ID kiracısında özel alan adı olarak doğrulanan e-posta alan adı

#### <mark style="color:mavi;">Entra ID’de ek sınırlamalar</mark>

* Öznitelik eşlemeleri yalnızca Entra *kullanıcı nesnesi* özniteliklerinden kaynaklanır. Güvenlik grupları, Zoom özniteliğine doğrudan değer sağlayamaz; grup üyeliği değeri değil, kapsamı belirler.
* Artımlı sağlama döngüleri yaklaşık her 40 dakikada bir çalışır. Sağlama etkinleştirildikten sonra değişiklikler anında gerçekleşmez.
* Entra ID'de Microsoft'a özgü bir sınırlama nedeniyle `Collaboration` değeri `userType` desteklenmez.

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

Standart sağlama yapılandırması şu adreslerden biri üzerinden yapılabilir: `entra.microsoft.com` veya `portal.azure.com`. Ancak 1. adımda kullanılan şema düzenleyiciye yalnızca Azure Portal URL'sine `forceSchemaEditorEnabled` parametresi eklenerek erişilebilir. Bu bayrağın `entra.microsoft.com`üzerinde etkisi yoktur. Yapılandırma sırasında portallar arasında geçiş yapmamak için bu bölümdeki tüm adımlarda 1. adımdaki Azure Portal bağlantısını kullanın.
{% endhint %}

### 1. Adım: Özniteliği Zoom uygulama şemasında bildirin

Bir özniteliği bildirmek, öznitelik başına tek seferlik bir işlemdir. Herhangi bir eşleme yapılandırmadan önce kullanmayı planladığınız her özniteliği bildirin, böylece 2. Adımda tüm hedefler kullanılabilir olur.

1. Şema düzenleyici URL'sini kullanarak Azure Portal'da oturum açın: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. Azure hizmetleri **altında**Seç **Microsoft Entra ID**.
3. Sol gezinme menüsünde, **Yönet**bölümünün altında **Kurumsal uygulamalar**.
4. Uygulamalar listesinde Zoom uygulamanıza tıklayın.\
   **Not**: Uygulama adı, uygulama oluşturulurken Entra yöneticisi tarafından belirlenir. Genellikle **Zoom** veya **Zoom SSO**olarak adlandırılır, ancak kiracınıza göre farklı olabilir.
5. Sol gezinme menüsünde, **Yönet**bölümünün altında tıklayın **Sağlama**.\
   **Not**: Azure şu anda iki düzenden birini sunuyor. Eski deneyimde şunu seçin: **Öznitelik eşlemelerini düzenle** şunun altında **Sağlamayı yönet**. Yeni deneyimde sayfa bir **Genel bakış** sekmesinde açılır; sol taraftaki menüden tekrar **Sağlama** seçin. Her iki yol da aynı hedefe ulaşır.
6. Şuna tıklayın **Eşlemeler** açılır menüden sonra tıklayın **Microsoft Entra ID kullanıcılarını sağlama**.\
   **Not**: Eski adlandırmayı göstermeye devam eden kiracılarda bu seçenek şu şekilde görünür **Azure Active Directory Kullanıcılarını Sağlama**.
7. Sol alt köşede, şunu Seç **Gelişmiş seçenekleri Göster** onay kutusu.
8. Tıklayın **Zoom için özellik listesini düzenle**.
9. İlk boş satıra kaydırın ve aşağıdakileri tamamlayın:
   * **Ad**: Tam öznitelik dizgesini girin; örneğin `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Tür**: Seç **Dize** veya **Boole değeri**, SCIM2 API başvuru belgesinde belirtilen veri türüyle eşleşecek şekilde.
10. Her ek öznitelik için 9. adımı tekrarlayın.
11. Sol üst köşede şuna tıklayın: **Kaydet**.

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

Öznitelik adları büyük/küçük harfe duyarlıdır ve API başvuru belgesindekiyle tam olarak eşleşmelidir. `zoomPhoneSite` geçerlidir; `zoomphonesite` ve `ZoomPhoneSite` geçerli değildir. Harf kullanımı yanlış olan bir öznitelik, şema düzenleyicisi tarafından hata vermeden kabul edilir ancak Zoom API'de sessizce başarısız olur.

Şu şekilde belgelenen öznitelikler için `boolean`, **String** eşlenen kaynak metinsel sabit değeri sağladığında da geçerlidir: `true` veya `false`. Seçmek **String** kaynak, metin depolayan bir Entra uzantı özniteliği olduğunda genellikle daha pratiktir.
{% endhint %}

### Adım 2: Bir dizin kaynağını özniteliğe eşleyin

Entra ID üç eşleme türü sunar ve bunlar arasındaki seçim, yapılandırmadaki en önemli karardır.

<table><thead><tr><th width="133.376708984375">Eşleme türü</th><th>Şu durumda kullanın</th><th>Davranış</th></tr></thead><tbody><tr><td><strong>Doğrudan</strong></td><td>Bir Entra alanı, Zoom'un beklediği tam değeri zaten tutar.</td><td>Kaynak değeri değişmeden iletir.</td></tr><tr><td><strong>Sabit</strong></td><td>Kapsamdaki her kullanıcı aynı değeri almalıdır.</td><td>Sağlanan her kullanıcıya sabit bir değer gönderir.</td></tr><tr><td><strong>İfade</strong></td><td>Değer, kullanıcı özniteliğine göre türetilmeli, çevrilmeli veya çeşitlendirilmelidir.</td><td>Bir ifadeyi kaynak alanlara karşı değerlendirir ve sonucu gönderir.</td></tr></tbody></table>

**Eşlemeyi oluşturmak için:**

1. Geri dön: **Sağlama** → **Eşlemeler** → **Microsoft Entra ID Kullanıcılarını Sağla**.
2. Sol alt köşede, şuna tıklayın: **Yeni Eşleme Ekle**.
3. Eşlemeyi seçilen türe göre Yapılandırın — aşağıdaki yönergeye bakın.
4. Şuna tıklayın: **Hedef öznitelik** açılır menüsünü açın ve 1. Adımda belirtilen özniteliği seçin.
5. Şuna tıklayın: **Nesneleri bu özniteliği kullanarak eşleştir** açılır menü ve Seç **Hayır**.\
   **Not**: Özel Zoom öznitelikleri, kimlik eşleştirme anahtarları değil, yapılandırma değerleridir. Entra kullanıcılarını Zoom kullanıcılarıyla ilişkilendiren öznitelik (genellikle `Kullanıcı Adı` — şu değere ayarlanmalıdır **Evet**.
6. Şuna tıklayın **Bu eşlemeyi uygula** açılır liste ve seç **Her zaman**, böylece değer hem oluşturma sırasında hem de sonraki güncellemelerde uygulanır.
7. Tıklayın **Tamam**.
8. Her öznitelik için tekrarlayın, ardından tıklayın **Kaydet** sayfanın üst kısmındaki **Öznitelik Eşleme** .

#### <mark style="color:mavi;">Doğrudan eşleme, mevcut bir alanı dönüştürmeden aktarır</mark>

* **Eşleme türü**: **Doğrudan**
* **Kaynak özniteliği**: Değeri, karakter karakter Zoom'un beklediğiyle eşleşen bir Entra alanı
* **Null ise varsayılan değer (İsteğe Bağlı)**: Kaynak alan boş olduğunda uygulanan yedek değer

Doğrudan eşleme en az sorun çıkaran seçenektir ve dizin verileri desteklediği her yerde tercih edilmelidir. Eğer `physicalDeliveryOfficeName` — şu adla gösterilir: **Ofis Konumu** Entra kullanıcı profilinde — Zoom Phone tesis adlarıyla tam olarak eşleşen değerler zaten bulunduğundan, doğrudan eşlemek için hiçbir mantık gerekmez.

{% hint style="info" icon="lightbulb" %}
**İpucu**

Doldur **null ise varsayılan değer** eksik bir kaynak değeri hataya veya istenmeyen bir sonuca yol açacaksa. Şu varsayılan değer `Ana tesis` tesis eşlemesinde, ofis Konumu olmayan kullanıcıların tanımsız bir duruma düşmek yerine başarıyla sağlanmasını garanti eder.
{% endhint %}

#### <mark style="color:mavi;">Sabit eşleme, kapsam içindeki tüm topluluğa tek bir değer uygular</mark>

* **Eşleme türü**: **Sabit**
* **Sabit Değer**: Gönderilecek sabit değer

Sabit eşleme, tek yapılandırmalı dağıtımlar için uygundur ve Zoom'a özgü çeşitli davranışların da temel mekanizmasıdır. Ayarlama `zoomPhoneExtNumber` değerini sabit bir `0` değerine ayarlamak, Zoom'a kullanıcının tesisinde uygun olan sonraki dahili numarayı atamasını söyler ve dahili numara çakışmalarını tamamen ortadan kaldırır.

#### <mark style="color:mavi;">İfade eşleme, sağlama sırasında bir değeri çevirir veya türetir</mark>

* **Eşleme türü**: **İfade**
* **İfade**: Bir veya daha fazla kaynak özniteliğini değerlendiren iç içe `IIF()` ifadesi

Dizin değeri ile Zoom değeri aynı dize olmadığında ifade eşleme gerekir:

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

{% hint style="danger" %}
**Uyarı**

İfadeler metinleri, büyük-küçük harf kullanımı da dâhil olmak üzere, tam olarak yazıldıkları biçimde karşılaştırır. `GB` ve `gb` farklı değerlerdir; aynı şekilde `United Kingdom` ve `united kingdom`de farklıdır. Başarısız bir karşılaştırma hata oluşturmaz; varsayılan dala geçilir ve kullanıcı yanlış yapılandırmayla sessizce sağlanır.
{% endhint %}

Büyük-küçük harf tutarsızlığını gidermek için kaynak değerleri `ToUpper()` ile sarmalayın ve büyük harfli sabit değerlerle karşılaştırın:

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

#### <mark style="color:mavi;">Kaynak alan biçimi, Entra kullanıcısının nasıl oluşturulduğuna bağlı olarak değişir</mark>

Bu, doğru görünüp bir topluluk genelinde tutarsız davranan ifade eşlemelerinin en yaygın nedenidir.

* **Kullanım konumu** Microsoft, lisans ve özellik kullanılabilirliğini belirlediği için bu alanın her zaman `GB`gibi geçerli bir ISO 3166-1 alfa-2 kodu içermesini zorunlu tutar. Bu alan güvenilirdir.
* **Ülke veya bölge** alanı için böyle bir zorunluluk yoktur ve içeriği, oluşturulma yöntemine bağlıdır. Entra yönetici portalı GUI'si üzerinden oluşturulan kullanıcılar, tam ülke adlarının yer aldığı bir açılır listeden seçim yapar; bu nedenle alanda genellikle `United Kingdom`saklanır. CSV içe aktarma veya PowerShell aracılığıyla oluşturulan kullanıcılara ise genellikle `GB` atanır; bu bir zorunluluktan değil, teamülden kaynaklanır.

Kullanıcıların birden fazla yöntemle oluşturulduğu tüm kiracılarda `country` tutarlı bir biçimde olmaz. İfadeyi oluşturmadan önce alanı standartlaştırın veya yukarıda gösterildiği gibi her iki biçimi de açıkça sınayın.

### Adım 3: Kullanıcıları ve grupları sağlama kapsamına alın

Atama, yapılandırmanın hangi kullanıcıları etkileyeceğini belirler. Uygulamanın atama kapsamı dışındaki kullanıcılar hiçbir eşlemeden etkilenmez; bu da atamayı dağıtım sırasında birincil güvenlik denetimi haline getirir.

1. Şuraya gidin: **Microsoft Entra ID** → **Kurumsal uygulamalar** → Zoom uygulamanız → **Kullanıcılar ve gruplar**.
2. Şuna tıklayın: **Kullanıcı/grup ekle**.
3. Şu bölümde **Kullanıcılar ve gruplar**, istenen kullanıcıyı veya güvenlik grubunu seçin.
4. Şu bölümde **Rol seçin**, uygun rolü seçin.
5. Şuna tıklayın: **Ata**.

Pratikte yalnızca iki rol değeri önemlidir. Şu seçenekler gibi diğerleri **Kurumsal** ve **Pro** ya kullanımdan kaldırılmakta olan eski adlandırmalardır ya da nadir görülen senaryolar için tasarlanmıştır.

<table><thead><tr><th width="157.5225830078125">Rol</th><th>Etkisi</th></tr></thead><tbody><tr><td><strong>Temel</strong></td><td>Kullanıcıyı ücretli bir toplantı lisansı olmadan sağlar. Bunu, ücretli yetkiyi atamaktan özel bir öznitelik — örneğin bir Zoom Phone çağrı planı — sorumlu olduğunda seçin.</td></tr><tr><td><strong>Lisanslı</strong></td><td>Zoom hesabının <em>varsayılan</em> lisans planını (ör. Zoom Workplace Kurumsal Plus) atar. Bu ekranda belirli bir paket seçilemez; varsayılan, Zoom tarafında yapılandırılır.</td></tr></tbody></table>

Bu Rol seçimi, uygulamaya eklenen her kullanıcı veya grup için bir kez uygulanır; kaç özel özniteliğin sağlandığından bağımsızdır.

**Entra gruplarını Zoom grupları olarak sağlamak için**, bu özellik varsayılan olarak devre dışıdır:

1. Şuraya gidin: **Sağlama** → **Eşlemeler** ve **Microsoft Entra ID Gruplarını Sağla**.
2. Aç/Kapat **Etkin** seçeneğini **Evet**.
3. Varsayılan eşlemelerin yerinde olduğunu doğrulayın: `displayName` → `displayName`, ve `members` → `members`.
4. Tıklayın **Kaydet**.
5. Şuraya dönün: **Kullanıcılar ve gruplar** ve yalnızca grubun bireysel üyelerinin değil, grubun kendisinin de uygulamaya atandığını doğrulayın. Grup sağlama yalnızca doğrudan atanmış grupları işler.

{% hint style="warning" %}
**Dikkat: SCIM'in gruplarla ne yapıp ne yapmadığı**

Aynı ada sahip bir Zoom grubu zaten yoksa SCIM, Entra grubunun `displayName` değerini aynen kullanarak bir grup oluşturur. Grup üyeleriyle birlikte oluşturulur, ancak **herhangi bir ürün yapılandırması olmadan**. Yönetici yine de Zoom web portalında [**Yönetici Merkezi**](https://zoom.com/account) → **Kullanıcılar** → [**Gruplar**](https://zoom.com/account/group#/) bölümünü açmalı ve amaçlanan ayarları uygulamalıdır: grup düzeyindeki Zoom Phone politikaları, arama izinleri veya diğer ürün yapılandırmaları. SCIM, grubun varlığını ve üyeliğini sağlar; bu grubun Zoom içinde ne yaptığını tanımlamaz.
{% endhint %}

### Adım 4: Talep Üzerine Sağlama ile doğrulayın

**İsteğe Bağlı Sağlama** özelliği, **Sağlama Durumu** Aç/Kapat ayarından bağımsız çalışır; bu nedenle doğrulama için doğru araçtır. Bu noktaya kadarki her adım (bu adım da dâhil), sağlama kapalıyken tamamlanabilir.

1. Şuraya gidin: **Sağlama** → **Sağlama Genel Bakışı**.
2. Tıklayın: **İsteğe Bağlı Sağlama**.
3. Tek bir test kullanıcısını arayıp seçin, ardından **Sağla**.
4. Sonucu inceleyin. Entra, her sağlama Etkinliği için çalıştırdığı dört aşamayı raporlar — **İçe aktarma**, **Kapsam dahilinde olup olmadığını belirleme**, **Eşleştirme**, ve **Sağlama** — her biri ayrı ayrı genişletilebilir.
5. Gösterilen öznitelik değerlerinin amacınızla eşleştiğini doğrulayın.
6. Zoom web portalına Giriş yapın ve yapılandırmanın uygulandığını doğrulayın.

{% hint style="info" %}
**Öneri**

En zor durumu temsil eden bir kullanıcıyla doğrulayın *en zor* durumu — yurt dışında yaşayan bir kullanıcı, farklı bir yöntemle oluşturulmuş bir kullanıcı veya kaynak alanı boş olan bir kullanıcı. Yalnızca kolay durumu kapsayan bir test, 2. adımda açıklanan hata türlerini ortaya çıkarmaz.
{% endhint %}

### Adım 5: Sürekli provizyonlamayı Etkinleştir

Provisioning'i Etkinleştirmek, yapılandırmayı kapsam dahilindeki her kullanıcı için canlı olarak yürürlüğe sokar. Önce 1'den 4'e kadar olan Adımları tamamlayıp doğrulayın.

1. Şuraya gidin: **Microsoft Entra ID** → **Kurumsal uygulamalar** → Zoom uygulamanız → **Sağlama** → **Sağlama**.
2. Aç/Kapat **Sağlama durumu** olarak **Açık**.
3. Tıklayın **Kaydet**.

İlk döngü yaklaşık 40 dakika sürebilir. Sonraki artımlı döngüler yaklaşık 40 dakikalık aralıklarla çalışır. Yeni katılanlar, öznitelik değişiklikleri ve devre dışı bırakmalar, hemen değil bu Plan'a göre senkronize edilir.

### Adım 6: Entra provisioning günlüklerini kullanarak doğrulayın

1. Şuraya gidin: **Microsoft Entra ID** → **Kurumsal uygulamalar** → Zoom uygulamanız → **İzleme** → **Sağlama günlükleri**.
2. Test kullanıcısını arayın veya filtreleyin, ardından ilgili etkinliği seçin. Ayrıntı görünümü dört sekmeyle açılır: **Adımlar**, **Sorun giderme ve öneriler**, **Değiştirilen Özellikler** ve **Özet**.
3. Şunları inceleyin: **Özet** — işlemin başarılı mı yoksa başarısız mı olduğunu doğrulamak için.
4. Başarısız olduysa şunu açın: **Sorun Giderme ve Öneriler**; bu bölümde gerçekleştirilmeye çalışılan işlem, etkilenen kullanıcının kullanıcı asıl adı ve — altında **Ayrıntılar** — Zoom API'si tarafından döndürülen hata kodu ve tam hata mesajı.

Bu, eşlemenin üretmesinin amaçlandığı değerler yerine iletilen gerçek değerleri gösterdiğinden, eşleme ekranını incelemekten daha güvenilirdir. Entra günlüğü kesin bir sonuç vermediğinde, şu bölümde açıklanan Zoom App Marketplace çağrı günlüklerine geçin: **Zoom tarafı doğrulaması ve yaygın hatalar**, ham istek ve yanıt alışverişini Göster.

#### <mark style="color:mavi;">Entra ID'de Katılım ve ayrılma davranışı</mark>

* Kapsam, birincil güvenlik denetimidir. Uygulamanın atama kapsamı dışındaki kullanıcılar, bu yapılandırmadaki herhangi bir eşleme tarafından asla değiştirilmez.
* Entra’da bir kullanıcıyı devre dışı bırakmak veya kapsamdan çıkarmak, sağlama işlemini otomatik olarak tersine çevirir ve işten ayrılma döngüsünü kapatır.
* Her hata, yukarıda belirtilen sessiz hata uyarısıyla birlikte ilgili bir günlük girdisi üretir.

### 7. Adım: Entra ID’deki referans senaryolarını uygulayın

Senaryolar, ön koşullar ve öznitelik tanımları şu bölümde yer alır: [**Referans senaryolar**](#reference-scenarios) bölümü. Burada yalnızca Entra eşlemeleri verilmiştir.

**Senaryo 0 — Departman.** 1. Adımda tanımlayın `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` olarak **Dize**, Zoom yerine Kurumsal ad alanını kullanmaya dikkat ederek. Şu şekilde eşleyin: **Doğrudan** Entra’daki `department` alanından. Gerekli değil **Boşsa varsayılan değer** — kaynak alan boşsa hiçbir şey gönderilmez ve Zoom tarafında herhangi bir nesnenin mevcut olması gerekmez.

**Senaryo 1 — Zoom Phone tesisi ve otomatik dahili numara.** Şunu eşleyin: `zoomPhoneSite` eşleme türü: **Doğrudan** kaynak: `physicalDeliveryOfficeName`, ve **Null ise varsayılan değer** şuna ayarlanmış: `Ana tesis`. Eşle `zoomPhoneExtNumber` eşleme türü: **Sabit** değerine sahip `0` önceden var olan bir dahili numara yapılandırmasını taşımıyorsanız. Ofis Konumu değerleri Zoom tesis adlarıyla tam olarak eşleşmiyorsa, yerine şu biçimde bir **İfade** eşlemesi koyun (2. Adımda gösterilen biçimde).

**Senaryo 2 — Ülkeye göre değişen çağrı planı.** Entra bir gruptan değer alamadığından bir ifade gerekir. İfadeyi ek `IIF()` ülke başına katman oluşturun ve 2. adımda açıklandığı gibi hem alfa-2 hem de tam metin biçimlerini hesaba katın:

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

Çağrı planı özniteliği ücretli yetkiyi atadığında, şunu Seç: **Temel** yerine **Lisanslı** 3. adımda. Şunu seçmek **Lisanslı** buna ek olarak hesabın varsayılan lisansını uygular; bu, amaçlanan ticari sonuç olmayabilir.

**Senaryo 3 — İletişim merkezi Paketi, Rol ve bölge.** Eşleyin `zoomContactCenterPackage` bir ... ile **ifade** aracı katmanlarını ayırt eden bir dizin alanı tarafından belirlenen ve `zoomContactCenterRole` olarak **Doğrudan** rol adını içeren bir alandan. Ayrıl `zoomContactCenterRegion` tek bölgeli dağıtımlarda eşlenmemiş bırakın.

## **SCIM'i Okta ile yapılandırma**

#### <mark style="color:mavi;">Okta için ek gereksinimler</mark>

* Profile Editor'a erişim sağlayan Okta yönetici ayrıcalıkları

#### <mark style="color:mavi;">Okta'daki ek sınırlamalar</mark>

* Bir kullanıcı aynı öznitelik için çelişen değerler sağlayan birden fazla gruba aitse, yalnızca en yüksek öncelikli grubun değeri iletilir. 5. adıma bakın.

{% hint style="warning" %}
**Dikkat: İki profil, iki amaç**

Okta, burada önemli olan iki farklı profili yönetir; bu ayrımı anlamak, başlangıçtaki kafa karışıklığının çoğunu önler.  **Okta kullanıcı profili** bir değerin *saklandığı* ve dizindeki bir kişiyle ilişkilendirildiği yerdir.  **Zoom kullanıcı uygulama profili** bir değerin *gönderilir* Zoom'a ve öznitelikleri SCIM dış adını ve ad alanını taşır. Kullanıcı bazında bir yapılandırma için her ikisi ve bunlar arasında bir Bağlanıyor eşlemesi gerekir. Grup düzeyindeki bir yapılandırma için yalnızca uygulama profili özniteliği gerekir; değer grup atamasında ayarlanır.
{% endhint %}

### Adım 1: Zoom uygulama kullanıcı profilinde özniteliği tanımlayın

Bu, gerçekten Zoom'a bir değer aktaran özniteliktir. Bunu tanımlamak, her öznitelik için tek seferlik bir işlemdir.

1. Okta Yönetici Konsolu'na Giriş yapın.
2. Sol gezinme menüsünde şuna tıklayın: **Uygulamalar**, ardından şuna tıklayın: **Uygulamalar**.
3. Altında **DURUM**, tıklayın **ETKİN**.
4. Şuna tıklayın: **Zoom** uygulaması.\
   **Not**: Uygulama adı, uygulama oluşturulurken Okta yöneticisi tarafından tanımlanır. Genellikle şu şekilde adlandırılır: **Zoom**, ancak kiracınızda farklı olabilir.
5. Şuna tıklayın: **Sağlama** sekmesi.
6. ... altında **Zoom Öznitelik Eşlemeleri**, şuna tıklayın: **Profil Düzenleyici'ye Git**.
7. ... altında **Öznitelikler**, şuna tıklayın: **+ Öznitelik Ekle**.
8. Aşağıdakileri tamamlayın:
   * **Veri türü**: Seç **string** veya **boolean**, SCIM2 API referansıyla eşleşir.
   * **Görünen ad**: Öznitelik adını girin, örneğin `zoomPhoneSite`.
   * **Değişken adı**: Aynı adı Girin.
   * **Harici ad**: Zoom tarafından belgelendiği şekilde öznitelik adını aynen girin; örneğin `zoomPhoneSite`.
   * **Harici ad alanı**: Girin `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **Açıklama** (İsteğe Bağlı): Özniteliğin neden var olduğunu ve değerlerinin nereden geldiğini kaydedin.
   * **Öznitelik türü**: Seç **Kişisel** kullanıcı başına bir değer için veya **grup** grup üyeliği yoluyla devralınan bir değer için.
9. Tıklayın **Kaydet**, veya **Kaydet ve Başka Bir Tane Ekle**.

{% hint style="danger" %}
**Uyarı**

External name ve External namespace değerlerinin ikisi de doğru olmalıdır. Zoom'un yayımladığı yönergelerde External namespace değerinin tam URN olması gerektiği belirtilir. *dahil* öznitelik adı — örneğin `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` — yalnızca ad alanını kullanmak yerine. Bu, genel SCIM kuralından farklıdır. Yukarıda gösterilen biçimi izleyin; bu biçim, Zoom’un çalıştığını belgelediği yapılandırmayı yansıtır.

Öznitelik adları her yerde büyük/küçük harfe duyarlıdır. Yanlış büyük/küçük harfli bir öznitelik, Profile Editor tarafından hatasız kabul edilir ve Zoom API'de sessizce başarısız olur.
{% endhint %}

### Adım 2: Okta kullanıcı profilinde bir kaynak öznitelik oluşturun

Değerin kullanıcı başına tutulduğu durumlarda bu adımı tamamlayın. Değer her kullanıcı için aynıysa veya bunun yerine grup düzeyinde sağlanacaksa bu adımı atlayın.

1. Soldaki gezinme menüsünde tıklayın **Dizin**, ardından tıklayın **Profil Düzenleyici**.
2. Şuna tıklayın **Kullanıcılar** sekme.
3. içinde **Kullanıcılar** kutusunda, altında **Filtreler**, tıklayın **Tümü**.
4. Sağında **Okta**, tıklayın **Kullanıcı** profiline.
5. ... altında **Öznitelikler**, şuna tıklayın: **+ Öznitelik Ekle**.
6. Aşağıdakileri tamamlayın:
   * **Veri türü**: 1. adımda tanımlanan Zoom özniteliğiyle eşleştirin.
   * **Görünen ad** ve **Değişken adı**: Bir ad girin, örneğin `zoomPhoneSite`.
   * **Enum** (İsteğe Bağlı): Seç **Numaralandırılmış değerler listesi tanımlayın** burada Zoom özelliği yalnızca sabit bir değer kümesini kabul eder.
   * **Özellik zorunlu** (İsteğe Bağlı): Seç **Evet** burada kapsam içindeki her kullanıcı bir değer taşımalıdır.
7. Tıklayın **Kaydet**.

{% hint style="info" icon="lightbulb" %}
**İpucu**

Okta kullanıcı profili özniteliği ile Zoom uygulama profili özniteliği için aynı adı kullanın. Okta bunu zorunlu kılmaz, ancak adların eşleşmesi eşleme listesini kendi kendini açıklayan hâle getirir ve öznitelik sayısı arttıkça sorun giderme süresini önemli ölçüde azaltır.
{% endhint %}

Şunu kullanın: **Enum** seçeneği, Zoom'un sabit bir değer kümesi belgelediği her yerde: iletişim merkezi paketleri, Workplace paket kodları, Revenue Accelerator plan değerleri. Alanın değerlerini giriş noktasında kısıtlamak, bir yazım hatasının haftalar sonra eksik bir yetki olarak ortaya çıkan, fark edilmeyen bir kaynak sağlama hatasına dönüşmesini önler.

### Adım 3: Kaynak özniteliği Zoom özniteliğiyle eşleyin

1. Şuraya gidin: **Uygulamalar** → **Uygulamalar** → **Aktif** → **Zoom** uygulamasına.
2. Şuna tıklayın: **Sağlama** sekmesi.
3. Şunun altında: **Zoom Öznitelik Eşlemeleri**, 1. Adımda tanımlanan özniteliği bulun ve sağındaki düzenleme simgesine tıklayın.\
   **Not**: Öznitelik görünmüyorsa şuna tıklayın: **Eşlenmemiş Öznitelikleri Göster**.
4. Şuna tıklayın: **Öznitelik değeri** açılır menüsünü açın ve şunu seçin: **Okta Profilinden Eşle**.
5. Şu değeri gösteren kaynak açılır menüsüne tıklayın: `login | string` varsayılan olarak — ve 2. Adımda oluşturulan Okta kullanıcı profili özniteliğini seçin.
6. Seç **Oluştur ve güncelle**.\
   **Not**: **Yalnızca oluştur** Zoom kullanıcısı ilk kez sağlandığında değeri uygular ve bir daha asla uygulamaz. İlk atamadan sonra üzerine yazılmaması gereken değerler için bunu bilinçli olarak seçin; diğer tüm durumlarda **Oluştur ve güncelle** seçeneğini seçin; böylece dizin değişiklikleri yansıtılır.
7. Tıklayın **Kaydet**.
8. Her öznitelik için tekrarlayın.

{% hint style="warning" %}
**Dikkat: Bir değeri türetme veya çevirme**

Okta değeri ile Zoom değeri aynı metin olmadığında, **Öznitelik değeri** alanı, koşullu mantığı ve dize işlevlerini destekleyen Okta İfade Dili'ni de kabul eder. İfade söz dizimi ve kullanılabilir işlevler Okta sürümüne göre değişir; herhangi bir ifadeyi tek bir test kullanıcısında şu yöntemi kullanarak doğrulayın: **Önizleme** Daha geniş kapsamlı uygulamadan önce, desteklenen işlevler için Okta'nın güncel İfade Dili belgelerine başvurun.

Çevirinin basit ve değer kümesinin küçük olduğu durumlarda, Zoom değerini doğrudan Okta özniteliğinde numaralandırılmış bir liste olarak tanımlamak — veya 5. Adımdaki gibi grup düzeyinde bir öznitelik kullanmak — genellikle bir ifadeden daha kolay yönetilebilir.
{% endhint %}

### Adım 4: Uygulamaya sağlamayı Etkinleştir

Öznitelik eşlemeleri, karşılık gelen sağlama işlemleri etkinleştirilene kadar etkili olmaz. 5. Adımda değer atamadan önce bunları Etkinleştirin.

1. Şuraya gidin: **Uygulamalar** → **Uygulamalar** → **Aktif** → **Zoom** uygulamasına.
2. Şuna tıklayın: **Sağlama** sekmesi.
3. Altında **Uygulamaya Sağlama**, tıklayın **Düzenle**.
4. Aşağıda açıklanan ayarları etkinleştirin, ardından tıklayın **Kaydet**.

| Ayar                                   | Etkisi                                                                                                                                                                                                |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kullanıcıları Oluştur**              | uygulama Okta'daki bir kullanıcıya atandığında Zoom'da bir kullanıcı oluşturur veya bağlar.                                                                                                           |
| **Kullanıcı Özniteliklerini Güncelle** | uygulama atandığında Zoom'daki bir kullanıcının özniteliklerini günceller. Okta kullanıcı profilinde yapılan sonraki değişiklikler, Zoom'daki karşılık gelen değerin üzerine otomatik olarak yazılır. |
| **Kullanıcıları Devre Dışı Bırak**     | uygulama Okta'da ataması kaldırıldığında veya Okta hesabı devre dışı bırakıldığında Zoom hesabını devre dışı bırakır. Hesaplar, uygulama yeniden atanarak yeniden etkinleştirilebilir.                |

{% hint style="danger" %}
**Uyarı**

**Kullanıcı Özelliklerini Güncelle** özel öznitelik eşlemelerinin mevcut kullanıcılar üzerinde etkili olmasını sağlar. Bu olmadan eşlemeler yalnızca kullanıcı oluşturulurken uygulanır ve Okta'da sonradan yapılan hiçbir değişiklik Zoom'a ulaşmaz.
{% endhint %}

### Adım 5: Kullanıcılara veya gruplara değer atayın

**Tek bir kullanıcıya değer atamak için:**

1. Şuraya gidin: **Dizin** → **Kişiler** ve kullanıcının adına tıklayın.
2. Şuna tıklayın: **Profil** sekmesi, ardından şuna tıklayın: **Düzenle**.
3. 2\. Adımda oluşturulan özniteliği Zoom'un beklediği değerle doldurun.
4. Tıklayın **Kaydet**.

Değer derhal iletilir. Aynı Değiştir işlemini daha geniş ölçekte uygulamadan önce sonucu Zoom web portalında doğrulayın.

**Bir değeri bir gruba atamak için** — yapılandırmanın kuruluş yapısını izlediği, daha ölçeklenebilir yaklaşım:

1. Özniteliğin 1. Adımda şu şekilde tanımlandığını doğrulayın: **Öznitelik türü: grup**. Öznitelik şu şekilde tanımlandıysa: **Kişisel**, 1. Adımı şu profil için tekrarlayarak grup düzeyinde eşdeğer bir öznitelik tanımlayın: **Zoom kullanıcısı** profili; konumu: **Dizin** → **Profil Düzenleyici** → **kullanıcılar** → **Tümü**; öznitelik türü olarak **grup** seçeneğini belirleyin.
2. Şu konuma gidin: **Dizin** → **gruplar** → **Tümü** sekmesi. Ardından şu seçeneğe tıklayın: **grup Ekle**.
3. Bir **Ad** ve İsteğe Bağlı bir **Açıklama**Girin, ardından şu seçeneğe tıklayın: **Kaydet**.
4. grubu açın ve şu sekmeye tıklayın: **uygulamalar** sekmesi.
5. Şu seçeneğe tıklayın: **uygulama Ata**, ardından şu seçeneğe tıklayın: **Ata** . Bu seçenek, şu uygulamanın sağındadır: **Zoom** uygulaması.
6. Grup düzeyindeki öznitelikleri, her Üyeler için geçerli olması gereken değerlerle doldurun.
7. Şu seçeneğe tıklayın: **Kaydet ve Geri Dön**, ardından şu seçeneğe tıklayın: **Bitti**.
8. grubun şu sekmesine tıklayın: **Kişiler** . Ardından şu seçeneğe tıklayın: **Kişileri Ata**.
9. İlk ad, birincil e-posta adresi veya Kullanıcı Adı ile kullanıcıları arayın ve her birinin yanındaki Ekle düğmesine tıklayın.
10. Şu seçeneğe tıklayın: **Bitti**.

Üyeler, grup öznitelik değerlerini otomatik olarak devralır. Daha sonra eklenen kullanıcılar katıldıklarında bunları devralır; bu da bu modeli tek seferlik bir geçiş çalışmasından ziyade devam eden Katılım için kalıcı hale getirir.

#### <mark style="color:mavi;">Grup önceliği, bir kullanıcı birkaç grup içinde yer aldığında çelişen değerleri çözer</mark>

Bir kullanıcı, aynı öznitelik için değer sağlayan birden fazla grubun Üyelerinden biri olduğunda, Okta değeri en yüksek öncelikli gruptan iletir.

1. Şuraya gidin: **Uygulamalar** → **Uygulamalar** → **Aktif** → **Zoom** uygulamasına.
2. sekmesine tıklayın **Atamalar**  sekmesine.
3. altında **Filtreler**, tıklayın **Gruplar**.
4. Grupları istenen sıraya sürükleyip bırakın.

{% hint style="info" %}
**Öneri**

Grupları en özelden en genele doğru sıralayın; böylece dar kapsamlı bir grup — belirli bir tesis veya Rol — geniş kapsamlı bir her şeyi kapsayan seçeneğe göre öncelik kazanır. Bu sıralamayı tersine çevirmek, genel grubun her bir özgül olanı geçersiz kılmasına neden olur; bu da genellikle tüm popülasyonun aynı istenmeyen yapılandırmayı alması şeklinde ortaya çıkar.
{% endhint %}

### 6. Adım: Okta Sistem Günlüğü’nü kullanarak doğrulayın

1. Şuraya gidin: **Raporlar** → **Sistem Günlüğü**.
2. Hedef kullanıcıya veya Zoom uygulamasına göre filtreleyin ve zaman aralığını sağlama girişimine daraltın.
3. İlgili Etkinlik'i açın ve sonucu ile alt uygulama tarafından döndürülen herhangi bir hatayı içeren ayrıntıyı inceleyin.

Çözümlenmemiş sağlama hataları Zoom uygulamasının ... bölümünde de görünür **Sağlama** sekmesi. Okta günlüğünün kesin bir sonuca varmadığı durumlarda, altında açıklanan Zoom App Marketplace çağrı günlüklerine geçin **Zoom tarafında doğrulama ve sık karşılaşılan hatalar**, ham istek ve yanıt alışverişini gösteren.

{% hint style="warning" %}
**Dikkat: Okta’ya özgü sessiz başarısızlık**

Zoom kullanıcı profilinde tanımlanmış ancak hiçbir zaman eşlenmemiş veya eşlenmiş ancak **Kullanıcı Özelliklerini Güncelle** 4. Adım'da etkinleştirilmiş olsa bile, eşlemeler listesinde görünür kalırken hiçbir şey iletmez. Hata oluşmaz. Bir değer Zoom'a ulaşmıyorsa ve Sistem Günlüğü'nde buna karşılık gelen hiçbir etkinlik görünmüyorsa, daha fazla araştırma yapmadan önce eşlemeyi ve provizyon ayarlarını kontrol edin.
{% endhint %}

#### <mark style="color:mavi;">Okta'da Katılım ve ayrılış davranışı</mark>

* Kapsam, birincil güvenlik denetimidir. Okta’da Zoom uygulaması atanmamış kullanıcılar, bu yapılandırmadaki herhangi bir eşleştirme tarafından asla değiştirilmez.
* İle **Kullanıcıları Devre Dışı Bırak** etkinse uygulamanın atamasını kaldırmak veya Okta hesabını devre dışı bırakmak Zoom hesabını otomatik olarak devre dışı bırakır.
* Uygulamanın yeniden atanması, daha önce devre dışı bırakılmış bir Zoom hesabı  yeniden etkinleştirir; bu da grup üyeliğini ayrılanları ve geri dönenleri yönetmek için uygun bir mekanizma hâline getirir.

### 7. Adım: Okta'da referans senaryolarını uygulayın

Senaryolar, ön koşullar ve öznitelik tanımları [**Referans senaryoları**](#reference-scenarios) bölümünde yer alır. Burada yalnızca Okta yapılandırması verilmiştir.

**Senaryo 0 — Departman.** 1. Adımda özniteliği şu değerlerle tanımlayın: **Görünen ad** ve **Değişken adı** `department`, **Harici ad** `department` ve **Harici ad alanı** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. Kullan **Öznitelik türü: Kişisel**. Okta'nın temel kullanıcı profili zaten bir `department` özniteliği; böylece 2. Adım atlanabilir — 3. Adımda doğrudan bu öznitelikten eşleyerek seçim yapın **Oluşturma ve güncelleme**.

{% hint style="warning" %}
**Dikkat: Kurumsal uzantı öznitelikleri için ad alanı biçimi**

1\. Adımdaki UYARI, Zoom'un öznitelik adını External ad alanına ekleme kuralını açıklar. Bu yönerge, Zoom uzantısı altındaki öznitelikler için belgelenmiştir. `department` Okta'nın normal davranışının, yukarıda gösterildiği gibi ad alanını ve harici adı ayrı alanlarda tutmak olduğu standart SCIM kurumsal uzantısına aittir. Değer Zoom'a ulaşmazsa eklenmiş biçimi deneyin — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` — ve Marketplace çağrı günlüğünde hangi formun başarılı olduğunu doğrulayın.
{% endhint %}

**Şu durumlarda alternatifler `department` zaten eşlenmiş.** Aşağıdakilerin tümü aynı şekilde davranır, aynı üst öğenin altında yer alır ve ön koşul taşımaz — öznitelik adını her iki yerde de değiştirin **Harici ad** ve ad alanını belirtin; Okta profilinde eşleşen bir kaynak öznitelik yoksa 2. adımda bir tane Ekle:

| Öznitelik        | Notlar                                                                                                                                                                                         |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `costCenter`     | İşletme alanı, kullanıcılar arasında değişir; bu yüzden yanlış bir değer görünür                                                                                                               |
| `Organizasyon`   | Çoğu zaman tüm kullanıcılar için aynıdır; bu da bir hatanın fark edilmesini zorlaştırır                                                                                                        |
| `employeeNumber` | Kimlik alanı olarak çoğu kez zaten eşlenmiştir — bildirmeden önce kontrol edin                                                                                                                 |
| `pronouns`       | Kurumsal uzantı yerine **Zoom** uzantısının altında yer alır. Bu nedenle, bu kılavuzdaki diğer tüm senaryolarla aynı ad alanını kullanır ve yukarıdaki biçim sorununu tamamen ortadan kaldırır |

**Senaryo 1 — Zoom Phone tesisi ve otomatik dahili numara.** Şunu tanımlayın: `zoomPhoneSite` için şu ayarı kullanın: **Öznitelik türü: grup** ve her tesisin Okta grubunda değerini ayarlayın. Böylece grup üyeliği tesisi doğrudan belirler ve dönüştürme mantığına gerek kalmaz. Şunu tanımlayın: `zoomPhoneExtNumber` özniteliğini varsayılan değeri `0` olan kişisel bir öznitelik olarak tanımlayın; ancak mevcut bir dahili numara yapılandırmasını taşıyorsanız bunu yapmayın.

**Senaryo 2 — Ülkeye göre değişen çağrı planı.** Şunu tanımlayın: `zoomPhoneCallingPlan` için şu ayarı kullanın: **Öznitelik türü: grup** ve her çağrı planı bölgesi için bir grup oluşturun; her grubun Zoom uygulama atamasında plan değerini ayarlayın. Kullanıcılar üyelik yoluyla doğru planı devralır ve Okta'da saklanan değer, Zoom'un beklediği değerin aynısıdır. Bu ayrıca yapılandırmayı **Atamalar** sekmesinde görünür ve denetlenebilir kılar; yapılandırma, temel dizin verilerinin doldurulma biçimindeki tutarsızlıklardan da etkilenmez. Şu değeri taşıyan bir grup: `-1` kullanıcıyı silmeden arama yetkilerini kaldırmak için temiz bir yol sağlar.

**Senaryo 3 — İletişim merkezi Paketi, Rol ve bölge.** Şunu tanımlayın: `zoomContactCenterPackage` özniteliğini izin verilen üç değerle sınırlı, numaralandırılmış bir öznitelik olarak tanımlayın; böylece geçersiz bir Paket girilemez. Şunu tanımlayın: `zoomContactCenterRole` özniteliğini grup düzeyinde bir öznitelik olarak tanımlayın; çünkü Rol genellikle ekip yapısına bağlıdır. Şunu: `zoomContactCenterRegion` tek bölgeli dağıtımlarda eşlemeyin.

## Sorun Giderme

### Hatalar

#### <mark style="color:mavi;">Kullanıcı Mevcut Değil veya Bu Hesaba Ait Değil</mark>

Bu hata, hedeflenen kullanıcının e-posta adresi zaten mevcut bir hesap nedeniyle sağlamaya alınamadığında oluşur. Zoom yöneticilerinin kullanıcıyla doğrudan iletişime geçip kullanıcıyı hesaba manuel olarak davet etmesi önerilir.

<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>Sağlama hatası örneği.</p></figcaption></figure></div>

#### <mark style="color:mavi;">Ücretli Kullanıcı Ekleme İşlemi Yapılamıyor</mark>

Bu hata, hesapta yeterli lisans olmadığında SCIM'in bir kullanıcıyı sağlamaya çalışmasıyla oluşur. Hatayı çözmek için kullanıcı Temel kullanıcı olarak sağlanmalı veya sağlama için bir lisans uygun hâle getirilmelidir.

<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>Sağlama hatası örneği.</p></figcaption></figure></div>

### Kullanıcı Sağlama Sorunlarını Gidermek için SCIM Günlüklerini Kullanma

Zoom, en son 100 API isteği günlüğünü şu adreste sunar: [Zoom Marketplace](https://marketplace.zoom.us/). Bir Zoom yöneticisi, sağlama API'leri aracılığıyla hangi bilgilerin gönderilip alındığını doğrulamak için bu günlükleri kullanabilir. Günlüklere erişmek için Zoom yöneticisi olarak Zoom Marketplace'te oturum açın ve **Yönet**öğesine tıklayın. Sonraki sayfada, **Çağrı Günlükleri** başlığının altından **Kişisel Uygulama Yönetimi**öğesini seçin. Ardından API günlüklerini genişletmek ve içeriklerini incelemek için bir kayda tıklayın.

Aşağıdaki görselde, kullanıcının kimlik ve lisanslama özelliklerinin referans amacıyla vurgulandığı bir SCIM kullanıcı sağlama isteği örneği gösterilmektedir.

<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>SCIM kullanıcı sağlama isteği örneği.</p></figcaption></figure></div>

Yanıt eşlemesinde olduğu gibi Zoom, yalnızca sağlama isteğinde kimlik sağlayıcıdan gönderilen bilgileri uygulayabilir. Kullanıcı kimliği ve lisanslama özelliklerinin kimlik sağlayıcıdan gönderildiğini doğrulamak için bu günlükleri kullanın. Beklenen bilgiler bu bildirimlerde eksikse destek için kimlik sağlayıcınızla iletişime geçin.


---

# 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/tr/yonetici-kosesi/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.
