Bu makale makine çevirisidir.
Genel bakış
Üyelerin iş kimlik bilgileriyle Legora içinde oturum açabilmesi için SAML 2.0 kimlik sağlayıcınızı bağlayın. Bu adımlar SAML, ADFS ve PingFederate için geçerlidir; SAML için yapılandırılmış bir Entra kurumsal uygulaması dâhil. Entra ID sağlayıcı seçeneği OpenID Connect kullanır.Önkoşullar
Kuruluşunuzun Legora global authentication kullanması gerekir ve rolünüz Manage authentication security içermelidir. Ayrıca kimlik sağlayıcınıza yönetici erişiminiz olmalıdır. Bkz. Kimlik doğrulamayı yönetme.
Nasıl çalışır
Legora, her yeni SAML bağlantısı için hizmet sağlayıcı ayrıntılarını ayırır. Bu değerleri kimlik sağlayıcınıza kaydedersiniz, ardından o uygulamanın meta verilerini Legora içine aktarırsınız. Legora, assertion’ı Assertion Consumer Service (ACS) URL’sinde alır. Hizmet sağlayıcı Entity ID (Identifier), Legora bağlantısını tanımlar. Kimlik sağlayıcınızın Entity ID’si issuer’ı tanımlar. Yeni bağlantılar için her kişi için kararlı, benzersiz bir değere sahip birid özniteliği gönderin.
Bağlantıyı ayarlama
Bağlantınızın değerlerini almak için Legora içinde başlayın. Yeni bir bağlantı hazırlarken mevcut çalışan bağlantıları ve tanımlayıcı eşlemelerini değiştirmeyin.Legora içinde kuruluma başlama
Kimlik sağlayıcınızı yapılandırmadan önce bağlantıyı ayırın.- Menüdeki adınızdan Ayarlar öğesini seçin. People altında Authentication öğesini seçin.
- SSO altında Add öğesini, ardından SAML, ADFS veya PingFederate öğesini seçin.
- Bir Connection name girin ve Continue öğesini seçin.
- Kurulum sayfasından Entity ID (Identifier) ve ACS URL (Reply URL) değerlerini kopyalayın. Bu kuruluma daha sonra dönebilirsiniz.
Kimlik sağlayıcınızı yapılandırma
Bir SAML uygulaması oluşturun ve Legora içinde gösterilen tam değerleri girin.
Bağlantınız için gösterilen tam değerleri kopyalayın. Sondaki eğik çizgiyi eklemeyin veya kaldırmayın. Okta’da Identifier alanı Audience URI (SP Entity ID)’dir.
Legora Support bir hizmet sağlayıcı meta veri bağlantısı sağlarsa, Entity ID ve ACS URL’sinin görüntülenen değerlerle eşleştiğini kontrol edin. Bir kimlik sağlayıcı meta veri URL’si, Legora içine aktardığınız uygulamayı tanımlar.
Kullanıcı tanımlayıcılarını ve öznitelikleri eşleme
Oturum açmış kullanıcının dizin kaydından alınan değerlerle şu SAML öznitelik adlarını kullanın:
Her yeni SAML bağlantısı için
id adlı bir öznitelik ekleyin ve bunu oturum açmış kullanıcının kararlı, benzersiz dizin tanımlayıcısına eşleyin. NameID’ye, başka bir tanımlayıcı özniteliğine veya e-postadan türetilen bir yedek değere güvenmek yerine bunu açıkça ayarlayın.
Yeni bir uygulama için bu öznitelikleri eklemek üzere sağlayıcınızın talimatlarını izleyin:
- Microsoft Entra ID
- Okta
- PingFederate
Uygulamaya özgü SAML claim’leri ekleyin. Tablodaki öznitelik adlarını boş bir Namespace ile kullanın ve
user.mail alanının dolu olduğundan emin olun.NameID, bir SAML yanıtının Subject içindeki kullanıcı tanımlayıcısıdır. Yukarıdaki tablodaki özniteliklerden ayrıdır: açık bir id veya nameidentifier özniteliği NameID’ye göre öncelik alabilir.
Sağlayıcınızın gönderdiği NameID kaynağını ve herhangi bir id veya nameidentifier özniteliğini kontrol edin. Oturum açmış kişiyi tutarlı şekilde tanımlamaları gerekir. Sabit metinden, kiracı kimliklerinden, uygulama kimliklerinden, paylaşılan adreslerden ve her oturum açma için üretilen geçici değerlerden kaçının. Görünen ad uygun değildir çünkü kişiler bunu paylaşabilir veya değiştirebilir.
NameID biçiminin sağlayıcınız ve bağlantınız tarafından desteklendiğini doğrulayın. E-posta tabanlı bir tanımlayıcı, adres değişiklikleri ve yeniden kullanım için bir plan gerektirir.
Standard attribute aliases
Standard attribute aliases
Mevcut eşlemeler şu önekle standart takma adları kullanabilir:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/Legora içinde kurulumu tamamlama
Az önce oluşturduğunuz uygulamanın yapılandırmasını aktarın.- Metadata URL’sini girin veya kimlik sağlayıcının Entity ID, Sign-In Endpoint URL ve Signing Certificate (PEM) değerlerini girin.
- Complete setup öğesini seçin.
- Yeni bağlantı için aşağıdaki kontrollü tam oturum açmalara kadar Status ve Auto-provision’ı kapalı bırakın.
İki test kullanıcısıyla doğrulama
Tanımlayıcı kararlılığını kontrol etmek için bir kişi olarak iki kez oturum açın, ardından tanımlayıcıların farklı olduğunu kontrol etmek için ikinci bir kişi olarak oturum açın. Tek bir başarılı oturum açma hâlâ yanlış paylaşılan bir tanımlayıcı kullanıyor olabilir. Test connection, SAML özniteliklerini göstermez veya kullanıcıları karşılaştırmaya. Her test oturum açması için gönderilen SAML yanıtını kontrol etmesini kimlik sağlayıcı yöneticinizden isteyin; sağlayıcının yanıt görüntüleyicisini veya kuruluş onaylı bir SAML izleme aracını kullanın. Bu değerleri göremiyorsanız bağlantıyı etkinleştirmeden önce yardım için Legora Support ile iletişime geçin. Yeni bir bağlantı için aşağıdaki her testte açıkid değerini doğrulayın. Eksik veya boşsa, Test connection başarılı olsa bile bağlantıyı etkinleştirmeden önce eşlemeyi düzeltin. Mevcut bir bağlantı için yerleşik tanımlayıcı eşlemesini değiştirmeden doğrulayın.
- Kimlik sağlayıcı uygulamasına iki ayrı test kullanıcısı atayın. Her biri kendi dizin kaydı ve iş e-postasıyla hâlihazırda Legora kuruluşunuzun bir üyesi olmalıdır. Yeni bir uygulama için doğrulama tamamlanana kadar erişimi bu test kullanıcılarıyla sınırlayın.
- Test connection öğesini seçin ve birinci kullanıcı olarak oturum açın.
- Kimlik sağlayıcınızın yanıt görüntüleyicisinde veya kuruluş onaylı SAML izleme aracında o oturum açmanın yanıtını açın.
idve diğer tanımlayıcı alanlarını,SubjectiçindekiNameIDve standartnameidentifierözniteliği dâhil, kontrol edin. - Aynı kullanıcı olarak yeni bir oturum açma başlatın. Tanımlayıcının değişmediğini doğrulayın.
- İkinci kullanıcı için ayrı bir tarayıcı profili veya gizli oturum kullanın. Tanımlayıcılarının birinci kullanıcıdan farklı olduğunu doğrulayın. Her kullanıcının e-posta ve ad özniteliklerinin dizin kaydıyla eşleştiğini kontrol edin.
- Yeni bağlantı için aşağıdaki kontrollü oturum açmalar için Status’u etkinleştirin. Auto-provision’ı kapalı tutun.
- Geniş dağıtımdan veya otomatik sağlamadan önce her iki kullanıcı için kontrollü bir tam Legora oturum açması ayarlayın. Her birinin kendi hesabına ve beklenen kuruluşa ulaştığını doğrulayın. Birinci kullanıcı için geri dönen bir oturum açmayı dâhil edin. Kurulum açılır penceresi tek başına bu hesap kontrolünü yapmaz.
- Her iki kullanıcı bu kontrolleri geçtikten sonra kimlik sağlayıcı uygulamasına erişimi planlandığı gibi genişletin. Auto-provision’ı yalnızca amaçlanan atamaları ve e-posta alanlarını doğruladıktan sonra etkinleştirin.