Criar funções personalizadas para scorecards

Um Scorecard serve como um contêiner para várias regras que avaliam coletivamente a adesão a padrões definidos. Scorecards usam regras para monitorar a conformidade em diferentes entidades e equipes, identificar áreas de melhoria e garantir o alinhamento com requisitos tanto internos quanto externos.

Acesso padrão aos Scorecards

O New Relic fornece acesso padrão aos Scorecards por meio destas funções padrão:

Ação	Função necessária
Visualizar Scorecards	Organization read only
Criar, atualizar e excluir Scorecards e regras	Organization Product Admin ou uma função personalizada do Scorecards

Ação

Função necessária

Visualizar Scorecards

Organization read only

Criar, atualizar e excluir Scorecards e regras

Organization Product Admin

ou uma função personalizada do Scorecards

Você pode precisar de uma função personalizada se as permissões padrão não atenderem às necessidades da sua organização.

Recursos de scorecards

Ao criar uma função personalizada para Scorecards, use as permissões abaixo. As permissões de Scorecards têm escopo de organização.

Capacidade	Identificador da permissão
Ler Scorecards (também concede `scorecards.read.rule` )	`scorecards.read.scorecard`
Criar, atualizar e excluir Scorecards	`scorecards.modify.scorecard`
Ler regras do Scorecard	`scorecards.read.rule`
Criar, atualizar e excluir regras do Scorecard	`scorecards.modify.rule`

Pré-requisitos

Antes de começar, certifique-se de ter:

Requisitos gerais do NerdGraph
Administrador da organização com função Organization Product Admin para criar funções personalizadas

Dica

Você também pode criar uma função personalizada para Scorecards pela interface. Para as permissões a serem selecionadas e o escopo a ser usado, consulte Capacidades do Scorecards.

Para criar uma função personalizada via API NerdGraph, execute as seguintes etapas:

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

Use a consulta customerAdministration para recuperar uma lista de capacidades, seus IDs de permissão e informações relacionadas. Filtre por scope: "organization" para obter permissões de Scorecards.

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

A partir da resposta, identifique e copie os IDs de permissão em que feature é "Scorecards" ou "Scorecards Rules" e category corresponde ao nível de acesso que você deseja conceder. Você precisará desses IDs na próxima etapa.

Recupere o ID da sua organização

Recupere o ID da sua organização, que você usará em mutações subsequentes.

Solicitação de amostra

{
  actor {
    organization {
      id
    }
  }
}

Resposta de amostra

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

Copie o ID da sua organização da resposta. Você precisará disso para criar a função personalizada.

Criar a função personalizada

Use a mutação customRoleCreate para criar sua função personalizada para o gerenciamento de Scorecards.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`id`	Corda	Sim	O ID da organização da etapa anterior.
`type`	Corda	Sim	Definido como `organization` .
`name`	Corda	Sim	O nome de exibição para a função personalizada.
`permissionIds`	Matriz de inteiros	Sim	Os IDs de permissão do Scorecards identificados na Etapa 1.
`scope`	Corda	Sim	Definido como `organization` .

Solicitação de amostra

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

Resposta de amostra

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

Salve o ID da função retornado — você precisará dele para atribuir essa função a um grupo de usuários.

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

Após criar a função personalizada, atribua-a a um grupo de usuários no New Relic.

Recuperar IDs de grupo

Use a consulta customerAdministration para obter uma lista de grupos de usuários disponíveis.

Parâmetro de entrada

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

Solicitação de amostra

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

A partir da resposta, copie o ID do grupo ao qual você deseja atribuir a função Scorecards.

Atribua a função ao grupo

Use a mutação authorizationManagementGrantAccess para atribuir a função personalizada 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 da etapa anterior.
`groupId`	Corda	Sim	O ID do grupo obtido acima.

Solicitação de amostra

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

Resposta de amostra

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

Gerenciar funções personalizadas existentes

Use a mutação customRoleUpdate para renomear uma função ou substituir seu conjunto de permissões.

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

Parâmetro	Descrição
`id`	O ID da função a ser atualizada.
`name`	Novo nome de exibição para a função.
`permissionIds`	Lista completa de substituição de IDs de permissão. Isso substitui todas as permissões existentes na função.

Use a mutação customRoleDelete para remover permanentemente uma função personalizada.

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

A resposta retorna o ID da função excluída, confirmando a exclusão bem-sucedida.

Use a seguinte consulta para buscar um ID de função navegando pelos grupos da sua organização e suas funções atribuídas.

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

Para obter mais informações sobre Scorecards, consulte a documentação de Scorecards.

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

Criar funções personalizadas para scorecards

Acesso padrão aos Scorecards

Recursos de scorecards

Pré-requisitos

Dica

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 a função personalizada

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

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

Recuperar IDs de grupo

Parâmetro de entrada

Solicitação de amostra

Atribua a função ao grupo

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Gerenciar funções personalizadas existentes

Atualizar uma função

Excluir uma função

Encontrar o ID de uma função personalizada

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

Criar funções personalizadas para scorecards

Acesso padrão aos Scorecards .css-21sua1{background:none;border:none;width:0;padding:0;}

Recursos de scorecards

Pré-requisitos

Dica

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 a função personalizada

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

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

Recuperar IDs de grupo

Parâmetro de entrada

Solicitação de amostra

Atribua a função ao grupo

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Gerenciar funções personalizadas existentes

Excluir uma função

Encontrar o ID de uma função personalizada

Acesso padrão aos Scorecards