Teams용 커스텀 역할 만들기

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

기본 팀 액세스

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

동작	필수 역할
팀 보기	Organization read only
팀 수정	Organization Product Admin
팀 생성 및 삭제	Organization Manager 또는 Authentication Manager

동작

필수 역할

팀 보기

Organization read only

팀 수정

Organization Product Admin

팀 생성 및 삭제

Organization Manager

또는

Authentication Manager

기본 권한이 조직의 요구 사항을 충족하지 않는 경우 사용자 지정 역할이 필요할 수 있습니다.

팀 기능

Teams용 사용자 지정 역할을 생성할 때는 아래의 권한을 사용하십시오. 팀 권한은 조직 범위로 지정됩니다.

능력	권한 식별자
팀 읽기	`teams.read.team`
팀 삭제	`teams.delete.team`
팀 만들기	`teams.create.team`
팀 수정	`teams.update.team`
자동화/설정 페이지에 대한 읽기 권한	`teams.read.organization_settings`
자동화/설정 페이지에 대한 액세스 수정	`teams.manage.organization_settings`
IdP 사용자 그룹(예: Okta)에서 팀 생성	`authentication_domain.read.groups`

전제 조건

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

일반 NerdGraph 요구 사항
사용자 정의 역할을 생성하려면 Authentication Domain Manager 역할을 가진 조직 관리자

팁

UI를 통해 Teams용 사용자 정의 역할을 생성할 수도 있습니다. 선택할 권한과 사용할 범위에 대해서는 팀 기능을 참조하십시오.

NerdGraph API를 통해 사용자 지정 역할을 생성하려면 다음 단계를 수행하십시오:

Teams에 필요한 권한 ID 찾기

기능, 해당 권한 ID 및 관련 정보 목록을 조회하려면 customerAdministration 쿼리를 사용하세요. Teams 권한을 가져오려면 scope: "organization" (으)로 필터링하세요.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`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"
          }
        ]
      }
    }
  }
}

응답에서 feature 이(가) "Teams" 이고 category 이(가) 부여하려는 액세스 수준과 일치하는 권한 ID를 식별하고 복사합니다. 다음 단계에서 이 ID가 필요합니다.

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

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

샘플 요청

{
  actor {
    organization {
      id
    }
  }
}

샘플 응답

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

응답에서 조직 ID를 복사하십시오. 사용자 지정 역할을 생성하는 데 필요합니다.

사용자 지정 역할을 생성합니다

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

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`id`	문자열	네	이전 단계의 조직 ID.
`type`	문자열	네	`organization` (으)로 설정합니다.
`name`	문자열	네	사용자 지정 역할의 표시 이름입니다.
`permissionIds`	정수 배열	네	1단계에서 확인한 팀 권한 ID입니다.
`scope`	문자열	네	`organization` (으)로 설정합니다.

샘플 요청

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

샘플 응답

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

반환된 역할 ID를 저장하세요. 이 역할을 사용자 그룹에 할당할 때 필요합니다.

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

사용자 지정 역할을 생성한 후, 뉴렐릭에서 사용자 그룹에 할당합니다.

그룹 ID 검색

customerAdministration 쿼리를 사용하여 사용 가능한 사용자 그룹 목록을 가져옵니다.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`id`	문자열	네	이전 단계의 조직 ID.

샘플 요청

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

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

그룹에 역할을 할당합니다.

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

입력스피커, 변수

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

샘플 요청

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

샘플 응답

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

기존 커스텀 역할 관리

역할의 이름을 변경하거나 권한 세트를 교체하려면 customRoleUpdate 뮤테이션을 사용하십시오.

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

매개변수	설명
`id`	업데이트할 역할의 ID입니다.
`name`	역할의 새 표시 이름입니다.
`permissionIds`	권한 ID의 전체 교체 목록. 이것은 역할에 대한 모든 기존 권한을 대체합니다.

사용자 지정 역할을 영구적으로 삭제하려면 customRoleDelete 뮤테이션을 사용하십시오.

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

응답은 삭제된 역할의 ID를 반환하며, 성공적으로 삭제되었음을 확인합니다.

조직의 그룹 및 할당된 역할을 탐색하여 역할 ID를 조회하려면 다음 쿼리를 사용하십시오.

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

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

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

기본 팀 액세스

팀 기능

전제 조건

팁

Teams에 필요한 권한 ID 찾기

입력스피커, 변수

샘플 요청

샘플 응답

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

샘플 요청

샘플 응답

사용자 지정 역할을 생성합니다

입력스피커, 변수

샘플 요청

샘플 응답

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

그룹 ID 검색

입력스피커, 변수

샘플 요청

그룹에 역할을 할당합니다.

입력스피커, 변수

샘플 요청

샘플 응답

기존 커스텀 역할 관리

역할 업데이트

역할 삭제

커스텀 역할 ID 찾기

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

Teams용 커스텀 역할 만들기

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

팀 기능

전제 조건

팁

Teams에 필요한 권한 ID 찾기

입력스피커, 변수

샘플 요청

샘플 응답

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

샘플 요청

샘플 응답

사용자 지정 역할을 생성합니다

입력스피커, 변수

샘플 요청

샘플 응답

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

그룹 ID 검색

입력스피커, 변수

샘플 요청

그룹에 역할을 할당합니다.

입력스피커, 변수

샘플 요청

샘플 응답

기존 커스텀 역할 관리

역할 삭제

커스텀 역할 ID 찾기

기본 팀 액세스