# Verdent Team için Feishu SSO'yu yapılandırma (/tr/docs/account-billing/configure-feishu-sso)

> Merkezi kurumsal oturum açma için Feishu'yu Verdent Team'e bağlayın



Verdent Team, Feishu tek oturum açmayı (SSO) destekler. Yapılandırmadan sonra, onaylı kurumsal e-posta alan adına sahip üyeler şirket Feishu hesaplarıyla kimliklerini doğrulayabilir.

Feishu SSO, mevcut kurumsal kimlik sistemini kullanmayı, ayrı giriş bilgilerini azaltmayı ve Team Owner'ın erişimi tek bir yerden yönetmesini sağlar.

<Note>
  Bu kılavuz Verdent Team Owner kullanıcıları içindir. Team ayarlarına erişip SSO'yu yalnızca Team Owner yönetebilir.
</Note>

## Feishu SSO nasıl çalışır? [#feishu-sso-nasıl-çalışır]

Team Owner, Feishu Open Platform'da özel bir kurumsal uygulama oluşturur ve uygulama bilgileriyle kurumsal e-posta alan adlarını Verdent Team'e ekler.

Bir üye Verdent giriş sayfasında eşleşen bir kurumsal e-posta girdiğinde Feishu yetkilendirmesine yönlendirilir. Verdent, Feishu'nun döndürdüğü kurumsal e-postayla kimliği doğrular.

<Warning>
  Üyelerin Feishu dizininde kurumsal e-postası olmalıdır. Aksi halde Feishu SSO ile giriş yapamazlar.
</Warning>

## Başlamadan önce [#başlamadan-önce]

Şunlara ihtiyacınız vardır:

* Özel uygulama oluşturabilen bir Feishu kurumsal yönetici hesabı
* Verdent Team Owner erişimi
* `yourcompany.com` gibi kurumsal e-posta alan adınız

Kurulum genellikle yaklaşık 5 dakika sürer.

## SSO ayarlarını açma [#sso-ayarlarını-açma]

1. Verdent'te oturum açın ve yapılandıracağınız Team'e geçin.
2. Team konsolunda **Settings** bölümünü açın.
3. **SSO**'yu seçin.
4. **Connect SSO**'ya tıklayın.

Kurulum sırasında Verdent ve Feishu Open Platform'u açık tutun.

## Feishu uygulamasını yapılandırma [#feishu-uygulamasını-yapılandırma]

