Skip to main content
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 bir id ö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.
  1. Menüdeki adınızdan Ayarlar öğesini seçin. People altında Authentication öğesini seçin.
  2. SSO altında Add öğesini, ardından SAML, ADFS veya PingFederate öğesini seçin.
  3. Bir Connection name girin ve Continue öğesini seçin.
  4. 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:
Mevcut bir SAML bağlantısı için id eklemeden veya herhangi bir tanımlayıcı kaynağını, biçimini veya eşlemesini değiştirmeden önce Legora support ile iletişime geçin. E-posta adresleri aynı kalsa bile farklı bir tanımlayıcı mevcut hesaplara erişimi etkileyebilir. Bir geçiş planı üzerinde anlaşana kadar geçerli yapılandırmayı koruyun.
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:
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.
Bir kişi için oturum açmalar arasında aynı kalan ve diğer her kişiden farklı olan boş olmayan bir tanımlayıcı seçin. Sağlayıcınızın desteklediği kalıcı, yeniden atanmayan bir dizin tanımlayıcısını tercih edin. Bir tanımlayıcı, kişinin e-posta adresinden farklı olabilir. 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.
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.
  1. Metadata URL’sini girin veya kimlik sağlayıcının Entity ID, Sign-In Endpoint URL ve Signing Certificate (PEM) değerlerini girin.
  2. Complete setup öğesini seçin.
  3. 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çık id 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.
  1. 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.
  2. Test connection öğesini seçin ve birinci kullanıcı olarak oturum açın.
  3. 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. id ve diğer tanımlayıcı alanlarını, Subject içindeki NameID ve standart nameidentifier özniteliği dâhil, kontrol edin.
  4. Aynı kullanıcı olarak yeni bir oturum açma başlatın. Tanımlayıcının değişmediğini doğrulayın.
  5. İ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.
  6. Yeni bağlantı için aşağıdaki kontrollü oturum açmalar için Status’u etkinleştirin. Auto-provision’ı kapalı tutun.
  7. 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.
  8. 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.
Tanımlayıcılardan biri oturum açmalar arasında değişirse, her iki kullanıcı bir tanımlayıcıyı paylaşırsa veya beklenmeyen bir hesap görünürse dağıtımı durdurun ve support@legora.com ile iletişime geçin. Belirteçleri, özel anahtarları ve ham assertion’ları e-posta ve destek taleplerinin dışında tutun.

Mevcut bir bağlantıyı taşıma

Geçerli ve önerilen tanımlayıcıları karşılaştırmak ve hesap taşımanın gerekip gerekmediğini belirlemek için Legora Support ile birlikte çalışın. Yapılandırmayı değiştirmeden önce kontrollü bir dağıtım, geri dönen kullanıcıların mevcut hesaplarına ulaştığı kontroller ve bir geri alma planı üzerinde anlaşın. Global authentication’a geçiş Yeni bağlantının kurulumundaki değerlerle ayrı bir uygulama hazırlayın. Koordineli bir geçiş doğrulanana kadar çalışan uygulamayı ve paylaşılan veya bağlantıya özgü callback’ini kullanılabilir tutun. Daha geniş geçiş için global authentication migration guide kullanın.

Sorun giderme

Bağlantının görüntülenen değerlerini kimlik sağlayıcı yapılandırması ve öznitelik eşlemeleriyle karşılaştırın.

Reply URL veya audience reddedildi

Bu bağlantı için tam Identifier ve ACS URL’yi kopyalayın. Başarılı bir meta veri alımı tek başına her iki değerin eşleştiğini doğrulamaz.

Eksik veya yanlış profil

Yukarıdaki SAML öznitelik adlarını ve kullanıcı başına değerleri kontrol edin. Kişinin bir iş e-postası olduğundan ve yapılandırılmış e-posta özniteliğinde gönderildiğinden emin olun. Meta veri kurulumunu tamamlamak tek bir kullanıcının özniteliklerini doğrulamaz.

Beklenmeyen hesap veya değişen tanımlayıcı

Dağıtımı durdurun. Mevcut bir eşlemeyi değiştirmeden önce tüm tanımlayıcı kaynaklarını Legora Support ile gözden geçirin. Bu kontroller sorunu çözmezse support@legora.com ile iletişime geçin.