@bostonuniversity/shibboleth-sp 1.0.2

package/dist/esm/Saml.js

@@ -0,0 +1,235 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFriendlySamlResponse = exports.SamlTools = void 0;
+const saml2_js_1 = require("saml2-js");
+const xmldom_1 = require("@xmldom/xmldom");
+class SamlTools {
+    constructor(parms) {
+        const { entityId, entryPoint, logoutUrl, idpCert, cert, key } = parms;
+        this.sp_options = {
+            entity_id: entityId,
+            private_key: '',
+            certificate: '',
+            assert_endpoint: '',
+            force_authn: true,
+            sign_get_request: true,
+            allow_unencrypted_assertion: true,
+            notbefore_skew: 60
+        };
+        if (cert) {
+            this.sp_options.certificate = cert;
+        }
+        if (key) {
+            this.sp_options.private_key = key;
+        }
+        this.idp_options = {
+            sso_login_url: entryPoint,
+            sso_logout_url: logoutUrl,
+            sign_get_request: true,
+            allow_unencrypted_assertion: true,
+            force_authn: false,
+            certificates: [idpCert]
+        };
+    }
+    setSpCertificate(cert) {
+        this.sp_options.certificate = cert;
+    }
+    setPrivateKey(key) {
+        this.sp_options.private_key = key;
+    }
+    setAssertUrl(assertEndpoint) {
+        this.sp_options.assert_endpoint = assertEndpoint;
+    }
+    getMetaData() {
+        return (new saml2_js_1.ServiceProvider(this.sp_options)).create_metadata();
+    }
+    /**
+     * The request indicates the user is not authenticated, and so needs to be redirected to a url for signin with the IDP.
+     *
+     * @see https://www.npmjs.com/package/saml2-js#create_login_request_urlidp-options-cb
+     * @param relay_state
+     * @returns
+     */
+    createLoginRequestUrl(relay_state) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                const sp = new saml2_js_1.ServiceProvider(this.sp_options);
+                const idp = new saml2_js_1.IdentityProvider(this.idp_options);
+                sp.create_login_request_url(idp, {
+                    relay_state,
+                }, (err, login_url, request_id) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(login_url);
+                    }
+                });
+            });
+        });
+    }
+    /**
+     * @returns The url to the IDP to logout.
+     */
+    createLogoutRequestUrl() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                const sp = new saml2_js_1.ServiceProvider(this.sp_options);
+                const idp = new saml2_js_1.IdentityProvider(this.idp_options);
+                sp.create_logout_request_url(idp, {}, (err, logout_url) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(logout_url);
+                    }
+                });
+            });
+        });
+    }
+    /**
+     * The saml response could come from the IDP as either a querystring parameter (GET), or as a
+     * form data parameter (POST).
+     * @param request
+     * @returns
+     */
+    getSamlResponseParameter(request) {
+        let samlResponseParm;
+        let xmlData;
+        let relayState;
+        try {
+            if (request.method === 'GET') {
+                // Check query string for SAMLResponse
+                const queryStringParams = request.querystring ? new URLSearchParams(request.querystring) : null;
+                const samlResponseFromQueryString = queryStringParams ? queryStringParams.get('SAMLResponse') : null;
+                relayState = queryStringParams ? queryStringParams.get('RelayState') || undefined : undefined;
+                if (samlResponseFromQueryString) {
+                    samlResponseParm = samlResponseFromQueryString;
+                }
+            }
+            else if (request.method === 'POST') {
+                /**
+                 * Check form data for SAMLResponse.
+                 * ( If the redirect binding was used to initiate the authentication flow,
+                 *   shibboleth may nonetheless send the saml response as form data, perhaps because its size exceeds
+                 *   the limits of querystring parameters )
+                 */
+                const ctheader = request.headers['content-type'];
+                if (ctheader && ctheader[0].value === 'application/x-www-form-urlencoded') {
+                    // 1) The body data will be base64 encoded, decode it:
+                    const body = Buffer.from(request.body.data, 'base64').toString();
+                    // 2) Get the "SAMLResponse" parameter from within the body, url-decoded:
+                    const params = body ? new URLSearchParams(body) : null;
+                    samlResponseParm = params ? params.get('SAMLResponse') : null;
+                    samlResponseParm = samlResponseParm ? decodeURIComponent(samlResponseParm) : null;
+                    relayState = params ? params.get('RelayState') || '' : '';
+                    if (samlResponseParm) {
+                        console.log('SAMLResponse parameter FOUND in request');
+                        // 3) The "SAMLResponse" parameter will in turn be base64 encoded, decode it (you should find xml):
+                        xmlData = samlResponseParm ? Buffer.from(samlResponseParm, 'base64').toString() : undefined;
+                        // console.log(xmlData);            
+                    }
+                    else {
+                        throw new Error('SAMLResponse parameter NOT FOUND in request');
+                    }
+                }
+            }
+        }
+        catch (e) {
+            console.log('Error getting SAMLResponse from request');
+            throw (e);
+        }
+        return {
+            samlResponseParm, xmlData, relayState
+        };
+    }
+    /**
+     * The request has a SAMLResponse parameter and so indicates authentication has completed and a followup
+     * assert against the SAMLResponse parameter is next.
+     *
+     * @see https://www.npmjs.com/package/saml2-js#create_login_request_urlidp-options-cb
+     * @param requestUrl
+     * @returns
+     */
+    sendAssert(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                const sp = new saml2_js_1.ServiceProvider(this.sp_options);
+                const idp = new saml2_js_1.IdentityProvider(this.idp_options);
+                const parm = this.getSamlResponseParameter(request);
+                const { samlResponseParm, xmlData, relayState } = parm;
+                const options = {
+                    request_body: { SAMLResponse: samlResponseParm }
+                };
+                const callback = (err, saml_assert_response) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        const friendlyResponse = getFriendlySamlResponse(xmlData, saml_assert_response);
+                        resolve({
+                            samlAssertResponse: friendlyResponse,
+                            relayState: relayState || null
+                        });
+                    }
+                };
+                if (request.method === 'POST') {
+                    sp.post_assert(idp, options, callback);
+                }
+                else {
+                    sp.redirect_assert(idp, options, callback);
+                }
+            });
+        });
+    }
+}
+exports.SamlTools = SamlTools;
+/**
+ * The saml assert response will have attributes that are missing the friendly names.
+ * These friendly names can still be found in the xml that was passed to the post_assert
+ * to get the response, and can be applied to that response to overwrite the "unfriendly" names.
+ * @param saml_assert_response
+ */
+function getFriendlySamlResponse(xmlData, response) {
+    var _a;
+    const xml = (new xmldom_1.DOMParser()).parseFromString(xmlData || '');
+    const xmlChoices = xml.getElementsByTagName('saml2:Attribute');
+    const friendlyAttributes = {};
+    const findFriendlyName = (unfriendlyName) => {
+        let item = null;
+        for (const itm in xmlChoices) {
+            if (!xmlChoices[itm].getAttribute)
+                continue;
+            if (xmlChoices[itm].getAttribute('Name') === unfriendlyName) {
+                return xmlChoices[itm].getAttribute('FriendlyName');
+            }
+        }
+        return null;
+    };
+    if ((response === null || response === void 0 ? void 0 : response.user) && ((_a = response.user) === null || _a === void 0 ? void 0 : _a.attributes)) {
+        const { attributes } = response.user;
+        for (const a in attributes) {
+            var fn = findFriendlyName(a);
+            var val = attributes[a];
+            if (fn) {
+                friendlyAttributes[fn] = val;
+            }
+            else {
+                friendlyAttributes[a] = val;
+            }
+        }
+    }
+    response.user.attributes = friendlyAttributes;
+    return response;
+}
+exports.getFriendlySamlResponse = getFriendlySamlResponse;
+//# sourceMappingURL=Saml.js.map

