Microsoft Entra ID ve Okta ile SCIM sağlama

Pilot

Bu sayfanın andığı şirket için tek oturum açma şu anda yalnız pilot organizasyonlarda açık. SCIM onsuz da çalışır.

SCIM 2.0 ile kimlik sağlayıcınız organizasyonunuzun üyelerini güncel tutar: Workify360 Focus’a atadığınız kişileri ekler, adlarını, e-posta adreslerini ve takımlarını değiştirir, ayrılan çalışanları otomatik olarak askıya alır ya da kaldırır. SCIM sağlama Premium paketine dahildir ve onu yalnız organizasyonun hesap sahibi yönetir.

SCIM rol atamaz. Eklediği kişiler çalışan olur ve SCIM hiç kimsenin rolünü değiştirmez; rolleri bir hesap sahibi ya da şirket yöneticisi Ayarlar → Kullanıcılar sayfasında verir. Kimlik sağlayıcının hiçbir ayarı SCIM üzerinden birini hesap sahibi ya da şirket yöneticisi yapamaz.

Anahtarı oluşturma

1. Ayarlar → Güvenlik sayfasını ve SCIM sayfasını açın.
2. SCIM anahtarı oluştur’u seçin, bir ad ve kaç gün geçerli olacağını verin (1 ile 730 arası, varsayılan 365). Focus isterse girişinizi onaylayın.
3. w360_scim_ ile başlayan anahtar bir kez gösterilir. Onu kimlik sağlayıcınıza kopyalayın.

SCIM sayfası taban URL’yi de gösterir:

https://api.focus.workify360.com/scim/v2

Bir organizasyonun iki etkin anahtarı olabilir; böylece eskisini iptal etmeden önce yenisini yerine koyabilirsiniz (scim_key_limit_reached). SCIM anahtarı yalnız SCIM için çalışır: giriş yapamaz ve genel API’yi çağıramaz; API anahtarları ve panel oturumları da SCIM’i çağıramaz.

Microsoft Entra ID

1. Microsoft Entra yönetim merkezinde Enterprise applications sayfasını açın, New application’ı ve ardından Create your own application’ı seçin; galeride olmayan bir uygulama seçeneğini işaretleyin. Tek oturum açma için Workify360 Focus uygulamasını zaten kullanıyorsanız onu kullanın.
2. Provisioning sayfasını açın, sağlama kipini Automatic yapın, taban URL’yi Tenant URL, anahtarı Secret Token olarak girin. Test Connection’ı seçin ve kaydedin.
3. Mappings altında kullanıcı eşlemesini koruyun ve öznitelikleri aşağıdaki tabloyla karşılaştırın. Takımlarınızın Entra gruplarını izlemesini istiyorsanız grup eşlemesini açın.
4. Focus’ta olması gereken kullanıcıları ve grupları atayın ve sağlamayı açın.

Entra değişikliklerini 20 ile 40 dakikada bir çalışan sağlama döngüleriyle gönderir; Provision on demand bir kişiyi hemen gönderir.

Okta

1. Okta Admin Console’da Workify360 Focus uygulama entegrasyonunuzu açın (ya da oluşturun) ve genel ayarlarında SCIM sağlamayı açın.
2. Provisioning sekmesinde, Integration altında taban URL’yi SCIM bağlayıcı taban URL’si, userName’i benzersiz tanımlayıcı alanı olarak girin ve anahtarı bearer token olarak kullanan HTTP Header kimlik doğrulamasını seçin. Yeni kullanıcıların, profil güncellemelerinin ve grupların gönderilmesine izin verin, sonra test edip kaydedin.
3. To App altında kullanıcı oluşturmayı, kullanıcı özniteliklerini güncellemeyi ve kullanıcıları devre dışı bırakmayı açın.
4. Kişileri atayın ve takım olması gereken grupları gönderin.

Okta bir değişikliği genellikle birkaç dakika içinde gönderir.

Öznitelik eşlemesi

SCIM özniteliği	Focus’ta	Notlar
userName	Üyenin SCIM kullanıcı adı	Zorunlu; organizasyonun etkin üyeleri arasında benzersiz
emails[type eq "work"].value	İş e-postası; yeni bir kişinin giriş e-postası	Var olan bir hesabın e-postası yalnız o hesabı organizasyonunuz yönetiyorsa değişir
name.givenName, name.familyName, displayName	Ad	Yalnız SCIM’in oluşturduğu kişiler ya da organizasyonunuzun yönettiği hesaplar için
externalId	Dış kimlik
active	false üyeyi askıya alır, true yeniden etkinleştirir
Gruplar	Takımlar; bir grubun üyesi o grubu takımı olarak alır	Birden fazla grupta son değişiklik kazanır

Kurumsal kullanıcı öznitelikleri (bölüm, yönetici ve benzerleri) kabul edilir ve yok sayılır.

Zaten üye olan kişiler

Kimlik sağlayıcı birini oluşturmadan önce onu userName ile arar. Focus, iş ya da giriş e-postası bu adres olan üyeyle yanıt verir; böylece SCIM’i kurmadan önce davet edilmiş kişiler iki kez eklenmez, devralınır. Rolleri ve verileri olduğu gibi kalır.

Ayrılan çalışanları askıya alma ve kaldırma

• active değerinin false yapılması üyeyi askıya alır ve onu her yerde hemen oturumdan çıkarır: panel oturumları, masaüstü uygulaması ve API anahtarları bir sonraki istekte durur.
• Kişiyi kimlik sağlayıcıda kaldırmak (bir DELETE) üyeliği bitirir. Verileri saklama kurallarınıza göre kalır.
• Hesabı salt okunur olan bir organizasyon SCIM ile yeni üye alamaz (subscription_read_only).

Erişim ne kadar hızlı biter

Kurulum	Kimlik sağlayıcıda kapatılan kişi ne kadar süre daha girebilir
SCIM’siz tek oturum açma	Kimlik sağlayıcıyla bir sonraki denetime kadar: varsayılan olarak panelde en fazla 12 saat, masaüstü uygulamasında 24 saat (tek oturum açma)
SCIM	Kimlik sağlayıcı değişikliği gönderene kadar (Microsoft Entra ID: bir sonraki sağlama döngüsü, 40 dakika içinde; Okta: genellikle birkaç dakika), sonra anında her yerde
Üyeyi Focus’ta askıya almak	Anında, her yerde

Hata mesajları

Kod	Ne yapmalı
scim_key_limit_reached	Organizasyonunuzun iki etkin SCIM anahtarı var; artık kullanmadığınızı iptal edin
scim_key_not_found	Anahtar zaten iptal edilmiş; sayfayı yenileyin
subscription_read_only	Hesap salt okunur; salt okunur hesap ve paket sınırları makalesine bakın