Tutoriel NerdGraph : Gérer les politiques d’accès aux données

Vous pouvez utiliser notre API NerdGraph pour créer, interroger, mettre à jour et supprimer des politiques d'accès aux données. Les politiques d'accès aux données contrôlent les partitionslog auxquelles vos utilisateurs peuvent accéder, vous permettant ainsi de restreindre l'accès aux données log sensibles en fonction des groupes d'utilisateurs.

Exigences

Pour gérer les politiques d'accès aux données via NerdGraph, vous avez besoin de :

Un compte New Relic Pro ou Enterprise
Rôle de gestionnaire de domaine d'authentification
utilisateur type de core utilisateur ou plateforme utilisateur complète
Une clé utilisateur pour l'authentification.

Avant de commencer

Avant d’utiliser l’API NerdGraph pour les politiques d’accès aux données, comprenez comment fonctionne le contrôle d’accès aux données et familiarisez-vous avec NerdGraph.

Attribut commun

Les attributs suivants sont couramment utilisés dans les requêtes et les mutations de politiques d'accès aux données :

Attribut	Description
`organizationId`	L'identifiant de l'organisation associée à la police d'assurance. Utilisé pour filtrer les politiques ou définir la portée de la création de politiques.
`id`	L'identifiant unique de la police d'assurance. Requis lors de la mise à jour ou de la suppression d'une politique spécifique.
`name`	Un nom convivial pour la politique d'accès aux données.
`policy`	L'objet JSON qui définit les règles de la politique. Il comprend : `rules`: Un éventail d'objets de règles. `operations`: Les opérations pour autoriser ou refuser (par exemple, `SELECT`, ``). `eventTypes`: Un objet spécifiant quels types d'événements `allow` (par exemple, `[""]`) ou `except` (par exemple, `["Log_accessible"]`).
`accountId`	L'identifiant du compte auquel le rôle donne accès.
`dataAccessPolicyId`	L'identifiant de la politique d'accès aux données qui définit quelles données d'un compte sont autorisées.
`roleId`	L'identifiant du rôle qui définit le niveau d'accès.

Opérations communes

Voici les opérations les plus courantes pour la gestion des politiques d'accès aux données :

Cette requête récupère tous les droits d'accès au sein de votre organisation et leurs politiques d'accès aux données associées. Utilisez cette fonction pour obtenir la liste des politiques actuellement associées aux autorisations.

Exemple de requête

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

paramètres	Description
`organizationId`	Requis. Identifiant de l'organisation à laquelle appartiennent les subventions. Utilisez l'opérateur égal (`eq`) pour filtrer.

Exemple de réponse

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

Champ de réponse	Description
`items`	Liste des subventions de l'organisation.
`dataAccessPolicy`	La politique d'accès aux données associée à chaque subvention.
`id`	L'identifiant unique de la politique d'accès aux données.
`name`	Le nom de la politique d'accès aux données.

Cette requête récupère toutes les politiques d'accès aux données de votre organisation.

Exemple de requête

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

paramètres	Description
`organizationId`	Requis. L'identifiant de l'organisation à laquelle appartiennent les polices. Utilisez l'opérateur égal (`eq`) pour filtrer.

Exemple de réponse

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

Champ de réponse	Description
`items`	Liste des politiques d'accès aux données au sein de l'organisation.
`id`	L'identifiant unique de la politique d'accès aux données.
`name`	Le nom de la politique d'accès aux données.
`policy`	L'objet JSON contenant les règles de politique avec `operations` et `eventTypes`.
`status`	L'état actuel de la politique (par exemple, `VALID`).
`version`	La version de la politique (actuellement `1.0-logs`).

Cette mutation crée une nouvelle politique d'accès aux données pour contrôler l'accès aux partitions log.

Mutation d'échantillon

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

Vous pouvez également utiliser les variables suivantes :

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

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

paramètres	Description
`organizationId`	Requis. Votre identifiant d'organisation New Relic.
`name`	Requis. Un nom descriptif pour cette politique.
`policy`	Requis. L'objet JSON définissant les règles de politique avec `operations` et `eventTypes`.

Exemple de réponse

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

Champ de réponse	Description
`id`	L'identifiant unique de la politique d'accès aux données nouvellement créée.
`name`	Le nom de la politique d'accès aux données.
`policy`	L'objet JSON contenant les règles de politique avec `operations` et `eventTypes`.
`status`	L'état de la politique (par exemple, `VALID`).

Cette mutation met à jour une politique d'accès aux données existante afin d'en modifier les règles ou le nom.

Mutation d'échantillon

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

paramètres	Description
`id`	Requis. L'identifiant de la police à mettre à jour.
`name`	Facultatif. Nouveau nom pour cette police d'assurance.
`policy`	Facultatif. L'objet JSON définissant les règles de politique mises à jour avec `operations` et `eventTypes`.

Exemple de réponse

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

