스코어카드용 커스텀 역할 생성

스코어카드는 정의된 표준 준수 여부를 종합적으로 평가하는 다양한 규칙의 컨테이너 역할을 합니다. 스코어카드는 규칙을 사용하여 다양한 엔티티와 팀 전반의 규정 준수를 모니터하고, 개선 영역을 식별하며, 내부 및 외부 요구 사항과의 일치를 보장합니다.

기본 스코어카드 액세스

뉴렐릭은 다음 표준 역할을 통해 스코어카드에 대한 기본 액세스를 제공합니다:

동작	필수 역할
스코어카드 보기	Organization read only
스코어카드 및 규칙 생성, 업데이트 및 삭제	Organization Product Admin 또는 사용자 지정 Scorecards 역할

동작

필수 역할

스코어카드 보기

Organization read only

스코어카드 및 규칙 생성, 업데이트 및 삭제

Organization Product Admin

또는 사용자 지정 Scorecards 역할

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

스코어카드 기능

Scorecards용 사용자 지정 역할을 생성할 때, 아래의 권한을 사용하십시오. 스코어카드 권한은 조직 범위로 지정됩니다.

능력	권한 식별자
스코어카드 읽기 ( `scorecards.read.rule` 도 부여함)	`scorecards.read.scorecard`
스코어카드 생성, 업데이트 및 삭제	`scorecards.modify.scorecard`
스코어카드 규칙 읽기	`scorecards.read.rule`
스코어카드 규칙 생성, 업데이트 및 삭제	`scorecards.modify.rule`

전제 조건

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

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

팁

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

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

스코어카드에 필요한 권한 ID 찾기

customerAdministration 쿼리를 사용하여 기능, 해당 권한 ID 및 관련 정보 목록을 조회하십시오. scope: "organization" (으)로 필터링하여 Scorecards 권한을 가져옵니다.

입력스피커, 변수

매개변수	데이터 형식	꼭 필요한가요?	설명
`eq`	문자열	네	스코어카드에 대한 권한을 검색하려면 값을 `organization` 으로 설정합니다.

매개변수

데이터 형식

꼭 필요한가요?

설명

eq

문자열

네

스코어카드에 대한 권한을 검색하려면 값을

organization

으로 설정합니다.

샘플 요청

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

샘플 응답

{
  "data": {
    "customerAdministration": {
      "permissions": {
        "items": [
          {
            "category": "READ",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MANAGE",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "READ",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MANAGE",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          }
        ]
      }
    }
  }
}

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

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

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

샘플 요청

{
  actor {
    organization {
      id
    }
  }
}

샘플 응답

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

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

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

스코어카드 관리를 위한 사용자 지정 역할을 생성하려면 customRoleCreate 뮤테이션을 사용하세요.

입력스피커, 변수

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

샘플 요청

mutation {
  customRoleCreate(
    container: { id: "YOUR_ORGANIZATION_ID", type: "organization" }
    name: "Scorecards 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
          }
        }
      }
    }
  }
}

응답에서 Scorecards 역할을 할당하려는 그룹의 그룹 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": "Scorecards manager",
          "groupId": null,
          "id": "99999999",
          "name": "scorecards_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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

스코어카드에 대한 자세한 내용은 스코어카드 문서를 참조하세요.

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

스코어카드용 커스텀 역할 생성

기본 스코어카드 액세스

스코어카드 기능

전제 조건

팁

스코어카드에 필요한 권한 ID 찾기

입력스피커, 변수

샘플 요청

샘플 응답

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

샘플 요청

샘플 응답

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

입력스피커, 변수

샘플 요청

샘플 응답

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

그룹 ID 검색

입력스피커, 변수

샘플 요청

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

입력스피커, 변수

샘플 요청

샘플 응답

기존 커스텀 역할 관리

역할 업데이트

역할 삭제

커스텀 역할 ID 찾기

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

스코어카드용 커스텀 역할 생성

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

스코어카드 기능

전제 조건

팁

스코어카드에 필요한 권한 ID 찾기

입력스피커, 변수

샘플 요청

샘플 응답

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

샘플 요청

샘플 응답

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

입력스피커, 변수

샘플 요청

샘플 응답

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

그룹 ID 검색

입력스피커, 변수

샘플 요청

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

입력스피커, 변수

샘플 요청

샘플 응답

기존 커스텀 역할 관리

역할 삭제

커스텀 역할 ID 찾기

기본 스코어카드 액세스