Tutorial do NerdGraph: Gerenciar políticas de acesso a dados

Você pode usar nossa APINerdGraph para criar, consultar, atualizar e excluir políticas de acesso a dados. As políticas de acesso a dados controlam a quais partições de log o usuário pode acessar, permitindo restringir o acesso a dados de log confidenciais com base em grupos de usuários.

Requisitos

Para gerenciar políticas de acesso a dados via NerdGraph, você precisa de:

Uma conta New Relic Pro ou Enterprise.
Função de gerente de domínio de autenticação
tipo de usuário do usuário principal ou usuário da plataforma completa
Uma chave de usuário para autenticação.

Antes de você começar

Antes de usar a API do NerdGraph para políticas de acesso a dados, entenda como funciona o controle de acesso a dados e familiarize-se com o NerdGraph.

Atributo comum

Os seguintes atributos são comumente usados em consultas e alterações de políticas de acesso a dados:

Atributo	Descrição
`organizationId`	O ID da organização associada à política. Utilizado para filtrar políticas ou definir o escopo da criação de políticas.
`id`	O identificador único da apólice. Necessário ao atualizar ou excluir uma política específica.
`name`	Um nome amigável para o usuário para a política de acesso a dados.
`policy`	O objeto JSON que define as regras da política. Inclui: `rules`: Uma matriz de objetos de regra. `operations`: As operações a permitir ou negar (ex.: `SELECT`, ``). `eventTypes`: Um objeto que especifica quais tipos de evento `allow` (por exemplo, `[""]`) ou `except` (por exemplo, `["Log_accessible"]`).
`accountId`	O ID da conta à qual a função concede acesso.
`dataAccessPolicyId`	O ID da política de acesso a dados que define quais dados em uma conta são permitidos.
`roleId`	O ID da função que define o nível de acesso.

Operações comuns

A seguir, estão as operações mais comuns para gerenciar políticas de acesso a dados:

Esta consulta recupera todas as concessões de acesso em sua organização e suas respectivas políticas de acesso a dados. Use esta ferramenta para obter quais políticas estão atualmente atribuídas às subvenções.

Exemplo de consulta

{
  customerAdministration {
    grants(filter: { organizationId: { eq: "YOUR_ORG_ID" } }) {
      items {
        dataAccessPolicy {
          id
          name
        }
      }
    }
  }
}

Parâmetro	Descrição
`organizationId`	Obrigatório. Identificação da organização à qual as subvenções pertencem. Use o operador igual (`eq`) para filtrar.

Resposta de amostra

{
  "data": {
    "customerAdministration": {
      "grants": {
        "items": [
          {
            "dataAccessPolicy": {
              "id": "DATA_ACCESS_POLICY_ID",
              "name": "DATA_ACCESS_POLICY_NAME"
            }
          }
        ]
      }
    }
  }
}

Campo de resposta	Descrição
`items`	Lista de bolsas de estudo da organização.
`dataAccessPolicy`	A política de acesso aos dados associada a cada concessão.
`id`	O identificador único da política de acesso aos dados.
`name`	O nome da política de acesso aos dados.

Esta consulta recupera todas as políticas de acesso a dados da sua organização.

Exemplo de consulta

{
  customerAdministration {
    dataAccessPolicies(filter: { organizationId: { eq: "YOUR_ORG_ID" } }) {
      items {
        id
        name
        policy
        status
        version
      }
    }
  }
}

Parâmetro	Descrição
`organizationId`	Obrigatório. O ID da organização à qual as políticas pertencem. Use o operador igual (`eq`) para filtrar.

Resposta de amostra

{
  "data": {
    "customerAdministration": {
      "dataAccessPolicies": {
        "items": [
          {
            "id": "ddadbdd2-183b-42d9-8a1a-41ec7692fb4c",
            "name": "Log Operations",
            "policy": {
              "rules": [
                {
                  "eventTypes": {
                    "allow": ["*"],
                    "except": ["Log_Operations"]
                  },
                  "operations": ["*"]
                }
              ]
            },
            "status": "VALID",
            "version": "1.0-logs"
          },
          {
            "id": "bb8efcf5-3127-4a4d-b25f-114505a0a68d",
            "name": "Restrict Log_Security",
            "policy": {
              "rules": [
                {
                  "eventTypes": {
                    "allow": ["*"],
                    "except": ["Log_Sec%"]
                  },
                  "operations": ["*"]
                }
              ]
            },
            "status": "VALID",
            "version": "1.0-logs"
          }
        ]
      }
    }
  }
}

Campo de resposta	Descrição
`items`	Lista de políticas de acesso a dados na organização.
`id`	O identificador único da política de acesso aos dados.
`name`	O nome da política de acesso aos dados.
`policy`	O objeto JSON contendo as regras de política com `operations` e `eventTypes`.
`status`	O estado atual da política (ex.: `VALID`).
`version`	A versão da política (atualmente `1.0-logs`).

Essa mutação cria uma nova política de acesso a dados para controlar o acesso às partições de log.

