> 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)を使って、ワークスペースで使用可能なロールのリストを検索します。