> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/enterprise-guide/jp/user-and-team-provisioning/duo-provisioning.md).

# DUOでのプロビジョニング

DUOプラットフォームを利用したSAML 2.0認証およびSCIMプロビジョニング

## **概要**

本ページでは、SCIMを使用したDUO自動プロビジョニングを取り扱います。設定を始める前に、まずリアルタイムなユーザー認証とジャストインタイム (JIT) プロビジョニングを実現するKeeperのSSOコネクトとDUOとの統合を有効にすることをお勧めします。

{% hint style="info" %}
DUO SSOの導入手順は、クラウドSSOコネクト (推奨) の[こちら](/sso-connect-cloud/jp/identity-provider-setup/duo.md)をご参照ください。
{% endhint %}

## **プロビジョニング機能**

KeeperのDUO自動プロビジョニングは、以下の機能に対応しています。

* Keeperでユーザーを作成
* ユーザー属性を更新
* ユーザーのアクティブ化または非アクティブ化 (Keeperでのロックまたはロック解除)
* Keeperでチームを作成 (DUOグループから)
* Keeperでロールを作成 (ロールマッピングプレフィックスを使用)
* プロビジョニングされたチームやロールにユーザーを割り当て

ユーザーをプロビジョニングする場合、DUOディレクトリは単一のKeeperノードにマッピングされます。

## **要件**

DUOを使用したKeeperのユーザープロビジョニングを設定するには、Keeper管理コンソールとDUO管理者アカウントへのアクセスが必要です。

## **設定手順**

**Keeper Security - Single Sign-On**アプリケーションの展開手順は、上記の要件で紹介したクラウドSSOコネクトガイドに記載されているため、本ページでは取り扱いません。

既存の**Keeper Security - Single Sign-On**アプリケーションで、**\[Provisioning]** (プロビジョニング) タブを開きます。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-1ad2ceee1594d6aaed1de725f5590e8602ac6767%2Fimage%20(251).png?alt=media" alt="DUOアプリケーションのプロビジョニングタブ" width="563"><figcaption></figcaption></figure>

### 認証

**\[Provisioning]** (プロビジョニング) の **\[Authentication]** (認証) で、**Authentication Mode** (認証モード) を\_Bearer Token\_に切り替えます。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-a60d9936640494c02628dd4ddc5f9f8a354b345d%2Fimage%20(252).png?alt=media" alt="DUOの認証モード" width="563"><figcaption></figcaption></figure>

**管理コンソール**で、DUO SSOノードに移動し、SCIM用の新しいプロビジョニングメソッドを作成します。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-44fefd092aafb591cf998484c043a97d759d11f7%2Fimage%20(253).png?alt=media" alt="プロビジョニングメソッドを追加"><figcaption></figcaption></figure>

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-197421c3437f77f27e244dd2a92fb35b32f06410%2Fimage%20(254).png?alt=media" alt="SCIMプロビジョニングメソッドの追加"><figcaption></figcaption></figure>

次のパネルで、以下の操作を行います。

* **URL**をコピーし、DUOの**Base URL** (ベースURL) フィールドに貼り付けます。
* **Token** (トークン) を生成してコピーし、DUOの**Token**フィールドに貼り付けます。
* 管理コンソールで **\[Next]** (次へ) をクリックします。

**Role Mapping Prefix** (ロールマッピングプレフィックス) は後で設定できるため、ここでは無視してかまいません。詳しくは以下をご参照ください。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-b384f1937c3f87779cf2bccb853df7c078d07d72%2Fimage%20(255).png?alt=media" alt="SCIMのURLとトークンのフィールド"><figcaption></figcaption></figure>

DUOで **\[Connect to Application]** (アプリケーションに接続) をクリックします。SCIMプロビジョニングメソッドが正しく送信されていれば、成功のメッセージが表示されます。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-ad5e7b5669172cc7137b8a3235d460cf988fda7b%2Fimage%20(256).png?alt=media" alt="DUOプロビジョニングの認証"><figcaption></figcaption></figure>

{% hint style="info" %}
管理コンソールで **\[Next]** (次へ) を押してSCIMプロビジョニングメソッドを完了していない場合、DUOでの接続テストは失敗します。
{% endhint %}

### 属性マッピング

デフォルトでは、DUO SCIMはDUOのユーザー名をKeeperの名前とメールアドレスの両方として設定してユーザーを作成します。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-fbf32483b6e0e9485ad177f27ea0f34d92d60afa%2Fimage%20(258).png?alt=media" alt="DUOの属性マッピング" width="562"><figcaption></figcaption></figure>

{% hint style="info" %}
シングルサインオンの設定で識別子として別のDUO属性を設定している場合は、SCIMでインポートされるユーザーのメールアドレスがログイン時と一致するように、ここでも同じ属性を設定してください。
{% endhint %}

SCIMで作成されるユーザー名をDUOの属性に一致させたい場合は、このパネルに`displayName`マッピングを追加できます。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-82df27f016e936887f68ab781b7e53efd1eeabe8%2Fimage%20(260).png?alt=media" alt="DUOのカスタムマッピング" width="563"><figcaption></figcaption></figure>

### グループ

**Groups** (グループ) パネルでは、Keeperエンタープライズにプッシュするグループを指定できます。

