利用可能なプラン： Enterprise プラン
設定者：会社レベルの管理者
⚠️ このガイドでは、機能を設定する手順をご説明します。利用可能な機能、Miro SCIM が従うルール、起こりうる問題とその解決方法については、こちらをご覧ください。
Miro の SCIM 開発者向けのドキュメントはこちらでご覧になれます。
フレキシブル ライセンス プログラムをご利用のお客様向けの詳細なプロビジョニング ガイドについては、こちらでご覧いただけます。
前提条件
自動プロビジョニングの設定を始める前に、SAML ベースの SSO が正しく設定され、Miro Enterprise プランで正常に機能している必要があります。SSO の設定手順については、こちらをご覧ください。
SCIM API を呼び出す際には、API トークンを提供する必要があります。トークンを表示するには、Enterprise のインテグレーション > SSO > SCIM の設定で SCIM オプションを有効化してください。
同期する前に、接続時のエラーを避けるため、「重要事項」 と 「Miro の SCIM 運用ルール」をご確認ください。
設定
- アプリケーションの設定ページで、 プロビジョニング タブに切り替えます。次に、API インテグレーションを設定：
事前設定された Miro アプリのプロビジョニングタブ
-
API インテグレーションを有効化のチェックボックスにチェックを入れ、それぞれのフィールドにBase URL（https://miro.com/api/v1/scim/）とアカウント固有のAPI トークン（Miro の設定内 セキュリティ セクションで入手可能）を入力します。その後、API 資格情報をテストをクリックします。
接続がテストに合格した場合、「Miro は正常に検証されました」という通知が表示されます：
プロビジョニング タブ、インテグレーション セクション
確認が表示されない場合は、Base URLhttps://miro.com/api/v1/scim/ を再確認し、ネットワーク内のファイアウォールやその他のトラフィック検査ツールによってブロックされていないか、また API Token が正しいか確認してください。 - 保存してください。
アプリへのプロビジョニングのマッピング
Miro SCIM API では、OKTA がユーザーとグループに付与するメタデータの一部を利用します。このセクションでは、Miro SCIM API と OKTA 属性間の必要なマッピングについて説明します。
- アプリケーションの設定ページで、[Provisioning]（プロビジョニング） > [To App]（アプリへ）タブに切り替えます。[Edit]（編集）をクリックし、「ユーザーを作成」、「ユーザー属性を更新」および「ユーザーを非アクティブ化」の各セクションのチェックボックスを有効にします。
あらかじめ設定された Miro アプリの [アプリへ] タブ
スクロールダウンして、ユーザー名が [サインオン設定で設定済み] に設定されていることを確認します：
あらかじめ設定された Miro アプリ用の属性マッピングのタブ
対応する属性を追加するには、[Go to Profile Editor]（プロフィール エディターに移動）オプションをクリックし、[属性を追加]を選択します。
プロフィール エディタのアクティブな属性の一覧
対応する属性の一覧については、Miro の SCIM ドキュメントをご覧ください。
割り当てとプッシュグループ
Miro SCIM プロビジョニングは、ユーザーを Miro Enterprise プランにプロビジョニングするだけでなく、チーム間で自動配布し、必要に応じて非アクティブ化するのに役立ちます。
⚠️ OKTA のグループは、Miro のアプリケーションに割り当てされる必要があり（グループに既に直接ユーザーとして割り当てられているユーザーが含まれている場合でも） また アプリのプッシュグループにも追加する必要があります。
1) 割り当てタブで Miro のアプリケーションにグループを割り当てます。割り当てられたユーザーはこの時点で Miro SSO 経由で認証できますが、Miro のチームには配置されません。
2) その後、プッシュグループを設定して、Okta グループを Miro のチームと同期させます。
- アプリケーション設定ページでプッシュグループ タブを選択し、次にアプリグループを更新:
事前設定済みの Miro アプリでのプッシュグループ
こうすることで、Okta は Miro サブスクリプションに存在するチームを認識し、その後それらに同期できるようになります。チーム数によっては、リストのダウンロードに数分かかる場合があります。 - クリックして ［プッシュグループ］ > ［名前でグループを検索］:
プッシュ対象グループの設定
クイック検索ボックスに OKTA のグループ名を入力し、オートサジェスト リストから選択します。OKTA は、事前にダウンロードしたリストをもとに、それぞれの Miro チームと一致するグループを表示します。OKTA グループと Miro チームのリンク
OKTA がグループを手動でリンクするオプションを表示する場合は、Miro 側にそのグループ名のMiro チームが存在することを確認してください。アプリ グループを更新 をもう一度クリックし、システムがエンティティを同期してから、グループ名で検索を再試行してください。 - Okta からプロビジョニングされるのではなく、Miro Enterprise プランに直接追加されているユーザーがいる場合は、インポートタブに移動し、今すぐインポート をクリックします。これにより、既存の Miro ユーザーに関する情報が Okta にインポートされます。そこから、インポートされたユーザーの処理方法を選択できます:
その結果、SSO を有効化した後にシステム間で不一致が発生してログインできなくなるユーザーが出ないようにできます。 - 保存 すればこれで完了です！ Miro にプッシュされたグループのリストと、アクティブ（緑色）になっているはずの同期のステータスが表示されます。 この時点で、選択したグループのユーザーは、それぞれの Miro チームに配置され、チームで共有されているボードにアクセスできるようになります。 その後、継続的に更新されることになります。
起こり得る問題とその解決方法
-
ユーザーが Miro にプッシュされていません。
Okta のプッシュされたグループがアプリに正しく割り当てられていることを確認してください。なお、Okta のプッシュグループ同期のアクティブステータスが不具合を起こすことがあります。同期エラーを解決するには、グループの割り当てを解除し、プッシュグループから削除してから、グループを再度割り当ててプッシュグループに再追加し、同期接続を再作成してみてください。設定に変更がない場合でも、問題を解決するために同期接続の再作成が必要になる場合があります。 -
ユーザーは削除されません。
なお、SCIM プロセスには、ユーザーの削除は含まれていません。ユーザーのアクセス権を取り上げるには、OKTA でユーザーを非アクティブ化するか、Okta 側でアプリケーションからユーザーの割り当てを解除してください。これにより Miro に対応するリクエストが送信され、ユーザーは非アクティブ状態に設定されます。ユーザーを削除する方法についてはガイドを参照してください。 -
ユーザーデータが更新されていません。
Please note that the ユーザー名 attribute should NOT be updated from アプリケーション > 割り当て:
ユーザー名属性（およびその他の属性）は、ユーザープロフィールの編集オプションから更新してください： -
「Conflict. Errors reported by remote server: DomainAddress is not whitelisted」のため、ユーザーがプロビジョニングされません。
ユーザーのドメインアドレスが共有ポリシー. -
「今すぐプッシュ」オプションを使用した後、一部のボードやプロジェクトがチームの管理者に再割り当てされました。
このオプションでは、Okta が PATCH リクエストを開始し、サブスクリプションのすべてのメンバーを置き換えます（つまり、Miro のユーザーリストを Okta のユーザーリストに同期します）。このプロセスの実行中にタイムアウトが発生した場合、Miro にはタイムアウトが発生するまでに同期可能だったユーザーだけが残されます。Miro 側では、ユーザーがチームから削除されることになるので、削除されたユーザーが所有していたボードやプロジェクトは、チームの管理者に再割り当てされます。 -
スキャン済みユーザー数（今すぐインポート オプションが示す）が、Miro のサブスクリプションに登録されているユーザー数と一致しません。
この数値には非アクティブ化されたユーザーおよびチームに所属していないユーザーは含まれていないことにご注意ください。 また、Okta が前回のインポート以降に発生した最新の変更（例えば、下のスクリーンショットに表示されている「ユーザー 1 名削除」のような変更）を含めている場合、結果が異なることがある点にも気づきました。正確な数を得るには、少なくとも 2 回はインポートコマンドを実行してみてください。 -
ユーザーのデータが一部更新されません。
設定したすべての属性（特に ProfilePicture や UserType などのカスタム属性）が、ユーザー プロフィール ページに表示され、入力されていることを確認してください： -
リンク / プッシュグループのタイムアウトにより、変更が Miro に送信されません:
"06-14-2021 12:16:29PM UTC に失敗しました: Unable to update Group Push mapping target App group <Group Name>: Error while creating user group <Group Name>: Read timed out".
このタイムアウトエラーは、既存のグループをリンクしようとしたときや、メンバーが多い新しいグループをプッシュしようとしたときに発生する場合があります。新しいグループをプッシュしていた場合、対象グループが Miro で作成される前に Okta の SCIM リクエストがタイムアウトしたのか、作成後にタイムアウトしたのかを確認してください。
対象グループが Miro で作成されなかった場合は、「プッシュグループ」操作を再試行してください。
既存のグループをリンクしていた場合や、最初のプッシュ操作の後に対象グループが Miro で作成された場合は、Okta と Miro のグループ間のリンクを復元する必要があります。そのためには、以下の手順を試してみてください：
- プッシュされたグループのリンクを解除します（モーダルウィンドウのターゲットアプリのグループを残すにチェックを入れてください）：
- Okta が Miro のグループ一覧を取得できるよう、アプリグループを更新ボタンをクリックします：
- [グループをプッシュ] ボタンをクリックして、[名前でグループを検索] オプションを選択します。
- 検索ボックスにプッシュしたいグループ名を入力し、ドロップダウンから該当するグループを選択します。Okta は [グループをリンク] オプションが無効化された状態で、以下のように表示されます:
- [保存] をクリックします。Okta は、PATCH /Groups SCIM リクエストを使用して対象グループを同期しようとします。
- Miro で Okta グループのメンバー全員が各チームに割り当てられていない場合は、Okta の「ディレクトリー → タスク」タブを確認し、失敗した操作を再試行してください: