#認証：Feishu / Lark

#はじめに

Feishu / Lark プラグインは、Feishu または Lark アカウントで NocoBase にログインでき、オプションで自動ログイン（サイレントログイン）に対応します。

#プラグインを有効にする

Feishu / Lark は商用プラグインです。ユーザー認証プラグインとともに、プラグインマネージャーでインストールして有効化してください。

#オープンプラットフォームでアプリを作成

Feishu オープンプラットフォームで企業自社アプリを作成します（Lark の場合は Lark オープンプラットフォーム）。App ID と App Secret を控えてください。

ログインに追加の API 権限は不要です。連絡先同期については Feishu からユーザーデータを同期するを参照してください。

#リダイレクト URL の設定

アプリのセキュリティ設定 → リダイレクト URL に、NocoBase が表示するコールバック URL を追加します：

https://あなたのドメイン/api/feishu:redirect

NocoBase の認証器設定画面に表示されるリダイレクト URL をそのままコピーするのが最も簡単です。

#NocoBase に Feishu 認証を追加

ユーザー認証ページで Feishu / Lark 認証器を追加します：

#ユーザー一意識別子フィールドの選択

ユーザーがログインした後はこの選択を変更しないでください。ユーザーデータ同期を使う場合、同期ソースでも同じフィールドを選択してください。

#ログインと自動登録

ログインページで Feishu / Lark ボタンをクリックして OAuth ログインを完了します。自動登録が有効な場合：

• ユーザー一意識別子フィールドでユーザーを照合または作成します；
• 電話番号・メール・ニックネームはプロフィールが空の場合のみ補完され、既存の値は上書きされません。

#自動ログイン

自動ログインを有効にすると、Feishu クライアント内でアプリを開いた際にログインボタンを押さず OAuth ログインが自動で始まります。同時に有効にできる Feishu 認証器は 1 つだけです。

条件：

• コールバック URL がリダイレクト URL のホワイトリストに含まれている；
• アプリが公開済みで、ユーザーが利用可能範囲内にいる；
• Feishu クライアント内でアプリを開いている。

初回のみ Feishu の確認ページが表示され、以降はサイレントにログインします。システムブラウザでは自動ログインは動作しません。これは仕様です。

#Feishu ワークベンチ入口（任意）

オープンプラットフォームのアプリ機能 → ウェブアプリでデスクトップ／モバイルのホームページを設定すると、Feishu のワークベンチから直接 NocoBase を開けます。URL は実際の NocoBase アドレス（サブパスプレフィックスを含む）と一致させてください。