Scribble Maps 說明中心
變更語言

SCIM 佈建

設定 SCIM 使用者佈建

ScribbleMaps 支援 SCIM 2.0（跨網域身分管理系統），可自動佈建與取消佈建使用者。這可讓您自動將使用者從身分提供者 (IdP) 同步至 ScribbleMaps，確保團隊成員資格與貴組織的目錄保持同步。

SCIM 佈建可在 team.scribblemaps.com 使用，且完全免費。

目錄

  1. 什麼是 SCIM？
  2. 開始之前
  3. 步驟 1：在 ScribbleMaps 中啟用 SCIM
  4. 步驟 2：產生持有人權杖
  5. 步驟 3：設定您的身分提供者
  6. 步驟 4：設定預設產品指派
  7. 步驟 5：測試並指派使用者
  8. 各提供者專屬指南
  9. 支援的 SCIM 操作
  10. 使用者生命週期管理
  11. 疑難排解

什麼是 SCIM？

SCIM（跨網域身分管理系統）是一項開放標準，可讓您自動：

  • 佈建使用者 - 當使用者在您的 IdP 中被指派時，自動建立 ScribbleMaps 帳戶
  • 更新使用者 - 保持使用者資訊（姓名、電子郵件）同步
  • 取消佈建使用者 - 當使用者從您的 IdP 中移除時，自動停用帳戶
  • 管理角色 - 透過群組成員資格將使用者指派為管理員或成員角色

SCIM 可與 SSO（SAML/OIDC）搭配運作，提供完整的身分生命週期管理。

開始之前

  • 您必須是團隊擁有者才能設定 SCIM
  • 您需要能夠存取身分提供者的管理主控台
  • 您的 IdP 必須支援 SCIM 2.0（Okta、Microsoft Entra ID、OneLogin、JumpCloud 等）
  • 為獲得最佳使用者體驗，建議在設定 SCIM 之前先設定 SSO

步驟 1：在 ScribbleMaps 中啟用 SCIM

  1. 登入 team.scribblemaps.com
  2. 前往SCIM 佈建（左側邊欄）
  3. 將啟用 SCIM切換為開啟

附註：您需要先產生持有人權杖，才能完整啟用 SCIM。

步驟 2：產生持有人權杖

持有人權杖用於向 ScribbleMaps 驗證您的身分提供者。

  1. 在 SCIM 設定頁面上，點選產生權杖
  2. 立即複製權杖並妥善保存

重要保全附註：

  • 權杖只會顯示一次 - 如果遺失，您需要產生新的權杖
  • 請將此權杖視同密碼 - 任何持有權杖的人都可以管理您團隊的使用者
  • 如果權杖外洩，您可以隨時撤銷並重新產生
  • 撤銷權杖會立即停止所有 SCIM 操作，直到設定新的權杖為止

步驟 3：設定您的身分提供者

請使用下列詳細資料，在您的 IdP 中將 ScribbleMaps 設定為 SCIM 應用程式：

設定 值
SCIM 基本 URL https://api.scribblemaps.com/scim/v2
驗證方法 HTTP 標頭 / 持有人權杖
授權標頭 Bearer YOUR_TOKEN_HERE
唯一識別碼 userName（電子郵件地址）

SCIM 端點參考

端點 用途
/scim/v2/Users 使用者佈建與管理
/scim/v2/Groups 角色/群組成員資格管理
/scim/v2/ServiceProviderConfig SCIM 功能（探索）
/scim/v2/ResourceTypes 支援的資源類型（探索）
/scim/v2/Schemas 使用者與群組結構描述（探索）

步驟 4：設定預設產品指派（選用）

您可以在使用者透過 SCIM 佈建時，自動指派產品授權：

  1. 在 SCIM 設定頁面上，找到預設產品指派
  2. 選取產品：
    • 無 - 建立使用者時不附帶產品（稍後再手動指派）
    • 檢視者 - 僅限檢視的存取權
    • 專業版 Basic - 標準編輯功能
    • 專業版 Business - 完整功能存取權
  3. 點選儲存

