Tutorial do NerdGraph: Criar função personalizada para Scorecards

Um Scorecard serve como um contêiner para várias regras que avaliam coletivamente a adesão a padrões definidos. Os scorecards usam regras para monitorar a conformidade entre diferentes entidades e equipes, identificar áreas para melhoria e garantir o alinhamento com os requisitos internos e externos. Este documento fornece instruções sobre como criar e gerenciar Scorecards e suas regras no New Relic.

No New Relic, dois tipos de usuários podem gerenciar Scorecards:

Administrador de produtos da organização
Função personalizada do scorecard usuário

Esta seção fornece instruções sobre como usar mutações GraphQL do NerdGraph para criar uma função personalizada para gerenciar Scorecards e regras associadas.

Para criar uma função personalizada de administrador de Scorecards, você precisa:

Encontre os IDs de permissão necessários para Scorecards
Recupere o ID da sua organização
Crie a função personalizada para administrador de Scorecards
Adicione a função personalizada a um grupo de usuários

Pré-requisitos:

Requisitos gerais do NerdGraph
Você precisa ser um Administrador de produto da organização para criar uma função personalizada.

Mutações

O New Relic fornece várias mutações do NerdGraph para criar funções personalizadas para gerentes de Scorecards.

Use a consulta customerAdministration para recuperar uma lista de recursos, seus IDs de permissão e informações relacionadas.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`eq`	Corda	Sim	Defina o valor como `organization` para recuperar as permissões para Scorecards.

Parâmetro

Tipo de dados

É obrigatório?

Descrição

eq

Corda

Sim

Defina o valor como

organization

para recuperar as permissões para Scorecards.

Solicitação de amostra

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

Resposta de amostra

{
  "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 e cole as informações relacionadas aos Scorecards em um arquivo de texto que corresponda aos seguintes critérios:

category: MANAGE
"feature"``: "Scorecards" ou "Scorecards Rules"

Por exemplo, na resposta anterior, o seguinte corresponde aos critérios:

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

Obtenha o ID da sua organização para usar em diversas mutações futuras.

Solicitação de amostra

{
  actor {
    organization {
      id
    }
  }
}

Resposta de amostra

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

Copie o ID da organização e reserve-o para criar uma função.

Execute a mutação customRoleCreate para criar sua própria função personalizada.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	Corda	Sim	O ID da organização copiada na etapa anterior.
`type`	Corda	Sim	Defina o tipo como `organization` .
`name`	Corda	Sim	O nome da função.
`permissionIds`	[Int]	Sim	Liste os IDs para o recurso identificado usando a consulta `customerAdministration` para Scorecards e regras de Scorecards.
`scope`	Corda	Sim	Defina o escopo como `organization` .

Solicitação de amostra

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
  }
}

Resposta de amostra

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

Parâmetro	Tipo de dados	Descrição
`id`	Interno	O ID da função personalizada. Copie e guarde este documento de identificação para uso futuro.

Depois de criar a função personalizada, você deve associá-la a um grupo de usuários na plataforma New Relic .

Obter o ID do grupo

Você pode usar a consulta customerAdministration para recuperar a lista de IDs de grupo.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	Corda	Sim	O ID da organização copiada na etapa anterior.

Solicitação de amostra

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

Na lista de IDs de grupo exibida, copie o ID de grupo desejado para associar a função do Scorecard personalizada que você criou anteriormente.

Adicione a regra a um grupo de usuários

Você pode usar a mutação authorizationManagementGrantAccess para adicionar a função a um grupo de usuários.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`roleId`	Corda	Sim	O ID da função personalizada criado na seção Função personalizada.
`groupId`	Corda	Não	O ID do grupo recuperado na etapa anterior.

Solicitação de amostra

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

Resposta de amostra

{
  "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
        }
      ]
    }
  }
}

Confira a nova função na plataforma New Relic

Você pode validar se a função do scorecard está refletida na plataforma New Relic.

Para verificar a função:

Entre na sua conta New Relic.
Clique no seu nome no canto inferior esquerdo.
Vá para Administration > Access Management.
Clique na aba Grants : Você pode ver a função personalizada que criou na lista de funções:

Esta tradução de máquina é fornecida para sua comodidade.

Tutorial do NerdGraph: Criar função personalizada para Scorecards

Mutações

Encontre os IDs de permissão necessários para Scorecards

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Recupere o ID da sua organização

Solicitação de amostra

Resposta de amostra

Criar função personalizada

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Adicionar função personalizada a um grupo de usuários

Obter o ID do grupo

Parâmetro de entrada

Solicitação de amostra

Adicione a regra a um grupo de usuários

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Confira a nova função na plataforma New Relic

Esta tradução de máquina é fornecida para sua comodidade.

Tutorial do NerdGraph: Criar função personalizada para Scorecards

Mutações .css-21sua1{background:none;border:none;width:0;padding:0;}

Recupere o ID da sua organização

Criar função personalizada

Adicionar função personalizada a um grupo de usuários

Confira a nova função na plataforma New Relic

Mutações