Crear roles personalizados para Scorecards

Un Scorecard sirve como contenedor para varias reglas que evalúan colectivamente el cumplimiento de los estándares definidos. Los scorecards utilizan reglas para monitorear el cumplimiento en diferentes entidades y equipos, identificar áreas de mejora y garantizar la alineación con los requisitos tanto internos como externos.

Acceso predeterminado a Scorecards

New Relic proporciona acceso predeterminado a Scorecards a través de estos roles estándar:

Acción	Rol requerido
Ver cuadros de mando	Organization read only
Crear, actualizar y eliminar Scorecards y reglas	Organization Product Admin o un rol personalizado de Scorecards

Acción

Rol requerido

Ver cuadros de mando

Organization read only

Crear, actualizar y eliminar Scorecards y reglas

Organization Product Admin

o un rol personalizado de Scorecards

Es posible que necesite un rol personalizado si los permisos predeterminados no satisfacen las necesidades de su organización.

Capacidades de las tarjetas de puntuación

Al crear un rol personalizado para Scorecards, utilice los siguientes permisos. Los permisos de Scorecards tienen alcance de organización.

Capacidad	Identificador de permiso
Leer Scorecards (también otorga `scorecards.read.rule` )	`scorecards.read.scorecard`
Crear, actualizar y eliminar Scorecards	`scorecards.modify.scorecard`
Leer reglas de Scorecard	`scorecards.read.rule`
Crear, actualizar y eliminar reglas de Scorecard	`scorecards.modify.rule`

Requisitos previos

Antes de comenzar, cerciorar de tener:

Requisitos generales de NerdGraph
Administrador de la organización con rol Organization Product Admin para crear roles personalizados

Sugerencia

También puede crear un rol personalizado para Scorecards a través de la UI. Para conocer los permisos que se deben seleccionar y el alcance que se debe usar, consulte Capacidades de Scorecards.

Para crear un rol personalizado a través de la API de NerdGraph, realice los siguientes pasos:

Encuentre los ID de licencias necesarias para los cuadros de mando

Use la consulta customerAdministration para obtener una lista de capacidades, sus ID de permisos e información relacionada. Filtre por scope: "organization" para obtener los permisos de Scorecards.

parámetro de entrada

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

Parámetro

Tipo de datos

¿Es obligatorio?

Descripción

eq

Cadena

Sí

Establezca el valor en

organization

para recuperar licencias 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"
          }
        ]
      }
    }
  }
}

De la respuesta, identifique y copie los ID de permiso donde feature sea "Scorecards" o "Scorecards Rules" y category coincida con el nivel de acceso que desea otorgar. Necesitarás estos ID en el siguiente paso.

Recuperar el ID de su organización

Recupere el ID de su organización, que empleará en mutaciones posteriores.

Solicitud de muestra

