Tutoriel NerdGraph : créer un rôle personnalisé pour les équipes

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

New Relic Teams vous permet de connecter l'entité que vous monitoring aux équipes qui en sont propriétaires. Lorsque vous pouvez facilement voir à qui appartient une entité, vous pouvez accélérer le dépannage, améliorer la collaboration au sein de l’équipe et améliorer votre efficacité opérationnelle.

Accès par défaut aux équipes

New Relic fournit un accès par défaut aux équipes via ces rôles standard :

Accès en lecture: tous les utilisateurs ont un accès en lecture aux équipes, y compris aux métadonnées telles que les informations de contact, les membres de l'équipe et d'autres détails pertinents.
Modifier les équipes: l'utilisateur avec le rôle Organization Product Admin peut modifier les équipes. Il s'agit d'un nouveau rôle attribué à tous les utilisateurs qui ont actuellement le rôle All Product Admin.
Créer et supprimer des équipes: l'utilisateur avec les rôles Organization Manager ou Authentication Manager peut créer et supprimer des équipes.

Vous pourriez avoir besoin d’un rôle personnalisé si les autorisations par défaut ne répondent pas aux besoins de votre organisation. Ce tutoriel vous montre comment utiliser les mutations NerdGraph GraphQL pour créer un rôle personnalisé pour la gestion des équipes.

Aperçu du processus

Pour créer un rôle personnalisé d’administrateur Teams, vous devez :

Récupérer toutes les capacités de l'organisation
Récupérez votre identifiant d'organisation
Identifier les identifiants d'autorisation requis pour les équipes
Créer le rôle personnalisé pour l'administrateur Teams
Ajouter le rôle personnalisé à un groupe d'utilisateurs

Prérequis

Avant de commencer, assurez-vous d’avoir :

Exigences générales de NerdGraph
Autorisations du rôle d'administrateur d'organisation pour créer des rôles personnalisés

Mutations

New Relic fournit diverses mutations NerdGraph pour créer un rôle personnalisé pour les chefs d'équipe.

Utilisez la mutation customerAdministration pour récupérer une liste de capacités, leurs identifiants d'autorisation et les informations associées.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`eq`	Chaîne	Oui	Définissez la valeur sur `organization` pour récupérer le rôle pour Teams.

paramètres

Type de données

Est-ce obligatoire ?

Description

eq

Chaîne

Oui

Définissez la valeur sur

organization

pour récupérer le rôle pour Teams.

Demande d'échantillon

{
  customerAdministration {
    permissions(filter: { scope: { eq: "organization" } }) {
      items {
        feature
        category
        id
        product
      }
    }
  }
}

Exemple de réponse

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

Étape suivante: À partir de la réponse, identifiez et copiez les identifiants d’autorisation où :

category: "MANAGE" (ou la catégorie appropriée à vos besoins)
feature: "Teams"

Vous aurez besoin de ces identifiants pour l’étape suivante.

Récupérez l'ID de votre organisation, que vous utiliserez dans les mutations ultérieures.

Demande d'échantillon

{
  actor {
    organization {
      id
    }
  }
}

Exemple de réponse

{
  "data": {
    "actor": {
      "organization": {
        "id": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
      }
    }
  }
}

Étape suivante: copiez l’ID de votre organisation à partir de la réponse. Vous en aurez besoin pour créer le rôle personnalisé.

Utilisez la mutation customRoleCreate pour créer votre rôle personnalisé pour la gestion des équipes.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`id`	Chaîne	Oui	L’ID de l’organisation copié à l’étape précédente.
`type`	Chaîne	Oui	Définissez le type sur `organization` .
`name`	Chaîne	Oui	Le nom du rôle.
`permissionId`	Éventail d'entiers	Oui	Les ID d’autorisation pour la fonctionnalité Teams récupérés lors de la première étape.
`scope`	Chaîne	Oui	Définissez la portée sur `organization` .

Demande d'échantillon

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

Exemple de réponse

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

Étape suivante: enregistrez l’ID de rôle renvoyé. Vous en aurez besoin pour attribuer ce rôle à un groupe d'utilisateurs.

Après avoir créé le rôle personnalisé, vous devez l’attribuer à un groupe d’utilisateurs dans New Relic.

Étape 1 : Récupérer les identifiants de groupe

Utilisez la mutation customerAdministration pour obtenir une liste des groupes d’utilisateurs disponibles.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`id`	Chaîne	Oui	L’ID de l’organisation copié à l’étape précédente.

Demande d'échantillon

{
  customerAdministration {
    groups(
      filter: {
        organizationId: { eq: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX" }
      }
    ) {
      nextCursor
      items {
        id
        name
        users {
          items {
            id
            email
          }
        }
      }
    }
  }
}

Étape suivante: à partir de la réponse, copiez l’ID de groupe du groupe auquel vous souhaitez attribuer le rôle Teams.

Étape 2 : Attribuer le rôle à un groupe d’utilisateurs

Utilisez la mutation authorizationManagementGrantAccess pour attribuer le rôle personnalisé à un groupe d’utilisateurs.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`roleId`	Chaîne	Oui	L’ID de rôle personnalisé de l’étape précédente.
`groupId`	Chaîne	Oui	L'ID de groupe de l'étape 1.

Demande d'échantillon

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      organizationAccessGrants: { roleId: "99999999" }
      groupId: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
    }
  ) {
    roles {
      id
      name
      organizationId
      roleId
      groupId
      displayName
    }
  }
}

Exemple de réponse

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

Et ensuite ?

Après avoir créé et attribué avec succès votre rôle Teams personnalisé, l'utilisateur du groupe attribué disposera des autorisations que vous avez configurées. Tu peux:

Monitorer l'utilisation du rôle via la gestion des utilisateurs de votre organisation
Modifiez les autorisations de rôle si nécessaire en utilisant des mutations NerdGraph similaires
Créez des rôles personnalisés supplémentaires pour différents niveaux d'accès aux équipes

Pour plus d'informations sur Teams, consultez notre documentation Teams.

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : créer un rôle personnalisé pour les équipes

Aperçu

Accès par défaut aux équipes

Aperçu du processus

Prérequis

Mutations

Récupérer les capacités à l'échelle de l'organisation

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Récupérez votre identifiant d'organisation

Demande d'échantillon

Exemple de réponse

Créer un rôle personnalisé

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Ajouter un rôle personnalisé à un groupe d'utilisateurs

Étape 1 : Récupérer les identifiants de groupe

Paramètres d'entrée

Demande d'échantillon

Étape 2 : Attribuer le rôle à un groupe d’utilisateurs

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Et ensuite ?

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : créer un rôle personnalisé pour les équipes

Aperçu

Accès par défaut aux équipes.css-21sua1{background:none;border:none;width:0;padding:0;}

Aperçu du processus

Prérequis

Mutations

Récupérez votre identifiant d'organisation

Créer un rôle personnalisé

Ajouter un rôle personnalisé à un groupe d'utilisateurs

Et ensuite ?

Accès par défaut aux équipes