アカウント共有により、管理組織のアドミニストレーターが監視しているデータを管理組織に公開できるようになります。 ハイタッチ組織構造で最初のアカウント共有を設定した後 ( 「アカウントと組織の作成」を参照)、フォローアップの変更が必要になる場合があります。
あなたが Betty's MSP (マネージド サービスプロバイダー) のアドミニストレーターで、顧客 Wayne Enterprises のマネージド アカウントを監視しているとします。 また、そのアカウントを Wayne Enterprises 組織と共有しました。 実行できるフォローアップ タスクは次のとおりです。
顧客である Wayne Enterprises が別のアカウントを希望する場合、次のようにします。
- NerdGraph ミューテーション
accountManagementCreateAccount
を使用して、管理組織に別の Wayne Enterprises アカウントを作成します。 - Wayne Enterprises も新しいアカウントのデータを直接確認したい場合は、
organizationCreateSharedAccount
使用してそのアカウントを組織と共有します。
顧客 Wayne Enterprises とアカウントを共有する必要がなくなったと判断した場合は、ミューテーションorganizationRevokeSharedAccount
を使用して共有を取り消すことができます。
Wayne Enterprises の共有アカウントのいずれかのユーザーロールを変更する必要がある場合は、ミューテーションorganizationUpdateSharedAccount
を使用できます。
要件
この機能を使用するには、組織で次の作業が完了していることを確認してください。
- 承認を得る: アカウント担当者に連絡して、組織がマルチテナントに追加されたことを確認してください。 承認されると、マルチテナントの権限が付与されます。
- ユーザー タイプが正しいことを確認してください。上記の機能セットを利用する管理組織内のユーザーは、コア プラットフォーム ユーザーまたはフル プラットフォーム ユーザーとしてプロビジョニングする必要があります。
- ユーザーを適切なグループに追加: コアまたは完全なプラットフォーム ユーザー タイプを持つユーザーは、
tenant_settings
が適用されたグループに追加する必要があります。
Nerdgraph では何を呼び出すことができますか?
アカウント共有について理解を深めていただくために、以下に基本的な例をいくつか示します。 まず、一般的なルーチンを見てみましょう。
- ソース組織はターゲット組織から組織 ID を取得します。 目標組織ユーザーがAccess Management [アクセス管理]タブを表示すると、目標組織 ID を取得できます。
- ソース組織は API を呼び出し、ターゲット組織 ID、アカウント ID、制限ロールを渡します。 ソース組織は、ターゲット組織のユーザーが制限される最大の機能を定義する制限ロールを宣言できます。
アカウント共有のために実行できる通話の種類は次のとおりです。
このミューテーションを使用するには、ターゲット組織をすでに作成しておく必要があります。 まだ設定されていない場合は、 「ステップ 1: アカウントと組織を作成する」を確認してください。
organizationCreateSharedAccount(
accountId: ACCOUNT_ID_TO_SHARE
targetOrganizationId: "CUSTOMER_ORGANIZATION_ID_HERE"
organizationRevokeSharedAccount(
sharedAccount: { id: "SHARED_ACCOUNT_ID_HERE" }
filter: { accountId: { eq: 1234 } }
sort: { direction: ASCENDING, key: ACCOUNT_ID }
name: { contains: "text" }
organizationId: { eq: "org-id" }
sharingMode: { eq: SHARED_WITH_THIS_ORGANIZATION }
sort: { direction: ASCENDING, key: ID }
roles(filter: { organizationId: { eq: "ANY_ORG_ID" } }) {
共有アカウントのロールを変更するには、このミューテーションを使用します。 既存のアカウントのロールを検索するには、 「ロールの一覧表示」のクエリを使用します。
organizationUpdateSharedAccount(
limitingRoleId: NEW_LIMTING_ROLE_ID