​
概要

Dify Enterprise Edition は、SCIM（System for Cross-domain Identity Management）標準プロトコルを通じて、既存の部門/人員構造の自動同期をサポートし、企業管理者が大規模な組織人員を効率的に管理できるよう支援します。

  • 標準 SCIM 2.0 プロトコルをサポート
  • ユーザー情報と組織構造を自動同期
  • 複数の主流 ID プロバイダーとの統合をサポート
  • メンバー変更のオンライン自動更新

​
設定前の準備

自動同期メカニズムを有効にする前に、以下の準備が必要です：

  1. システム管理者権限を取得
  2. 組織が使用している ID プロバイダーのタイプを理解し、バックエンド管理権限を持つ

​
設定手順

​
ステップ 1：SCIM 設定情報の取得

1

同期設定ページへのアクセス

エンタープライズ管理バックエンドに移動し、左側メニューバーの メンバー → 同期設定 をクリックします。

2

SCIM エンドポイント URL の取得

ページに表示されている SCIM 2.0 Base URL をコピーします。この URL は ID プロバイダーの設定に使用されます。

3

認証トークンの生成

  • 「トークンを取得」ボタンをクリック
  • システムが OAuth Bearer Token を生成します

認証トークンは一度だけ表示されます。すぐにコピーして安全に保存してください。紛失した場合は、新しいトークンを再生成する必要があります。

4

設定情報の保存

後続の設定のために以下の情報を適切に保存してください：

  • SCIM Base URL
  • OAuth Bearer Token

​
ステップ 2：ID プロバイダーの設定

組織が使用している ID プロバイダーに基づいて、適切な設定ガイドを選択してください：

Azure Active Directory

Azure AD と Dify 間のメンバー同期を設定

Okta

Okta と Dify 間のメンバー同期を設定

​
属性マッピング関係

Dify 機能と SCIM フィールドの属性マッピング関係：

SCIM リソースタイプDify 機能サポートされる操作追加説明
Userメンバー（ユーザーメール、ユーザー名、ユーザーステータス）作成 / 更新 / 無効化（無効化操作は実際にユーザーデータを削除せず、Dify Enterprise 内のメンバーのステータスを アクティブ から 無効 に変更するだけで、ユーザーデータは保持されます）
Groupグループ（名前、メンバー）作成 / グループ名の更新 / メンバーの更新 / 削除削除操作はグループとそのメンバー関係を永久に削除します

​
重要な注意事項

SCIM 同期を有効にした後、データの一貫性を確保するため、ID プロバイダー (IdP) がユーザーとグループ管理の唯一の権威あるソースになります。Admin API の使用制限に関する詳細情報については、エンタープライズ API ドキュメントを参照してください。

​
機能制限

SCIM 有効時：

  • ユーザーとグループ管理は ID プロバイダーを通じて完了する必要があります
  • Admin API は読み取り専用操作のみをサポート
  • メンバーの自己登録はサポートされません

SCIM 無効時：

  • Admin API の完全な管理権限が復元されます
  • すべてのユーザー管理操作がサポートされます

​
緊急操作ガイド

Admin API を通じて一時的な修正が必要な場合：

  1. SCIM を一時的に無効化
  2. 必要な API 操作を実行
  3. SCIM を再度有効化し、同期ステータスを確認

この操作はデータ同期の競合を引き起こす可能性があります。慎重に実行してください。

SCIM と Admin API の相互作用に関する技術的な詳細については、エンタープライズ API ドキュメントをご参照ください。