Entra ID による自動プロビジョニングの設定 – Miro Help Center

このガイドでは、SCIM を使用して Entra ID と Miro Enterprise アカウント間でユーザーおよびユーザーグループの自動プロビジョニングを設定する手順を案内します。

利用可能なプラン： Enterprise プラン
設定者： 会社レベルの管理者

⚠️ このガイドは設定手順のみを扱います。サポートされている機能や同期ルール、トラブルシューティングについては、SCIM の概要を参照してください。SCIM API リファレンスは開発者向けドキュメントを参照してください。

注：このインテグレーションで設定された SCIM グループは、Miro の ユーザーグループ に直接同期され、チームには同期されません。詳細は New synchronization model を参照してください。

組織でフレキシブルライセンスプログラムをご利用の場合は、代わりにその設定についての詳細なプロビジョニングガイドをご覧ください。

前提条件

自動プロビジョニングを設定する前に、以下を完了してください。

Miro Enterprise プランで SAML ベースのシングルサインオン（SSO）を設定し、動作を確認してください。手順については、Entra ID SSO の設定をご覧ください。
同期中の接続エラーを避けるため、SCIM 概要の「重要事項」と「Miro の運用ルール」を確認してください。

設定

Entra ID を Miro の SCIM API に接続して、プロビジョニング要求を認証できるようにします。SSO 設定中にアプリケーションが作成されると、その設定が表示されます：

Miro アプリケーションの設定

左側のパネルでプロビジョニングを選択し、プロビジョニングモードを手動から自動に変更します。
管理者の認証情報を入力します：
- https://miro.com/api/v1/scim/ を テナント URL として使用します。
- Miro の設定の SSO セクションで取得できる シークレットトークン を入力します。
- シークレットキー フィールドの下にある 接続テスト をクリックします。接続に成功すると、次の通知が表示されます：
  
  接続テスト成功の通知
  確認が表示されない場合は、ネットワーク上で テナント URL がファイアウォールやその他のトラフィックインターセプターによりブロックされていないか、また API トークン が正しいかを確認してください。
設定を保存します:

設定の保存

属性のマッピング

Miro SCIM API は、Entra ID がユーザーとグループに付加するメタデータの一部を利用します。このセクションでは、Miro SCIM API と Entra ID 属性間の必要なマッピングについて説明します。

ユーザー

左サイドバーの プロビジョニング タブを選択し、Synchronize Entra Active Directory Users to Miro をクリックします。

同期を有効にする
デフォルトのマッピングはほとんどの場合で十分です。ユーザーの同期が有効になっており、必要なメソッド（作成、更新、削除）がすべてオンになっていることを確認してください。

属性マッピング

Miro は、SP-initiated フローでは UPN によってのみ Entra ユーザーを認識します。

対応する属性を追加するには、詳細オプションを表示をクリックし、続けて Miro の属性リストを編集 を選択します:

詳細オプション

マッピングしたい属性名を入力して、保存します。対応する属性の全リストについては、Miro の SCIM ドキュメントをご覧ください。

Miro のユーザー属性

新しいマッピングを追加を選択し、先ほど追加した属性を選択します:

新しい属性をマッピングするには、まず次の URL で Entra にアクセスしてこのオプションを有効にしてください：

https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true

新しい属性の追加に関する詳細は、Microsoft の文書アプリケーション属性のカスタマイズおよび拡張属性の作成を参照してください。

⚠️ Entra は ProfilePicture 属性をサポートしていません。開発の優先度を高めるため、この機能を User Voice でリクエストできます。

グループ

プロビジョニング タブを選択し、次に Synchronize Entra Active Directory Groups to Miro をクリックします。
グループの同期が有効になっていることを確認し、Create および Delete を有効にするかどうかを選択します。
クリック保存をクリックします。

⚠️ Miro の SCIM API は、ユーザーグループの作成と削除をサポートするようになりました。作成を有効にすると、Entra で対応するグループを初めてアプリに割り当てたときに Entra が自動的に対応する Miro のユーザーグループを作成するため、Miro 側で事前にユーザーグループを作成する必要はありません。削除を有効にすると、Entra でグループの割り当てを解除した際に対応する Miro のユーザーグループも削除されます。これが望ましい動作の場合のみ有効にしてください。ユーザーグループの作成と削除を手動で管理する場合は、どちらもチェックしないでください。

