Tutorial de NerdGraph: Gestionar las políticas de acceso a datos

Puede emplear nuestra APINerdGraph para crear, consultar, actualizar y eliminar políticas de acceso a datos. Las políticas de acceso a datos controlan a qué particiones de log puede acceder su usuario, lo que le permite restringir el acceso a datos de log confidenciales en función de los grupos de usuarios.

Requisitos

Para gestionar las políticas de acceso a datos mediante NerdGraph, necesitas:

Una cuenta de New Relic edición Pro o Enterprise
Rol de administrador de dominio de autenticación
tipo de usuario de usuario principal o usuario de plataforma completa
Clave de usuario para la autenticación.

Antes de que empieces

Antes de emplear la API de NerdGraph para las políticas de acceso a datos, comprenda cómo funciona el control de acceso a datos y familiarizar con NerdGraph.

atributo común

Los siguientes atributos se emplean comúnmente en las consultas y mutaciones de políticas de acceso a datos:

Atributo	Descripción
`organizationId`	El identificador de la organización asociada a la póliza. Se emplea para filtrar políticas o delimitar la creación de políticas.
`id`	El identificador único de la póliza. Requerido al actualizar o eliminar una política específica.
`name`	Un nombre fácil de usar para la política de acceso a datos.
`policy`	El objeto JSON que define las reglas de la política. Incluye: `rules`: Una matriz de objetos de reglas. `operations`: Las operaciones para permitir o denegar (ej., `SELECT`, ``). `eventTypes`: Un objeto que especifica qué tipos de eventos corresponden a `allow` (por ejemplo, `[""]`) o `except` (por ejemplo, `["Log_accessible"]`).
`accountId`	El ID de la cuenta a la que el rol otorga acceso.
`dataAccessPolicyId`	El ID de la política de acceso a datos que define qué datos de una cuenta están permitidos.
`roleId`	El ID del rol que define el nivel de acceso.

Operaciones comunes

Estas son las operaciones más comunes para gestionar las políticas de acceso a los datos:

Esta consulta recupera todas las licencias de acceso de su organización y sus políticas de acceso a datos asociadas. Emplee esta herramienta para saber qué políticas están actualmente asignadas a las subvenciones.

Consulta de muestra

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

Parámetro	Descripción
`organizationId`	Requerido. El ID de la organización a la que pertenecen las subvenciones. Emplee el operador igual (`eq`) para filtrar.

Ejemplo de respuesta

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

Campo de respuesta	Descripción
`items`	Lista de subvenciones de la organización.
`dataAccessPolicy`	La política de acceso a los datos asociada a cada subvención.
`id`	El identificador único de la política de acceso a los datos.
`name`	El nombre de la política de acceso a los datos.

Esta consulta recupera todas las políticas de acceso a datos de su organización.

Consulta de muestra

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

Parámetro	Descripción
`organizationId`	Requerido. El ID de la organización a la que pertenecen las políticas. Emplee el operador igual (`eq`) para filtrar.

Ejemplo de respuesta

