Başka bir SCIM hizmeti bağlama

Klang’ın üye senkronizasyonu standart SCIM 2.0’dır. Microsoft Entra ve Okta’nın konsolları farklı olduğu için bu ikisinin ayrı kılavuzları vardır, ancak Klang’da ikisine özgü hiçbir şey yoktur. Bearer token ile bir temel URL’ye SCIM 2.0 gönderebilen her sağlayıcı çalışır; OneLogin, JumpCloud, Ping ve şirket içinde yazılmış betikler de buna dahildir.

Bu makale, diğer tüm sağlayıcılar için başvuru kaynağıdır. Entra veya Okta kullanıyorsanız bunun yerine o kılavuzları izleyin.

Başlamadan önce

İki şeye ihtiyacınız var:

• Klang’da: Pro veya Enterprise çalışma alanında yönetici olmanız
• Sağlayıcınızda: Uygulama oluşturma ve sağlamayı (provisioning) yapılandırma izni

Kimlik bilgilerinizi Klang’dan alma

1. Klang’da Ayarlar → Çalışma alanı → Üyeler → Üye senkronizasyonu sayfasını açın
2. SCIM dizini kartında Bağla’ya tıklayın
3. Açılan iletişim kutusunda Başka bir SCIM hizmeti sekmesini seçin
4. Bağlantıyı oluşturmak ve URL ile token’ı görüntülemek için Kaydet’e tıklayın

İki değer alırsınız: bir temel URL ve bir bearer token. Token yalnızca bir kez gösterilir. İletişim kutusunu kapatmadan önce kopyalayın.

Token’ı her isteğin Authorization başlığında Authorization: Bearer <token> biçiminde gönderin. Başka bir kimlik bilgisi yoktur ve ayarlanması gereken özel bir başlık da yoktur.

Bağlantı ayarları görünüyorsa yeni bir kurulum için Yeni bağlantı oluştur seçeneğini seçili bırakın. Mevcut bir bağlantıyı yeniden kullanmak için bunun yerine yöneticisi olduğunuz bir çalışma alanını seçin ve Kaydet’e tıklayın. Yeni bir token’a veya sağlayıcı tarafında yeni bir kuruluma gerek kalmaz.

Kurulumu daha sonra yeniden incelemek için bağlantı kartında Diğer seçenekler (⋮) menüsünü açın ve Kurulumu göster’i seçin. URL ve sağlayıcı talimatları erişilebilir kalır, ancak kaydedilen token tekrar gösterilemez. Kapat düğmesi, bağlantıyı değiştirmeden kılavuzu kapatır.

Klang’ın destekledikleri

Uç nokta	Yöntemler
/ServiceProviderConfig, /ResourceTypes, /Schemas	GET
/Users	GET, POST
/Users/{id}	GET, PUT, PATCH, DELETE
/Groups	GET, POST
/Groups/{id}	GET, PUT, PATCH, DELETE

PATCH her iki kaynak için de desteklenir; bazı sağlayıcıların gönderdiği yolsuz (path içermeyen) biçim de buna dahildir. Grup üyelikleri PATCH işlemleri olarak da tam bir PUT değiştirmesi olarak da gelebilir. GET /ServiceProviderConfig aynı bilgileri bildirir; yani kendini yapılandırmadan önce bu uç noktayı okuyan bir sağlayıcı bunları orada bulur.

Klang kişileri ve grupları nasıl eşleştirir?

• Kullanıcılar userName ile eşleştirilir; Klang bunun kişinin e-posta adresi olmasını bekler
• Gruplar displayName ile veya sağlayıcınız gönderiyorsa externalId ile eşleştirilir
• Sağlayıcınızın userName eq "..." filtresini desteklemesi gerekir, çünkü sağlayıcı bir kişiyi oluşturmadan önce o kişinin zaten var olup olmadığını bu şekilde öğrenir

Klang’ın bilerek yapmadığı iki şey

İçerik korunur. DELETE /Users/{id} isteği veya active değerinin false yapılması, kişinin senkronize erişimini kaldırır. Kişinin içeriğini silmez.