ユーザーとグループを割り当てる

Miro の SCIM プロビジョニングは、Enterprise サブスクリプション内のユーザーのプロビジョニングとデプロビジョニングを行い、それらをユーザーグループに自動的に振り分けます。

Entra Active Directory のユーザーまたはグループを Miro SCIM Provisioner アプリに割り当てると、Miro で自動的に管理されるようになります。ユーザーとグループをアプリに割り当てるには、以下の手順に従ってください:

プロビジョニング タブを選択します。「設定」 セクションで、スコープが Miro と同期させたいものに設定されていることを確認します。割り当てられたユーザーとグループのみを同期する を選択します。
ユーザーとグループ タブを選択し、次に ユーザーを追加 をクリックします:

ユーザーとグループのタブ
割り当て追加 画面で、ユーザーとグループ タブを選択し、リストからユーザーとグループを選択します。グループ同期で作成を有効にしていない場合は、ここで割り当てる前に該当する Miro のユーザーグループが既に存在していることを確認してください。
選択、割り当て の順にクリックします。
割り当てられたユーザーとグループが一覧に表示されます。

✏️ Entra ID でグループの割り当てを削除しても、Miro の同期されたユーザーグループからそのユーザーが削除されたり、非アクティブ化されたりすることはありません。ユーザーを完全にプロビジョニング解除するには、Miro に接続されているすべての Entra ID グループからそのユーザーを削除してください。

ユーザーのダウングレード

ユーザーをダウングレードするには、次の手順に従ってください：

Entra ID で：
1. Full のアプリロールが割り当てられているグループからユーザーを削除します。
2. User のアプリロールが割り当てられている別のグループのメンバーであることを確認します。
Miro で、ライセンスを Free Restricted に更新します。

⚠️ Miro アプリケーションに割り当てられているすべての Entra ID グループからユーザーを削除すると、そのユーザーは Miro で非アクティブ化され、アプリケーションにアクセスできなくなります。ダウングレードされたユーザーが制限付き無料ライセンスで引き続き Miro を利用する必要がある場合は、ユーザーロールが割り当てられている Entra ID グループのメンバーであることを確認してください。

✏️ SCIM プロビジョニングによるユーザーのフルライセンスから制限付き無料ライセンスへのダウングレードにはまだ対応していません。

プロビジョニングの有効化と無効化

初期設定が完了したら、プロビジョニングを有効にします:

左側のプロビジョニングタブを選択します。
プロビジョニングステータスのトグルをオンにします：

プロビジョニングステータス
保存をクリックします。これで初期プロビジョニングが開始され、完了までにしばらく時間がかかることがあります。約 20 分後にページ下部のステータスを確認してください。

プロビジョニングを無効化するには、トグルをオフにします。Entra は断続的にデータを更新するため、緊急の更新が必要な場合は、一度プロビジョニングを停止してから再開してください。再同期は即時に行われ、保留中の更新も含まれます。

トラブルシューティング

ユーザーのメールアドレスの変更によって生じる問題

ユーザーのメールアドレスを更新したのに Miro 側に反映されない場合は、どの属性を更新したかを確認してください。この問題は通常、emails[type eq "work"] を使用している場合に発生します。

emails[type eq "work"] は Entra のデフォルト属性で、Miro は対応しています。ただし読み取り専用で、userName から動的に生成される場合に限ります。ユーザーを読み取ると、Miro は次のように返します。

Miro 側で emails[type eq "work"] が読み取り専用であるため、Miro はそれを変更しようとする試みを無視します。Miro ではユーザーのメールアドレスはプライマリ ID（ユーザーを識別する識別子）であるため、追加のメールアドレスはサポートしていません。SCIM の構造上、email 配列が必要なため、存在自体はサポートしますが、編集可能なフィールドとしてはサポートしていません。

ユーザーのメールアドレスを変更するには、emails[type eq "work"] ではなく、userName に更新を送信してください。

ユーザーの更新に失敗しました

Entra のログにFailed のステータスが以下の内容とともに表示されます：

ステータス理由: "ユーザーの更新に失敗しました：属性 emails に複数値または複雑な値がありません"
エラーコード: SystemForCrossDomainIdentityManagementServiceIncompatible

このセクションの記事