Paso 3: Compartir cuentas (opcional)

Compartir cuentas permite que el administrador de una organización administradora haga que los datos que está monitoreando sean visibles para su organización gestionada. Una vez que configuró el uso compartido de cuentas inicial en la estructura de su organización de alto contacto (consulte Crear cuentas y organización), es posible que considere necesario realizar algunos cambios de seguimiento.

Digamos que usted es un administrador en el MSP de Betty (un proveedor de servicios gestionado) que monitorear una cuenta gestionada para sus clientes de Wayne Enterprises. También compartiste esa cuenta con la organización Wayne Enterprises. A continuación se muestran algunas tareas de seguimiento que podría realizar:

Requisitos

Para emplear esta función, cerciorar de completar lo siguiente para su organización:

1. Obtener aprobación: comunicar con su representante de cuenta para confirmar que su organización se agregó a la tenencia múltiple. Una vez aprobado, recibirá el derecho de múltiples inquilinos.
2. Cerciorar de tener los tipos de usuario correctos: el usuario dentro de la organización administradora que aprovechará el conjunto de características anterior debe estar aprovisionado como usuario principal o de plataforma completa.
3. Agregar usuario al grupo apropiado: el usuario con el tipo de usuario de plataforma principal o completa debe agregar a un grupo con tenant_settings aplicado.

¿Cómo puedes llamar en Nerdgraph?

Para ayudarlo a familiarizar con el uso compartido de cuentas, tenemos algunos ejemplos básicos a continuación. Primero, echemos un vistazo a la rutina general:

1. La organización de origen obtiene el ID de la organización de la organización de destino. Puede obtener el ID de la organización objetivo del usuario de la organización objetivo cuando ve su pestaña Access Management [Administración de acceso].
2. La organización de origen llama a la API y pasa el ID de la organización de destino, el ID de la cuenta y el rol limitante. La organización de origen puede declarar un rol limitante que define las capacidades máximas a las que estará restringido el usuario de la organización objetivo.

Estos son los tipos de llamadas que puedes realizar para compartir cuentas:

mutation {
  organizationCreateSharedAccount(
    sharedAccount: {
      accountId: ACCOUNT_ID_TO_SHARE
      limitingRoleId: 0
      targetOrganizationId: "CUSTOMER_ORGANIZATION_ID_HERE"
    }
  ) {
    sharedAccount {
      accountId
      id
      limitingRoleId
      name
    }
  }
}

mutation {
  organizationRevokeSharedAccount(
    sharedAccount: { id: "SHARED_ACCOUNT_ID_HERE" }
  ) {
    sharedAccount {
      accountId
      id
      limitingRoleId
      name
      sourceOrganizationId
      sourceOrganizationName
      targetOrganizationId
      targetOrganizationName
    }
  }
}

{
  customerAdministration {
    accountShares(
      cursor: ""
      filter: { accountId: { eq: 1234 } }
      sort: { direction: ASCENDING, key: ACCOUNT_ID }
    ) {
      items {
        accountId
        id
        limitingRole {
          id
        }
        name
        source {
          id
          name
        }
        target {
          id
        }
      }
    }
  }
}

{
  customerAdministration {
    accounts(
      cursor: ""
      filter: {
        id: { eq: 1234 }
        name: { contains: "text" }
        organizationId: { eq: "org-id" }
        sharingMode: { eq: SHARED_WITH_THIS_ORGANIZATION }
        status: { eq: ACTIVE }
      }
      sort: { direction: ASCENDING, key: ID }
    ) {
      nextCursor
    }
  }
}

{
  customerAdministration {
    roles(filter: { organizationId: { eq: "ANY_ORG_ID" } }) {
      items {
        id
        name
        scope
        type
      }
    }
  }
}

mutation {
  organizationUpdateSharedAccount(
    sharedAccount: {
      id: "SHARE_ACCOUNT_ID"
      limitingRoleId: NEW_LIMTING_ROLE_ID
    }
  ) {
    sharedAccount {
      accountId
      id
      limitingRoleId
      name
      sourceOrganizationId
      sourceOrganizationName
      targetOrganizationId
      targetOrganizationName
    }
  }
}