附註：只有在有可用席位時，使用者才會被指派產品。如果沒有可用席位，使用者仍會被建立，但不會被指派。

步驟 5：測試並指派使用者

  1. 在您的身分提供者中，使用測試連線功能來驗證 SCIM 連線
  2. 在您的 IdP 中，將測試使用者指派給 ScribbleMaps 應用程式
  3. 確認該使用者出現在您的 ScribbleMaps 團隊成員清單中
  4. 確認無誤後，視需要指派其他使用者或群組

各提供者專屬指南

Okta

  1. 在 Okta 管理主控台中，前往應用程式 > 瀏覽應用程式目錄
  2. 搜尋「SCIM 2.0 Test App (Header Auth)」，或建立自訂 SCIM 應用程式
  3. 前往佈建索引標籤 > 設定 API 整合
  4. 勾選啟用 API 整合
  5. 設定：
    • SCIM 2.0 基本 URL：https://api.scribblemaps.com/scim/v2
    • OAuth 持有人權杖：貼上您的 ScribbleMaps SCIM 權杖
  6. 點選測試 API 認證以進行驗證
  7. 前往佈建 > 至應用程式並啟用：
    • 建立使用者
    • 更新使用者屬性
    • 停用使用者
  8. 前往指派索引標籤以指派使用者或群組

Microsoft Entra ID (Azure AD)

  1. 在 Azure 入口網站中，前往 Microsoft Entra ID > 企業應用程式
  2. 選取您的 ScribbleMaps 應用程式（或建立一個）
  3. 前往佈建 > 開始使用
  4. 將佈建模式設定為自動
  5. 在管理員認證下：
    • 租用戶 URL：https://api.scribblemaps.com/scim/v2
    • 祕密權杖：貼上您的 ScribbleMaps SCIM 權杖
  6. 點選測試連線以進行驗證
  7. 設定使用者屬性的對應
  8. 將佈建狀態設定為開啟
  9. 前往使用者和群組以指派使用者

OneLogin

  1. 在 OneLogin 管理中，前往應用程式 > 新增應用程式
  2. 搜尋「SCIM Provisioner with SAML (SCIM v2 Core)」或類似項目
  3. 前往設定索引標籤
  4. 設定：
    • SCIM 基本 URL：https://api.scribblemaps.com/scim/v2
    • SCIM 持有人權杖：貼上您的 ScribbleMaps SCIM 權杖
  5. 前往佈建索引標籤並啟用佈建
  6. 前往使用者索引標籤以指派使用者

JumpCloud

  1. 在 JumpCloud 管理中，前往 SSO 應用程式
  2. 點選 + 以新增應用程式
  3. 選取自訂 SCIM
  4. 設定：
    • 基本 URL：https://api.scribblemaps.com/scim/v2
    • 權杖金鑰：貼上您的 ScribbleMaps SCIM 權杖
    • 驗證：持有人權杖
  5. 點選測試連線
  6. 設定屬性對應
  7. 將使用者群組指派給應用程式

支援的 SCIM 操作

使用者操作

操作 方法 是否支援 說明
列出使用者 GET /Users 是 擷取所有使用者，支援分頁與篩選
取得使用者 GET /Users/{id} 是 依 ID 擷取特定使用者
建立使用者 POST /Users 是 佈建新使用者
取代使用者 PUT /Users/{id} 是 完整更新使用者屬性
更新使用者 PATCH /Users/{id} 是 部分更新使用者屬性
刪除使用者 DELETE /Users/{id} 是 停用使用者（軟刪除）

群組操作

操作 方法 是否支援 說明
列出群組 GET /Groups 是 傳回管理員與成員角色群組
取得群組 GET /Groups/{id} 是 擷取群組及其成員清單
更新群組 PATCH /Groups/{id} 是 在角色群組中新增/移除成員
建立群組 POST /Groups 否 不支援（角色為固定）