{
  "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 respuesta	Descripción
`items`	Lista de políticas de acceso a datos en la organización.
`id`	El identificador único de la política de acceso a los datos.
`name`	El nombre de la política de acceso a los datos.
`policy`	El objeto JSON que contiene las reglas de política con `operations` y `eventTypes`.
`status`	El estado actual de la política (por ejemplo, `VALID`).
`version`	La versión de la política (actualmente `1.0-logs`).

Esta mutación crea una nueva política de acceso a datos para controlar el acceso a las particiones de log.

Mutación de muestra

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

También puedes emplear las siguientes variables:

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

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

Parámetro	Descripción
`organizationId`	Requerido. Su ID de organización de New Relic.
`name`	Requerido. Un nombre descriptivo para la póliza.
`policy`	Requerido. El objeto JSON que define las reglas de política con `operations` y `eventTypes`.

Ejemplo de respuesta

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

Campo de respuesta	Descripción
`id`	El identificador único de la política de acceso a datos recién creada.
`name`	El nombre de la política de acceso a los datos.
`policy`	El objeto JSON que contiene las reglas de política con `operations` y `eventTypes`.
`status`	El estado de la política (ej., `VALID`).

Esta mutación actualiza una política de acceso a datos existente para modificar sus reglas o su nombre.

Mutación de muestra

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

Parámetro	Descripción
`id`	Requerido. El ID de la política que se va a actualizar.
`name`	Opcional. Nombre actualizado de la póliza.
`policy`	Opcional. El objeto JSON que define las reglas de política actualizadas con `operations` y `eventTypes`.

Ejemplo de respuesta

{
  "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 respuesta	Descripción
`assigned`	Indica si la política está asignada a alguna subvención (por ejemplo, `UNASSIGNED`).
`id`	El identificador único de la política de acceso a datos actualizada.
`name`	El nombre de la política de acceso a los datos.
`policy`	El objeto JSON que contiene las reglas de política actualizadas con `operations` y `eventTypes`.
`status`	El estado de la política (ej., `VALID`).

Esta mutación elimina una política de acceso a datos existente.

Importante

Eliminar una política la elimina de todas las concesiones asignadas. Los usuarios que pertenezcan a grupos con esas licencias perderán las restricciones de acceso a datos definidas por la política.

Mutación de muestra

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

Parámetro	Descripción
`id`	Requerido. El ID de la política que se va a eliminar.

Ejemplo de respuesta

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

Campo de respuesta	Descripción
`id`	El identificador único de la política de acceso a datos eliminados.
`name`	Nombre de la política de acceso a datos eliminados.
`policy`	El objeto JSON que contiene las reglas de política que fueron eliminadas.
`status`	El estado de la política (ej., `VALID`).

Esta mutación crea una nueva concesión de acceso que incluye una política de acceso a datos, asignándola a una cuenta y un rol específicos.

Mutación de muestra

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

Parámetro	Descripción
`accountId`	Requerido. El ID de la cuenta a la que se concederá acceso.
`dataAccessPolicyId`	Requerido. El ID de la política de acceso a datos que se aplicará.
`roleId`	Requerido. El ID del rol que define las licencias.

Respuesta

La respuesta muestra la concesión de acceso recién creada con su ID.

Esta mutación actualiza una concesión de acceso existente para agregar o modificar la política de acceso a los datos.

Mutación de muestra

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

Parámetro	Descripción
`ids`	Requerido. El ID de la subvención que se va a actualizar.
`dataAccessPolicyId`	Requerido. El ID de la política de acceso a datos que se aplicará a la subvención.

Ejemplo de respuesta

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

Campo de respuesta	Descripción
`grants`	Lista de subvenciones actualizadas.
`dataAccessPolicy.id`	El ID de la política de acceso a datos ahora asignada a la concesión.
`id`	El ID de la subvención actualizada.

Esta mutación elimina una concesión de acceso que incluye una política de acceso a datos.

Mutación de muestra

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

Parámetro	Descripción
`accountId`	Requerido. El ID de la cuenta de la autorización que se va a revocar.
`dataAccessPolicyId`	Requerido. El ID de la política de acceso a datos de la autorización que se va a revocar.
`roleId`	Requerido. El ID del rol de la subvención a revocar.

Respuesta

La respuesta muestra la concesión de acceso revocada con su ID.

Guía UI para el control de acceso a datos

Aprenda a gestionar las políticas de acceso a datos a través de la UI New Relic.

Conceptos de gestión de usuarios

Comprender los tipos de usuario, los roles y la gestión de accesos.

Gestiona usuarios con NerdGraph

Emplee la API de NerdGraph para gestionar mediante programación las licencias de usuario y de acceso.

Particiones de log

Aprende a organizar tus datos de log en particiones.

Te ofrecemos esta traducción automática para facilitar la lectura.

Tutorial de NerdGraph: Gestionar las políticas de acceso a datos

Requisitos

Antes de que empieces

atributo común

Operaciones comunes

Consultar las políticas de acceso a datos asociadas con las concesiones de acceso.

Consulta de muestra

Ejemplo de respuesta

consultar políticas de acceso a datos para una organización

Consulta de muestra

Ejemplo de respuesta

Cree una política de acceso a datos.

Mutación de muestra

Ejemplo de respuesta

Actualizar la política de acceso a datos

Mutación de muestra

Ejemplo de respuesta

Eliminar una política de acceso a datos

Importante

Mutación de muestra

Ejemplo de respuesta

Cree una concesión de acceso con una política de acceso a datos.

Mutación de muestra

Respuesta

Actualizar una concesión de acceso con una política de acceso a datos

Mutación de muestra

Ejemplo de respuesta

Revocar una concesión de acceso con una política de acceso a datos

Mutación de muestra

Respuesta

Guía UI para el control de acceso a datos

Conceptos de gestión de usuarios

Gestiona usuarios con NerdGraph

Particiones de log

Te ofrecemos esta traducción automática para facilitar la lectura.

Tutorial de NerdGraph: Gestionar las políticas de acceso a datos

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

Antes de que empieces

atributo común

Operaciones comunes

consultar políticas de acceso a datos para una organización

Cree una política de acceso a datos.

Actualizar la política de acceso a datos

Eliminar una política de acceso a datos

Cree una concesión de acceso con una política de acceso a datos.

Actualizar una concesión de acceso con una política de acceso a datos

Revocar una concesión de acceso con una política de acceso a datos

Temas relacionados

Guía UI para el control de acceso a datos

Conceptos de gestión de usuarios

Gestiona usuarios con NerdGraph

Particiones de log

Requisitos