* **Select groups** (グループを選択): DUOディレクトリからグループを選択します。
* **Use groups with SSO access** (SSOアクセスのあるグループを使用): シングルサインオンアプリケーションに割り当てられたグループを継承します。
* **Exclude group information** (グループ情報を除外): 選択したグループのメンバーのみをインポートし、Keeperにチームを作成しません。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-f1cd7bcf0d6fadcc6ca3f4e310156e59e0d5a290%2Fimage%20(257).png?alt=media" alt="DUOのグループパネル"><figcaption></figcaption></figure>

### ユーザーの登録解除

次のパネルでは、ユーザーの登録解除の方法として以下の2つから選択します。

* **Deactivate Users** (ユーザーを非アクティブ化)
* **Delete Users** (ユーザーを削除)

Keeperでは、いずれを選択してもアクティブなユーザーが削除されることはなく、ロックのみが行われるため、この選択は実質的な意味を持ちません。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-ffae78161c71baaf1b7f58d9d7e6439c2c475484%2Fimage%20(261).png?alt=media" alt="DUOのユーザー登録解除"><figcaption></figcaption></figure>

## プロビジョニングサイクルの実行

**\[Save and Enable]** (保存して有効化) をクリックするか、ページ上部のパネルで **\[Enable]** (有効化) をクリックすると、DUOの自動プロビジョニングをすぐに有効にできます。有効にすると、新しい変更が加わるたびに自動的に更新とプッシュが行われます。プロビジョニングはいつでも無効化・有効化できます。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-e3539cfe128419003c112fc1340d7f365ee80a37%2Fimage%20(262).png?alt=media" alt="DUOプロビジョニングの実行"><figcaption></figcaption></figure>

## **チームとユーザーの承認**

Keeperのゼロ知識アーキテクチャにより、DUOによるチームおよびチームメンバーの割り当ては、管理者がKeeper管理コンソールにログインしているか、Keeperの自動化ツールが導入されている場合のみ適用されます。

* 管理者としてチームの承認を行う場合:

ユーザーまたはチームをKeeper管理コンソールにプッシュした後、ログインするか **\[完全同期]** をクリックして処理を承認します。

* チームの承認を自動化するツール:
  * [Keeperオートメーターサービス](/sso-connect-cloud/jp/device-approvals/automator.md)
  * [Keeperコマンダーの自動化](/sso-connect-cloud/jp/device-approvals/commander-cli.md)

## **SCIMを使用したチームとロールのマッピング**

DUOの自動プロビジョニングは、プッシュグループをKeeperチームにマッピングします。チームごとに異なるKeeperロールを自動的に割り当てるには、「チームとロールのマッピング」機能を使用します。

<figure><img src="https://3468650114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeJwa6ByNJ2qindnPknCW%2Fuploads%2Fgit-blob-2a173113ff0f906c14af6df7db42325e6cdb8cee%2Fimage%20(263).png?alt=media" alt="SCIMロールプレフィックスの例"><figcaption></figcaption></figure>

上記の画像では、ロールマッピングプレフィックスが`Keeper_role_`に設定されています。この場合、以下のようになります。

* `Keeper_role_developers`という名前のDUOグループは、KeeperチームとしてではなくKeeperロールとしてプロビジョニングされ、すべてのメンバーがそのロールに割り当てられます。
* `developers`という名前のDUOグループは、通常どおりKeeperチームとしてプロビジョニングされます。

この仕組みにより、DUOグループを使用してロールとチームを分離できます。

{% hint style="info" %}
ユーザーは複数のSCIM同期チームにプロビジョニングできますが、複数のプレフィックスマッピングロールに同時にプロビジョニングすることはできません。
{% endhint %}

## **ベストプラクティスとトラブルシューティング**

SCIMを使用する場合、Keeper側から割り当てを変更することは避けてください。すべての割り当てにおいて、DUOディレクトリを正としてください。DUOはKeeperエンタープライズ側での変更を検知できないため、Keeper側で割り当てを更新すると不整合が生じるおそれがあります。強くお勧めしません。

### よくある問題

* 管理コンソールでSCIMプロビジョニングメソッドを保存する前に **\[Connect to application]** (アプリケーションに接続) をクリックすると、テストは失敗します。トークンをコピーしてから **\[Next]** (次へ) をクリックしてください。
* Keeperユーザーはメールアドレスで識別されるため、DUOユーザーをKeeperアプリに割り当てる際は、`userName`にマッピングされた属性に有効なメールアドレスが含まれていることを確認してください。
* DUOからグループメンバーシップを同期すると、Keeperにチームメンバーシップが作成されますが、すぐには表示されません。プロビジョニングされたユーザーが実際のチームメンバーになるには、Keeperに登録して招待を受諾した後、Keeper管理者によるグループ加入の承認を受けるか、ウェブボルトにログインしている既存のKeeperチームメンバーによって自動承認される必要があります。
* Keeperでユーザーやグループを削除して再作成すると、DUOがオブジェクトの以前のIDを保持しているため新しいIDを認識せず、DUO側でエラーが発生することがあります。この場合は、プロビジョニングを無効化してから再度有効化すると解決します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/enterprise-guide/jp/user-and-team-provisioning/duo-provisioning.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
