Microsoft Entra ID ile SSO kurulumu

Pilot

Şirket için tek oturum açma şu anda yalnız pilot organizasyonlarda açık. Henüz genel kullanıma açık değil. Bağlantıyı Focus’ta, panelin yeni sürümünün parçası olan ve organizasyonun owner’ına gösterilen Ayarlar → Güvenlik → Tek oturum açma sekmesinde oluşturursunuz.

Bu rehber Workify360 Focus’u Microsoft Entra ID kiracınıza bir uygulama olarak kaydeder. Uygulama kaydedip yönetici onayı verebilen bir Entra hesabına ve Focus’ta doğrulanmış bir alan adına ihtiyacınız var (alan adı doğrulama). Test, etkinleştirme ve girişin nasıl çalıştığı için önce tek oturum açma makalesini okuyun.

Entra’da neler kaydedilir

Ayar	Değer
Desteklenen hesap türleri	Tek kiracılı (yalnız bu kuruluş dizinindeki hesaplar) önerilir; çok kiracılı da çalışır
Yönlendirme URI’si (platform Web)	https://auth.focus.workify360.com/sso/oidc/callback
İsteğe bağlı talepler (ID token)	email ve xms_edov
API izinleri (Microsoft Graph, temsilci)	openid, email, profile, offline_access, yönetici onayıyla
Kimlik bilgisi	Focus’un ürettiği sertifika (önerilir) ya da istemci sırrı

Çok kiracılı bir uygulamada da Focus yalnız kendi kiracınızın hesaplarını kabul eder: her giriş kiracı kimliğinizi (tid) ve kiracınızın issuer değerini taşımak zorundadır.

Adım adım

1. Microsoft Entra yönetim merkezinde Uygulama kayıtları (App registrations) sayfasını açın ve Yeni kayıt seçeneğini seçin.

2. Bir ad verin, örneğin “Workify360 Focus”, ve desteklenen hesap türünü seçin.

3. Yönlendirme URI’si altında Web seçin ve şunu girin:

   https://auth.focus.workify360.com/sso/oidc/callback

4. Kaydet seçeneğini seçin. Genel bakış sayfasında Uygulama (istemci) kimliği ve Dizin (kiracı) kimliği değerlerini kopyalayın.

5. Token yapılandırması → İsteğe bağlı talep ekle bölümünü açın, token türü olarak ID seçin ve email ile xms_edov taleplerini seçin. Entra Microsoft Graph e-posta iznini eklemeyi önerdiğinde kabul edin. Focus, e-posta alanının organizasyonunuza ait olduğunu xms_edov ile anlar ve adresi email talebinden (boşsa preferred_username talebinden) okur.

6. API izinleri bölümünü açın ve Microsoft Graph’ta openid, email, profile ve offline_access temsilci izinlerinin olduğundan emin olun. Yönetici onayı ver seçeneğini seçin. offline_access, masaüstü uygulamasına hesabı düzenli denetlemek için gereken refresh token’ı verir.

7. Bir kimlik bilgisi ekleyin:

   • Sertifika (önerilir): Focus’ta bağlantıyı “Sertifika (private_key_jwt, önerilir)” kimlik doğrulama yöntemiyle (private_key_jwt) oluşturun. Focus bir anahtar çifti ve 2 yıl geçerli bir sertifika üretir; özel anahtar Focus’tan hiç çıkmaz. Bağlantı kartında Sertifikayı indir bağlantısını seçin ve dosyayı Entra’da Sertifikalar ve gizli diziler → Sertifikalar → Sertifika yükle bölümünden yükleyin. Kart sertifikanın parmak izini ve bitiş tarihini gösterir.
   • İstemci sırrı: Entra’da Sertifikalar ve gizli diziler → İstemci gizli dizileri → Yeni istemci gizli dizisi bölümünü açın ve Değer alanını kopyalayın (gizli dizi kimliğini değil). İstemci sırlarının süresi dolar; etkin bir bağlantının sırrını değiştirmek için Devre dışı bırak düğmesini seçmeniz, yeni sırrı Düzenle ile girmeniz, test edip yeniden etkinleştirmeniz gerekir (sso_connection_active); bu yüzden bitiş tarihini not edin.

Focus’ta bağlantıyı oluşturma

1. Ayarlar → Güvenlik → Tek oturum açma sekmesini açın ve Bağlantı ekle düğmesini seçin.
2. Sağlayıcı olarak Microsoft Entra ID’yi seçin.
3. Giriş sayfasında görünen adı, Dizin (kiracı) kimliği ve (“İstemci kimliği” alanına) Uygulama (istemci) kimliği değerlerini girin. Kimlik doğrulama yöntemini seçin: sertifika ya da sırrın Değer alanıyla “İstemci sırrı”. Focus issuer değerini kiracı kimliğinden türetir: https://login.microsoftonline.com/<kiracı-kimliği>/v2.0.
4. Yönlendirme URI’si adımını Entra’ya kaydettiğinizle karşılaştırın, ilk girişte kimlerin ekleneceğini seçin ve kaydedin.
5. Sertifika seçtiyseniz bağlantı kartında Sertifikayı indir bağlantısını seçin ve dosyayı Entra’ya yükleyin (yukarıdaki 7. adım).
6. Bağlantıyı test et düğmesini seçin, yeni sekmede doğrulanmış alan adınızdaki bir hesapla giriş yapın ve sonuçları kartta kontrol edin. Kiracı denetimi geçmek zorundadır, refresh token denetiminin de geçmesi gerekir.
7. Etkinleştir düğmesini seçin (son 24 saatte geçmiş bir test gerekir, sso_test_required).

Entra’daki isteğe bağlı ayarlar

• Kimler giriş yapabilir: Kurumsal uygulamalar bölümünde uygulamayı açın, Özellikler altında Atama gerekli mi? seçeneğini Evet yapın ve Kullanıcılar ve gruplar altında kişileri ya da grupları ekleyin. Diğerlerini Entra reddeder.
• Çok adımlı doğrulama: Koşullu Erişim ilkesiyle zorunlu tutun. Bağlantıda “Sağlayıcıda iki adımlı doğrulamayı şart koş” (requireIdpMfa) açıksa Focus bir girişi yalnız Entra çok adımlı doğrulamayı bildirdiğinde kabul eder.