package/dist/esm/Saml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Saml.js","sourceRoot":"","sources":["../../src/Saml.ts"],"names":[],"mappings":"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"}

package/dist/esm/Utils.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeStringify = exports.instanceOf = exports.debugLog = exports.findFirstFieldValue = exports.debugPrint = exports.ParameterTester = void 0;
+const isBlank = (s) => {
+    return s === undefined || s === null || `${s}`.trim() == '';
+};
+const isNotBlank = (s) => !isBlank(s);
+const anyBlank = (...a) => a.findIndex((s) => isBlank(s)) > -1;
+const anyNotBlank = (...a) => a.findIndex((s) => isNotBlank(s)) > -1;
+const allBlank = (...a) => !anyNotBlank(...a);
+const noneBlank = (...a) => !anyBlank(...a);
+const someBlankSomeNot = (...a) => anyBlank(...a) && anyNotBlank(...a);
+exports.ParameterTester = {
+    isBlank, isNotBlank, anyBlank, anyNotBlank, allBlank, noneBlank, someBlankSomeNot
+};
+/**
+ * Prints debug information to console when DEBUG environment variable is set to 'true'.
+ * @param value The debug message to print
+ */
+const debugPrint = (value) => {
+    var _a;
+    if (((_a = process.env) === null || _a === void 0 ? void 0 : _a.DEBUG) == 'true') {
+        console.log(`DEBUG: ${value}`);
+    }
+};
+exports.debugPrint = debugPrint;
+/**
+ * Find the first field with a value in an object for the list of field names provided.
+ * The field is assumed to be an array, and the value is the first element of it.
+ * @param parentObj The object to search within
+ * @param names The field names to search for
+ * @returns The first non-empty field value found, or null if none found
+ */
+const findFirstFieldValue = (parentObj, ...names) => {
+    for (const name of names) {
+        if (parentObj[name] && parentObj[name].length > 0) {
+            if (parentObj[name][0]) {
+                return parentObj[name][0];
+            }
+        }
+    }
+    return null;
+};
+exports.findFirstFieldValue = findFirstFieldValue;
+/**
+ * Logs debug messages to console when DEBUG environment variable is set to 'true'.
+ * @param msg The message to log
+ */
+const debugLog = (msg) => {
+    var _a;
+    if (((_a = process.env) === null || _a === void 0 ? void 0 : _a.DEBUG) == 'true') {
+        console.log(msg);
+    }
+};
+exports.debugLog = debugLog;
+/**
+ * Type guard function to check if a value is of a specific type based on field presence.
+ * @param value The value to check
+ * @param fieldName The field name that should exist on the type
+ * @returns True if the field exists on the value, indicating it's of type T
+ */
+const instanceOf = (value, fieldName) => fieldName in value;
+exports.instanceOf = instanceOf;
+const safeStringify = (obj, replacer, space) => {
+    // Handle array replacer by converting to a function
+    let replaceFn = null;
+    if (typeof replacer === 'function') {
+        replaceFn = replacer;
+    }
+    else if (Array.isArray(replacer)) {
+        const allowList = new Set(replacer.map(String));
+        replaceFn = (key, value) => (key === '' || allowList.has(key) ? value : undefined);
+    }
+    // Track visited objects to detect circular references
+    const visited = new WeakSet();
+    const _serialize = (value, key = '') => {
+        // Apply replacer function if provided
+        const replacedValue = replaceFn ? replaceFn(key, value) : value;
+        // Handle undefined and functions
+        if (replacedValue === undefined || typeof replacedValue === 'function') {
+            return undefined;
+        }
+        // Handle null and non-objects
+        if (replacedValue === null || typeof replacedValue !== 'object') {
+            return JSON.stringify(replacedValue);
+        }
+        // Handle built-in objects
+        if (replacedValue instanceof Date) {
+            return JSON.stringify(replacedValue);
+        }
+        if (replacedValue instanceof RegExp) {
+            return JSON.stringify(replacedValue.toString());
+        }
+        if (replacedValue instanceof Map || replacedValue instanceof Set) {
+            return '{}';
+        }
+        // Handle circular references
+        if (visited.has(replacedValue)) {
+            return '"[Circular]"';
+        }
+        visited.add(replacedValue);
+        try {
+            // Process arrays
+            if (Array.isArray(replacedValue)) {
+                const items = replacedValue.map((item, i) => {
+                    const serialized = _serialize(item, String(i));
+                    return serialized === undefined ? 'null' : serialized;
+                });
+                return `[${items.join(',')}]`;
+            }
+            // Process objects
+            const entries = [];
+            for (const [k, v] of Object.entries(replacedValue)) {
+                const serialized = _serialize(v, k);
+                if (serialized !== undefined) {
+                    entries.push(`${JSON.stringify(k)}:${serialized}`);
+                }
+            }
+            return `{${entries.join(',')}}`;
+        }
+        finally {
+            // Clean up visited set for recursive structures
+            visited.delete(replacedValue);
+        }
+    };
+    try {
+        const result = _serialize(obj);
+        if (space) {
+            return JSON.stringify(JSON.parse(result || 'null'), null, space);
+        }
+        return result;
+    }
+    catch (_a) {
+        return '{}';
+    }
+};
+exports.safeStringify = safeStringify;
+//# sourceMappingURL=Utils.js.map

package/dist/esm/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../src/Utils.ts"],"names":[],"mappings":"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"}