Mutação de amostra

mutation createMyPolicy {
  dataAccessPolicyCreate(
    policy: {
      rules: [
        {
          operations: ["SELECT"]
          eventTypes: { allow: ["*"], except: ["Log_accessible"] }
        }
      ]
    }
    name: "Test"
    organizationId: "YOUR_ORG_ID"
  ) {
    dataAccessPolicy {
      id
    }
  }
}

Você também pode usar as seguintes variáveis:

mutation createMyPolicy($policy: DataAccessPolicyRawDocument!) {
  dataAccessPolicyCreate(
    policy: $policy
    name: "Test"
    organizationId: "YOUR_ORG_ID"
  ) {
    dataAccessPolicy {
      id
    }
  }
}

{
  "policy": {
    "rules": [
      {
        "operations": ["SELECT"],
        "eventTypes": { "allow": ["*"], "except": [] }
      }
    ]
  }
}

Parâmetro	Descrição
`organizationId`	Obrigatório. Seu ID de organização do New Relic.
`name`	Obrigatório. Um nome descritivo para a política.
`policy`	Obrigatório. O objeto JSON que define as regras da política com `operations` e `eventTypes`.

Resposta de amostra

{
  "data": {
    "dataAccessPolicyCreate": {
      "dataAccessPolicy": {
        "id": "YOUR_DATA_POLICY_ID",
        "name": "Test",
        "policy": {
          "rules": [
            {
              "eventTypes": {
                "allow": ["*"],
                "except": ["Log"]
              },
              "operations": ["*"]
            }
          ]
        },
        "status": "VALID"
      }
    }
  }
}

Campo de resposta	Descrição
`id`	O identificador único da política de acesso a dados recém-criada.
`name`	O nome da política de acesso aos dados.
`policy`	O objeto JSON contendo as regras de política com `operations` e `eventTypes`.
`status`	O estado da política (ex.: `VALID`).

Essa mutação atualiza uma política de acesso a dados existente para modificar suas regras ou seu nome.

Mutação de amostra

mutation {
  dataAccessPolicyUpdate(
    policy: {
      rules: [
        {
          operations: ["SELECT"]
          eventTypes: { allow: ["*"], except: ["Log_inaccessible"] }
        }
      ]
    }
    name: "Test"
    id: "YOUR_DATA_POLICY_ID"
  ) {
    dataAccessPolicy {
      name
      id
    }
  }
}

Parâmetro	Descrição
`id`	Obrigatório. O ID da política a ser atualizada.
`name`	Opcional. Nome atualizado para a apólice.
`policy`	Opcional. O objeto JSON que define as regras de política atualizadas com `operations` e `eventTypes`.

Resposta de amostra

{
  "data": {
    "dataAccessPolicyUpdate": {
      "dataAccessPolicy": {
        "assigned": "UNASSIGNED",
        "id": "YOUR_DATA_POLICY_ID",
        "name": "Test",
        "policy": {
          "rules": [
            {
              "eventTypes": {
                "allow": ["*"],
                "except": ["Log_inaccessible"]
              },
              "operations": ["SELECT"]
            }
          ]
        },
        "status": "VALID"
      }
    }
  }
}

Campo de resposta	Descrição
`assigned`	Indica se a política está atribuída a alguma subvenção (ex.: `UNASSIGNED`).
`id`	O identificador único da política de acesso a dados atualizada.
`name`	O nome da política de acesso aos dados.
`policy`	O objeto JSON contendo as regras de política atualizadas com `operations` e `eventTypes`.
`status`	O estado da política (ex.: `VALID`).

Essa mutação exclui uma política de acesso a dados existente.

Importante

Excluir uma política a remove de todas as concessões atribuídas. Usuários em grupos com essas permissões perderão as restrições de acesso a dados definidas pela política.

Mutação de amostra

mutation {
  dataAccessPolicyDelete(id: "YOUR_DATA_POLICY_ID") {
    dataAccessPolicy {
      name
      id
      policy
      status
    }
  }
}

Parâmetro	Descrição
`id`	Obrigatório. O ID da política a ser excluída.

Resposta de amostra

{
  "data": {
    "dataAccessPolicyDelete": {
      "dataAccessPolicy": {
        "id": "YOUR_DATA_POLICY_ID",
        "name": "Test",
        "policy": {
          "rules": [
            {
              "eventTypes": {
                "allow": ["*"],
                "except": ["Log_inaccessible"]
              },
              "operations": ["SELECT"]
            }
          ]
        },
        "status": "VALID"
      }
    }
  }
}

Campo de resposta	Descrição
`id`	O identificador único da política de acesso aos dados excluídos.
`name`	O nome da política de acesso aos dados excluídos.
`policy`	O objeto JSON contendo as regras de política que foram excluídas.
`status`	O estado da política (ex.: `VALID`).

Essa mutação cria uma nova concessão de acesso que inclui uma política de acesso a dados, atribuindo-a a uma conta e função específicas.

