Crear roles personalizados para Equipos

New Relic Teams te permite conectar la entidad que estás monitoreando con los equipos que la poseen. Cuando puede ver fácilmente quién es el propietario de una entidad, puede acelerar la resolución de problemas, mejorar la colaboración en equipo y mejorar su eficiencia operativa.

Acceso predeterminado a Teams

New Relic proporciona acceso predeterminado a Teams a través de estos roles estándar:

Acción	Rol requerido
Ver equipos	Organization read only
Modificar equipos	Organization Product Admin
Crear y eliminar equipos	Organization Manager o Authentication Manager

Acción

Rol requerido

Ver equipos

Organization read only

Modificar equipos

Organization Product Admin

Crear y eliminar equipos

Organization Manager

Authentication Manager

Es posible que necesite un rol personalizado si los permisos predeterminados no satisfacen las necesidades de su organización.

Capacidades de equipos

Al crear un rol personalizado para Teams, use los siguientes permisos. Los permisos de los equipos tienen alcance a nivel de la organización.

Capacidad	Identificador de permiso
Leer equipos	`teams.read.team`
Eliminar equipos	`teams.delete.team`
Crear equipos	`teams.create.team`
Modificar equipos	`teams.update.team`
Acceso de lectura a la página de automatizaciones/configuración	`teams.read.organization_settings`
Modificar el acceso a la página de automatizaciones/configuración	`teams.manage.organization_settings`
Crear equipos a partir de grupos de usuarios de IdP (p. ej., Okta)	`authentication_domain.read.groups`

Requisitos previos

Antes de comenzar, cerciorar de tener:

Requisitos generales de NerdGraph
Administrador de la organización con rol Authentication Domain Manager para crear roles personalizados

Sugerencia

También puede crear un rol personalizado para Teams a través de la UI. Para conocer los permisos que se deben seleccionar y el alcance que se debe usar, consulte Capacidades de los equipos.

Para crear un rol personalizado a través de la API de NerdGraph, realice los siguientes pasos:

Encuentre los ID de licencias necesarias para Teams

Utilice la consulta customerAdministration para recuperar una lista de capacidades, sus ID de permiso e información relacionada. Filtre por scope: "organization" para obtener los permisos de Teams.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`eq`	Cadena	Sí	Establezca el valor en `organization` para recuperar licencias para Teams.

Parámetro

Tipo de datos

¿Es obligatorio?

Descripción

eq

Cadena

Sí

Establezca el valor en

organization

para recuperar licencias para Teams.

Solicitud de muestra

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

Ejemplo de respuesta

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

De la respuesta, identifique y copie los ID de permiso donde feature es "Teams" y el category coincide con el nivel de acceso que desea otorgar. Necesitarás estos ID en el siguiente paso.

Recuperar el ID de su organización

Recupere el ID de su organización, que empleará en mutaciones posteriores.

Solicitud de muestra

{
  actor {
    organization {
      id
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "actor": {
      "organization": {
        "id": "YOUR_ORGANIZATION_ID"
      }
    }
  }
}

Copia tu ID de organización de la respuesta. Lo necesitará para crear el rol personalizado.

Crear el rol personalizado

Emplee la mutación customRoleCreate para crear su rol personalizado para la administración de Teams.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`id`	Cadena	Sí	El ID de la organización del paso anterior.
`type`	Cadena	Sí	Establezca en `organization` .
`name`	Cadena	Sí	El nombre para mostrar del rol personalizado.
`permissionIds`	Matriz de números enteros	Sí	Los ID de permisos de Teams identificados en el paso 1.
`scope`	Cadena	Sí	Establezca en `organization` .

Solicitud de muestra

mutation {
  customRoleCreate(
    container: { id: "YOUR_ORGANIZATION_ID", type: "organization" }
    name: "Teams manager"
    permissionIds: [xxxxx, xxxxx]
    scope: "organization"
  ) {
    id
  }
}

Ejemplo de respuesta

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

Guarde el ID del rol devuelto — lo necesitará para asignar este rol a un grupo de usuarios.

Agregar el rol personalizado a un grupo de usuarios

Después de crear el rol personalizado, asígnalo a un grupo de usuarios en New Relic.

Recuperar los ID de grupos

Emplee la consulta customerAdministration para obtener una lista de grupos de usuarios disponibles.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`id`	Cadena	Sí	El ID de la organización del paso anterior.

Solicitud de muestra

{
  customerAdministration {
    groups(filter: { organizationId: { eq: "YOUR_ORGANIZATION_ID" } }) {
      nextCursor
      items {
        id
        name
        users {
          items {
            id
            email
          }
        }
      }
    }
  }
}

De la respuesta, copie el ID del grupo al que desea asignar el rol de Teams.

Asigna el rol al grupo

Emplee la mutación authorizationManagementGrantAccess para asignar el rol personalizado a un grupo de usuarios.

parámetro de entrada

Parámetro	Tipo de datos	¿Es obligatorio?	Descripción
`roleId`	Cadena	Sí	El ID del rol personalizado del paso anterior.
`groupId`	Cadena	Sí	El ID de grupo obtenido anteriormente.

Solicitud de muestra

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      organizationAccessGrants: { roleId: "YOUR_ROLE_ID" }
      groupId: "YOUR_GROUP_ID"
    }
  ) {
    roles {
      id
      name
      organizationId
      roleId
      groupId
      displayName
    }
  }
}