Champ de réponse	Description
`assigned`	Indique si la politique est attribuée à des subventions (par exemple, `UNASSIGNED`).
`id`	L'identifiant unique de la politique d'accès aux données mise à jour.
`name`	Le nom de la politique d'accès aux données.
`policy`	L'objet JSON contenant les règles de politique mises à jour avec `operations` et `eventTypes`.
`status`	L'état de la politique (par exemple, `VALID`).

Cette mutation supprime une politique d'accès aux données existante.

Important

La suppression d'une politique la retire de toutes les autorisations attribuées. Les utilisateurs appartenant à des groupes bénéficiant de ces autorisations perdront les restrictions d'accès aux données définies par la politique.

Mutation d'échantillon

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

paramètres	Description
`id`	Requis. L'identifiant de la politique à supprimer.

Exemple de réponse

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

Champ de réponse	Description
`id`	L'identifiant unique de la politique d'accès aux données supprimées.
`name`	Nom de la politique d'accès aux données supprimée.
`policy`	L'objet JSON contenant les règles de stratégie qui ont été supprimées.
`status`	L'état de la politique (par exemple, `VALID`).

Cette mutation crée une nouvelle autorisation d'accès qui inclut une politique d'accès aux données, en l'attribuant à un compte et à un rôle spécifiques.

Mutation d'échantillon

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

paramètres	Description
`accountId`	Requis. L'identifiant du compte auquel accorder l'accès.
`dataAccessPolicyId`	Requis. L'identifiant de la politique d'accès aux données à appliquer.
`roleId`	Requis. L'identifiant du rôle définissant les autorisations.

Réponse

La réponse affiche le nouveau droit d'accès créé avec son identifiant.

Cette mutation met à jour une autorisation d'accès existante afin d'ajouter ou de modifier la politique d'accès aux données.

Mutation d'échantillon

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

paramètres	Description
`ids`	Requis. L'identifiant de la subvention à mettre à jour.
`dataAccessPolicyId`	Requis. L'identifiant de la politique d'accès aux données à appliquer à la subvention.

Exemple de réponse

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

Champ de réponse	Description
`grants`	Liste des subventions mises à jour.
`dataAccessPolicy.id`	L'identifiant de la politique d'accès aux données désormais attribuée à l'autorisation.
`id`	L'identifiant de la subvention mise à jour.

Cette mutation supprime une autorisation d'accès qui inclut une politique d'accès aux données.

Mutation d'échantillon

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

paramètres	Description
`accountId`	Requis. L'identifiant du compte de l'autorisation à révoquer.
`dataAccessPolicyId`	Requis. L'identifiant de la politique d'accès aux données de l'autorisation à révoquer.
`roleId`	Requis. L'identifiant du rôle de l'autorisation à révoquer.

Réponse

La réponse affiche l'autorisation d'accès révoquée avec son identifiant.

Guide d'utilisation du contrôle d'accès aux données

Découvrez comment gérer les politiques d'accès aux données via l'interface utilisateur de New Relic.

Concepts de gestion des utilisateurs

Comprendre les types d'utilisateurs, leurs rôles et la gestion des accès.

Gérer les utilisateurs avec NerdGraph

Utilisez l'API NerdGraph pour gérer par programmation les droits d'accès et les autorisations des utilisateurs.

Partitions de logs

Apprenez à organiser vos données log en partitions.

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : Gérer les politiques d’accès aux données

Exigences

Avant de commencer

Attribut commun

Opérations communes

politiques d'accès aux données de requête associées aux autorisations d'accès

Exemple de requête

Exemple de réponse

politiques d'accès aux données de requête pour une organisation

Exemple de requête

Exemple de réponse

Créer une politique d'accès aux données

Mutation d'échantillon

Exemple de réponse

Mettre à jour une politique d'accès aux données

Mutation d'échantillon

Exemple de réponse

Supprimer une politique d'accès aux données

Important

Mutation d'échantillon

Exemple de réponse

Créer une autorisation d'accès avec une politique d'accès aux données

Mutation d'échantillon

Réponse

Mettre à jour une autorisation d'accès avec une politique d'accès aux données

Mutation d'échantillon

Exemple de réponse

Révoquer une autorisation d'accès avec une politique d'accès aux données

Mutation d'échantillon

Réponse

Guide d'utilisation du contrôle d'accès aux données

Concepts de gestion des utilisateurs

Gérer les utilisateurs avec NerdGraph

Partitions de logs

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : Gérer les politiques d’accès aux données

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

Avant de commencer

Attribut commun

Opérations communes

politiques d'accès aux données de requête pour une organisation

Créer une politique d'accès aux données

Mettre à jour une politique d'accès aux données

Supprimer une politique d'accès aux données

Créer une autorisation d'accès avec une politique d'accès aux données

Mettre à jour une autorisation d'accès avec une politique d'accès aux données

Révoquer une autorisation d'accès avec une politique d'accès aux données

Sujets connexes

Guide d'utilisation du contrôle d'accès aux données

Concepts de gestion des utilisateurs

Gérer les utilisateurs avec NerdGraph

Partitions de logs

Exigences