本文介紹綁定飛書的操作步驟和常見用法。
實現場景
綁定飛書后，您可以使用下述能力。
分類 | 實現能力 |
賬戶 |
|
登錄 |
|
綁定飛書
在身份提供方菜單中，單擊，即可開始綁定流程。
第一步：應用權限配置
飛書對應用權限有較為細致的要求，部分權限需要管理員審批并發布應用后才可生效，您可能需要企業其他管理員協助。缺少權限將無法使用數據同步等能力，建議完成本步驟權限配置后，再進行后續綁定操作。
1、創建飛書應用
前往飛書開放平臺，登錄開發者后臺。在開發者后臺中創建企業自建應用。
完成創建后，將自動進入飛書應用詳情頁。點擊菜單，獲取 App ID 和 App Secret，并填寫到 IDaaS 中。
2、分配飛書 API 權限
在飛書應用詳情頁，點擊菜單，在 API 權限中，分別進行如下授權。這些均屬于通訊錄的查詢權限，以實現數據同步和用戶登錄。
權限名稱 | 權限值 | 特殊說明 |
獲取通訊錄基本信息 | contact:contact.base:readonly | -- |
獲取用戶 user ID | contact:user.employee_id:readonly | -- |
獲取部門基礎信息 | contact:department.base:readonly | -- |
獲取通訊錄部門組織架構信息 | contact:department.organize:readonly | 申請權限后需提交版本發布申請并通過審核才可生效 |
獲取用戶基本信息 | contact:user.base:readonly | -- |
獲取用戶組織架構信息 | contact:user.department:readonly | 申請權限后需提交版本發布申請并通過審核才可生效 |
獲取用戶郵箱信息 | contact:user.email:readonly | 該權限非強制要求，只有您希望同步該字段數據到 IDaaS 時才需分配 |
獲取用戶手機號 | contact:user.phone:readonly | 申請權限后需提交版本發布申請并通過審核才可生效 該權限非強制要求，只有您希望同步該字段數據到 IDaaS 時才需分配 |
提交發布申請后，將在飛書中通知管理員，管理員需要在飛書管理后臺中進行審核。
3、分配飛書數據權限
在中，選擇通訊錄權限范圍進行數據權限授權。這個范圍決定哪些用戶、組織數據可以同步到 IDaaS 并使用飛書登錄。
4、在 IDaaS 中提交
完成上述權限配置后，在 IDaaS 中點擊，IDaaS 將檢查對應的 API 權限和數據權限。具備所有必需的權限后，即可進入到下一步。
第二步：開發配置
1、填寫基礎信息
填寫顯示名稱和企業編號等基礎信息。
企業編號需要在飛書管理后臺中獲取。
2、配置開發信息
重定向 URL：該地址用于處理用戶登錄請求。請在飛書應用詳情的中填入 URL。
應用主頁：如果您希望用戶在飛書工作臺中可以免登到 IDaaS 用戶門戶，則需要配置該主頁。請在飛書應用詳情的中，添加。
完成添加后，在桌面端主頁和移動端主頁中填入該 URL。
若您希望網絡有請求 IP 限制，請復制 IDaaS 的出口 IP 列表，加入飛書中，通過填寫。
通過專屬端點，您也可以使用專屬的 IP 實現飛書的數據同步和委托認證，專屬端點介紹請參考：網絡端點
完成配置后，點擊下一步。
第三步：選擇場景
在第三步中，選擇希望使用的場景能力。
能力說明
同步目標：飛書的通訊錄數據將會導入到 IDaaS 的這個節點之下。
定時校驗：IDaaS將于每日凌晨自動全量同步企業微信來源節點下的全量數據。未來將支持增量同步能力。
您可以在字段映射中設置映射標識，使用 IDaaS 賬戶的某個字段（如賬戶名）與飛書用戶的某個字段（如
userid）進行匹配，如果匹配成功，將綁定并覆蓋更新；否則將創建 IDaaS 賬戶。如果需要及時同步數據，請手動觸發全量同步。
IDaaS 內置了同步保護能力， 當 30 個以上的賬戶或 10 個以上的組織需要被刪除時，自動取消同步任務，以防止數據被誤刪除。建議根據企業規模調整同步保護設置。
掃碼登錄：開啟后，會在登錄菜單中創建飛書掃碼登錄，并處于啟用狀態，可直接掃碼登錄。如果在上一步配置了應用主頁，則支持在飛書工作臺中免登到 IDaaS。
第四步：字段映射
如果您在 IDaaS 中已存在存量數據，需要飛書成員/部門和IDaaS賬戶/組織綁定，或者希望使用飛書中成員的某些字段數據作為 IDaaS 賬戶的數據，例如將飛書用戶的姓名作為IDaaS賬戶的顯示名，則需要在第四步配置字段映射。
飛書中的用戶 ID（即userid）作為飛書用戶的唯一標識，可以被修改。由于此字段是 IDaaS 能唯一依賴的主鍵，如果該字段被修改，將導致對應的 IDaaS 賬戶被刪除并重新創建，請謹慎修改。
管理飛書身份提供方
完成綁定后，會自動跳轉到身份提供方菜單中。您可在此處對與身份提供方聯動的不同功能進行管理。
