인증

SCRAM

SCRAM 인증 은 MongoDB의 기본 인증 메커니즘입니다. MongoDB에는 SCRAM-SHA-1 (MongoDB 3.0 부터 사용 가능) 및 SCRAM-SHA-256 (MongoDB 4.0 부터 사용 가능)의 두 가지 SCRAM 메커니즘이 있습니다. 인증 메커니즘이 지정되지 않았지만 사용자 자격 증명이 지정된 경우 드라이버는 3 서버에서 SCRAM 인증을 사용하려고 시도합니다.0 이상이며 서버 버전과 특정 사용자에 대해 정의된 메커니즘을 기반으로 사용할 메커니즘을 협상합니다(서버에서 사용자가 SCRAM-SHA-1 메커니즘만 허용하도록 구성할 수 있으며 SCRAM만 허용 -SHA-256 메커니즘 또는 둘 다).

SCRAM-SHA-1을 인증 메커니즘으로 명시적으로 지정하려면 다음과 같이 auth_mech: :scram Ruby 클라이언트 옵션 또는 authMechanism URI 옵션의 값으로 SCRAM-SHA-1 를 사용합니다.

client = Mongo::Client.new([ '127.0.0.1:27017' ],
                           database: 'mydb',
                           user: 'test',
                           password: '123',
                           auth_mech: :scram )
client = Mongo::Client.new("mongodb://test:123@127.0.0.1:27017/mydb?authMechanism=SCRAM-SHA-1")

SCRAM-SHA-256을 인증 메커니즘으로 명시적으로 지정하려면 다음과 같이 auth_mech: :scram256 Ruby 클라이언트 옵션 또는 authMechanism URI 옵션의 값으로 SCRAM-SHA-256 를 사용합니다.

client = Mongo::Client.new([ '127.0.0.1:27017' ],
                           database: 'mydb',
                           user: 'test',
                           password: '123',
                           auth_mech: :scram256 )
client = Mongo::Client.new("mongodb://test:123@127.0.0.1:27017/mydb?authMechanism=SCRAM-SHA-256")

클라이언트 인증서(X.509)

드라이버는 TLS 협상 중에 X.509 인증서를 제공합니다. MONGODB-X509 인증 메커니즘은 이 인증서의 고유 주체 이름에서 검색된 사용자 이름을 인증합니다.

이 인증 방법을 사용하려면 인증서 유효성 검사와 함께 TLS 연결을 사용해야 합니다.

클라이언트를 인증하려면 유효한 TLS 인증서와 비공개 암호화 키가 필요합니다. 이러한 파일은 별도의 파일로 저장하거나 하나의 파일(PEM 형식)에 함께 저장할 수 있습니다. 인증서와 비공개 키가 동일한 파일에 저장되어 있더라도 ssl_cert 및 ssl_key 옵션을 모두 클라이언트에 전달하여 해당 파일의 경로를 지정해야 합니다.

MongoDB에서 X.509 인증을 구성하는 방법에 대한 자세한 내용은 MongoDB 매뉴얼의 X.509 튜토리얼을 참조하세요.

client = Mongo::Client.new([ '127.0.0.1:27017' ],
                           auth_mech: :mongodb_x509,
                           ssl: true,
                           ssl_cert: '/path/to/client.pem',
                           ssl_key: '/path/to/client.pem',
                           ssl_ca_cert: '/path/to/ca.pem' )

AWS

MongoDB Enterprise Edition과 서버 버전 4.4 이상이 필요합니다.

Amazon Web Services 인증 메커니즘은 Amazon Web Services ID 및 액세스 관리(IAM) 를 MongoDB 사용합니다. 및 Amazon Web Services Security Token Service(STS) 서버에 클라이언트의 ID를 증명합니다. Amazon Web Services 인증은 다음과 같이 작동합니다.

1. 클라이언트는 Amazon Web Services IAM 자격 증명을 사용하여 MongoDB Server로 전송되는 서명을 생성합니다.

2. 서버는 클라이언트의 서명을 사용하여 Amazon Web Services STS에 요청을 보냅니다.

3. STS 요청이 성공하면 클라이언트가 사용한 자격 증명에 해당하는 사용자 이름(엄밀히 말하면 IAM 사용자 또는 역할의 ARN)이 반환됩니다. IAM 사용자 ARN은 서버에서 정의된 사용자를 조회하는 데 사용되며 클라이언트는 이 사용자로 인증한 것으로 간주됩니다.

Amazon Web Services 자격 증명은 다음과 같이 구성됩니다.

• 액세스 키 ID입니다.

• 비밀 액세스 키입니다.

• 선택적 세션 토큰입니다.

Amazon Web Services IAM 자격 증명 을 사용한 인증 은(는) 액세스 키 ID 와 비밀 액세스 키를 사용합니다. 임시 Amazon Web Services IAM 자격 증명 을 사용한 인증 세 가지 구성 요소를 모두 사용합니다.

임시 자격 증명은 다음과 함께 사용됩니다.

• STS 역할 맡기 제공할 수 있습니다.

• EC2 인스턴스 역할.

• ECS 작업 역할.

• Amazon Web Services Lambda 환경.

• 서비스 계정에 대한 IAM 역할.

Ruby 드라이버를 사용하면 일반 자격 증명과 임시 자격 증명을 Ruby 옵션 또는 URI 옵션으로 명시적으로 제공할 수 있습니다. 자격 증명이 명시적으로 제공되지 않으면 드라이버는 아래에 설명된 환경 변수와 EC2 인스턴스 및 ECS 작업 메타데이터 엔드포인트에서 자격 증명을 검색하려고 시도합니다.

