メインコンテンツにスキップ

ArculesとのSCIM連携

SCIM向け外部IDプロバイダーとのArcules連携

SCIMとは何か?

SCIM(System for Cross-domain Identity Management)は、ユーザープロビジョニング(ユーザーアカウントの作成・更新・無効化、および複数のアプリケーションにおけるアクセス権の管理)を自動化するためのオープン標準です。

IT 管理者は通常、Microsoft Entra ID や Okta などの IDプロバイダー(IdP: Identity Provider)でユーザーやグループを管理します。IdP は、それらのユーザーやグループ情報をサービスプロバイダー(SP: Service Provider)である Arcules Web Platform に同期するため、管理者は同じアカウント情報を複数箇所で管理する必要がありません。

ユーザーアカウントに変更が発生した場合、その変更内容は SCIM プロトコルを通じて IdP から Arcules Web Platform に自動的に同期されます。これにより、ユーザーの追加、属性変更、無効化などの管理作業を一元化し、運用負荷の軽減と管理精度の向上を実現できます。

​注:SCIMプロトコルを使用すると、Microsoft Entra IDに既に存在する既存のユーザーとグループを活用し、それらを Arcules Web Platform と同期させることができます。


サポートされている ID プロバイダー

ID プロバイダー

セットアップガイド

Microsoft Entra ID

Okta

SCIM 2.0 をサポートするその他の IdP

他の SCIM 2.0 IDプロバイダー(後述)

シングルサインオン(SAML 2.0)の設定については、「SAML 2.0シングルサインオン(SSO)」を参照してください。


Arcules Web Portal での SCIM の有効化

Arculesウェブポータル の [Settings] > [Identity & Access Management] に移動します:

ドロップダウンメニューから使用する IdP を選択し、SCIM セクションの [Enable] ボタンをクリックします。

[Enable] をクリックすると、以下の設定情報が表示されます。

  • URL: テナント固有の URL です。Entra ID で SCIM を設定する際に使用します

  • シークレットトークン: Entra IDでSCIMを設定する際に必要なトークンです。このトークンを表示できるのは一度だけです。ページを再読み込みすると、トークンは再表示されません。最初に表示された際にコピーし忘れた場合は、新しいトークンを再生成する必要があります。


SCIMトークンの更新

SCIMトークンを紛失した場合や、漏えいした可能性がある場合は、Arcules Web Portalで新しいトークンを生成できます。

注: 組織のSCIMトークンを更新すると、以前のトークンは直ちに無効になります。ユーザーのプロビジョニングが中断されないよう、新しいトークンを使ってIDプロバイダー(IdP)を再設定してください。

必要条件

  • Org組織でSCIMプロビジョニングがすでに有効になっていること

  • SCIMトークンを更新するには、IT マネージャー権限が割り当てられていること

Arcules Web Portalの左側のメニューから Settings > Identity & Access Management を開き、SCIMセクションの Refresh ボタンをクリックします。

次のダイアログが表示されます。

確認のため、Refresh Token をクリックします。新しく生成されたSCIMトークンが表示されます。

トークンを選択すると、クリップボードにコピーできます。この新しいトークンを生成すると以前のトークンは無効になり、この操作は取り消せません。


トークン有効期限のメール通知

SCIM トークンの有効期間は 1年間 です。ITマネージャー 権限を持つユーザーには、期限切れ防止のためメール通知が送信されます。

タイミング

通知内容

有効期限前

60日前、30日前、15日前

最終週

期限の7日前から期限当日まで毎日

期限切れ後

3日後、7日後、13日後

ユーザーおよびグループの同期が停止しないよう、定期的なトークン更新を推奨します。


SCIM でプロビジョニングされたユーザーとグループの動作

  • SCIMを通じてプロビジョニングされたユーザーとグループは、IDプロバイダーによって管理されます。変更はArculesウェブポータルではなく、IdP側で行ってください

  • グループは権限が割り当てられていない状態で作成されます。グループのプロビジョニング後、ITマネージャーがArcules Web Portalにサインインし、そのグループに権限を割り当てる必要があります

  • ユーザーのメールアドレスは userName を使用します。IdP はユーザーのメールアドレスを SCIM の userName 属性として送信する必要があります


IdP 上の操作と Arcules での動作

IdP の操作

Microsoft Entra ID

Okta

その他の SCIM 2.0 IdP

ユーザーを Arcules アプリへ割り当て

ユーザー作成

ユーザー作成

ユーザー作成 (POST)

プロフィール更新

ユーザー更新

ユーザー更新

ユーザー更新 (PUT / PATCH)

割り当て解除または無効化

ユーザー無効化

ユーザー無効化

ユーザー無効化active:false

再割り当てまたは再有効化

ユーザー再有効化

ユーザー再有効化

ユーザー再有効化active:true

ユーザー削除

Entra ID で完全削除後に削除

削除されず無効状態を維持

ユーザー削除

DELETE


ユーザープロビジョニングの例

以下の図は、各ペルソナ(IT管理者、エンドユーザー)がそれぞれのタスクを実行するために必要な手順の例を示し、ArculesウェブプラットフォームとのSCIM連携における一般的なワークフローを説明しています。

その他のSCIM 2.0対応IDプロバイダー

SCIM 2.0に対応している任意のIDプロバイダーからプロビジョニングできます。SCIMを有効にする際に「その他」を選択し、以下の情報を使ってIdPを設定してください。

項目

値

Base URL

Arcules Portal に表示される URL(例: https://scim.eu.arcules.com/scim)

認証

Authorization: Bearer <Secret Token>

リソース

/Users, /Groups

ユーザー識別子

userName(ユーザーのメールアドレス必須)


ユーザー属性

SCIM 属性

必須

説明

userName

Yes

メールアドレス。Arcules のログイン ID

name.givenName

Yes

名

name.familyName

Yes

姓

active

No

false にするとユーザー無効化

externalId

推奨

IdP の一意な識別子

preferredLanguage

No

例: ja, en-US

phoneNumbers

No

主番号(primary)が使用

される

emails や password など、その他の属性は無視されます。


グループ属性

SCIM 属性

必須

説明

displayName

Yes

グループ名

externalId

推奨

IdP の一意識別子

members

No

value に Arcules ユーザー ID を指定


サポートされている操作とクエリ

  • ユーザーとグループ:GET、POST、PUT、PATCH、DELETE

  • フィルター(演算子は eq と and のみ)

    ユーザー:userName、emails.value、externalId、active、id

    グループ:displayName、externalId、id

  • ページネーション: startIndex、count

  • サポート対象外: ソート(sortBy、sortOrder)、or および not 演算子、emails[type eq "work"] のような角括弧付きフィルター。これらを使用すると、400 invalidFilter が返されます。

こちらの回答で解決しましたか?