# Verdent Team で Feishu SSO を設定する (/ja/docs/account-billing/configure-feishu-sso)

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



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

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

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

## Feishu SSO の仕組み [#feishu-sso-の仕組み]

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

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

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

## 事前準備 [#事前準備]

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

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

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

## SSO 設定を開く [#sso-設定を開く]

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

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

## Feishu アプリを設定する [#feishu-アプリを設定する]

<Steps>
  <Step title="企業カスタムアプリを作成する">
    [Feishu Open Platform](https://open.feishu.cn/app) の**開発者コンソール**を開き、**企業カスタムアプリを作成**をクリックします。名前とアイコンを設定して作成します。
  </Step>

  <Step title="アプリの認証情報を取得する">
    **認証情報と基本情報**で App ID と App Secret を確認します。

    | Feishu         | Verdent SSO     |
    | -------------- | --------------- |
    | **App ID**     | `Client ID`     |
    | **App Secret** | `Client Secret` |

    <Warning>
      App Secret はパスワードとして扱ってください。Feishu でリセットした場合は、Verdent の 

      `Client Secret`

       も更新します。
    </Warning>
  </Step>

  <Step title="リダイレクト URL を追加する">
    **開発設定 → セキュリティ設定**で次の**リダイレクト URL**を追加します。

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

    <Warning>
      URL は完全に一致させてください。

      `https`

       を使用し、末尾に 

      `/`

       や空白を追加しないでください。誤りがあると Feishu エラー 

      `20029`

       が発生します。
    </Warning>
  </Step>

  <Step title="権限を付与する">
    **開発設定 → 権限管理**で次の権限を付与します。

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

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

  <Step title="アプリを公開する">
    **バージョン管理と公開**でバージョンを作成し、公開を申請します。公開後にメンバーが利用できます。
  </Step>
</Steps>

## Verdent で接続を完了する [#verdent-で接続を完了する]

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

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

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

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

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

## メンバーのログイン手順 [#メンバーのログイン手順]

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

## 設定をテスト・管理する [#設定をテスト管理する]

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

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

## トラブルシューティング [#トラブルシューティング]

<AccordionGroup>
  <Accordion title="Feishu エラー 20029：リダイレクト URL が無効">
    **開発設定 → セキュリティ設定**で `https://login.verdent.ai/passport/sso/callback`
    が正確に追加されていることを確認します。
  </Accordion>

  <Accordion title="Client ID または Client Secret が無効と表示される">
    **認証情報と基本情報**から App ID と App Secret を再度コピーします。Secret
    をリセットした場合は最新の値を使用します。
  </Accordion>

  <Accordion title="ログイン時にアプリを利用できない">
    **バージョン管理と公開**でバージョンが公開済みか確認します。
  </Accordion>

  <Accordion title="ログイン後にメールが空になる">
    Feishu ディレクトリでメンバーに企業メールを追加してから再試行します。
  </Accordion>

  <Accordion title="Feishu SSO に移動しない">
    メールが設定済みドメインに一致し、Verdent で Feishu SSO が有効になっていることを確認します。
  </Accordion>
</AccordionGroup>