<Steps>
  <Step title="Özel kurumsal uygulama oluşturma">
    [Feishu Open Platform](https://open.feishu.cn/app) sayfasını açın, **Developer Console**'a girin ve **Create custom enterprise app**'e tıklayın. Ad ve simge ekleyerek uygulamayı oluşturun.
  </Step>

  <Step title="Uygulama bilgilerini alma">
    **Credentials & Basic Info** bölümünde App ID ve App Secret değerlerini bulun:

    | Feishu bilgisi | Verdent SSO alanı |
    | -------------- | ----------------- |
    | **App ID**     | `Client ID`       |
    | **App Secret** | `Client Secret`   |

    <Warning>
      App Secret'ı parola gibi koruyun. Feishu'da sıfırlarsanız Verdent'teki 

      `Client Secret`

       değerini de güncelleyin.
    </Warning>
  </Step>

  <Step title="Yönlendirme URL'sini ekleme">
    **Development Configuration → Security Settings** bölümünde şu **Redirect URL**'yi ekleyin:

    ```text
    https://login.verdent.ai/passport/sso/callback
    ```

    <Warning>
      URL tamamen aynı olmalıdır: 

      `https`

       kullanın, sona 

      `/`

       eklemeyin ve boşlukları kaldırın. Hatalı değer Feishu 

      `20029`

       hatasına yol açar.
    </Warning>
  </Step>

  <Step title="İzinleri verme">
    **Development Configuration → Permissions** bölümünde şunları verin:

    | İzin                                | Kapsam                        |
    | ----------------------------------- | ----------------------------- |
    | Temel kullanıcı bilgilerini okuma   | `contact:user.base:readonly`  |
    | Kullanıcı e-posta bilgilerini okuma | `contact:user.email:readonly` |

    Verdent, üyeleri ad ve kurumsal e-posta ile tanımlamak için bu izinleri kullanır.
  </Step>

  <Step title="Uygulamayı yayımlama">
    **Version Management & Release** bölümünde bir sürüm oluşturup yayımlayın. Üyeler uygulamayı ancak yayımlandıktan sonra kullanabilir.
  </Step>
</Steps>

## Verdent'te bağlantıyı tamamlama [#verdentte-bağlantıyı-tamamlama]

Verdent'teki Feishu SSO yapılandırmasına dönüp şunları girin:

| Verdent alanı   | Değer                     |
| --------------- | ------------------------- |
| `Client ID`     | Feishu App ID             |
| `Client Secret` | Feishu App Secret         |
| `Email domain`  | Kurumsal e-posta alan adı |

En fazla 5 kurumsal alan adı ekleyebilirsiniz. Gmail gibi herkese açık alan adları desteklenmez.

Yapılandırmayı kaydedin ve kartta Feishu SSO'nun etkin olduğunu doğrulayın. Bağlantıyı silmeden geçici olarak devre dışı bırakabilirsiniz.

<Note>
  Verdent kaydederken kimlik bilgilerini doğrular ancak Feishu'daki yönlendirme URL'sini doğrulamaz.
</Note>

## Üye giriş deneyimi [#üye-giriş-deneyimi]

SSO etkinleştirildikten sonra üyeler yapılandırılmış bir kurumsal e-posta girer, SSO ile devam etmeyi onaylar, Feishu'da yetki verir ve Verdent'e döner. Girilen e-posta Feishu'nun döndürdüğünden farklıysa Verdent onay ister ve kimlik doğrulamada Feishu e-postasını kullanır.

## Yapılandırmayı test etme ve yönetme [#yapılandırmayı-test-etme-ve-yönetme]

SSO'yu herkese açmadan önce Feishu hesabında kurumsal e-postası bulunan normal bir üyeyle test edin. Oturumu kapatın, bu e-postayla giriş yapın, Feishu yetkilendirmesini tamamlayın ve Verdent Team'e erişimi doğrulayın.

Team Owner, **Team → Settings → SSO** üzerinden alan adlarını ve durumu görebilir, SSO'yu etkinleştirip devre dışı bırakabilir, bilgileri güncelleyebilir, başarısız bağlantıyı yeniden yapılandırabilir veya silebilir.

## Sorun giderme [#sorun-giderme]

<AccordionGroup>
  <Accordion title="Feishu 20029 hatası: Geçersiz yönlendirme URL'si">
    **Development Configuration → Security Settings** bölümünde `https://login.verdent.ai/passport/sso/callback`
    adresinin tam olarak eklendiğini doğrulayın.
  </Accordion>

  <Accordion title="Verdent, Client ID veya Client Secret'ın geçersiz olduğunu belirtiyor">
    App ID ve App Secret'ı **Credentials & Basic Info** bölümünden yeniden kopyalayın. Secret sıfırlandıysa en yeni
    değeri kullanın.
  </Accordion>

  <Accordion title="Giriş sırasında uygulama kullanılamıyor">
    **Version Management & Release** bölümünde bir sürüm oluşturup yayımladığınızı doğrulayın.
  </Accordion>

  <Accordion title="Girişten sonra e-posta boş">
    Feishu dizininde üyeye kurumsal e-posta ekleyip yeniden deneyin.
  </Accordion>

  <Accordion title="Üye Feishu SSO'ya yönlendirilmiyor">
    E-postanın yapılandırılmış alan adıyla eşleştiğini ve Verdent'te Feishu SSO'nun etkin olduğunu doğrulayın.
  </Accordion>
</AccordionGroup>