> ## Documentation Index
> Fetch the complete documentation index at: https://support.legora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entegrasyon genel bakışı - Entra ID Single Sign-on

> Legora için küresel kimlik doğrulama üzerinde bir kuruluş için Entra ID single sign-on kurun.

Bu makale makine çevirisidir.

## Genel bakış

Bu kılavuz, single sign-on (SSO) için Microsoft Entra ID’yi Legora için küresel kimlik doğrulamaya bağlayan BT yöneticileri içindir. Üyeler ardından Entra ID hesaplarıyla Legora içinde oturum açar.

İki yerde çalışırsınız: Microsoft Entra admin center ve Legora içinde **Authentication**. Entra ID, Legora için küresel kimlik doğrulamada OpenID Connect kullanır.

> [!NOTE]
>
> Kuruluşunuz Legora için küresel kimlik doğrulamayı kullanmalı ve rolünüz **Manage authentication security** içermelidir. Bkz. [Kuruluşum için kimlik doğrulamayı nasıl yönetirim?](https://support.legora.com/tr/how-do-i-manage-authentication-for-my-organization.md).
>
> Kuruluşunuz henüz geçmediyse Legora support single sign-on (SSO) kurar. [support@legora.com](mailto:support@legora.com) adresine yazın. Mevcut bir kuruluşu taşımak için [IT Admin guide: Legora’s global authentication](https://support.legora.com/tr/it-admin-guide-legora-s-new-authentication-protocol.md) sayfasına bakın.

## Nasıl çalışır

Her adım işlemi nerede yaptığınızı belirtir. Legora içinde bağlantıyı test etmeden önce Entra adımlarını tamamlayın.

| Adım | Nerede |
| - | - |
| 1. Uygulama kaydını oluşturun | Entra |
| 2. Redirect URI’yi ekleyin | Entra |
| 3. Bir client secret oluşturun | Entra |
| 4. Bağlantı ayrıntılarını ekleyin | Legora |
| 5. Kullanıcıları ve grupları atayın | Entra |
| 6. Bağlantıyı test edin | Legora |
| 7. Bağlantıyı etkinleştirin | Legora |

### Adım 1: Uygulama kaydını oluşturun (Entra içinde)

Üyelerin Legora içinde oturum açması için kullanılan bir uygulama kaydı oluşturun.

**Legora, galeri dışı bir enterprise application olmalıdır.** Galeri uygulamaları SCIM’i desteklemediklerini bildirir; bu nedenle [Directory Sync](https://support.legora.com/tr/how-to-set-up-directory-sync-scim.md#before-you-start) provisioning kullanılamaz kalır. Sizinki bir galeri uygulamasıysa yeni bir uygulama kaydı oluşturun ve bunu oturum açma ile provisioning için kullanın.

1. [Microsoft Entra admin center](https://entra.microsoft.com) içinde oturum açın.
2. **Entra ID** > **App registrations** bölümüne gidin ve **New registration** öğesini seçin.
3. Formu doldurun ve **Register** öğesini seçin:
   * **Name**: Uygulamanın ne için olduğunu söyleyen bir ad, örneğin “Legora SSO.”
   * **Supported account types**: Varsayılanı bırakın, **Accounts in this organizational directory only** (single tenant).
   * **Redirect URI**: Şimdilik boş bırakın. Adım 2’de eklersiniz.
4. Uygulamanın **Overview** sayfasında adım 4 için şu değerleri kopyalayın:
   * **Application (client) ID**
   * **Directory (tenant) ID**

### Adım 2: Redirect URI’yi ekleyin (Entra içinde)

Üyeler oturum açtıktan sonra Entra’nın onları geri gönderebilmesi için Legora callback URI’sini kaydedin.

1. Uygulama kaydınızda **Authentication** bölümüne gidin.
2. **Add a platform** öğesini seçin, ardından **Web** öğesini seçin.
3. Bu redirect URI’yi yapıştırın ve **Configure** öğesini seçin:

`https://sso.legora.com/api/oauth/oidc`

Legora için küresel kimlik doğrulamada her kuruluş için bu URI’yi kullanın. Adım 4’te bağlantıyı oluşturduktan sonra bağlantıdaki **Redirect URL** aynı değeri gösterir.

Entra hangi OpenID Connect kapsamlarına izin verileceğini sorarsa `openid`, `profile` ve `email` öğelerini etkinleştirin. Legora oturum açmadan sonra e-posta adresine ihtiyaç duyar. Ad ve soyadı önerilir.

Bu uygulama kaydında daha eski bir Legora oturum açma kurulumundan redirect URI’ler varsa bunları yerinde bırakın ve yukarıdaki URI’yi ekleyin. Eski URI’leri yalnızca kuruluşunuz Legora için küresel kimlik doğrulamaya geçişi tamamladıktan sonra kaldırın. Tam görev listesi [IT Admin guide: Legora’s global authentication](https://support.legora.com/tr/it-admin-guide-legora-s-new-authentication-protocol.md) sayfasındadır.

### Adım 3: Bir client secret oluşturun (Entra içinde)

Legora uygulamasının bağlanmak için kullandığı secret’ı oluşturun.

1. Uygulama kaydınızda **Certificates & secrets** > **Client secrets** bölümüne gidin ve **New client secret** öğesini seçin.
2. “Legora SSO secret” gibi bir açıklama ekleyin ve secret’ın ne zaman sona ereceğini seçin.
3. **Add** öğesini seçin, ardından **Value** değerini kopyalayıp güvenli bir yere kaydedin. Entra **Value** değerini yalnızca bir kez gösterir. Secret ID Legora içine yapıştırılamaz.

Secret sona ermeden birkaç gün önce bir hatırlatıcı ayarlayın.

**Client secret sona erdiğinde**

Entra’da yeni bir client secret oluşturun, ardından Legora uygulamasını güncelleyin:

1. Menüdeki adınızdan **Ayarlar** > **People** > **Authentication** öğesini seçin.
2. **SSO** altında bağlantıyı seçin.
3. **Connection details** altında **Edit** öğesini seçin.
4. **Client secret** alanına yeni değeri girin. Alanı yalnızca geçerli secret’ı korumak istediğinizde boş bırakın.
5. Kaydedin.

Secret yenilemesi için yeni bir bağlantıya ihtiyacınız yoktur.

### Adım 4: Bağlantı ayrıntılarını ekleyin (Legora içinde)

1–3. adımlardaki değerleri Legora içine girin.

Domain için kuruluşunuzun sahip olduğu bir domain kullanın. Entra admin center’da bunu **Entra ID** > **Domain names** altında bulun. `legora.com` gibi doğrulanmış bir domain kullanın. `onmicrosoft.com` ile biten bir domaini atlayın.

1. Menüdeki adınızdan **Ayarlar** > **People** > **Authentication** öğesini seçin.
2. **SSO** altında **Add** öğesini seçin, ardından **Entra ID** öğesini seçin.
3. Formu doldurun:
   * **Display Name**: Üyelerin oturum açma ekranında gördüğü ad.
   * **Domain**: Kuruluşunuzun domain’i.
   * **Tenant ID**: Adım 1’deki Directory (tenant) ID.
   * **Client ID**: Adım 1’deki Application (client) ID.
   * **Client Secret**: Adım 3’teki secret değeri.
4. **Create connection** öğesini seçin. Legora yeni bağlantıyı açar.

Bağlantıyı oluşturmadan önce domain, tenant ID ve client ID’yi kontrol edin. Daha sonra farklı değerler kullanmak için yeni bir bağlantı oluşturun. **Edit** görünen adı, discovery URL’yi ve client secret’ı değiştirebilir.

### Adım 5: Kullanıcıları ve grupları atayın (Entra içinde)

Entra üzerinden Legora içinde kimlerin oturum açabileceğini seçin.

1. Entra’nın uygulama kaydınız için oluşturduğu enterprise application’ı açın. Uygulama kaydının **Overview** sayfasında **Managed application in local directory** öğesini seçin veya **Entra ID** > **Enterprise applications** bölümüne gidip uygulamayı seçin.
2. **Properties** içinde dizininizdeki her kullanıcının oturum açıp açamayacağını veya yalnızca atadığınız kullanıcıların açabileceğini seçin. **Assignment required?** varsayılan olarak **No**’dur. Yalnızca atanan kullanıcı ve gruplara izin vermek için **Yes** olarak ayarlayın.
3. Atama gerekiyorsa **Users and groups** bölümüne gidin ve **Add user/group** öğesini seçin.
4. Legora erişimine sahip olması gereken kullanıcıları veya grupları seçin, ardından **Assign** öğesini seçin.

### Adım 6: Bağlantıyı test edin (Legora içinde)

Üyeler buna güvenmeden önce bağlantının çalıştığını doğrulayın.

1. Menüdeki adınızdan **Ayarlar** > **People** > **Authentication** öğesini seçin.
2. **SSO** altında bağlantıyı seçin.
3. **Test connection** öğesini seçin. Bir oturum açma penceresi açılır.

Microsoft izinleri onaylamanızı isterse, testin tamamlanması için bir Entra yöneticisinin onay vermesi gerekebilir. Test başarısız olursa redirect URI’yi, client ID’yi ve client secret’ı kontrol edin, ardından testi yeniden çalıştırın. Hâlâ başarısız olursa [support@legora.com](mailto:support@legora.com) adresine yazın.

### Adım 7: Bağlantıyı etkinleştirin (Legora içinde)

Bağlantıyı üyeler için kullanılabilir yapın.

Bağlantıda **Status** öğesini açın. Üyeler ardından Entra ID ile oturum açabilir. Bunu yapana kadar bağlantı kurulu kalır ancak bir oturum açma yöntemi olarak görünmez.

***

## Kimler katılabilir

Entra kimlerin kimlik doğrulaması yapabileceğini denetler. Legora kimlerin üye olacağını denetler. Üyeliği bağlantıda **Auto-provision** ve **Email domains** altında ayarlarsınız.

### Auto-provision açık

**Auto-provision** açıkken Legora, listelenen bir domain’deki e-posta adresiyle ilk kez oturum açan kişiyi ekler.

Entra’da kimlik doğrulama iznine yine ihtiyaçları vardır. Uygulama ataması, Conditional Access ve çok faktörlü kimlik doğrulama Entra’da kalır.

**Auto-provision** öğesini açmadan önce **Email domains** altına en az bir domain ekleyin. Bağlantı etkin olmalıdır. Bağlantı için Directory Sync açıksa üyelik yönetimi için bunun yerine Directory Sync kullanın. Bkz. [Directory Sync](https://support.legora.com/tr/how-to-set-up-directory-sync-scim.md).

### Auto-provision kapalı

**Auto-provision** kapalıyken kişi Entra’da yine kimlik doğrulaması yapabilir. Legora onları yalnızca bir Admin davet ettikten ve onlar kabul ettikten sonra ekler.

Aktif üyelikleri yoksa oturum açma durur. Legora şunu gösterir: “User has no active membership in any of the connection organisations.”

Erişim vermek için kişiyi Entra’da izinlendirin ve Legora içinde davet edin. Erişimi kaldırmak için onları Entra uygulamasından veya Legora içindeki kuruluştan çıkarın.

***

## Sık sorulan sorular

Bu yanıtlar, bağlantı açıldıktan sonra yöneticilerin en sık bildirdiği oturum açma sorunlarını kapsar.

### Bir kullanıcı Entra’daki enterprise app’ten kaldırıldığında ne olur?

Artık o uygulama üzerinden oturum açamazlar. Legora profilleri kalır. Onları uygulamaya yeniden atarsanız, hâlâ üye oldukları veya **Auto-provision**’ın onları ekleyebildiği sürece oturum açabilirler.

Kuruluş ayrıca Directory Sync kullanıyorsa, kullanıcıyı Entra’da devre dışı bırakmak veya kaldırmak kuruluş erişimini iptal eder. Legora profilini silmez.

### Bir kullanıcı neden boş bir Legora hesabında oturum açar?

**Auto-provision** açıkken Legora hesabı Entra’nın gönderdiği e-posta adresinden oluşturur. Bu adres davetten farklıysa, örneğin `jane.doe@example.com` yerine `jdoe@example.com` ise, Legora Entra adresi için ayrı bir hesap oluşturur. Entra’daki e-postayı Legora içinde kullanılan adresle eşleştirin veya [support@legora.com](mailto:support@legora.com) adresine yazın.

### Biri neden oturum açmayı tamamlayamaz?

Bu genellikle **Auto-provision**’ın kapalı olduğu ve kişinin davet edilmediği veya üyeliğinin kaldırıldığı anlamına gelir. Legora şunu gösterir: “User has no active membership in any of the connection organisations.”

Onları Legora içinde davet edin veya e-posta domain’leri için **Auto-provision** öğesini açın. Ayrıca Entra’daki Legora uygulamasına erişimleri olmalıdır.

### Birkaç domain’imiz var, ancak SSO hepsi için başlamıyor

Her domain’i bağlantıdaki **Email domains** altına ekleyin. Bu domain’leri kuruluşun izin verilen domain’lerine de ekleyin. Menüdeki adınızdan **Ayarlar** > **People** > **Authentication** öğesini seçin. **Restrictions** altında **Approved email domains** öğesini seçin, ardından **Allowed domains** öğesini düzenleyin.

Tek bir SSO bağlantısıyla Legora, kuruluşun izin verilen domain’leriyle oturum açmayı yönlendirebilir. Birden fazla bağlantıda, o bağlantıyı seçmek için yalnızca **Auto-provision** açık olan bir bağlantıdaki domain’ler kullanılır.

## Ek kaynaklar

Bu sayfalar oturum açma kurulumunun geri kalanını ve Microsoft’un uygulama kaydı adımlarını kapsar.

* [Kuruluşum için kimlik doğrulamayı nasıl yönetirim?](https://support.legora.com/tr/how-do-i-manage-authentication-for-my-organization.md)
* [IT Admin guide: Legora’s global authentication](https://support.legora.com/tr/it-admin-guide-legora-s-new-authentication-protocol.md)
* [Microsoft identity platform app registration](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)
