mongodb-connection-model

mongodb-connection-model

MongoDB connection model.

Installation

npm install --save mongodb-connection-model

Usage

var Connection = require('mongodb-connection-model');

Properties

• hostname (optional, String) ... Hostname of a MongoDB Instance [Default: localhost].
• port (optional, Number) ... TCP port of a MongoDB Instance [Default: 27017].
• name (optional, String) ... User specified name [Default: My MongoDB].

Derived Properties

• instance_id (String) ... The mongoscope instance_id [Default: localhost:27017].
• driver_url (String) ... The first argument mongoscope-server passes to mongodb.connect [Default: mongodb://localhost:27017/?slaveOk=true].
• driver_options (Object) ... The second argument mongoscope-server passes to mongodb.connect [Default: {}].

Traits

It's useful to think of the remaining properties as two primary traits: authentication and ssl.

Trait: Authentication

• authentication (optional, String) ... The desired authetication strategy [Default: NONE]
  • NONE Use no authentication.
  • MONGODB Allow the driver to auto-detect and select SCRAM-SHA-1 or MONGODB-CR depending on server capabilities.
  • KERBEROS
  • X509
  • LDAP

A1. No Authentication

var model = new Connection({
  authentication: 'NONE'
});
console.log(model.driver_url);
>>> 'mongodb://localhost:27017?slaveOk=true'

console.log(new Connection().driver_url);
>>> 'mongodb://localhost:27017?slaveOk=true'

A2. MongoDB

• mongodb_username (required, String)
• mongodb_password (required, String)
• mongodb_database_name (optional, String) [Default: admin]

var model = new Connection({
  authentication: 'MONGODB',
  mongodb_username: 'arlo',
  mongodb_password: 'B@sil'
});
console.log(model.driver_url);
>>> 'mongodb://arlo:B%40sil@localhost:27017?slaveOk=true&authSource=admin'

A3. Kerberos

• kerberos_principal (required, String) ... The format of a typical Kerberos V5 principal is primary/instance@REALM.
• kerberos_password (optional, String) ... [Default: undefined].
• kerberos_service_name (optional, String) ... [Default: mongodb].

node.js driver Kerberos reference

var model = new Connection({
  authentication: 'KERBEROS',
  kerberos_principal: '[e-mail]'
});
console.log(model.driver_url);
>>> 'mongodb://arlo%2540MONGODB.PARTS@localhost:27017/kerberos?slaveOk=true&gssapiServiceName=mongodb&authMechanism=GSSAPI'

A4. Kerberos on Windows

@note (imlucas): Broken out as it's own state for UX consideration.

var model = new Connection({
  authentication: 'KERBEROS',
  kerberos_principal: 'arlo/[e-mail]',
  kerberos_password: 'B@sil',
  kerberos_service_name: 'MongoDB'
});
console.log(model.driver_url);
>>> 'mongodb://arlo%252Fadmin%2540MONGODB.PARTS:B%40sil@localhost:27017/kerberos?slaveOk=true&gssapiServiceName=MongoDB&authMechanism=GSSAPI'

A5. X509

node.js driver X509 reference

A6. LDAP

node.js driver LDAP reference

Trait: SSL

Note: Not to be confused with authentication=X509.

• ssl (optional, String) ... The desired ssl strategy [Default: NONE]
  • NONE No SSL.
  • UNVALIDATED No validation of certificate chain.
  • SERVER Driver should validate Server certificate.
  • ALL Driver should validate Server certificate and present valid Certificate.

S1. NONE

Do not use SSL for anything.

S2. UNVALIDATED

Use SSL but do not perform any validation of the certificate chain.

S3. SERVER

The driver should validate the server certificate and fail to connect if validation fails.

S4. ALL

The driver must present a valid certificate and validate the server certificate.

Matrix

authentication:ssl	NONE	UNVALIDATED	SERVER	ALL
NONE
MONGODB
KERBEROS
KERBEROS_WINDOWS
X509
LDAP

Testing

npm test

License

Apache 2.0

Questions