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

SCIM機能の設定

  • 更新

概要

MagicPodでは、新エンタープライズプランをご利用のお客様向けに、SCIM (System for Cross-domain Identity Management) 機能をご提供しています。

Oktaと連携することで、ユーザーアカウントの作成・更新・削除を自動化し、管理の手間を大幅に削減できます。

 

ご利用条件

SCIM機能をご利用いただくには、以下の条件をすべて満たす必要があります。

  • ご契約プランが新エンタープライズプランであること
  • 組織専用ユーザーの設定を有効にしていること（「利用する（<組織名>専用でないユーザーは追加不可）」）
    → 設定方法はこちら
  • SAML認証の設定を有効にしていること（「利用する（SAML認証でないユーザーは追加不可）」）
    → 設定方法はこちら
  • 対応IdPはOktaのみ
    → Okta公式サイト
  • 現時点で管理できるのはユーザーのみ（グループはグループ内ユーザーの同期のみ対応、グループ自体の作成・更新・削除は非対応）

 

設定方法

  1. MagicPodの組織設定画面からSCIM機能を有効化します
  2. 有効化後にAPIトークンを発行します
  3. 組織設定を更新します
  4. OktaでプライベートSCIM連携を設定します

これでMagicPodとOktaのSCIM連携が有効になり、Okta上でのユーザー管理が自動的にMagicPodへ反映されます。

日々のアカウント管理を効率化し、セキュリティと運用性を両立できます。

 

メールアドレスの変更

Okta側でユーザーのメールアドレス（ドメイン変更を含む）を変更すると、MagicPodの既存アカウントのメールアドレスが書き換わります。アカウントは同一のまま維持されるため、テストデータ・権限・組織／プロジェクトへの所属はすべてそのまま引き継がれます。

変更手順

  1. Oktaの管理コンソールで Directory > People を開き、対象ユーザーを選択します
  2. Profile タブの Attributes で [Edit] をクリックします
  3. 以下の2項目を新しいメールアドレスに変更して保存します
    • Username (login)
    • Primary email

2つの項目には必ず同じ値を設定してください。値が異なる場合はMagicPod側でエラーとなり、変更は反映されません。

※ Applications の Assignments タブからは変更しないでください。別のアカウントとして新規作成され、テストデータや権限が引き継がれません。

この方法で変更した場合に起きること

以下の操作でメールアドレスを変更すると、MagicPodには「新しいユーザーの作成」と「既存ユーザーの無効化」として通知されます。その結果、新しいメールアドレスのアカウントが別途作成され、元のアカウントは無効化されます。

  • Applications >（MagicPodのSCIMアプリ）> Assignments タブで、対象ユーザーの編集（鉛筆アイコン）から Username / Email を変更する
  • アプリの割り当てを解除（Unassign）してから再度割り当てる（Assign）

これらの操作を実施してしまった場合は、サポートまでお問い合わせください。

 

変更できない場合

  • 変更後のメールアドレスが、MagicPod上で別のユーザーにすでに使用されている場合
  • 対象ユーザーが、有料プランの組織のオーナーである場合

複数のユーザーを変更する場合は、まず1ユーザーで試して正しく反映されることをご確認のうえ、残りのユーザーに展開することをおすすめします。

 

トラブルシューティング

Oktaにてユーザーをプロビジョニングした際に、以下のようなコンフリクトエラーが発生する場合があります。

Automatic provisioning of user <username> to app SCIM 2.0 Test App (OAuth Bearer Token)
failed: Error while creating user <email>: Conflict.
Errors reported by remote server: User with this email already exists

こちらのエラーは、SCIMによるユーザー作成時に、すでにMagicPod上に同一メールアドレスのユーザーデータが存在している場合に発生します。既存ユーザーとの重複により、新規ユーザーとしての作成ができず、コンフリクトエラーとなります。

本問題を解決するには、既存のユーザーアカウントを削除する必要があります。

  • 組織専用ユーザーの場合
    組織の管理者がメンバーページから削除することが可能です。
  • 通常のユーザーアカウントの場合
    管理画面から削除することはできません。そのため、こちらのヘルプページを参考に、「ユーザーアカウントの削除リクエスト」をサポートまでご依頼ください

 

関連記事