Criar funções personalizadas para equipes

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:

Ação	Função necessária
Visualizar equipes	Organization read only
Modificar equipes	Organization Product Admin
Criar e excluir equipes	Organization Manager ou Authentication Manager

Ação

Função necessária

Visualizar equipes

Organization read only

Modificar equipes

Organization Product Admin

Criar e excluir equipes

Organization Manager

Authentication Manager

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 equipes

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

Capacidade	Identificador da permissão
Ler equipes	`teams.read.team`
Excluir equipes	`teams.delete.team`
Criar equipes	`teams.create.team`
Modificar equipes	`teams.update.team`
Acesso de leitura à página de automações/configurações	`teams.read.organization_settings`
Modificar o acesso à página de automações/configurações	`teams.manage.organization_settings`
Crie equipes a partir de grupos de usuários do IdP (por exemplo, Okta)	`authentication_domain.read.groups`

Pré-requisitos

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

Requisitos gerais do NerdGraph
Administrador da organização com função Authentication Domain Manager para criar funções personalizadas

Dica

Você também pode criar uma função personalizada para o Teams pela interface. Para as permissões a selecionar e o escopo a usar, consulte Recursos de Equipes.

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

Encontre os IDs de permissão necessários para o Teams.

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 as permissões do Teams.

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 o Teams.

Parâmetro

Tipo de dados

É obrigatório?

Descrição

eq

Corda

Sim

Defina o valor como

organization

para recuperar as permissões para o Teams.

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

Na resposta, identifique e copie os IDs de permissão em que feature é "Teams" e o 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 gerenciamento de equipes.

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 Teams identificados na Etapa 1.
`scope`	Corda	Sim	Definido como `organization` .

Solicitação de amostra

mutation {
  customRoleCreate(
    container: { id: "YOUR_ORGANIZATION_ID", type: "organization" }
    name: "Teams 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 do Teams.

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": "Teams manager",
          "groupId": null,
          "id": "99999999",
          "name": "teams_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 o Teams, consulte a documentação do Teams.

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

Criar funções personalizadas para equipes

Acesso padrão às equipes

Recursos de equipes

Pré-requisitos

Dica

Encontre os IDs de permissão necessários para o Teams.

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 equipes

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

Recursos de equipes

Pré-requisitos

Dica

Encontre os IDs de permissão necessários para o Teams.

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 às equipes