문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/
참조
/
Mongo쉬 방법
/
데이터베이스 메서드

db.rotateCertificates()를 호출합니다.

이 페이지의 내용

  • 정의
  • 출력
  • 행동
  • 로깅
  • 필요한 액세스 권한
  • 예제

정의

버전 5.0에 추가.

db.rotateCertificates(message)

또는 에 mongod 대해 현재사용되는 TLS mongos 인증서 를 순환하여 구성 파일에정의된 이러한 인증서에 대해 업데이트된 값을 사용합니다.

db.rotateCertificates(message)

db.rotateCertificates() 메서드는 다음과 같은 선택적 인수를 사용합니다.

매개변수
유형
설명
message
문자열
선택적 서버가 로그 파일과 감사 파일에 기록하는 메시지입니다.

db.rotateCertificates() 메서드는 rotateCertificates 명령을 래핑합니다.

출력

db.rotateCertificates() 메서드는 다음 필드가 있는 문서를 반환합니다.

필드
유형
설명
ok
부울
명령의 실행 상태를 포함합니다. 성공하면 true , 오류가 발생하면 false 을 반환합니다. false 인 경우 자세한 오류 메시지와 함께 errmsg 필드가 추가로 제공됩니다.

행동

순환에는 다음 인증서가 포함됩니다.

이러한 인증서 중 하나 이상을 회전하려면 다음을 수행하세요.

  1. 다음 제약 조건에 유의하여 파일 시스템에서 회전하려는 인증서를 교체하세요.

    • 새로운 각 인증서는 교체하는 인증서와 동일한 파일 이름 및 파일 경로를 가지고 있어야 합니다.

    • 암호화된 TLS Certificate를 회전하는 경우, 새 인증서의 암호는 이전 인증서의 암호( certificateKeyFilePassword 구성 파일 설정에 지정된 대로)와 같아야 합니다. 인증서 회전은 대화형 비밀번호 프롬프트를 지원하지 않습니다.

  2. mongosh 를 인증서 로테이션을 수행하려는 mongod 또는 mongos 인스턴스에 연결합니다.

  3. db.rotateCertificates() 를 실행하여 mongod 또는 mongos 인스턴스에서 사용하는 인증서를 순환합니다.

인증서 회전이 발생하는 경우:

  • mongod 또는 mongos 인스턴스에 대한 기존 연결은 종료되지 않으며 이전 인증서를 계속 사용합니다.

  • 모든 새 연결은 새 인증서를 사용합니다.

배포서버에 OCSP 를 구성한 경우 db.rotateCertificates() 메서드는 순환 중에 스테이플된 OCSP 응답도 가져옵니다.

db.rotateCertificates() 메서드는 복제 상태에 관계없이 실행 중인 mongod 또는 mongos 에서 실행할 수 있습니다.

각 또는 프로세스에서 mongod db.rotateCertificates() rotateCertificates 한 번에 mongos 하나의 또는 인스턴스만 실행할 수 있습니다. 두 번째 인스턴스가 이미 실행 중인 상태에서 두 번째 인스턴스를 시작하려고 하면 오류가 발생합니다.

인증서 파일이 잘못되었거나, 만료되었거나, 해지되었거나, 누락된 경우 인증서 회전이 실패하지만 기존 TLS 구성이 무효화되거나 실행 중인 mongod 또는 mongos 프로세스가 종료되지는 않습니다.

가 로 설정된 mongos 상태에서 또는 가 mongod --tlsCertificateSelector 실행 중인 경우 thumbprint db.rotateCertificates() 는 실패하고 로그 파일에 경고 메시지를 기록합니다.

로깅

순환에 성공하면 주체 이름, 지문, 서버 및 cluster 인증서 지문의 유효 기간이 구성된 로그 대상 에 기록됩니다. 감사 가 활성화된 경우 이 정보는 감사 로그에도 기록됩니다.

Linux 및 Windows 플랫폼에서 CRL file 가 있으면 지문 및 유효 기간도 이 위치에 기록됩니다.

필요한 액세스 권한

메서드를 사용하려면 db.rotateCertificates() 작업 rotateCertificates 이 rotateCertificates 있어야 합니다. 작업은 역할의 hostManager 일부입니다.

예제

다음 작업은 업데이트된 인증서 정보를 지정하기 위해 구성 파일을 적절하게 업데이트한 후 실행 중인 mongod 인스턴스에서 인증서를 순환합니다.

db.rotateCertificates()

다음은 위와 동일한 작업을 수행하지만 순환 시 로그 파일 과 감사 파일에 사용자 지정 로그 메시지를 씁니다.

db.rotateCertificates("message": "Rotating certificates")
← db.resetError()
db.runCommand() →

이 페이지의 내용