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

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

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:

Administração 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:

Recuperar todos os recursos do escopo da organização
Recupere o ID da sua organização
Encontre os IDs de permissão necessários para Scorecards
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ê deve ser um administrador 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 mutação 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 a função dos Scorecards.

Parâmetro

Tipo de dados

É obrigatório?

Descrição

eq

Corda

Sim

Defina o valor como

organization

para recuperar a função dos 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.
`PermissionId`	Interno	Sim	Liste os IDs do recurso recuperado usando mutações `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 mutação 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.

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

visualização

Mutações

Recuperar capacidades no escopo da organização

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