Kişiler listelenemez. Filtresiz bir GET /Users isteği, kullanıcı listenizin tamamı yerine boş bir sonuçla yanıtlanır. Klang dizininiz için doğruluk kaynağı değildir, bu nedenle listeyi geri vermez. Filtreli okumalar normal şekilde çalışır ve bir sağlayıcının kullanıcı sağlamak için ihtiyaç duyduğu da yalnızca budur. GET /Groups ise listeleme yapar, çünkü sağlayıcılar göndermek üzere oldukları bir grubu zaten var olan bir grupla bu şekilde eşleştirir.

İsteğe bağlı: Hangi grupların gönderileceğini seçme

Tüm senkronize kullanıcılar seçeneğini kullanıyorsanız grup sağlamayı atlayabilirsiniz. Klang’da belirli grupları seçmek için bu grupları ve üyeliklerini gönderin.

Klang yalnızca sağlayıcınızın gerçekten gönderdiği grupları öğrenir. Bu grupları nasıl seçeceğiniz sağlayıcınıza bağlıdır: Entra buna grupları uygulamaya atamak der, Okta ise Push Groups der. Adı ne olursa olsun, gönderdiğiniz gruplar Klang’da seçebileceğiniz gruplardır.

Bu çalışma alanının üyelerini seçme

Tüm senkronize kullanıcılar, bu bağlantı üzerinden gönderilen her etkin kullanıcıya üye erişimi verir. Yöneticileri Klang’da yönetin. Hangi kullanıcıların gönderileceğini yine sağlayıcınız belirler.

1. Üye senkronizasyonu sayfasına dönün ve Kimler erişim almalı? bölümünü bulun
2. Tüm senkronize kullanıcılar veya Belirli grupları seç seçeneğini belirleyin. Belirli gruplar için hangi grupların Yönetici, hangilerinin Üye erişimi vereceğini seçin
3. Seçiminizdeki kişileri incelemek için Kimlerin dahil olduğunu göster düğmesine tıklayın
4. Gerekebilecek ek kullanıcı lisanslarını gözden geçirin, ardından Kaydet’e tıklayın

Gruplar çakışabilir; her kişi çalışma alanı başına bir kez sayılır. Siz bir seçimi kaydedene kadar yeni bir bağlantı kimseye erişim vermez.

Bundan sonra ne olur?

• Kaydedilen seçiminize dahil olan etkin kullanıcılar bu çalışma alanına erişim kazanır
• Devre dışı bırakılan veya artık seçiminize dahil olmayan kullanıcılar senkronize erişimlerini kaybeder. İçerikleri korunur
• Yönetici grupları üyeleri yöneticiliğe yükseltebilir. Mevcut yöneticiler bir üye grubuna geçtiklerinde rollerini korur
• Klang’a hiç giriş yapmamış kişiler e-postayla davet alır

Klang’daki bağlantı kartı, sağlayıcınızın en son ne zaman çağrı yaptığını gösterir. Kartta bir sağlayıcı adı yazıyorsa bu, Klang’ın istekten tanıdığı sağlayıcıdır; aksi halde yalnızca SCIM yazar. Bu, Klang’da logosu bulunmayan sağlayıcılar için normaldir.

Token’ı yenileme

Bağlantı kartında Diğer seçenekler (⋮) menüsünü açın ve Yeni token oluştur’u seçin. Eski token, bağlantıyı paylaşan tüm çalışma alanlarında hemen çalışmayı bırakır. Yeni token’ı sağlayıcınıza yapıştırın.

Bağlantıyı kesme

Bu çalışma alanının senkronizasyonunu durdurmak için Diğer seçenekler (⋮) → Bağlantıyı kes seçeneğine tıklayın. Mevcut üyeler erişimlerini korur ve elle yönetilmeye başlar; bekleyen senkronizasyon davetleri iptal edilir. Bağlı diğer çalışma alanları senkronize olmaya devam eder. Son çalışma alanının bağlantısını kesmek, paylaşılan bağlantıyı ve token’ını da kaldırır.