• 로그인지금 시작하기

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

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

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

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

요구 사항

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

시작하기 전에

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

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

사용자 유형 필드

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

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

그룹 관리

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

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.