Mutação de amostra

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      accountAccessGrants: {
        accountId: YOUR_ACCOUNT_ID
        dataAccessPolicyId: "YOUR_DATA_POLICY_ID"
        roleId: "YOUR_ROLE_ID"
      }
    }
  ) {
    accessGrants {
      id
    }
  }
}

Parâmetro	Descrição
`accountId`	Obrigatório. O ID da conta à qual conceder acesso.
`dataAccessPolicyId`	Obrigatório. O ID da política de acesso a dados a ser aplicada.
`roleId`	Obrigatório. O ID da função define as permissões.

Resposta

A resposta mostra a concessão de acesso recém-criada com seu ID.

Esta mutação atualiza uma concessão de acesso existente para adicionar ou alterar a política de acesso aos dados.

Mutação de amostra

mutation {
  authorizationManagementUpdateAccess(
    updateAccessOptions: {
      accountAccessGrant: { dataAccessPolicyId: "YOUR_DATA_POLICY_ID" }
      ids: YOUR_GRANT_ID
    }
  ) {
    grants {
      dataAccessPolicy {
        id
      }
      id
    }
  }
}

Parâmetro	Descrição
`ids`	Obrigatório. O ID da concessão precisa ser atualizado.
`dataAccessPolicyId`	Obrigatório. O ID da política de acesso a dados a ser aplicada à concessão.

Resposta de amostra

{
  "data": {
    "authorizationManagementUpdateAccess": {
      "grants": [
        {
          "dataAccessPolicy": {
            "id": "YOUR_DATA_POLICY_ID"
          },
          "id": "YOUR_GRANT_ID"
        }
      ]
    }
  }
}

Campo de resposta	Descrição
`grants`	Lista de subsídios atualizados.
`dataAccessPolicy.id`	O ID da política de acesso a dados agora atribuída à concessão.
`id`	O ID da concessão atualizada.

Essa mutação remove uma concessão de acesso que inclui uma política de acesso a dados.

Mutação de amostra

mutation {
  authorizationManagementRevokeAccess(
    revokeAccessOptions: {
      accountAccessGrants: {
        accountId: YOUR_ACCOUNT_ID
        dataAccessPolicyId: "YOUR_DATA_POLICY_ID"
        roleId: "YOUR_ROLE_ID"
      }
    }
  ) {
    accessGrants {
      id
    }
  }
}

Parâmetro	Descrição
`accountId`	Obrigatório. O ID da conta da concessão a ser revogada.
`dataAccessPolicyId`	Obrigatório. O ID da política de acesso aos dados da concessão a ser revogada.
`roleId`	Obrigatório. O ID da função da concessão a ser revogada.

Resposta

A resposta mostra a concessão de acesso revogada com seu respectivo ID.

Guia de interface do usuário para controle de acesso a dados

Aprenda a gerenciar políticas de acesso a dados por meio da interface do usuário do New Relic.

Conceitos de gerenciamento de usuários

Compreender os tipos de usuários, funções e gerenciamento de acesso.

Gerenciar usuário com NerdGraph

Utilize a API do NerdGraph para gerenciar programaticamente usuários e permissões de acesso.

Partições de log

Aprenda como organizar seus dados de log em partições.

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

Tutorial do NerdGraph: Gerenciar políticas de acesso a dados

Requisitos

Antes de você começar

Atributo comum

Operações comuns

Políticas de acesso a dados de consulta associadas a concessões de acesso.

Exemplo de consulta

Resposta de amostra

consultar políticas de acesso a dados para uma organização

Exemplo de consulta

Resposta de amostra

Criar uma política de acesso a dados

Mutação de amostra

Resposta de amostra

Atualizar uma política de acesso a dados

Mutação de amostra

Resposta de amostra

Excluir uma política de acesso a dados

Importante

Mutação de amostra

Resposta de amostra

Criar uma concessão de acesso com uma política de acesso a dados

Mutação de amostra

Resposta

Atualizar uma concessão de acesso com uma política de acesso a dados

Mutação de amostra

Resposta de amostra

Revogar uma concessão de acesso com uma política de acesso a dados

Mutação de amostra

Resposta

Guia de interface do usuário para controle de acesso a dados

Conceitos de gerenciamento de usuários

Gerenciar usuário com NerdGraph

Partições de log

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

Tutorial do NerdGraph: Gerenciar políticas de acesso a dados

Requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Antes de você começar

Atributo comum

Operações comuns

consultar políticas de acesso a dados para uma organização

Criar uma política de acesso a dados

Atualizar uma política de acesso a dados

Excluir uma política de acesso a dados

Criar uma concessão de acesso com uma política de acesso a dados

Atualizar uma concessão de acesso com uma política de acesso a dados

Revogar uma concessão de acesso com uma política de acesso a dados

Tópicos relacionados

Guia de interface do usuário para controle de acesso a dados

Conceitos de gerenciamento de usuários

Gerenciar usuário com NerdGraph

Partições de log

Requisitos