この記事では、SCIM ProvisioningをOktaのIntercomアプリで設定する手順を説明します。これにより、Oktaを唯一の信頼できる情報源として使用し、新しいteammatesのプロビジョニングやアカウント、グループ、権限の管理が可能になります。

対応機能

OktaのIntercomアプリは以下のプロビジョニング機能をサポートしています：

teammatesのインポート：すでにOktaに存在するteammatesはIntercomに作成されます。
パスワード同期：teammatesのパスワードをOktaからIntercomに同期できます（これはオプション設定です）。
新しいteammatesのプッシュ：Oktaで作成された新しいteammatesもIntercomに作成されます。
プロフィール更新のプッシュ：Oktaでteammatesのプロフィールに加えた更新はIntercomにプッシュされます。
teammatesの無効化：Oktaでteammatesを無効化またはアプリケーションへのアクセスを停止すると、Intercomからそのteammatesが削除されます。
teammatesの再有効化：teammatesのアカウントはアプリケーション内で再有効化できます。
グループのプッシュ：OktaからIntercomにグループをプッシュし、Intercomの役割にマッピングします。

開始前に

重要 無効化の警告：Intercomのteammatesは「active」か「deleted」のいずれかの状態です。Intercomにはteammatesのソフト削除、無効化、アーカイブ状態はありません。IDプロバイダーでteammatesがactiveでない場合、そのアカウントはIntercomワークスペースから永久に削除されます。

注意：

SCIM Provisioningは特定のIntercomプランでのみ利用可能です。プランと料金をご覧ください。
Intercomはメールアドレスを大文字小文字を区別しないものとみなします（例：「Teammate@example.com」は「teammate@example.com」と同じです）。
リクエストに「displayName」パラメータが送信された場合、「name」パラメータの代わりに使用されます。

要件

Oktaでは、パスワードポリシーが最低10文字を要求するようにしてください。変更するには、Oktaのセキュリティ設定内のAuthenticationセクションにアクセスしてください。

Intercomでは、SCIMプロビジョニングを設定する前に、まずSAML SSOを設定する必要があります。

次に、以下のセットアップ手順に従います。以下の項目はIntercomのセキュリティ設定で提供されます：

SCIM 2.0 ベースURL
APIトークン

ステップ1：IntercomからSCIM認証情報を取得する

Oktaを設定する前に、IntercomでSCIMを有効にして認証情報を取得する必要があります。

設定 > ワークスペース > セキュリティ > 認証方法に移動します。
SAML SSOを有効にします。
Provisioningを選択し、ドロップダウンでSCIM provisioningを有効にします。
「除外：deprovisioningおよびrole provisioning」からteammatesを追加をクリックし、自分のアカウントを除外してロックアウトを防ぎます。
保存をクリックします。
Base URLとAPI Tokenをコピーします。次のステップで必要になります。

設定手順の詳細はこちらをご覧ください。

ステップ2：OktaでIntercomアプリを設定する

OktaのダッシュボードでApplicationsに移動し、Browse App Catalogを選択します。
「Intercom」を検索してアプリを追加します。
IntercomアプリのProvisioningタブに移動し、Configure API Integrationをクリックします。
Enable API integrationのチェックボックスをオンにします。
IntercomからコピーしたBase URLとAPI Tokenを貼り付けます。
Test API Credentialsをクリックします。成功メッセージが表示されるはずです。
保存をクリックします。
成功メッセージが表示されます：「Intercomは正常に検証されました！」
左側のパネルでTo Appを選択し、Editをクリックします。
ユーザー作成を有効にする。
ユーザー属性の更新を有効にする。
Usersの無効化を有効にする。
パスワード同期（オプション）を有効にする。
保存をクリックします。

注意：OktaのSign OnアプリケーションタブでApplication username formatに「Email」を選択する必要があります。これは、このアプリのSCIM userName属性がメールアドレス形式である必要があるためです。

ステップ3：グループプッシュの設定（推奨）

SCIMグループを使用してteammatesの役割を管理している場合：

Oktaで、IntercomアプリのPush Groupsタブを開きます。
Intercomに同期したいOktaグループを選択します（例：「Intercom Admins」）。
Intercomでは、同期したグループをIntercomの役割にマッピングする必要があります。設定 > Workspace > Teammates > SCIM Provisioningに移動してください。
マッピングの詳細な手順については、SCIMグループを使ったteammatesの役割自動割り当ての完全ガイドをご覧ください。