Tutorial de NerdGraph: Crear un rol personalizado para los cuadros de mando

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

Un cuadro de mando sirve como contenedor de varias reglas que evalúan colectivamente el cumplimiento de estándares definidos. Los cuadros de mando emplean reglas para monitorear el cumplimiento en diferentes entidades y equipos, identificar áreas de mejora y garantizar la alineación con los requisitos internos y externos. Este documento proporciona instrucciones sobre cómo crear y gestionar cuadros de mando y sus reglas en New Relic.

En New Relic, dos tipos de usuarios pueden gestionar cuadros de mando:

Administrador de la organización
Rol personalizado de usuario del cuadro de mando

Esta sección proporciona instrucciones sobre el uso de mutaciones GraphQL de NerdGraph para crear un rol personalizado para gestionar cuadros de mando y reglas asociadas.

Para crear un rol personalizado de administrador de Scorecards, debe:

Recupere todas las capacidades del ámbito de la organización
Recuperar el ID de su organización
Encuentre los ID de licencias necesarias para los cuadros de mando
Crear el rol personalizado para el administrador de Scorecards
Agregar el rol personalizado a un grupo de usuarios

Prerrequisitos:

Requisitos generales de NerdGraph
Debes ser administrador de la organización para crear una función personalizada.

Mutaciones

New Relic proporciona varias mutaciones de NerdGraph para crear roles personalizados para los administradores de Scorecards.

Emplee la mutación customerAdministration para recuperar una lista de capacidades, sus ID de licencias e información relacionada.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`eq`	Cadena	Sí	Establezca el valor en `organization` para recuperar la función para los cuadros de mando.

Parámetro

Tipo de datos

¿Es obligatorio?

Descripción

eq

Cadena

Sí

Establezca el valor en

organization

para recuperar la función para los cuadros de mando.

Solicitud de muestra

{
  customerAdministration {
    permissions(filter: { scope: { eq: "organization" } }) {
      items {
        feature
        category
        id
        product
      }
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "customerAdministration": {
      "permissions": {
        "items": [
          {
            "category": "READ",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MANAGE",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "READ",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MANAGE",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "READ",
            "feature": "Teams",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "OTHER",
            "feature": "Teams",
            "id": "xxxxxx",
            "product": "New Relic One"
          },
          {
            "category": "DELETE",
            "feature": "Teams",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MODIFY",
            "feature": "Teams",
            "id": "xxxxxx",
            "product": "New Relic One"
          }
        ]
      }
    }
  }
}

Copie y pegue la información relacionada con Scorecards en un archivo de texto que coincida con los siguientes criterios:

category: MANAGE
"feature"``: "Scorecards" o “Scorecards Rules”

Por ejemplo, en la respuesta anterior, lo siguiente coincide con los criterios:

{
            "category": "MANAGE",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
{
            "category": "MANAGE",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          }

Obtenga el ID de su organización para usarlo en varias mutaciones futuras.

Solicitud de muestra

{
  actor {
    organization {
      id
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "actor": {
      "organization": {
        "id": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
      }
    }
  }
}

Copie el ID de la organización y déjelo a un lado para crear un rol.

Ejecute la mutación customRoleCreate para crear su propio rol personalizado.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`id`	Cadena	Sí	El ID de la organización copiado en el paso anterior.
`type`	Cadena	Sí	Establezca el tipo en `organization` .
`name`	Cadena	Sí	El nombre del rol.
`PermissionId`	En t	Sí	Enumere los identificadores de las características recuperadas mediante mutaciones `customerAdministration` para tarjetas de puntaje y reglas de tarjetas de puntaje.
`scope`	Cadena	Sí	Establezca el alcance en `organization` .

Solicitud de muestra

mutation {
  customRoleCreate(
    container: {
      id: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
      type: "organization"
    }
    name: "Scorecards manager"
    permissionIds: [xxxxx, xxxxx]
    scope: "organization"
  ) {
    id
  }
}

Ejemplo de respuesta

{
  "data": {
    "customRoleCreate": {
      "id": 9999999
    }
  }
}

Parámetro	Tipo de datos	Descripción
`id`	En t	El ID del rol personalizado. Copie y conserve esta identificación para uso futuro.

Luego de crear el rol personalizado, debe asociarlo con un grupo de usuarios en la plataforma New Relic .

Obtener el ID del grupo

Puede emplear la mutación customerAdministration para recuperar la lista de ID de grupo.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`id`	Cadena	Sí	El ID de la organización copiado en el paso anterior.

Solicitud de muestra

{
  customerAdministration {
    groups(
      filter: {
        organizationId: { eq: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX" }
      }
    ) {
      nextCursor
      items {
        id
        name
        users {
          items {
            id
            email
          }
        }
      }
    }
  }
}

De la lista de ID de grupo que se muestra, copie el ID de grupo que desee asociar con el rol de Scorecard personalizado que creó anteriormente.

Agregar la regla a un grupo de usuarios

Puede emplear la mutación authorizationManagementGrantAccess para agregar el rol a un grupo de usuarios.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`roleId`	Cadena	Sí	El ID del rol personalizado creado en la sección Rol personalizado .
`groupId`	Cadena	No	El ID de grupo recuperado en el paso anterior.

Parámetro

Tipo de datos

¿Es obligatorio?

Descripción

roleId

Cadena

Sí

El ID del rol personalizado creado en la sección

Rol personalizado

groupId

Cadena

El ID de grupo recuperado en el paso anterior.

Solicitud de muestra

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      organizationAccessGrants: { roleId: "99999999" }
      groupId: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
    }
  ) {
    roles {
      id
      name
      organizationId
      roleId
      groupId
      displayName
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "authorizationManagementGrantAccess": {
      "roles": [
        {
          "displayName": "Scorecards manager",
          "groupId": null,
          "id": "99999999",
          "name": "scorecards_manager",
          "organizationId": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX",
          "roleId": 99999
        }
      ]
    }
  }
}

Conoce el nuevo rol en la plataforma New Relic

Puede validar si el rol del cuadro de mando se refleja en la plataforma New Relic.

Para comprobar el rol:

Inicie sesión en su cuenta de New Relic.
Haga clic en su nombre en la parte inferior izquierda.
Vaya a Administration > Access Management.
Haga clic en la pestaña Grants : Puede ver el rol personalizado que creó en la lista de roles:

Te ofrecemos esta traducción automática para facilitar la lectura.

Tutorial de NerdGraph: Crear un rol personalizado para los cuadros de mando

avance

Mutaciones

Recuperar capacidades del ámbito de la organización

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Recuperar el ID de su organización

Solicitud de muestra

Ejemplo de respuesta

Crear un rol personalizado

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Agregar un rol personalizado a un grupo de usuarios

Obtener el ID del grupo

parámetro de entrada

Solicitud de muestra

Agregar la regla a un grupo de usuarios

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Conoce el nuevo rol en la plataforma New Relic