> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SCIM ディレクトリ統合

> Iru Endpoint で SCIM ベースのユーザーディレクトリ同期を設定します。ID プロバイダーからユーザーとグループを自動的にプロビジョニングおよびプロビジョニング解除します。

### SCIM ディレクトリ統合について

SCIM ([System for Cross-domain Identity Management](https://scim.cloud/)) は、異なるシステム間でのユーザー ID の管理をよりシンプルかつ効率的にするために設計されたプロトコルです。ユーザーの追加と削除のプロセスを自動化するのに役立つため、複数のクラウドベースのアプリケーションを使用している場合に特に便利です。

### 仕組み

SCIM には 2 つの主要な役割があります。

* **クライアント** - 通常は、コアとなる ID データを管理する Microsoft Entra ID や Okta などの ID プロバイダーまたは ID アクセス管理システムです。
* **サービスプロバイダー** - ID データを使用してユーザーのアクセスと権限を管理する、Iru Endpoint などの SaaS (Software as a Service) アプリケーションです。

SCIM は、プロビジョニング、同期、プロビジョニング解除などのいくつかの操作をサポートしています。この一方向の同期により、Iru Endpoint でユーザーアカウントを自動的に作成し、MDM と IdP の間でユーザー属性を最新の状態に保ち、不要になったユーザーアカウントを自動的に削除または無効化できます。

### Iru Endpoint で SCIM を構成する

ID プロバイダー (IdP) と Iru Endpoint の間で SCIM 統合を構成するには、次の作業が必要です。

* Iru Endpoint で新しい SCIM ディレクトリ統合を作成する
* IdP で使用するために、Iru Endpoint から SCIM API URL と API トークンを取得する
* IdP にアクセスしてアプリ統合を作成し、SCIM 属性をマッピングして、目的のユーザーグループをプッシュする

#### 新しい SCIM ディレクトリ統合を作成する

<Steps>
  <Step title="インテグレーションを開く">
    Iru Endpoint のサイドバーで [**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択し、**インテグレーション** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Integrations オプションが強調表示されたアカウントメニューのスクリーンショット" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="すべての統合を参照する">
    Integrations ページの右上にある **すべてのインテグレーションを参照** を選択します。
  </Step>

  <Step title="Directory integrations でフィルタリングする">
    **Directory integrations** フィルターにチェックを入れます。
  </Step>

  <Step title="SCIM protocol を選択する">
    **SCIM protocol** タイルを選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/mFx4MUIljla7jvxs/assets/media/images/iru-integrations-add-scim.png?fit=max&auto=format&n=mFx4MUIljla7jvxs&q=85&s=336ae459ab0810c8d899d6abecb96ad9" alt="SCIM protocol タイルが表示された新しい統合の追加ページ" width="2126" height="1354" data-path="assets/media/images/iru-integrations-add-scim.png" />
    </Frame>
  </Step>

  <Step title="構成を開始する">
    **開始する** を選択します。
  </Step>

  <Step title="統合に名前を付ける">
    SCIM 統合の一意の名前を入力します。
  </Step>

  <Step title="認証トークンを生成する">
    **トークンを生成** を選択します。SCIM ユーザーディレクトリ統合は、認証方法として Bearer トークンを含む HTTP 認証ヘッダーを使用します。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-name.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cf4df5d3d63147de7739024f71f94bf8" alt="名前フィールドと トークンを生成 ボタンが表示された SCIM ユーザー統合の構成画面" width="1898" height="1258" data-path="assets/media/images/iru-scim-name.png" />
    </Frame>
  </Step>

  <Step title="トークンをコピーする">
    **Copy token** を選択します。
  </Step>

  <Step title="トークンのコピーを確認する">
    Done を選択した後は、トークンは再表示されません。続行する前に安全に保管してください。
  </Step>

  <Step title="セットアップを完了する">
    チェックボックスをオンにしてトークンをコピーしたことを確認し、**完了** を選択します。**インテグレーション** ページに戻ります。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c31e71ca70b13bd8db22047685ff47ae" alt="Copy token ボタンが表示された、トークンをコピーして ID プロバイダーで構成するためのダイアログ" width="1912" height="1262" data-path="assets/media/images/iru-scim-copy-token.png" />
    </Frame>
  </Step>
</Steps>

#### SCIM API URL を取得する

SCIM API URL は、Iru Endpoint の統合の詳細から確認できます。SCIM 接続を構成する際に、この URL を ID プロバイダーに提供する必要があります。

<Steps>
  <Step title="統合の詳細にアクセスする">
    作成した SCIM ディレクトリ統合の**省略記号**を選択します。
  </Step>

  <Step title="詳細を表示する">
    **View Details** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-view-details.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=72a2ce0cf83d041f18caa066996ffd4f" alt="SCIM 統合と、View details、Rename、Rotate token、Delete が表示された省略記号メニューを含むディレクトリ統合の一覧" width="876" height="492" data-path="assets/media/images/iru-scim-view-details.png" />
    </Frame>
  </Step>

  <Step title="API URL をコピーする">
    SCIM API URL (例: `https://subdomain.api.iru.com/api/v1/scim`) を **コピー** します。これは ID プロバイダーで必要になります。

    <Note>テナントに表示される URL には、まだ `api.kandji.io` ドメインが表示されている場合があります。`api.kandji.io` バージョンの SCIM API URL もこの目的で使用できます。</Note>
  </Step>

  <Step title="詳細を閉じる">
    **閉じる** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-api-url.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f826bc146ef440fff34093ffeb0202d6" alt="SCIM API URL とコピーボタンが表示されたユーザー統合の詳細表示モーダル" width="1258" height="804" data-path="assets/media/images/iru-scim-copy-api-url.png" />
    </Frame>
  </Step>
</Steps>

### SCIM 統合の名前を変更する

既存の SCIM ディレクトリ統合の名前を変更するには、次の手順を実行します。

<Steps>
  <Step title="統合メニューを開く">
    名前を変更したい SCIM ディレクトリ統合の**省略記号**を選択します。
  </Step>

  <Step title="Rename を選択する">
    **Rename** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-rename.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=23ec71b5a32fe4f4c79dbc3b0fb3d573" alt="Rename オプションが表示された SCIM 統合の省略記号メニュー" width="876" height="502" data-path="assets/media/images/iru-scim-rename.png" />
    </Frame>
  </Step>

  <Step title="新しい名前を入力する">
    統合の新しい名前を入力して保存します。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rename-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8bce3f3a702cc1044918b75de8937961" alt="名前フィールドが表示された SCIM 統合の名前変更プロンプトまたはダイアログ" width="1270" height="674" data-path="assets/media/images/iru-scim-rename-prompt.png" />
    </Frame>
  </Step>
</Steps>

### SCIM トークンをローテーションする

現在のトークンを無効にする必要がある場合 (たとえば、セキュリティ上の懸念が生じた後や、IdP で再構成した場合) は、SCIM API トークンをローテーションします。ローテーション後、ID プロバイダーで新しいトークンに更新してください。

<Steps>
  <Step title="統合メニューを開く">
    SCIM ディレクトリ統合の**省略記号**を選択します。
  </Step>

  <Step title="Rotate token を選択する">
    **Rotate token** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f8f63aedfd798b4a2c0d08f6d96f5cbc" alt="Rotate token オプションが表示された SCIM 統合の省略記号メニュー" width="1160" height="534" data-path="assets/media/images/iru-scim-rotate-token.png" />
    </Frame>
  </Step>

  <Step title="ローテーションを確認する">
    プロンプトでローテーションを確認します。以前のトークンは使用できなくなります。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8a4ba4bc590415c8380c2a21848455ac" alt="SCIM 統合のトークンローテーションの確認プロンプト" width="1106" height="674" data-path="assets/media/images/iru-scim-rotate-prompt.png" />
    </Frame>
  </Step>

  <Step title="新しいトークンをコピーする">
    新しいトークンをコピーし、IdP で更新します。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-new-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=12bfb79182832a84389e2f1d57f67013" alt="ローテーション後の新しい SCIM トークンのコピー" width="1098" height="1282" data-path="assets/media/images/iru-scim-copy-new-token.png" />
    </Frame>
  </Step>
</Steps>

### SCIM 統合を削除する

SCIM ディレクトリ統合を削除すると、IdP からの同期が停止し、Iru Endpoint から統合が削除されます。エラーを避けるため、IdP の SCIM アプリを更新または削除してください。

<Steps>
  <Step title="統合メニューを開く">
    削除したい SCIM ディレクトリ統合の**省略記号**を選択します。
  </Step>

  <Step title="Delete integration を選択する">
    **Delete integration** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-delete-integration.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=f540e04a54a5ab4db9060b2aa9b6d599" alt="Delete integration オプションが表示された SCIM 統合の省略記号メニュー" width="868" height="496" data-path="assets/media/images/iru-scim-delete-integration.png" />
    </Frame>
  </Step>

  <Step title="削除を確認する">
    プロンプトで統合を削除することを確認します。

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-delete-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=fd94a0d15d035bb5c9b6468ef97b0662" alt="SCIM 統合の削除確認プロンプト" width="1108" height="728" data-path="assets/media/images/iru-scim-delete-prompt.png" />
    </Frame>
  </Step>
</Steps>

### SCIM スキーマとサポートされている属性

Iru Endpoint は次の SCIM 属性をサポートしています。IdP で SCIM アプリケーションをマッピングする際は、これらの属性を参照してください。

<Note>
  Iru Endpoint は、以下の一覧にない属性は使用しません。送信される属性を制限するには、IdP の SCIM アプリで構成されている属性を変更してください。
</Note>

**ユーザー属性**

| **属性** | **説明** | **必須** |
| - | - | - |
| userName | サービスプロバイダーへの認証に使用される、ユーザーの一意の識別子 | はい |
| name.formatted | ユーザーのフルネーム (例: 「John Doe」)。この属性または displayName 属性のいずれかが必須です | いいえ |
| displayName | ユーザーのフルネーム (例: 「John Doe」)。この属性または name.formatted 属性のいずれかが必須です | はい |
| title | 「Vice President」などのユーザーの役職。 | いいえ |
| active | ID プロバイダー内でのユーザーのステータス。この属性は ID プロバイダーによって自動的に追加されます。 | はい |
| emails.value | emails のサブ属性としてのユーザーのメールアドレス。Iru Endpoint は一覧の最初のメールのみを保存します。 | はい |
| department | 部署の名前を示します。 | いいえ |

ユーザーの最初のプッシュで `active` が `false` に設定されている場合、Iru Endpoint はそのユーザーを停止状態で作成します。

**グループ属性**

| **属性** | **説明** | **必須** |
| - | - | - |
| displayName | グループの人が読める形式の名前。 | はい |
| members | グループのメンバーの一覧。 | はい |

SCIM を使用してディレクトリからユーザーを同期する場合、SCIM アプリが新しい情報を自動的に Iru Endpoint に送信するため、ネイティブの Entra ID または Google Workspace ディレクトリ統合を使用する場合に表示される Sync Now ボタンは必要ありません。各クラウド IdP には、SCIM データを同期するための独自の標準があります。

SCIM 同期の構成方法については、ID プロバイダーのドキュメントを確認してください。

### 関連記事

使用している IdP の記事を参照して、ID プロバイダーで SCIM を構成します。Iru Endpoint の SCIM 実装は SCIMv2 仕様に準拠しています。

<CardGroup cols={3}>
  <Card title="Okta との SCIM ディレクトリ統合" icon="key" href="/ja/endpoint/integrations/scim/scim-directory-integration-with-okta">
    SCIM を介したユーザーとグループの自動プロビジョニングのために、Okta を Iru Endpoint に接続します
  </Card>

  <Card title="Microsoft Entra ID との SCIM ディレクトリ統合" icon="microsoft" iconType="brands" href="/ja/endpoint/integrations/scim/scim-directory-integration-with-microsoft-entra-id">
    SCIM ベースのユーザーとグループのプロビジョニングのために、Microsoft Entra ID (旧 Azure AD) を Iru Endpoint に接続します
  </Card>

  <Card title="OneLogin との SCIM ディレクトリ統合" icon="key" href="/ja/endpoint/integrations/scim/scim-directory-integration-with-onelogin">
    SCIM を介したユーザーとグループの自動プロビジョニングのために、OneLogin を Iru Endpoint に接続します
  </Card>
</CardGroup>
