secure-headers.js 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189
  1. var __defProp = Object.defineProperty;
  2. var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
  3. var __getOwnPropNames = Object.getOwnPropertyNames;
  4. var __hasOwnProp = Object.prototype.hasOwnProperty;
  5. var __export = (target, all) => {
  6. for (var name in all)
  7. __defProp(target, name, { get: all[name], enumerable: true });
  8. };
  9. var __copyProps = (to, from, except, desc) => {
  10. if (from && typeof from === "object" || typeof from === "function") {
  11. for (let key of __getOwnPropNames(from))
  12. if (!__hasOwnProp.call(to, key) && key !== except)
  13. __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
  14. }
  15. return to;
  16. };
  17. var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
  18. var secure_headers_exports = {};
  19. __export(secure_headers_exports, {
  20. NONCE: () => NONCE,
  21. secureHeaders: () => secureHeaders
  22. });
  23. module.exports = __toCommonJS(secure_headers_exports);
  24. var import_encode = require("../../utils/encode");
  25. const HEADERS_MAP = {
  26. crossOriginEmbedderPolicy: ["Cross-Origin-Embedder-Policy", "require-corp"],
  27. crossOriginResourcePolicy: ["Cross-Origin-Resource-Policy", "same-origin"],
  28. crossOriginOpenerPolicy: ["Cross-Origin-Opener-Policy", "same-origin"],
  29. originAgentCluster: ["Origin-Agent-Cluster", "?1"],
  30. referrerPolicy: ["Referrer-Policy", "no-referrer"],
  31. strictTransportSecurity: ["Strict-Transport-Security", "max-age=15552000; includeSubDomains"],
  32. xContentTypeOptions: ["X-Content-Type-Options", "nosniff"],
  33. xDnsPrefetchControl: ["X-DNS-Prefetch-Control", "off"],
  34. xDownloadOptions: ["X-Download-Options", "noopen"],
  35. xFrameOptions: ["X-Frame-Options", "SAMEORIGIN"],
  36. xPermittedCrossDomainPolicies: ["X-Permitted-Cross-Domain-Policies", "none"],
  37. xXssProtection: ["X-XSS-Protection", "0"]
  38. };
  39. const DEFAULT_OPTIONS = {
  40. crossOriginEmbedderPolicy: false,
  41. crossOriginResourcePolicy: true,
  42. crossOriginOpenerPolicy: true,
  43. originAgentCluster: true,
  44. referrerPolicy: true,
  45. strictTransportSecurity: true,
  46. xContentTypeOptions: true,
  47. xDnsPrefetchControl: true,
  48. xDownloadOptions: true,
  49. xFrameOptions: true,
  50. xPermittedCrossDomainPolicies: true,
  51. xXssProtection: true,
  52. removePoweredBy: true,
  53. permissionsPolicy: {}
  54. };
  55. const generateNonce = () => {
  56. const arrayBuffer = new Uint8Array(16);
  57. crypto.getRandomValues(arrayBuffer);
  58. return (0, import_encode.encodeBase64)(arrayBuffer.buffer);
  59. };
  60. const NONCE = (ctx) => {
  61. const key = "secureHeadersNonce";
  62. const init = ctx.get(key);
  63. const nonce = init || generateNonce();
  64. if (init == null) {
  65. ctx.set(key, nonce);
  66. }
  67. return `'nonce-${nonce}'`;
  68. };
  69. const secureHeaders = (customOptions) => {
  70. const options = { ...DEFAULT_OPTIONS, ...customOptions };
  71. const headersToSet = getFilteredHeaders(options);
  72. const callbacks = [];
  73. if (options.contentSecurityPolicy) {
  74. const [callback, value] = getCSPDirectives(options.contentSecurityPolicy);
  75. if (callback) {
  76. callbacks.push(callback);
  77. }
  78. headersToSet.push(["Content-Security-Policy", value]);
  79. }
  80. if (options.contentSecurityPolicyReportOnly) {
  81. const [callback, value] = getCSPDirectives(options.contentSecurityPolicyReportOnly);
  82. if (callback) {
  83. callbacks.push(callback);
  84. }
  85. headersToSet.push(["Content-Security-Policy-Report-Only", value]);
  86. }
  87. if (options.permissionsPolicy && Object.keys(options.permissionsPolicy).length > 0) {
  88. headersToSet.push([
  89. "Permissions-Policy",
  90. getPermissionsPolicyDirectives(options.permissionsPolicy)
  91. ]);
  92. }
  93. if (options.reportingEndpoints) {
  94. headersToSet.push(["Reporting-Endpoints", getReportingEndpoints(options.reportingEndpoints)]);
  95. }
  96. if (options.reportTo) {
  97. headersToSet.push(["Report-To", getReportToOptions(options.reportTo)]);
  98. }
  99. return async function secureHeaders2(ctx, next) {
  100. const headersToSetForReq = callbacks.length === 0 ? headersToSet : callbacks.reduce((acc, cb) => cb(ctx, acc), headersToSet);
  101. await next();
  102. setHeaders(ctx, headersToSetForReq);
  103. if (options?.removePoweredBy) {
  104. ctx.res.headers.delete("X-Powered-By");
  105. }
  106. };
  107. };
  108. function getFilteredHeaders(options) {
  109. return Object.entries(HEADERS_MAP).filter(([key]) => options[key]).map(([key, defaultValue]) => {
  110. const overrideValue = options[key];
  111. return typeof overrideValue === "string" ? [defaultValue[0], overrideValue] : defaultValue;
  112. });
  113. }
  114. function getCSPDirectives(contentSecurityPolicy) {
  115. const callbacks = [];
  116. const resultValues = [];
  117. for (const [directive, value] of Object.entries(contentSecurityPolicy)) {
  118. const valueArray = Array.isArray(value) ? value : [value];
  119. valueArray.forEach((value2, i) => {
  120. if (typeof value2 === "function") {
  121. const index = i * 2 + 2 + resultValues.length;
  122. callbacks.push((ctx, values) => {
  123. values[index] = value2(ctx, directive);
  124. });
  125. }
  126. });
  127. resultValues.push(
  128. directive.replace(
  129. /[A-Z]+(?![a-z])|[A-Z]/g,
  130. (match, offset) => offset ? "-" + match.toLowerCase() : match.toLowerCase()
  131. ),
  132. ...valueArray.flatMap((value2) => [" ", value2]),
  133. "; "
  134. );
  135. }
  136. resultValues.pop();
  137. return callbacks.length === 0 ? [void 0, resultValues.join("")] : [
  138. (ctx, headersToSet) => headersToSet.map((values) => {
  139. if (values[0] === "Content-Security-Policy" || values[0] === "Content-Security-Policy-Report-Only") {
  140. const clone = values[1].slice();
  141. callbacks.forEach((cb) => {
  142. cb(ctx, clone);
  143. });
  144. return [values[0], clone.join("")];
  145. } else {
  146. return values;
  147. }
  148. }),
  149. resultValues
  150. ];
  151. }
  152. function getPermissionsPolicyDirectives(policy) {
  153. return Object.entries(policy).map(([directive, value]) => {
  154. const kebabDirective = camelToKebab(directive);
  155. if (typeof value === "boolean") {
  156. return `${kebabDirective}=${value ? "*" : "none"}`;
  157. }
  158. if (Array.isArray(value)) {
  159. if (value.length === 0) {
  160. return `${kebabDirective}=()`;
  161. }
  162. if (value.length === 1 && (value[0] === "*" || value[0] === "none")) {
  163. return `${kebabDirective}=${value[0]}`;
  164. }
  165. const allowlist = value.map((item) => ["self", "src"].includes(item) ? item : `"${item}"`);
  166. return `${kebabDirective}=(${allowlist.join(" ")})`;
  167. }
  168. return "";
  169. }).filter(Boolean).join(", ");
  170. }
  171. function camelToKebab(str) {
  172. return str.replace(/([a-z\d])([A-Z])/g, "$1-$2").toLowerCase();
  173. }
  174. function getReportingEndpoints(reportingEndpoints = []) {
  175. return reportingEndpoints.map((endpoint) => `${endpoint.name}="${endpoint.url}"`).join(", ");
  176. }
  177. function getReportToOptions(reportTo = []) {
  178. return reportTo.map((option) => JSON.stringify(option)).join(", ");
  179. }
  180. function setHeaders(ctx, headersToSet) {
  181. headersToSet.forEach(([header, value]) => {
  182. ctx.res.headers.set(header, value);
  183. });
  184. }
  185. // Annotate the CommonJS export names for ESM import in node:
  186. 0 && (module.exports = {
  187. NONCE,
  188. secureHeaders
  189. });