> For the complete documentation index, see [llms.txt](https://manual.dxable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.dxable.com/clickup/integrations-and-clickup-api/integrations/okta-scim-clickup-configuration-guide.md).

# Okta SCIM ClickUp構成ガイド

[プロビジョニングにOkta](https://developer.okta.com/docs/concepts/scim/)を利用するワークスペースは、[カスタムロール](https://help.clickup.com/hc/en-us/articles/6310020641175-Custom-Roles-overview-enterprise)を使ってOktaと完全に統合できます。ClickUpで作成されたロールは全てOkta内のオプションとして追加できるため、カスタムロールを既存のワークフローに簡単に統合できます。

### **必要条件** <a href="#gjdgxs" id="gjdgxs"></a>

* プロビジョニングを設定する前に、ワークスペースでOkta SSOを有効にする必要があります。
  * [Enterpriseプラン](https://clickup.com/pricing)のワークスペースでのみ利用できます。
  * Okta SSO を有効にできるのは、ワークスペースの[所有者と管理者のみ](https://help.clickup.com/hc/en-us/articles/6310033667223-User-Roles)です。
* Okta SCIM を構成できるのはOkta管理者のみです。

### **Okta SCIMを構成する** <a href="#id-30j0zll" id="id-30j0zll"></a>

Okta SCIMを構成するには：

1. [Okta SSO](https://help.clickup.com/hc/en-us/articles/6305095991703-Enable-Okta-single-sign-on-integration)を有効にすると、SCIMベースURLとSCIM APIトークンが表示されます。

{% hint style="info" %}
注\
Identity Provider (IdP) が SCIMをサポートしているが、Oktaを使っていない場合は、SSO を正常に統合した後、SCIM ベース URL と SCIM API トークンを提示する必要があります。 IdP の公式ClickUp SSO 統合で SCIM がサポートされていない場合は、代わりに[カスタムSAML](https://help.clickup.com/hc/en-us/articles/6305027039767-Custom-SAML-Single-Sign-On)を使用する必要があります。
{% endhint %}

![Screenshot of the Okta SSO authentication page.](/files/jFwLaSMjRRdiDdgEz7EL)

1. Okta ダッシュボードで、 ClickUpアプリケーションに移動し、**［Provisioning］**&#x30BF;ブをクリックします。
2. **［Enable provisioning features］チェックボックス**をオンにします。
3. **［Configure API Integration］**&#x3092;クリックします。
4. **［Enable API integration］**&#x3092;チェックします。
5. 手順1. から SCIM ベース URL と SCIM API トークンをコピーして貼り付けます。<br>

   <figure><img src="/files/Htd9QGz1ReF2Srw4EuHK" alt="" width="540"><figcaption></figcaption></figure>
6. **［Test API Credentials］**&#x3092;クリックします。 成功した場合、確認メッセージが表示されます。
7. **［Save］**&#x3092;クリックします。
8. 左側のパネルで、**［To App］**&#x3092;選択します。
9. 有効にする**Provisioning Features**を選択します。
10. アプリにユーザーを割り当て、アプリケーションのセットアップを完了します。
11. ユーザーまたはグループを割り当てるときは、 [ClickUpロール属性](https://help.clickup.com/hc/en-us/articles/6310033667223-User-Roles)を割り当てます。 この属性が設定されていない場合、すべてのユーザーがデフォルトでメンバー ロールになります。

### **あなたにできること** <a href="#id-1fob9te" id="id-1fob9te"></a>

Okta SCIM を使って次のアクションを実行できます。

| アクション                | 説明                                                                                                                                                                                                                                                                                                                          |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **新規ユーザーをプッシュする**    | <p>Okta を通じて作成された新しいユーザーは、サードパーティ アプリケーションでも作成されます。</p><p>注</p><p>Okta はユーザー名とeメールを作成しますが、パスワードは作成しません。 SSO がリンク解除されたためにユーザーがロックアウトされた場合、所有者または管理者は SSO ポリシーをオプションに変更して、ユーザーがパスワードをリセットできるようにする必要があります。</p>                                                                                                                 |
| **プロフィールの更新をプッシュする** | Okta を介したユーザー プロファイルの更新は、サードパーティ アプリケーションでも行われます。                                                                                                                                                                                                                                                                           |
| **プッシュユーザーの無効化**     | <p>Okta を介してユーザーのアプリケーションへのアクセスを非アクティブ化または無効にすると、サードパーティのアプリケーションでもユーザーが非アクティブ化されます。 Okta でユーザーが非アクティブ化されると、関連付けられているClickUpワークスペースから削除されます。 ユーザーはそのワークスペース内のどのコンテンツにもアクセスできなくなりますが、データは「非アクティブ ユーザー」として引き続き利用できます。</p><p>注</p><p>このアプリケーションでは、ユーザーを非アクティブ化すると、ログインへのアクセスは削除されますが、ユーザーの Chorus 情報は非アクティブ ユーザーとして維持されます。</p> |
| **ユーザーの再アクティブ化**     | ユーザー アカウントはアプリケーション内で再アクティブ化できます。                                                                                                                                                                                                                                                                                           |

### **トラブルシューティングのヒント** <a href="#id-3znysh7" id="id-3znysh7"></a>

以下は、Okta SCIM を構成する際に役立つヒントです。

* ClickUpでユーザーを作成すると、 Okta で**givenName** 、 **lastName** 、または**emailが変更されても、そのユーザーには更新が送信されなくなります。 ClickUpロールに対して行われた更新のみが Okta からClickUpに送信されます。**&#x65;メールまたはユーザー名を変更する必要がある場合は、ユーザーがClickUp設定で行う必要があります。
* ClickUpで名前がeメールアドレスとして表示される場合は、個人設定ページで更新できます。<br>

  <figure><img src="/files/XTDlJblSGXFS3VcXTSg3" alt="" width="563"><figcaption></figcaption></figure>
* ユーザーのカスタムロールを設定するには、 **customRoleName**属性または**customRoleId**属性のいずれかにマップできます。 パブリックClickUp APIにアクセスできるユーザーがいない場合は、 ClickUpワークスペースで作成したカスタムロールに一致する名前の列挙リストである属性を Okta プロファイルに作成します。 ユーザのプロビジョニング時に、これが**customRoleName**にマップされることを確認してください。

ClickUpでカスタムロール名が変更されると、このマッピングは壊れます。 ClickUpパブリック API にアクセスできる場合は、**customRoleId**属性を使って、 ClickUpでカスタムロール名が変更されたときにカスタムロール マッピングが壊れないようにします。 作成したカスタムロールに対応するIDを確認するには、[このエンドポイント](https://jsapi.apiary.io/apis/clickup20/reference/0/teams/get-teams.html)を使って、ワークスペースで使用可能なロールのリストを検索します。


---

# 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 dynamically by asking a question.

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

```
GET https://manual.dxable.com/clickup/integrations-and-clickup-api/integrations/okta-scim-clickup-configuration-guide.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.
