NerdGraph 튜토리얼: Teams에 대한 사용자 지정 역할 만들기

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 출시 전 정책 에 따라 미리보기 프로그램의 일부로 제공됩니다.

뉴렐릭 Teams를 사용하면 모니터링 중인 팀을 해당 팀을 소유한 팀에 연결할 수 있습니다. 누가음을 소유하고 있는지 쉽게 확인할 수 있으면 문제 진단 및 해결 속도를 높이고, 팀 협업을 강화하고, 운영 효율성을 개선할 수 있습니다.

기본 팀 액세스

뉴렐릭은 다음과 같은 표준 역할을 통해 Teams에 대한 기본 액세스를 제공합니다.

읽기 액세스: 모든 사용자는 연락처 정보, 팀 구성원 및 기타 관련 세부 정보와 같은 메타데이터를 포함하여 Teams에 대한 읽기 액세스 권한을 갖습니다.
팀 수정: Organization Product Admin [조직 제품 관리자] 역할이 있는 사용자는 팀을 수정할 수 있습니다. 이는 현재 All Product Admin [모든 제품 관리자] 역할을 갖고 있는 모든 사용자에게 할당된 새로운 역할입니다.
팀 만들기 및 삭제: Organization Manager [조직 관리자] 또는 Authentication Manager [인증 관리자] 역할이 있는 사용자는 팀을 만들고 삭제할 수 있습니다.

기본 권한이 조직의 요구 사항을 충족하지 못하는 경우 사용자 지정 역할이 필요할 수 있습니다. 이 튜토리얼에서는 NerdGraph GraphQL 뮤테이션을 사용하여 팀을 관리하기 위한 사용자 지정 역할을 만드는 방법을 보여줍니다.

프로세스 개요

Teams 관리자 사용자 지정 역할을 만들려면 다음이 필요합니다.

모든 조직 범위 기능 검색
귀하의 조직 ID를 검색하세요
Teams에 필요한 권한 ID 식별
Teams 관리자를 위한 사용자 지정 역할 만들기
사용자 그룹에 사용자 정의 역할 추가

전제 조건

시작하기 전에 다음 사항을 확인하세요.

일반 NerdGraph 요구 사항
사용자 정의 역할을 생성하기 위한 조직 관리자 역할 권한

돌연변이

뉴렐릭은 팀 관리자를 위한 사용자 정의 역할을 생성하기 위해 다양한 NerdGraph 변형을 제공합니다.

customerAdministration 변형을 사용하여 기능 목록, 해당 권한 ID 및 관련 정보를 검색합니다.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`eq`	문자열	네	Teams의 역할을 검색하려면 값을 `organization` 으로 설정하세요.

매개변수

데이터 형식

꼭 필요한가요?

설명

eq

문자열

네

Teams의 역할을 검색하려면 값을

organization

으로 설정하세요.

샘플 요청

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

샘플 응답

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

다음 단계: 응답에서 다음의 권한 ID를 식별하여 복사합니다.

category: "MANAGE" (또는 귀하의 필요에 맞는 적절한 카테고리)
feature: "Teams"

다음 단계에서는 이 ID가 필요합니다.

이후 변형에 사용할 조직 ID를 검색합니다.

샘플 요청

{
  actor {
    organization {
      id
    }
  }
}

샘플 응답

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

다음 단계: 응답에서 조직 ID를 복사합니다. 사용자 지정 역할을 만들려면 이것이 필요합니다.

customRoleCreate 변형을 사용하여 Teams 관리를 위한 사용자 지정 역할을 만듭니다.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`id`	문자열	네	이전 단계에서 복사한 조직 ID입니다.
`type`	문자열	네	유형을 `organization` 으로 설정합니다.
`name`	문자열	네	역할의 이름.
`permissionId`	정수 배열	네	첫 번째 단계에서 검색된 Teams 기능에 대한 권한 ID입니다.
`scope`	문자열	네	범위를 `organization` 로 설정합니다.

샘플 요청

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

샘플 응답

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

다음 단계: 반환된 역할 ID를 저장합니다. 이 역할을 사용자 그룹에 할당하려면 이것이 필요합니다.

사용자 지정 역할을 만든 후에는 뉴렐릭의 사용자 그룹에 해당 역할을 할당해야 합니다.

1단계: 그룹 ID 검색

customerAdministration 변형을 사용하여 사용 가능한 사용자 그룹 목록을 가져옵니다.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`id`	문자열	네	이전 단계에서 복사한 조직 ID입니다.

샘플 요청

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

다음 단계: 응답에서 Teams 역할을 할당하려는 그룹의 그룹 ID를 복사합니다.

2단계: 사용자 그룹에 역할 할당

authorizationManagementGrantAccess 변형을 사용하여 사용자 그룹에 사용자 정의 역할을 할당합니다.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`roleId`	문자열	네	이전 단계의 사용자 정의 역할 ID입니다.
`groupId`	문자열	네	1단계의 그룹 ID.

샘플 요청

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

샘플 응답

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

무엇 향후 계획

사용자 지정 Teams 역할을 성공적으로 만들고 할당하면 할당된 그룹의 사용자는 구성한 권한을 갖게 됩니다. 다음을 수행할 수 있습니다.

조직의 사용자 관리를 통해 역할 사용을 모니터링합니다.
필요한 경우 유사한 NerdGraph 변형을 사용하여 역할 권한을 수정합니다.
다양한 수준의 Teams 액세스에 대해 추가 사용자 지정 역할을 만듭니다.

Teams에 대한 자세한 내용은 Teams 설명서를 참조하세요.

사용자의 편의를 위해 제공되는 기계 번역입니다.

NerdGraph 튜토리얼: Teams에 대한 사용자 지정 역할 만들기

시사

기본 팀 액세스

프로세스 개요

전제 조건

돌연변이

조직 범위 기능 검색

입력스피커, 변수

샘플 요청

샘플 응답

귀하의 조직 ID를 검색하세요

샘플 요청

샘플 응답

커스텀 역할 생성

입력스피커, 변수

샘플 요청

샘플 응답

사용자 그룹에 사용자 정의 역할 추가

1단계: 그룹 ID 검색

입력스피커, 변수

샘플 요청

2단계: 사용자 그룹에 역할 할당

입력스피커, 변수

샘플 요청

샘플 응답

무엇 향후 계획

사용자의 편의를 위해 제공되는 기계 번역입니다.

NerdGraph 튜토리얼: Teams에 대한 사용자 지정 역할 만들기

시사

기본 팀 액세스.css-21sua1{background:none;border:none;width:0;padding:0;}

프로세스 개요

전제 조건

돌연변이

귀하의 조직 ID를 검색하세요

커스텀 역할 생성

사용자 그룹에 사용자 정의 역할 추가

무엇 향후 계획

기본 팀 액세스