/* * @copyright * Copyright © Microsoft Open Technologies, Inc. * * All Rights Reserved * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http: *www.apache.org/licenses/LICENSE-2.0 * * THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS * OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION * ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A * PARTICULAR PURPOSE, MERCHANTABILITY OR NON-INFRINGEMENT. * * See the Apache License, Version 2.0 for the specific language * governing permissions and limitations under the License. */ 'use strict'; var request = require('request'); var uuid = require('uuid'); var Logger = require('./log').Logger; var util = require('./util'); var WSTrustResponse = require('./wstrust-response'); var WSTrustVersion = require('./constants').WSTrustVersion; var USERNAME_PLACEHOLDER = '{UsernamePlaceHolder}'; var PASSWORD_PLACEHOLDER = '{PasswordPlaceHolder}'; /** * Creates a new instance of WSTrustRequest * @constructor * @private * @param {object} callContext Contains any context information that applies to the request. * @param {string} wstrustEndpointUrl An STS WS-Trust soap endpoint. * @param {string} appliesTo A URI that identifies a service for which the a token is to be obtained. */ function WSTrustRequest(callContext, wstrustEndpointUrl, appliesTo, wstrustEndpointVersion) { this._log = new Logger('WSTrustRequest', callContext._logContext); this._callContext = callContext; this._wstrustEndpointUrl = wstrustEndpointUrl; this._appliesTo = appliesTo; this._wstrustEndpointVersion = wstrustEndpointVersion; } /** * Given a Date object adds the minutes parameter and returns a new Date object. * @private * @static * @memberOf WSTrustRequest * @param {Date} date A Date object. * @param {Number} minutes The number of minutes to add to the date parameter. * @returns {Date} Returns a Date object. */ function _datePlusMinutes(date, minutes) { var minutesInMilliSeconds = minutes * 60 * 1000; var epochTime = date.getTime() + minutesInMilliSeconds; return new Date(epochTime); } /** * Builds the soap security header for the RST message. * @private * @param {string} username A username * @param {string} password The passowrd that corresponds to the username parameter. * @returns {string} A string that contains the soap security header. */ WSTrustRequest.prototype._buildSecurityHeader = function() { var timeNow = new Date(); var expireTime = _datePlusMinutes(timeNow, 10); var timeNowString = timeNow.toISOString(); var expireTimeString = expireTime.toISOString(); var securityHeaderXml = '\ \ ' + timeNowString + '\ ' + expireTimeString + '\ \ \ ' + USERNAME_PLACEHOLDER + '\ ' + PASSWORD_PLACEHOLDER + '\ \ '; return securityHeaderXml; }; /** * Replaces the placeholders in the RST template with the actual username and password values. * @private * @param {string} RSTTemplate An RST with placeholders for username and password. * @param {string} username A username * @param {string} password The passowrd that corresponds to the username parameter. * @returns {string} A string containing a complete RST soap message. */ WSTrustRequest.prototype._populateRSTUsernamePassword = function(RSTTemplate, username, password) { var RST = RSTTemplate.replace(USERNAME_PLACEHOLDER, username).replace(PASSWORD_PLACEHOLDER, this._populatedEscapedPassword(password)); return RST; }; /** * Escape xml characters in password. * @private * @param {string} password The password to be excaped with xml charaters. */ WSTrustRequest.prototype._populatedEscapedPassword = function (password) { var escapedPassword = password; return escapedPassword.replace(/&/g, '&') .replace(/"/g, '"') .replace(/'/g, ''') .replace(//g, '>'); } /** * Builds a WS-Trust RequestSecurityToken (RST) message using username password authentication. * @private * @param {string} username A username * @param {string} password The passowrd that corresponds to the username parameter. * @returns {string} A string containing a complete RST soap message. */ WSTrustRequest.prototype._buildRST = function(username, password) { var messageID = uuid.v4(); // Create a template RST with placeholders for the username and password so the // the RST can be logged without the sensitive information. var schemaLocation = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd'; var soapAction = 'http://docs.oasis-open.org/ws-sx/ws-trust/200512/RST/Issue'; var rstTrustNamespace = 'http://docs.oasis-open.org/ws-sx/ws-trust/200512'; var keyType = 'http://docs.oasis-open.org/ws-sx/ws-trust/200512/Bearer'; var requestType = 'http://docs.oasis-open.org/ws-sx/ws-trust/200512/Issue'; if (this._wstrustEndpointVersion === WSTrustVersion.WSTRUST2005) { soapAction = 'http://schemas.xmlsoap.org/ws/2005/02/trust/RST/Issue'; rstTrustNamespace = 'http://schemas.xmlsoap.org/ws/2005/02/trust'; keyType = 'http://schemas.xmlsoap.org/ws/2005/05/identity/NoProofKey'; requestType = 'http://schemas.xmlsoap.org/ws/2005/02/trust/Issue'; } var RSTTemplate = '\ \ ' + soapAction + '\ urn:uuid:' + messageID + '\ \ http://www.w3.org/2005/08/addressing/anonymous\ \ ' + this._wstrustEndpointUrl + '\ ' + this._buildSecurityHeader() + '\ \ \ \ \ \ ' + this._appliesTo + '\ \ \ ' + keyType + '\ ' + requestType + '\ \ \ '; this._log.verbose('Created RST: \n' + RSTTemplate, true); var RST = this._populateRSTUsernamePassword(RSTTemplate, username, password); return RST; }; /** * Handles the processing of a RSTR * @private * @param {string} body * @param {WSTrustRequest.AcquireTokenCallback} callback */ WSTrustRequest.prototype._handleRSTR = function(body, callback) { var err; var wstrustResponse = new WSTrustResponse(this._callContext, body, this._wstrustEndpointVersion); try { wstrustResponse.parse(); } catch (error) { err = error; } callback(err, wstrustResponse); }; /** * Performs a WS-Trust RequestSecurityToken request to obtain a federated token in exchange for a username password. * @param {string} username A username * @param {string} password The passowrd that corresponds to the username parameter. * @param {WSTrustRequest.AcquireTokenCallback} callback Called once the federated token has been retrieved or on error. */ WSTrustRequest.prototype.acquireToken = function(username, password, callback) { if (this._wstrustEndpointVersion === WSTrustVersion.UNDEFINED) { var err = this._log.createError('Unsupported wstrust endpoint version. Current support version is wstrust2005 or wstrust13.'); callback(err); return; } var self = this; var RST = this._buildRST(username, password); var soapAction = this._wstrustEndpointVersion === WSTrustVersion.WSTRUST2005 ? 'http://schemas.xmlsoap.org/ws/2005/02/trust/RST/Issue' : 'http://docs.oasis-open.org/ws-sx/ws-trust/200512/RST/Issue'; var options = util.createRequestOptions( this, { headers : { 'Content-Type' : 'application/soap+xml; charset=utf-8', 'SOAPAction' : soapAction }, body : RST } ); this._log.verbose('Sending RST to: ' + this._wstrustEndpointUrl, true); request.post(this._wstrustEndpointUrl, options, util.createRequestHandler('WS-Trust RST', this._log, callback, function(response, body) { self._handleRSTR(body, callback); } )); }; /** * @callback AcquireTokenCallback * @memberOf WSTrustRequest * @param {Error} err Contains an error object if acquireToken fails. * @param {WSTrustResponse} A successful response to the RST. */ module.exports = WSTrustRequest;