Okta'yı bağlama

Üyeleri Klang’a senkronize etmek için Okta dizininizi bağlayın. Tüm senkronize kullanıcıları seçin veya erişimi belirli gruplarla sınırlayın.

Klang bunun yerine Microsoft Entra, Google Workspace veya başka bir SCIM hizmetinden de senkronize edebilir. Her çalışma alanı aynı anda tek bir sağlayıcı kullanır. Bir Okta bağlantısı birden fazla çalışma alanı tarafından paylaşılabilir.

Başlamadan önce

İki şeye ihtiyacınız var:

• Klang’da: Pro veya Enterprise çalışma alanında yönetici olmanız
• Okta’da: Uygulama ekleme ve sağlamayı (provisioning) yapılandırma izni

Gruplar isteğe bağlıdır. Farklı kişilere farklı erişim veya roller vermek istiyorsanız grupları önceden planlayın.

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 Okta sekmesini seçin
4. Bağlantıyı oluşturmak ve URL ile token’ı görüntülemek için Kaydet’e tıklayın

Klang size bir temel URL ve bir token gösterir; Okta’da izlemeniz gereken adımlar da yanında yer alır.

Token yalnızca bir kez gösterilir. İletişim kutusunu kapatmadan önce kopyalayın. Token’ı kaybederseniz yenisini oluşturmak için Yeni token oluştur’a tıklayın; ancak eski token’ın hemen çalışmayı bıraktığını unutmayın.

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.

Okta’da uygulamayı ekleme

1. Okta Admin Console’da Applications bölümüne gidin
2. Browse App Catalog’a tıklayın
3. SCIM 2.0 Test App (OAuth Bearer Token) uygulamasını arayın ve Add integration’a tıklayın
4. Uygulamaya Klang adını verin, ardından Next ve Done düğmelerine tıklayın

Adına rağmen bu, Okta’nın genel SCIM bağlayıcısıdır. Okta Integration Network’te bulunmayan bir uygulamayı bu şekilde bağlarsınız; birçok yazılım şirketinin belgelerinde anlattığı bağlayıcı da budur.

Kimlik bilgilerini Okta’ya yapıştırma

1. Klang uygulamasında Provisioning’i açın
2. Sol sütunda Integration’ı seçin, ardından Edit’e tıklayın
3. Enable API integration kutusunu işaretleyin
4. Klang’daki temel URL’yi SCIM 2.0 Base Url alanına yapıştırın
5. Klang’daki token’ı OAuth Bearer Token alanına yapıştırın
6. Test API Credentials’a tıklayın. Okta, uygulamanın başarıyla doğrulandığını (“was verified successfully”) bildirmelidir
7. Save’e tıklayın

Test başarısız olursa token’ın tamamını kopyaladığınızdan ve temel URL’nin sonunda eğik çizgi olmadığından emin olun.

Klang’ın ihtiyaç duyduğu işlemleri açma

Bu, çoğu kişinin atladığı adımdır. Atlanırsa sonraki tüm adımlar hiçbir hata göstermeden sonuçsuz kalır.

1. Yine Provisioning altında, sol sütunda To App’i seçin ve Edit’e tıklayın
2. Create Users, Update User Attributes ve Deactivate Users seçeneklerini açın
3. Sync Password seçeneğini kapalı bırakın. Klang’da hiç kimse Okta’dan gelen bir şifreyle giriş yapmaz
4. Save’e tıklayın

Değişiklikleri Edit formunun içinde yapın. Aynı seçenekler formun üstünde salt okunur olarak da gösterilir ve oradaki kutuları işaretlemek hiçbir işe yaramaz.

Create Users açık değilse Okta yalnızca Klang’da zaten var olan kişileri arar ve hiç kimseyi oluşturmaz. Bu durumda her atama Automatic provisioning of user ... failed: Matching user not found hatası verir.

Kişileri atama

1. Assignments sekmesini açın
2. Assign’a, ardından Assign to People veya Assign to Groups’a tıklayın
3. Kimlerin sağlanacağını seçin, Save and Go Back’e ve ardından Done’a tıklayın

Bir kişiyi atamak onu Klang’da oluşturur. Ancak bu, kişiye henüz bir çalışma alanına erişim vermez; erişim aşağıdaki son adımda verilir.

İsteğe bağlı: Gruplarınızı gönderme

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.

Okta grup adlarını kişilerden ayrı gönderir; gruplarınızın Klang’da görünmesini sağlayan bu adımdır.

Uygulamayı bir grup aracılığıyla atıyorsanız Push Groups için ayrı bir grup kullanın.

1. Push Groups sekmesini açın
2. Push Groups → Find groups by name’e tıklayın
3. Grup adını yazın ve listeden seçin
4. Push group memberships immediately kutusunu işaretli bırakın
5. Klang’da bu ada sahip bir grup zaten varsa Okta Match found der; bu durumda Link Group’u seçin. Yoksa Create Group seçeneğini sunar
6. Save’e tıklayın

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.

Bağlantıyı başka bir çalışma alanında kullanma

1. Yöneticisi olduğunuz başka bir çalışma alanına geçin
2. Ayarlar → Çalışma alanı → Üyeler → Üye senkronizasyonu sayfasını açın
3. SCIM dizini kartında Bağla’ya tıklayın
4. Bağlantısını yeniden kullanmak istediğiniz çalışma alanını seçin
5. Bu bağlantıyı kullanmak için Kaydet’e tıklayın
6. Kimlerin erişim alacağını seçin ve seçimi kaydedin

Çalışma alanlarını birbirine bağlarken her ikisinin de yöneticisi olmanız gerekir. Bağlantı paylaşıldığı için Okta tarafını yalnızca bir kez yapılandırmanız yeterlidir. Aynı grup, farklı çalışma alanlarında farklı roller verebilir.

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
• Uygulamadan ataması kaldırılan veya Okta’da devre dışı bırakılan kişi de erişimini aynı şekilde kaybeder
• 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

Kişileri Okta’da yönetmeye devam edersiniz. Klang da buna uyar.

Token’ı yenileme

Bağlantı kartında Diğer seçenekler (⋮) menüsünü açın ve Yeni token oluştur’u seçin. Bağlı herhangi bir çalışma alanının yöneticisi bunu yapabilir. Onay iletişim kutusu etkilenen tüm çalışma alanlarını listeler: eski token bunların hepsinde çalışmayı bırakır. Senkronizasyonu sürdürmek için yeni token’ı Okta’daki OAuth Bearer Token alanına yapıştırın.

Bir şey senkronize olmazsa

• Provisioning → Integration altındaki Test API Credentials, bağlantıyı istediğiniz zaman yeniden kontrol eder
• Okta, kişi bazındaki hataları Assignments sekmesinde gösterir. Nedenini okumak için kişinin yanındaki kırmızı simgeye tıklayın
• Matching user not found, Create Users seçeneğinin kapalı olduğu anlamına gelir. Yukarıdaki adıma bakın
• Import sekmesi gruplarınızı Klang’dan geri okur, ancak kişilerinizi okumaz. Klang, tam kullanıcı listesi isteğine bilerek boş bir sonuçla yanıt verir, çünkü dizininiz için doğruluk kaynağı değildir. Kullanılması gereken yön gönderme (push) yönüdür

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.