何かを検索

SAP向けSCIM統合

Last Updated 3月 3, 2026
Share Article Copy link to clipboard

概要

WalkMe SCIMサービスプロバイダーでは、SCIM 2.0準拠のエンドポイントを使用して、プログラム的にユーザーやグループを管理できます。 WalkMeは、クロスドメインアイデンティティ管理システム（SCIM 2.0）仕様に基づくREST APIを公開します。

このAPIでは、次のことができます：

  • ユーザーとグループの作成、読み取り、更新、パッチ適用、削除を行います。
  • フィルターとページ付けを使用してユーザーとグループを検索対象にします。
  • WalkMeサービスプロバイダー、利用可能なスキーマ、リソースタイプに関する情報を取得します。

前提条件

  • WalkMeアカウントが必要です。
  • WalkMe管理センターでSCIM統合を作成し、認証情報を生成する必要があります。

SCIM統合の設定

注

組織でSCIMを有効にするには、WalkMe管理者である必要があります。

WalkMeでSCIMを有効にする

SCIMを有効にする前に、まずWalkMe管理センターでSCIM統合を作成する必要があります。

  1. WalkMe管理センターにサインインします

  2. SCIM統合ページに移動します。

  3. 「SCIM統合」を選択します。

    1. また、次の経由で直接移動することもできます：

      1. 米国：https://admin-us01.walkme.cloud.sap/scim

      2. EU：https://admin-eu01.walkme.cloud.sap/scim

  4. [+ SCIM統合を作成する]を選択します

  5. 「SCIM統合の作成」パネル：

    1. 統合を識別する統合名を入力します（例：「プロダクション」または「ステージング」）。

    2. 承認タイプを選択します。

      1. 基本認証：認証にユーザー名とパスワードを使用します。

      2. ベアラートークン：認証にベアラートークンを使用します。

  6. 「認証情報の生成」を選択します。

  1. 基本認証を選択した場合、ポップアップが開き、この統合のために生成された SCIM 認証情報が表示されます：

    1. SCIMベースURL：アイデンティティプロバイダーのSCIM設定のエンドポイントURL

    2. ユーザー名：認証用に自動生成されたユーザー名

    3. パスワード：認証用に自動生成されたパスワード

Notes

  • パスワードは1回のみ表示され、ポップアップを閉じた後は取得できません。
  • パスワードを忘れた場合、統合を削除し、新しい統合を作成する必要があります。

  1. 「完了」を選択して、WalkMeでSCIM統合の設定を完了します。

  1. ベアラートークンを選択した場合、ポップアップが開き、この統合のために生成されたSCIM認証情報が表示されます：

    1. SCIMベースURL：アイデンティティプロバイダーのSCIM設定のエンドポイントURL

    2. ベアラートークン：認証に使用されるセキュアトークン

  2. 「完了」を選択して、WalkMeでSCIM統合の設定を完了します。

SCIM 2.0 APIエンドポイントとパラメータ

このAPIは、SCIM 2.0を使用します。 詳細については、「SCIMコアスキーマ」（RFC 7643）を参照してください。

ベースURL

認証

すべてのリクエストには、HTTP基本認証またはベアラートークン認証が必要です：

  • 基本認証：

    • 承認：基本<base64（ユーザー名:パスワード）>

  • ベアラートークン：

    • 承認：生成された<ベアラトークン>

ユーザー管理

エンドポイント

  • /Users：ユーザーを作成（POST）またはユーザーリストを取得（GET）

  • /Users/{id}：ユーザーの取得（GET）、更新（PUT）、パッチ適用（PATCH）、または削除（DELETE）

GET /Users

オプションのフィルタリングやページ付けを使用してユーザーリストを取得します。

URLパラメータ：

  • startIndex：最初に返されるユーザーの1ベースのインデックス。 デフォルトは1です。 （オプション）

  • count：（オプション）ページごとに返すユーザーの番号（最大1000）。 デフォルトは1000です。 （オプション）

  • フィルター：SCIMフィルター式（オプション）

    • サポート対象演算子：eq、ne、co、sw、ew、gt、ge、lt、le、pr

注

並べ替えはサポートされていません（sortByおよびsortOrderパラメータは無視されます）。

