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

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.

New Relic Teams permite que você conecte a entidade que está monitorando às equipes que as possuem. Quando você consegue ver facilmente quem é o proprietário de uma entidade, você pode acelerar a resolução de problemas, melhorar a colaboração da equipe e melhorar sua eficiência operacional.

Acesso padrão às equipes

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

Acesso de leitura: todos os usuários têm acesso de leitura ao Teams, incluindo metadados como informações de contato, membros da equipe e outros detalhes relevantes.
Modificar equipes: o usuário com a função Organization Product Admin pode modificar equipes. Esta é uma nova função atribuída a todos os usuários que atualmente têm a função All Product Admin.
Criar e excluir equipes: usuários com funções Organization Manager ou Authentication Manager podem criar e excluir equipes.

Você pode precisar de uma função personalizada se as permissões padrão não atenderem às necessidades da sua organização. Este tutorial mostra como usar mutações GraphQL do NerdGraph para criar uma função personalizada para gerenciar equipes.

Visão geral do processo

Para criar uma função personalizada de administrador do Teams, você precisará:

Recuperar todos os recursos do escopo da organização
Recupere o ID da sua organização
Identifique os IDs de permissão necessários para as equipes
Crie a função personalizada para administrador do Teams
Adicione a função personalizada a um grupo de usuários

Pré-requisitos

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

Requisitos gerais do NerdGraph
Permissões de função de administrador da organização para criar funções personalizadas

Mutações

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

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 para equipes.

Parâmetro

Tipo de dados

É obrigatório?

Descrição

eq

Corda

Sim

Defina o valor como

organization

para recuperar a função para equipes.

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

Próximo passo: A partir da resposta, identifique e copie os IDs de permissão onde:

category: "MANAGE" (ou a categoria apropriada para suas necessidades)
feature: "Teams"

Você precisará desses IDs para a próxima etapa.

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": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
      }
    }
  }
}

Próximo passo: copie o ID da sua organização da resposta. Você precisará dele para criar a função personalizada.

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

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`	Matriz de inteiros	Sim	Os IDs de permissão para o recurso do Teams recuperados na primeira etapa.
`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: "Teams manager"
    permissionIds: [xxxxx, xxxxx]
    scope: "organization"
  ) {
    id
  }
}

Resposta de amostra

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

Próxima etapa: salve o ID da função retornado. Você precisará dele para atribuir essa função a um grupo de usuários.

Depois de criar a função personalizada, você precisa atribuí-la a um grupo de usuários no New Relic.

Etapa 1: recuperar IDs de grupo

Use a mutação 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 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
          }
        }
      }
    }
  }
}

Próxima etapa: na resposta, copie o ID do grupo ao qual você deseja atribuir a função Equipes.

Etapa 2: atribuir a função a um grupo de usuários

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 da Etapa 1.

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": "Teams manager",
          "groupId": null,
          "id": "99999999",
          "name": "teams_manager",
          "organizationId": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX",
          "roleId": 99999
        }
      ]
    }
  }
}

Qual é o próximo

Após criar e atribuir com sucesso sua função personalizada do Teams, o usuário no grupo atribuído terá as permissões que você configurou. Você pode:

Monitore o uso da função através do gerenciamento de usuários da sua organização
Modifique as permissões de função, se necessário, usando mutações semelhantes do NerdGraph
Crie funções personalizadas adicionais para diferentes níveis de acesso às equipes

Para obter mais informações sobre o Teams, consulte nossa documentação do Teams.

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

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

visualização

Acesso padrão às equipes

Visão geral do processo

Pré-requisitos

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

Etapa 1: recuperar IDs de grupo

Parâmetro de entrada

Solicitação de amostra

Etapa 2: atribuir a função a um grupo de usuários

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Qual é o próximo

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

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

visualização

Acesso padrão às equipes.css-21sua1{background:none;border:none;width:0;padding:0;}

Visão geral do processo

Pré-requisitos

Mutações

Recupere o ID da sua organização

Criar função personalizada

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

Qual é o próximo

Acesso padrão às equipes