db.getUsers() (mongosh 메서드)

정의

db.getUsers(<options>)

데이터베이스의 모든 사용자에 대한 정보를 반환합니다.

db.getUsers() 은 usersInfo: 1 명령을 래핑합니다.

db.getUsers() 메서드는 다음과 같은 옵션을 사용할 수 있습니다.

db.getUsers( {
   showCredentials: <Boolean>,
   showCustomData: <Boolean>,
   authenticatedMechanism: <string>,
   filter: <document>
} )

필드	유형	설명
showCredentials	부울	선택 사항입니다. 사용자의 비밀번호 해시를 표시하려면 true로 설정합니다. 기본적으로 이 필드는 false입니다.
showCustomData	부울	선택 사항입니다. 출력에서 사용자의 customData를 생략하려면 false로 설정합니다. 기본적으로 이 필드는 true입니다. 버전 5.2에 추가 되었습니다.
authenticatedMechanism	문자열	버전 9.0에 추가 되었습니다. 선택 사항. 지원되는 인증 메커니즘 나타내는 문자열로 설정하여 db.getUsers()가 사용자 권한 부여 정보를 조회하는 위치를 결정합니다. 메커니즘 및 관련 문자열 목록은 authenticationMechanisms를 참조하세요. 이 필드 지정하지 않으면 db.getUsers()은(는) $external 데이터베이스 에 정의된 사용자에 대해서는 LDAP 에서 정보를 반환하고 SCRAM 사용자에 대해서는 로컬 권한 부여 데이터베이스 에서 정보를 반환합니다.
filter	문서	선택 사항입니다. 필터 조건과 일치하는 사용자에 대한 정보를 반환하기 위해 $match 단계 조건을 지정하는 문서입니다.

자세한 내용은 usersInfo를 참조하세요.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

필요한 액세스 권한

다른 사용자의 정보를 확인하려면 다른 사용자의 데이터베이스에 viewUser 조치가 있어야 합니다.

사용자는 자신의 정보를 확인할 수 있습니다.

예시

db.getUsers({ filter: { mechanisms: "SCRAM-SHA-256" } })

db.getSiblingDB("products").runCommand( {
   createUser: "accountAdmin01",
   pwd: passwordPrompt(),
   customData: { employeeId: 12345 },
   roles: [ { role: 'readWrite', db: 'products' } ]
} )

db.getSiblingDB("products").getUsers( { showCustomData: false } )

{
   users: [
     {
       _id: 'products.accountAdmin01',
       userId: UUID("0955afc1-303c-4683-a029-8e17dd5501f4"),
       user: 'accountAdmin01',
       db: 'products',
       roles: [ { role: 'readWrite', db: 'products' } ],
       mechanisms: [ 'SCRAM-SHA-1', 'SCRAM-SHA-256' ]
     }
   ],
   ok: 1
}