Ejemplo de respuesta

{
  "data": {
    "authorizationManagementGrantAccess": {
      "roles": [
        {
          "displayName": "Teams manager",
          "groupId": null,
          "id": "99999999",
          "name": "teams_manager",
          "organizationId": "YOUR_ORGANIZATION_ID",
          "roleId": 99999
        }
      ]
    }
  }
}

Administrar roles personalizados existentes

Usa la mutación customRoleUpdate para renombrar un rol o reemplazar su conjunto de permisos.

mutation {
  customRoleUpdate(
    id: ROLE_ID
    name: "Updated role name"
    permissionIds: [xxxxx, xxxxx]
  ) {
    id
  }
}

Parámetro	Descripción
`id`	El ID del rol a actualizar.
`name`	Nuevo nombre para mostrar del rol.
`permissionIds`	Lista completa de reemplazo de ID de permisos. Esto reemplaza todos los permisos existentes en el rol.

Usa la mutación customRoleDelete para eliminar permanentemente un rol personalizado.

mutation {
  customRoleDelete(id: ROLE_ID) {
    id
  }
}

La respuesta devuelve el ID del rol eliminado, lo que confirma la eliminación exitosa.

Use la siguiente consulta para buscar un ID de rol explorando los grupos de su organización y sus roles asignados.

{
  actor {
    organization {
      authorizationManagement {
        authenticationDomains(id: "YOUR_AUTHENTICATION_DOMAIN_ID") {
          authenticationDomains {
            groups {
              groups {
                displayName
                id
                roles {
                  roles {
                    roleId
                    name
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Para obtener más información sobre Equipos, consulte la documentación de Equipos.

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

Crear roles personalizados para Equipos

Acceso predeterminado a Teams

Capacidades de equipos

Requisitos previos

Sugerencia

Encuentre los ID de licencias necesarias para Teams

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Recuperar el ID de su organización

Solicitud de muestra

Ejemplo de respuesta

Crear el rol personalizado

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Agregar el rol personalizado a un grupo de usuarios

Recuperar los ID de grupos

parámetro de entrada

Solicitud de muestra

Asigna el rol al grupo

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Administrar roles personalizados existentes

Actualizar un rol

Eliminar un rol

Encontrar el ID de un rol personalizado

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

Crear roles personalizados para Equipos

Acceso predeterminado a Teams .css-21sua1{background:none;border:none;width:0;padding:0;}

Capacidades de equipos

Requisitos previos

Sugerencia

Encuentre los ID de licencias necesarias para Teams

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Recuperar el ID de su organización

Solicitud de muestra

Ejemplo de respuesta

Crear el rol personalizado

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Agregar el rol personalizado a un grupo de usuarios

Recuperar los ID de grupos

parámetro de entrada

Solicitud de muestra

Asigna el rol al grupo

parámetro de entrada

Solicitud de muestra

Ejemplo de respuesta

Administrar roles personalizados existentes

Eliminar un rol

Encontrar el ID de un rol personalizado

Acceso predeterminado a Teams