Verdent Docs

Verdent Team için Feishu SSO'yu yapılandırma

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.

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

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.

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

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

  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

Özel kurumsal uygulama oluşturma

Feishu Open Platform sayfasını açın, Developer Console'a girin ve Create custom enterprise app'e tıklayın. Ad ve simge ekleyerek uygulamayı oluşturun.

Uygulama bilgilerini alma

Credentials & Basic Info bölümünde App ID ve App Secret değerlerini bulun:

Feishu bilgisiVerdent SSO alanı
App IDClient ID
App SecretClient Secret
App Secret'ı parola gibi koruyun. Feishu'da sıfırlarsanız Verdent'teki Client Secret değerini de güncelleyin.

Yönlendirme URL'sini ekleme

Development Configuration → Security Settings bölümünde şu Redirect URL'yi ekleyin:

https://login.verdent.ai/passport/sso/callback
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.

İzinleri verme

Development Configuration → Permissions bölümünde şunları verin:

İzinKapsam
Temel kullanıcı bilgilerini okumacontact:user.base:readonly
Kullanıcı e-posta bilgilerini okumacontact:user.email:readonly

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

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.

Verdent'te bağlantıyı tamamlama

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

Verdent alanıDeğer
Client IDFeishu App ID
Client SecretFeishu App Secret
Email domainKurumsal 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.

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

Ü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

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

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.

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.

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.

Girişten sonra e-posta boş

Feishu dizininde üyeye kurumsal e-posta ekleyip yeniden deneyin.

Ü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.