NerdGraph 튜토리얼: 사용자 생성 및 관리

NerdGraph API 를 사용하여 사용자를 보고 관리할 수 있습니다. 사용자를 추가 및 삭제하고, 사용자의 이메일 주소 및 사용자 유형을 편집하고, 다른 유형의 사용자 정보를 반환할 수 있습니다.

UI에서 이 작업을 수행하는 방법은 사용자 관리 UI 문서 를 참조하세요.

요구 사항

NerdGraph를 통해 사용자를 관리하기 위한 몇 가지 요구 사항:

최신 사용자 모델에서 사용자를 관리하기 위한 것 입니다. 기타 권한 관련 요구 사항:
- 필수 사용자 유형 : 핵심 사용자 또는 전체 플랫폼 사용자.
- 필수 관리 설정 : 사용자를 보고 변경하려면 인증 도메인 설정 이 필요합니다. 조직 수준에서 보고 변경하려면 조직 설정 이 필요합니다.

시작하기 전에

NerdGraph를 사용하여 사용자를 관리하기 전에 몇 가지 중요한 사항이 있습니다.

사용자 관리 개념 을 충분히 이해하고 있는지 확인합니다.
NerdGraph 탐색기 에는 이러한 요청에 사용되는 필드를 정의하는 내장 문서가 있습니다.
New Relic 계정의 변경 사항을 추적 할 수 있습니다.

다음은 사용자 정보를 쿼리하고 사용자를 변경하는 몇 가지 예입니다.

사용자 유형 필드

사용 가능한 사용자 유형 값은 다음과 같습니다.

FULL_USER_TIER
CORE_USER_TIER
BASIC_USER_TIER

사용자 정보 쿼리

다음은 조직의 모든 사용자 유형 을 보기 위한 쿼리의 예입니다.

{
  actor {
    organization {
      userManagement {
        types {
          displayName
          id
        }
      }
    }
  }
}

다음은 특정 인증 도메인의 사용자에 대한 마지막 활성 날짜 및 사용자 유형을 가져오는 쿼리의 예입니다.

{
  actor {
    organization {
      userManagement {
        authenticationDomains(id: "YOUR_AUTH_DOMAIN_ID") {
          authenticationDomains {
            users {
              users {
                id
                name
                email
                lastActive
                type {
                  displayName
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}

사용자 만들기

다음은 기본 사용자를 만드는 예입니다.

mutation {
  userManagementCreateUser(
    createUserOptions: {
      authenticationDomainId: "YOUR_AUTH_DOMAIN_ID"
      email: "EMAIL_OF_YOUR_USER"
      name: "NAME_OF_YOUR_USER"
      userType: BASIC_USER_TIER
    }
  ) {
    createdUser {
      authenticationDomainId
      email
      id
      name
      type {
        displayName
        id
      }
    }
  }
}

다음은 수동으로 프로비저닝된 사용자에 대해 설정되지 않은 인증 도메인 내에서 사용자를 생성하려고 할 때 발생하는 오류 응답의 예입니다.

{
  "data": {
    "userManagementCreateUser": null
  },
  "errors": [
    {
      "message": "This API can only be used to create users within Authentication Domains set for manually provisioned users."
    }
  ]
}

다음은 인증 도메인에 이미 존재하는 사용자를 생성하려고 할 때 발생하는 오류 응답의 예입니다.

{
  "data": {
    "userManagementCreateUser": null
  },
  "errors": [
    {
      "message": "User with email: <USER_EMAIL> and authentication domain: <AUTH_DOMAIN_ID> already exists."
    }
  ]
}

사용자 업데이트

다음은 사용자의 사용자 유형을 전체 플랫폼 사용자로 업데이트하는 예입니다.

mutation {
  userManagementUpdateUser(
    updateUserOptions: { id: "ID_OF_YOUR_USER", userType: FULL_USER_TIER }
  ) {
    user {
      id
      type {
        displayName
        id
      }
    }
  }
}

다음은 사용자의 이메일 주소를 업데이트하는 예입니다.

mutation {
  userManagementUpdateUser(
    updateUserOptions: { id: "ID_OF_YOUR_USER", email: "EMAIL_OF_YOUR_USER" }
  ) {
    user {
      id
      email
    }
  }
}

그룹에 사용자 추가

그룹을 관리하고 사용자를 그룹에 추가하는 방법 은 NerdGraph로 사용자 그룹 관리 를 참조하세요.

사용자 삭제

다음은 사용자 삭제의 예입니다.

mutation {
  userManagementDeleteUser(deleteUserOptions: {id: "ID_OF_YOUR_USER"}) {
    deletedUser {
      id
    }
  }
}

다음은 SCIM 프로비저닝된 인증 도메인에서 사용자를 삭제하려고 할 때 발생하는 오류 응답의 예입니다.

{
  "data": {
    "userManagementDeleteuser": null
  },
  "errors": [
    {
      "message": "This API can only be used to delete users within Authentication Domains set for manually provisioned users."
    }
  ]
}

쪽수 매기기

기본적으로 API는 최대 500명의 사용자 또는 10개의 인증 도메인만 반환합니다. 그 이상이면 커서를 사용하여 다음 500명의 사용자 또는 10개의 인증 도메인을 가져올 수 있습니다. 이 호출은 커서 입력을 사용하여 다른 호출에 공급할 수 있는 nextCursor 을 반환합니다.

{
  actor {
    organization {
      userManagement {
        authenticationDomains(id: "YOUR_AUTH_DOMAIN_ID") {
          authenticationDomains {
            users(cursor: "=abcdEFGH2356X") {
              nextCursor
              totalCount
              users {
                email
                id
                lastActive
                name
                type {
                  displayName
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}

다음은 조직의 모든 인증 도메인에 대해 페이지를 매긴 반환을 시작하는 예입니다.

{
  actor {
    organization {
      userManagement {
        authenticationDomains(cursor: "=123xyzABCx") {
          nextCursor
          totalCount
          authenticationDomains {
            id
            name
          }
        }
      }
    }
  }
}

그룹 관리

그룹을 관리하고 그룹에서 사용자를 추가 및 제거하는 방법은 그룹 관리 를 참조하십시오.

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.