123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177 |
- "use strict";
- Object.defineProperty(exports, "__esModule", { value: true });
- exports.MongoCredentials = exports.DEFAULT_ALLOWED_HOSTS = void 0;
- const error_1 = require("../../error");
- const gssapi_1 = require("./gssapi");
- const providers_1 = require("./providers");
- // https://github.com/mongodb/specifications/blob/master/source/auth/auth.rst
- function getDefaultAuthMechanism(hello) {
- if (hello) {
- // If hello contains saslSupportedMechs, use scram-sha-256
- // if it is available, else scram-sha-1
- if (Array.isArray(hello.saslSupportedMechs)) {
- return hello.saslSupportedMechs.includes(providers_1.AuthMechanism.MONGODB_SCRAM_SHA256)
- ? providers_1.AuthMechanism.MONGODB_SCRAM_SHA256
- : providers_1.AuthMechanism.MONGODB_SCRAM_SHA1;
- }
- // Fallback to legacy selection method. If wire version >= 3, use scram-sha-1
- if (hello.maxWireVersion >= 3) {
- return providers_1.AuthMechanism.MONGODB_SCRAM_SHA1;
- }
- }
- // Default for wireprotocol < 3
- return providers_1.AuthMechanism.MONGODB_CR;
- }
- const ALLOWED_PROVIDER_NAMES = ['aws', 'azure'];
- const ALLOWED_HOSTS_ERROR = 'Auth mechanism property ALLOWED_HOSTS must be an array of strings.';
- /** @internal */
- exports.DEFAULT_ALLOWED_HOSTS = [
- '*.mongodb.net',
- '*.mongodb-dev.net',
- '*.mongodbgov.net',
- 'localhost',
- '127.0.0.1',
- '::1'
- ];
- /** Error for when the token audience is missing in the environment. */
- const TOKEN_AUDIENCE_MISSING_ERROR = 'TOKEN_AUDIENCE must be set in the auth mechanism properties when PROVIDER_NAME is azure.';
- /**
- * A representation of the credentials used by MongoDB
- * @public
- */
- class MongoCredentials {
- constructor(options) {
- this.username = options.username ?? '';
- this.password = options.password;
- this.source = options.source;
- if (!this.source && options.db) {
- this.source = options.db;
- }
- this.mechanism = options.mechanism || providers_1.AuthMechanism.MONGODB_DEFAULT;
- this.mechanismProperties = options.mechanismProperties || {};
- if (this.mechanism.match(/MONGODB-AWS/i)) {
- if (!this.username && process.env.AWS_ACCESS_KEY_ID) {
- this.username = process.env.AWS_ACCESS_KEY_ID;
- }
- if (!this.password && process.env.AWS_SECRET_ACCESS_KEY) {
- this.password = process.env.AWS_SECRET_ACCESS_KEY;
- }
- if (this.mechanismProperties.AWS_SESSION_TOKEN == null &&
- process.env.AWS_SESSION_TOKEN != null) {
- this.mechanismProperties = {
- ...this.mechanismProperties,
- AWS_SESSION_TOKEN: process.env.AWS_SESSION_TOKEN
- };
- }
- }
- if (this.mechanism === providers_1.AuthMechanism.MONGODB_OIDC && !this.mechanismProperties.ALLOWED_HOSTS) {
- this.mechanismProperties = {
- ...this.mechanismProperties,
- ALLOWED_HOSTS: exports.DEFAULT_ALLOWED_HOSTS
- };
- }
- Object.freeze(this.mechanismProperties);
- Object.freeze(this);
- }
- /** Determines if two MongoCredentials objects are equivalent */
- equals(other) {
- return (this.mechanism === other.mechanism &&
- this.username === other.username &&
- this.password === other.password &&
- this.source === other.source);
- }
- /**
- * If the authentication mechanism is set to "default", resolves the authMechanism
- * based on the server version and server supported sasl mechanisms.
- *
- * @param hello - A hello response from the server
- */
- resolveAuthMechanism(hello) {
- // If the mechanism is not "default", then it does not need to be resolved
- if (this.mechanism.match(/DEFAULT/i)) {
- return new MongoCredentials({
- username: this.username,
- password: this.password,
- source: this.source,
- mechanism: getDefaultAuthMechanism(hello),
- mechanismProperties: this.mechanismProperties
- });
- }
- return this;
- }
- validate() {
- if ((this.mechanism === providers_1.AuthMechanism.MONGODB_GSSAPI ||
- this.mechanism === providers_1.AuthMechanism.MONGODB_CR ||
- this.mechanism === providers_1.AuthMechanism.MONGODB_PLAIN ||
- this.mechanism === providers_1.AuthMechanism.MONGODB_SCRAM_SHA1 ||
- this.mechanism === providers_1.AuthMechanism.MONGODB_SCRAM_SHA256) &&
- !this.username) {
- throw new error_1.MongoMissingCredentialsError(`Username required for mechanism '${this.mechanism}'`);
- }
- if (this.mechanism === providers_1.AuthMechanism.MONGODB_OIDC) {
- if (this.username && this.mechanismProperties.PROVIDER_NAME) {
- throw new error_1.MongoInvalidArgumentError(`username and PROVIDER_NAME may not be used together for mechanism '${this.mechanism}'.`);
- }
- if (this.mechanismProperties.PROVIDER_NAME === 'azure' &&
- !this.mechanismProperties.TOKEN_AUDIENCE) {
- throw new error_1.MongoAzureError(TOKEN_AUDIENCE_MISSING_ERROR);
- }
- if (this.mechanismProperties.PROVIDER_NAME &&
- !ALLOWED_PROVIDER_NAMES.includes(this.mechanismProperties.PROVIDER_NAME)) {
- throw new error_1.MongoInvalidArgumentError(`Currently only a PROVIDER_NAME in ${ALLOWED_PROVIDER_NAMES.join(',')} is supported for mechanism '${this.mechanism}'.`);
- }
- if (this.mechanismProperties.REFRESH_TOKEN_CALLBACK &&
- !this.mechanismProperties.REQUEST_TOKEN_CALLBACK) {
- throw new error_1.MongoInvalidArgumentError(`A REQUEST_TOKEN_CALLBACK must be provided when using a REFRESH_TOKEN_CALLBACK for mechanism '${this.mechanism}'`);
- }
- if (!this.mechanismProperties.PROVIDER_NAME &&
- !this.mechanismProperties.REQUEST_TOKEN_CALLBACK) {
- throw new error_1.MongoInvalidArgumentError(`Either a PROVIDER_NAME or a REQUEST_TOKEN_CALLBACK must be specified for mechanism '${this.mechanism}'.`);
- }
- if (this.mechanismProperties.ALLOWED_HOSTS) {
- const hosts = this.mechanismProperties.ALLOWED_HOSTS;
- if (!Array.isArray(hosts)) {
- throw new error_1.MongoInvalidArgumentError(ALLOWED_HOSTS_ERROR);
- }
- for (const host of hosts) {
- if (typeof host !== 'string') {
- throw new error_1.MongoInvalidArgumentError(ALLOWED_HOSTS_ERROR);
- }
- }
- }
- }
- if (providers_1.AUTH_MECHS_AUTH_SRC_EXTERNAL.has(this.mechanism)) {
- if (this.source != null && this.source !== '$external') {
- // TODO(NODE-3485): Replace this with a MongoAuthValidationError
- throw new error_1.MongoAPIError(`Invalid source '${this.source}' for mechanism '${this.mechanism}' specified.`);
- }
- }
- if (this.mechanism === providers_1.AuthMechanism.MONGODB_PLAIN && this.source == null) {
- // TODO(NODE-3485): Replace this with a MongoAuthValidationError
- throw new error_1.MongoAPIError('PLAIN Authentication Mechanism needs an auth source');
- }
- if (this.mechanism === providers_1.AuthMechanism.MONGODB_X509 && this.password != null) {
- if (this.password === '') {
- Reflect.set(this, 'password', undefined);
- return;
- }
- // TODO(NODE-3485): Replace this with a MongoAuthValidationError
- throw new error_1.MongoAPIError(`Password not allowed for mechanism MONGODB-X509`);
- }
- const canonicalization = this.mechanismProperties.CANONICALIZE_HOST_NAME ?? false;
- if (!Object.values(gssapi_1.GSSAPICanonicalizationValue).includes(canonicalization)) {
- throw new error_1.MongoAPIError(`Invalid CANONICALIZE_HOST_NAME value: ${canonicalization}`);
- }
- }
- static merge(creds, options) {
- return new MongoCredentials({
- username: options.username ?? creds?.username ?? '',
- password: options.password ?? creds?.password ?? '',
- mechanism: options.mechanism ?? creds?.mechanism ?? providers_1.AuthMechanism.MONGODB_DEFAULT,
- mechanismProperties: options.mechanismProperties ?? creds?.mechanismProperties ?? {},
- source: options.source ?? options.db ?? creds?.source ?? 'admin'
- });
- }
- }
- exports.MongoCredentials = MongoCredentials;
- //# sourceMappingURL=mongo_credentials.js.map
|