# SCIM

**SCIM** (System for Cross-domain Identity Management、クロスドメインID管理システム) は、ユーザーのプロビジョニングを自動化します。Chamilo アカウントの作成、更新、無効化を、アイデンティティプロバイダーの変更に基づいて行います。OAuth2 や LDAP とは異なり、SCIM はプロビジョニングを扱い、ログインは扱いません。

| シナリオ            | SCIM のアクション              |
| --------------- | ------------------------ |
| 新しい従業員が入社する     | Chamilo アカウントを作成する       |
| 従業員の名前や役割が変更される | Chamilo アカウントを更新する       |
| 従業員が退職する        | Chamilo アカウントを無効化または削除する |

## 設定

### 1. SCIM トークンの設定

`.env`（または `.env.local`）ファイルに、安全なランダムトークンを定義します：

```
SCIM_TOKEN=your-secure-random-token
```

このトークンは、アイデンティティプロバイダーが Chamilo の SCIM エンドポイントへのリクエストを認証するために使用されます。

### 2. authentication.yaml で SCIM を有効化する

```yaml
authentication:
  1:
    scim:
      main:
        enabled: true
        auth_source: platform
```

編集後にキャッシュをクリアし、ウォームアップします：

```bash
php bin/console cache:clear && php bin/console cache:warmup
```

### 3. アイデンティティプロバイダーの設定

アイデンティティプロバイダー（Azure AD、Okta など）で以下の手順を行います：

1. Chamilo を SCIM アプリケーションとして追加する
2. SCIM ベース URL を `https://your-chamilo-url/scim/v2/` に設定する
3. 手順 1 で設定したトークンをベアラートークンとして入力する
4. プロバイダーの属性を SCIM 標準フィールド（userName、name.givenName、name.familyName、emails）にマッピングする
5. 自動プロビジョニングを有効化する

## SCIM エンドポイント

Chamilo は SCIM 2.0 を実装しています：

| エンドポイント               | メソッド   | アクション       |
| --------------------- | ------ | ----------- |
| `/scim/v2/Users`      | GET    | ユーザーを一覧表示する |
| `/scim/v2/Users`      | POST   | ユーザーを作成する   |
| `/scim/v2/Users/{id}` | GET    | ユーザーを取得する   |
| `/scim/v2/Users/{id}` | PUT    | ユーザーを置き換える  |
| `/scim/v2/Users/{id}` | PATCH  | ユーザーを更新する   |
| `/scim/v2/Users/{id}` | DELETE | ユーザーを削除する   |

## ヒント

* **テストグループから始める** — 組織全体に SCIM を有効化する前に、少数のユーザーをプロビジョニングしてテストしてください。
* **OAuth2 と組み合わせる** — 一般的な設定として、Azure AD OAuth2 をログインに、Azure AD SCIM をプロビジョニングに使用することがあります。
* **ログを監視する** — エラーがないか、Chamilo（`var/log/`）とアイデンティティプロバイダーのプロビジョニングログの両方を確認してください。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-ja/gaido-1/admin-guide/authentication/scim.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.