{
  actor {
    organization {
      id
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "actor": {
      "organization": {
        "id": "YOUR_ORGANIZATION_ID"
      }
    }
  }
}

Copia tu ID de organización de la respuesta. Lo necesitará para crear el rol personalizado.

Crear el rol personalizado

Usa la mutación customRoleCreate para crear tu rol personalizado para la gestión de Scorecards.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`id`	Cadena	Sí	El ID de la organización del paso anterior.
`type`	Cadena	Sí	Establezca en `organization` .
`name`	Cadena	Sí	El nombre para mostrar del rol personalizado.
`permissionIds`	Matriz de números enteros	Sí	Los ID de permisos de Scorecards identificados en el Paso 1.
`scope`	Cadena	Sí	Establezca en `organization` .

Solicitud de muestra

mutation {
  customRoleCreate(
    container: { id: "YOUR_ORGANIZATION_ID", type: "organization" }
    name: "Scorecards manager"
    permissionIds: [xxxxx, xxxxx]
    scope: "organization"
  ) {
    id
  }
}

Ejemplo de respuesta

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

Guarde el ID del rol devuelto — lo necesitará para asignar este rol a un grupo de usuarios.

Agregar el rol personalizado a un grupo de usuarios

Después de crear el rol personalizado, asígnalo a un grupo de usuarios en New Relic.

Recuperar los ID de grupos

Emplee la consulta customerAdministration para obtener una lista de grupos de usuarios disponibles.

parámetro de entrada

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

Solicitud de muestra

{
  customerAdministration {
    groups(filter: { organizationId: { eq: "YOUR_ORGANIZATION_ID" } }) {
      nextCursor
      items {
        id
        name
        users {
          items {
            id
            email
          }
        }
      }
    }
  }
}

De la respuesta, copie el ID del grupo al que desea asignar el rol de Scorecards.

Asigna el rol al grupo

Emplee la mutación authorizationManagementGrantAccess para asignar el rol personalizado 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 del paso anterior.
`groupId`	Cadena	Sí	El ID de grupo obtenido anteriormente.

Solicitud de muestra

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      organizationAccessGrants: { roleId: "YOUR_ROLE_ID" }
      groupId: "YOUR_GROUP_ID"
    }
  ) {
    roles {
      id
      name
      organizationId
      roleId
      groupId
      displayName
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "authorizationManagementGrantAccess": {
      "roles": [
        {
          "displayName": "Scorecards manager",
          "groupId": null,
          "id": "99999999",
          "name": "scorecards_manager",
          "organizationId": "YOUR_ORGANIZATION_ID",
          "roleId": 99999
        }
      ]
    }
  }
}

Administrar roles personalizados existentes

Usa la mutación customRoleUpdate para renombrar un rol o reemplazar su conjunto de permisos.

mutation {
  customRoleUpdate(
    id: ROLE_ID
    name: "Updated role name"
    permissionIds: [xxxxx, xxxxx]
  ) {
    id
  }
}

Parámetro	Descripción
`id`	El ID del rol a actualizar.
`name`	Nuevo nombre para mostrar del rol.
`permissionIds`	Lista completa de reemplazo de ID de permisos. Esto reemplaza todos los permisos existentes en el rol.

Usa la mutación customRoleDelete para eliminar permanentemente un rol personalizado.

mutation {
  customRoleDelete(id: ROLE_ID) {
    id
  }
}

La respuesta devuelve el ID del rol eliminado, lo que confirma la eliminación exitosa.

Use la siguiente consulta para buscar un ID de rol explorando los grupos de su organización y sus roles asignados.

{
  actor {
    organization {
      authorizationManagement {
        authenticationDomains(id: "YOUR_AUTHENTICATION_DOMAIN_ID") {
          authenticationDomains {
            groups {
              groups {
                displayName
                id
                roles {
                  roles {
                    roleId
                    name
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Para obtener más información sobre los Cuadros de mando, consulte la documentación de Cuadros de mando.

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

Crear roles personalizados para Scorecards

Acceso predeterminado a Scorecards

Capacidades de las tarjetas de puntuación

Requisitos previos

Sugerencia

Encuentre los ID de licencias necesarias para los cuadros de mando

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Recuperar el ID de su organización

Solicitud de muestra

Ejemplo de respuesta

Crear el rol personalizado

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Agregar el rol personalizado a un grupo de usuarios

Recuperar los ID de grupos

parámetro de entrada

Solicitud de muestra

Asigna el rol al grupo

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Administrar roles personalizados existentes

Actualizar un rol

Eliminar un rol

Encontrar el ID de un rol personalizado

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

Crear roles personalizados para Scorecards

Acceso predeterminado a Scorecards .css-21sua1{background:none;border:none;width:0;padding:0;}

Capacidades de las tarjetas de puntuación

Requisitos previos

Sugerencia

Encuentre los ID de licencias necesarias para los cuadros de mando

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Recuperar el ID de su organización

Solicitud de muestra

Ejemplo de respuesta

Crear el rol personalizado

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Agregar el rol personalizado a un grupo de usuarios

Recuperar los ID de grupos

parámetro de entrada

Solicitud de muestra

Asigna el rol al grupo

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Administrar roles personalizados existentes

Eliminar un rol

Encontrar el ID de un rol personalizado

Acceso predeterminado a Scorecards