client = Mongo::Client.new(['mongodb.example.com'],
  auth_mech: :aws,
  user: '<AWS-ACCESS-KEY-ID>',
  password: '<AWS-SECRET-ACCESS-KEY>',
  database: 'mydb',
)

client = Mongo::Client.new(
  'mongodb://<AWS-ACCESS-KEY-ID>:<AWS-SECRET-ACCESS-KEY>@mongodb.example.com/mydb?authMechanism=MONGODB-AWS')

client = Mongo::Client.new(['mongodb.example.com'],
  auth_mech: :aws,
  user: '<AWS-ACCESS-KEY-ID>',
  password: '<AWS-SECRET-ACCESS-KEY>',
  auth_mech_properties: {
    aws_session_token: '<AWS-SESSION-TOKEN>',
  },
  database: 'mydb',
)

client = Mongo::Client.new(
  'mongodb://<AWS-ACCESS-KEY-ID>:<AWS-SECRET-ACCESS-KEY>@mongodb.example.com/mydb?authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<AWS-SESSION-TOKEN>')

client = Mongo::Client.new(['mongodb.example.com'],
  auth_mech: :aws,
  database: 'mydb',
)
# Using a URI:
client = Mongo::Client.new(
  'mongodb://mongodb.example.com/mydb?authMechanism=MONGODB-AWS')

LDAP(SASL PLAIN)

MongoDB Enterprise Edition이 필요합니다.

MongoDB Enterprise Edition은 경량 디렉토리 액세스 프로토콜 LDAP 를 사용하여 인증을 위임할 수 있는 LDAP 인증 메커니즘을 지원합니다. 서버.

MongoDB에서 LDAP 인증을 구성하는 방법에 대한 자세한 내용은 MongoDB 매뉴얼의 SASL/LDAP 튜토리얼을 참조하세요.

client = Mongo::Client.new([ '127.0.0.1:27017' ],
                           auth_mech: :plain,
                           ssl: true,
                           ssl_verify: true,
                           ssl_cert: '/path/to/client.pem',
                           ssl_ca_cert: '/path/to/ca.pem' )

Kerberos(GSSAPI)

MongoDB Enterprise Edition이 필요합니다.

Kerberos를 사용하도록 MongoDB 서버를 구성하려면 서버 Kerberos 설명서를 참조하세요.

Ruby MongoDB 드라이버와 함께 Kerberos 인증 메커니즘을 사용하려면 Kerberos 인증자를 구현하는 추가 라이브러리인 mongo_kerberos 를 사용합니다. - 을(를) 설치하고 로드해야 합니다. 이렇게 하려면 Gemfile 에 다음을 추가합니다.

gem 'mongo', '~> 2'
gem 'mongo_kerberos', '~> 2'

... 애플리케이션 코드에 다음을 추가합니다.

require 'mongo'
require 'mongo_kerberos'

자기공명영상( MRI)과 함께 Kerberos 인증을 사용하는 경우, 드라이버 구성에 비밀번호가 지정되지 않았으며 드라이버가 비밀번호를 MongoDB 서버로 전송하지 않습니다. 대신 드라이버 외부에서 Kerberos 세션을 설정해야 하며 드라이버가 이 세션을 사용하여 서버에 사용자의 ID를 증명합니다. 이 세션을 설정하려면 호스트 시스템이 Kerberos 인증을 위해 구성되어야 합니다.Kerberos 설명서 참조 또는 운영 체제 설명서에서 자세한 내용을 확인하세요. kinit 유틸리티 사용 Kerberos 세션을 설정합니다.

JRuby 와 함께 Kerberos 인증을 사용하는 경우, Kerberos 세션은 위에서 설명한 자기공명(MRI) 프로세스를 사용하여 드라이버 외부에서 설정할 수 있습니다. 또는 클라이언트 구성을 통해 비밀번호를 드라이버에 직접 제공하거나 java.security.auth.login.config 시스템 속성에 저장된 구성을 통해 키탭 파일 경로를 제공할 수 있습니다. 또한 Kerberos에 맞게 Java 런타임 환경을 구성해야 합니다.MongoDB Java 드라이버 Kerberos 설명서 를 참조하세요. 을(를) 참조하세요.

# Authenticate as appuser@MYREALM:
client = Mongo::Client.new("mongodb://appuser%40MYREALM@myserver.mycompany.com:27017/mydb?authMechanism=GSSAPI")
# Authenticate as myapp/appuser@MYREALM:
client = Mongo::Client.new("mongodb://myapp%2Fappuser%40MYREALM@myserver.mycompany.com:27017/mydb?authMechanism=GSSAPI")
# Authenticate using Ruby options:
client = Mongo::Client.new(['myserver.mycompany.com:27017'],
                           auth_mech: :gssapi,
                           user: 'myapp/appuser@MYREALM')

MONGODB-CR

더 이상 사용되지 않음: MONGODB-CR 메커니즘은 MongoDB 3.6 부터 더 이상 사용되지 않으며 MongoDB 4.0 부터 제거되었습니다. 대신 SCRAM 인증 을 사용하세요.

MONGODB-CR은 버전 2.6까지 MongoDB의 기본 인증 메커니즘이었습니다.

메커니즘은 자격 증명을 사용하여 명시적으로 설정할 수 있습니다.

client = Mongo::Client.new([ '127.0.0.1:27017' ],
                           database: 'mydb',
                           user: 'test',
                           password: '123',
                           auth_mech: :mongodb_cr )