▼レスポンス例 
{
 "スキーマ":["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
 「totalResults」：1、
 「itemsPerPage」：1000、
 「startIndex」：1、
 「リソース」：[
 {
 "id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"、
 "userName": "john.doe@example.com",
 「名前」：{
 "formatted": "John Doe",
 「familyName」：「Doe」、
 「givenName」：「ジョン」
 },
 "displayName": "John Doe",
 "active": true,
 "emails": [
 {
 "value": "john.doe@example.com",
 「タイプ」：「仕事」、
 「プライマリ」：真
 }
 ],
 "groups"：［］,
 "schemas"：[
 「urn:ietf:params:scim:schemas:core:2.0:User」、
 「urn:ietf:params:scim:schemas:extension:sap:2.0:User」
 ],
 "urn:ietf:params:scim:schemas:extension:sap:2.0:User"：{
 "userUuid"："b2c3d4e5-f6a7-8901-bcde-f23456789012"
 },
 「メタ」：{
 「resourceType」:「ユーザー」、
 「場所」："/Users/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 「作成」:「2025-12-02T11:30:23Z」
 "lastModified"："2025-12-02T11:30:23Z",
 「バージョン」：「1.0」
 }
 }
 ]
}

応答コード：

  • 200 OK：成功

  • 400 Bad Request：無効なリクエストまたはフィルター

  • 401 Unauthorized：無効な認証情報

  • 403 禁止：アクセスが拒否されました。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

POST /ユーザー

新しいユーザーを作成します。

必須属性：

  • ユーザー名：ユニークである必要があります（大文字と小文字を区別しません）。
  • メール：primary: true を付けたメールを少なくとも1つ含める必要があります。

自動生成された属性：

  • id：システム生成のUUID
  • urn:ietf:params:scim:schemas:extension:sap:2.0:User.userUuid：提供されていない場合、自動生成されます。
▼リクエスト本文の例 
{
 "schemas"：[
 「urn:ietf:params:scim:schemas:core:2.0:User」、
 「urn:ietf:params:scim:schemas:extension:sap:2.0:User」
 ],
 "userName": "john.doe@example.com",
 「名前」：{
 "formatted": "John Doe",
 「familyName」：「Doe」、
 「givenName」：「ジョン」
 },
 "displayName": "John Doe",
 "emails": [
 {
 "value": "john.doe@example.com",
 「タイプ」：「仕事」、
 「プライマリ」：真
 }
 ],
 「active」：true
}

応答コード：

  • 201 Created：ユーザーが作成されました。

  • 400 不正リクエスト：必須属性が不足しているか、値が無効です。

  • 401 Unauthorized：無効な認証情報

  • 409 矛盾：ユーザー名はすでに存在します。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

GET/Users/{id}

ID（UUID）で特定のユーザーを取得します。

パスパラメータ：

  • id：ユーザーUUID（ユーザー名ではない）

応答コード：

  • 200 OK：成功
  • 401 Unauthorized：無効な認証情報
  • 404 見つかりません：ユーザーは存在しません。
  • 429 リクエストが多すぎる：レート制限を超過しました。
  • 500内部サーバーエラー

PUT /Users/{id}

すべてのユーザー属性を置き換えます。 読み取り専用属性は保持され、変更できません。

パスパラメータ：

id：ユーザーUUID（ユーザー名ではない）

応答コード：

  • 200 OK：ユーザーが正常に更新されました。

  • 400 Bad Request：無効なリクエスト

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：ユーザーは存在しません。

  • 409 Conflict：userName の重複

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

PATCH/Users/{id}

パスパラメータ：

  • id：ユーザーUUID（ユーザー名ではない）

サポートされている操作：

  • 追加、置換、削除

▼リクエスト本文の例 
{
 "schemas"：["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
 "Operations"：[
 {
 "op"："replace",
 "path"："active",
 「値」：偽
 },
 {
 "op"："add",
 「パス」：「メール」、
 「値」：[
 {
 「値」：「secondary@example.com」、
 「タイプ」：「ホーム」
 }
 ]
 }
 ]
}

応答コード：

  • 200 OK：ユーザーが正常に更新されました。

  • 400 Bad Request：無効な操作またはパス

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：ユーザーは存在しません。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

DELETE /Users{id}

ユーザーを削除します。

パスパラメータ：

  • id：ユーザーUUID（ユーザー名ではない）

注

ユーザーが削除されると、割り当てられたすべてのグループから自動的に削除されます。

応答コード：

  • 204 コンテンツなし：ユーザーが正常に削除されました。

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：ユーザーは存在しません。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

グループ管理

エンドポイント

  • /グループ：グループを作成（POST）またはグループのリストを取得（GET）

  • /グループ/{id}：グループの取得（GET）、更新（PUT）、パッチ適用（PATCH）、または削除（DELETE）

GET/グループ

オプションのフィルターとページネーションを備えたグループのリストを取得します。

URLパラメータ：

  • startIndex：返される最初のグループの1ベースのインデックス。 デフォルトは1です。 （オプション）

  • count：ページごとに返されるグループの番号（最大1000）。 デフォルトは1000です。 （オプション）

  • filter：特定のグループを検索対象とするために使用されるSCIMフィルター式。 デフォルトはなしです。 （オプション）

▼リクエスト例 
GET /Groups?filter=displayName sw "Sales"&count=50
▼レスポンス例 
{
 "スキーマ":["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
 「totalResults」：1、
 「itemsPerPage」：1000、
 「startIndex」：1、
 「リソース」：[
 {
 "id"："d737377c-f8ba-4df7-b290-78b9a2bff8e9",
 "displayName"："Sales Team",
 「メンバー」：[
 {
 "value"："a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 「$ref」："/Users/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 「タイプ」：「ユーザー」
 }
 ],
 "スキーマ":["urn:ietf:params:scim:schemas:core:2.0:Group"],
 「メタ」：{
 「resourceType」：「グループ」、
 「場所」："/Groups/d737377c-f8ba-4df7-b290-78b9a2bff8e9",

応答コード：

  • 200 OK：成功
  • 400 Bad Request：無効なフィルター
  • 401 Unauthorized：無効な認証情報
  • 429 リクエストが多すぎる：レート制限を超過しました。
  • 500内部サーバーエラー

POST /グループ

新しいグループを作成します。

URLパラメータ：

  • displayName：人間が読める名前（必須ではない、ユニークではない - 複数のグループが同じ名前を持つことができます）（必須）

  • メンバー：メンバーオブジェクトの配列（オプション）

▼リクエスト本文の例 
{
 "スキーマ":["urn:ietf:params:scim:schemas:core:2.0:Group"],
 「displayName」：「エンジニアリングチーム」、
 「メンバー」：[
 {
 "value"："a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 「タイプ」：「ユーザー」
 }
 ]
}
▼レスポンス例 
{
 "id":"e8f9a0b1-c2d3-4567-89ab-cdef01234567"、
 「displayName」：「エンジニアリングチーム」、
 「メンバー」：[
 {
 "value"："a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 「$ref」："/Users/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 「タイプ」：「ユーザー」
 }
 ],
 "スキーマ":["urn:ietf:params:scim:schemas:core:2.0:Group"],
 「メタ」：{
 「resourceType」：「グループ」、
 「場所」："/Groups/e8f9a0b1-c2d3-4567-89ab-cdef01234567",
 「作成」:「2025-12-02T11:30:23Z」
 "lastModified"："2025-12-02T11:30:23Z",
 「バージョン」：「1.0」
 }
}

応答コード：

  • 201 Created：グループが正常に作成されました。

  • 400 Bad Request：無効なリクエスト

  • 401 Unauthorized：無効な認証情報

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

GET/グループ/{id}

UUIDで特定のグループを取得します。

パスパラメータ：

  • id：グループUUID

応答コード：

  • 200 OK：成功

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：グループは存在しません。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

PUT/グループ/{id}

メンバーを含むすべてのグループ属性を置き換えます。

パスパラメータ：

  • id：グループUUID

応答コード：

  • 200 OK：グループが正常に更新されました。

  • 400 Bad Request：無効な操作

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：グループは存在しません。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

PATCH /グループ/{id}

グループを部分的に更新します。 メンバーの追加/削除に一般的に使用されます。

パスパラメータ：

id - グループUUID

▼リクエスト本文の例：グループにメンバーを追加 
{
 "schemas"：["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
 "Operations"：[
 {
 "op"："add",
 「パス」：「メンバー」、
 「値」：[
 {
 "value":"user-uuid-here"、
 「タイプ」：「ユーザー」
 }
 ]
 }
 ]
}
▼リクエスト本文の例：グループからメンバーを削除します。 
{
 "schemas"：["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
 "Operations"：[
 {
 "op"："削除"、
 "path"： "members[value eq \"user-uuid-here\"]"
 }
 ]
}

応答コード：

  • 200 OK：グループが正常に更新されました。

  • 400 Bad Request：無効な操作

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：グループは存在しません。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

DELETE/グループ/{id}

グループを削除します。

パスパラメータ：

  • id：グループUUID

応答コード：

  • 204 コンテンツなし：グループを正常に削除しました。

  • 401 Unauthorized：無効な認証情報

  • 404 見つかりません：グループは存在しません。

  • 429 リクエストが多すぎる：レート制限を超過しました。

  • 500内部サーバーエラー

サービスプロバイダー情報

エンドポイント

  • /ServiceProviderConfig：サービスプロバイダーに関する情報を取得します。

  • /スキーマ：ユーザーとグループ管理に使用されるスキーマに関する情報を取得します。

GET /ServiceProviderConfig

SCIMサービスプロバイダーの機能に関する情報を取得します。

▼レスポンス例 
{
 "スキーマ":["urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig"],
 「パッチ」：{
 「サポート」：真
 },
 「バルク」：{
 "supported"： false
 },
 「フィルター」：{
 "supported"： true,
 「maxResults」：1000
 },
 「changePassword」：{
 "supported"： false
 },
 「sort」：{
 "supported"： false
 },
 「etag」：{
 "supported"： false
 },
 「認証スキーム」：[
 {
 "name":"HTTP Basic"、
 「説明」：「基本認証スキーム」、
 「specUri」：「https://www.ietf.org/rfc/rfc2617」、
 "primary": true,
 「タイプ」：「基本認証」
 }
 ],
 「メタ」：{
 「場所」："/ServiceProviderConfig",
 「resourceType」：「ServiceProviderConfig」
 }
}

GET/スキーマ

サポートされているすべてのSCIMスキーマに関する情報を取得します。

サポートされているスキーマ：

  • urn:ietf:params:scim:schemas:core:2.0:User

  • urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

  • urn:ietf:params:scim:schemas:extension:sap:2.0:User

  • urn:ietf:params:scim:schemas:core:2.0:グループ

この記事は役に立ちましたか？

はい いいえ
はい
いいえ
ご意見ありがとうございます！

関連記事

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×