Verdent Team で Feishu SSO を設定する

Feishu と Verdent Team を連携し、企業アカウントによる一元的なログインを提供します

Verdent Team は Feishu のシングルサインオン（SSO）に対応しています。設定後、指定した企業メールドメインを持つメンバーは、会社の Feishu アカウントで本人確認できます。

Feishu SSO を使うと、既存の企業 ID 基盤を活用し、個別の認証情報を減らしながら、Team Owner がアクセスを一元管理できます。

このガイドは Verdent Team Owner 向けです。Team 設定にアクセスして SSO を管理できるのは Team Owner のみです。

Feishu SSO の仕組み

Team Owner は Feishu Open Platform で企業のカスタムアプリを作成し、その認証情報と企業メールドメインを Verdent Team に追加します。

メンバーが Verdent のログイン画面で対象ドメインのメールアドレスを入力すると、Feishu の認可画面に移動します。Verdent は Feishu から返された企業メールで本人確認を行います。

メンバーの Feishu ディレクトリに企業メールが登録されている必要があります。

事前準備

次の情報と権限が必要です。

カスタムアプリを作成できる Feishu 企業管理者アカウント
Verdent Team の Owner 権限
yourcompany.com などの企業メールドメイン

設定には通常約 5 分かかります。

SSO 設定を開く

Verdent にログインし、設定する Team に切り替えます。
Team コンソールで Settings を開きます。
SSO を選択します。
Connect SSO をクリックします。

設定中は Verdent と Feishu Open Platform の両方を開いておくことをお勧めします。

Feishu アプリを設定する

企業カスタムアプリを作成する

Feishu Open Platform の開発者コンソールを開き、企業カスタムアプリを作成をクリックします。名前とアイコンを設定して作成します。

アプリの認証情報を取得する

認証情報と基本情報で App ID と App Secret を確認します。

Feishu	Verdent SSO
App ID	`Client ID`
App Secret	`Client Secret`

App Secret はパスワードとして扱ってください。Feishu でリセットした場合は、Verdent の Client Secret も更新します。

リダイレクト URL を追加する

開発設定 → セキュリティ設定で次のリダイレクト URLを追加します。

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

URL は完全に一致させてください。https を使用し、末尾に / や空白を追加しないでください。誤りがあると Feishu エラー 20029 が発生します。

権限を付与する

開発設定 → 権限管理で次の権限を付与します。

権限	スコープ
ユーザー基本情報の取得	`contact:user.base:readonly`
ユーザーメール情報の取得	`contact:user.email:readonly`

Verdent は氏名と企業メールを使ってメンバーを識別します。

アプリを公開する

バージョン管理と公開でバージョンを作成し、公開を申請します。公開後にメンバーが利用できます。

Verdent で接続を完了する

Verdent の Feishu SSO 設定に戻り、次を入力します。

Verdent フィールド	値
`Client ID`	Feishu App ID
`Client Secret`	Feishu App Secret
`Email domain`	企業メールドメイン

企業ドメインは最大 5 件まで追加できます。Gmail などの公開メールドメインは使用できません。

保存後、設定カードで Feishu SSO が有効になっていることを確認します。接続を削除せず、一時的に無効化することもできます。

Verdent は保存時に認証情報を検証しますが、Feishu のリダイレクト URL は検証しません。

メンバーのログイン手順

メンバーは Verdent のログイン画面で企業メールを入力し、SSO の利用を確認して、Feishu で認可します。認可後は Verdent に戻ります。入力したメールと Feishu が返したメールが異なる場合、Verdent は確認を求め、Feishu のメールで認証します。

設定をテスト・管理する

全社展開前に、Feishu に企業メールが登録された一般メンバーでテストしてください。ログアウトしてそのメールでログインし、Feishu の認可後に Verdent と Team に戻れることを確認します。

Team Owner は Team → Settings → SSO で状態とドメインの確認、有効化・無効化、認証情報の更新、再設定、削除を行えます。

トラブルシューティング

Feishu エラー 20029：リダイレクト URL が無効

開発設定 → セキュリティ設定で https://login.verdent.ai/passport/sso/callback が正確に追加されていることを確認します。

Client ID または Client Secret が無効と表示される

認証情報と基本情報から App ID と App Secret を再度コピーします。Secret をリセットした場合は最新の値を使用します。

ログイン時にアプリを利用できない

バージョン管理と公開でバージョンが公開済みか確認します。

ログイン後にメールが空になる

Feishu ディレクトリでメンバーに企業メールを追加してから再試行します。

Feishu SSO に移動しない

メールが設定済みドメインに一致し、Verdent で Feishu SSO が有効になっていることを確認します。

View as Markdown