支援的使用者屬性

SCIM 屬性 ScribbleMaps 欄位 必填
userName 電子郵件地址 是
externalId 外部 IdP 識別碼 否
name.givenName 名字 否
name.familyName 姓氏 否
displayName 顯示名稱 否
active 帳戶狀態 否
emails[].value 電子郵件地址 否

支援的篩選條件

篩選 範例
依電子郵件篩選 userName eq "[email protected]"
依外部 ID 篩選 externalId eq "12345"
依狀態篩選 active eq true

使用者生命週期管理

當使用者被佈建時

  1. ScribbleMaps 中會建立新的團隊成員帳戶
  2. 使用者資訊（姓名、電子郵件）會從您的 IdP 填入
  3. 如果已設定預設產品且有可用席位，系統會自動指派授權
  4. 使用者可立即透過 SSO 登入（若已設定）

當使用者被更新時

  1. 使用者屬性（姓名、顯示名稱）會更新以符合您的 IdP
  2. 電子郵件變更會同步（除非使用者已連結其帳戶）

當使用者被取消佈建時

  1. 使用者的帳戶會被停用（軟刪除）
  2. 所有產品授權都會被移除，釋出席位
  3. 所有作用中的工作階段會立即失效
  4. 使用者無法再登入
  5. 使用者資料與地圖會保留（不會被刪除）
  6. 如果使用者重新被佈建，帳戶可以重新啟用

透過群組進行角色管理

ScribbleMaps 透過 SCIM 提供兩個角色群組：

群組 ID 角色 權限
admin 管理員 管理團隊設定、使用者與帳務
member 成員 標準團隊成員存取權

若要將使用者指派為管理員，請透過 SCIM PATCH 將其新增至 admin 群組。擁有者角色無法透過 SCIM 修改。

疑難排解

常見問題

「401 Unauthorized」或「Invalid token」

  • 確認持有人權杖正確且未被撤銷
  • 確保權杖以 Bearer YOUR_TOKEN 的形式傳遞在 Authorization 標頭中
  • 檢查權杖是否已過期（若有設定到期日）
  • 如有需要，請產生新的權杖

「409 Conflict」- 使用者已存在

  • 您的團隊中已存在使用該電子郵件的使用者
  • 如果現有使用者已被停用，SCIM 會自動將其重新啟用
  • 檢查您的 IdP 中是否有重複的電子郵件地址

「400 Bad Request」- 缺少必填欄位

  • 確保要求中包含 userName（電子郵件）
  • 確認電子郵件格式有效
  • 檢查您 IdP 的屬性對應設定

使用者已建立但未指派產品

  • 檢查 SCIM 設定中是否已設定預設產品
  • 確認預設產品有可用席位
  • 可以在團隊設定中手動為使用者指派產品

使用者變更未同步

  • 部分 IdP 依排程同步（例如 Azure AD 每 40 分鐘一次）
  • 請嘗試在您的 IdP 中強制手動同步
  • 確認 SCIM 仍為啟用狀態且權杖有效

測試連線失敗

  • 確認 SCIM 基本 URL 精確為 https://api.scribblemaps.com/scim/v2
  • 確保沒有結尾斜線或拼字錯誤
  • 檢查您的網路/防火牆是否允許對 api.scribblemaps.com 的對外 HTTPS 連線
     

需要協助嗎？

如果您在使用 SCIM 佈建時遇到問題，請聯絡我們的支援團隊，並提供：

  • 您的團隊名稱
  • 您使用的身分提供者
  • 您 IdP 佈建記錄中的任何錯誤訊息
  • 您的 SCIM 設定的螢幕擷取畫面（請隱藏權杖）

我們隨時準備協助您為貴組織設定 SCIM 佈建。

最後更新