fix(@angular/ssr): validate host headers to prevent header-based SSRF

This change introduces strict validation for `Host`, `X-Forwarded-Host`, `X-Forwarded-Proto`, and `X-Forwarded-Port` headers in the Angular SSR request handling pipeline, including `CommonEngine` and `AngularAppEngine`.

Previously, the application engine constructed the base URL for server-side rendering using these headers without validation. This could allow an attacker to manipulate the headers to steer relative `HttpClient` requests to arbitrary internal or external hosts (SSRF).

With this change:
- The `Host` and `X-Forwarded-Host` headers are validated against a strict allowlist.
- `X-Forwarded-Port` must be numeric.
- `X-Forwarded-Proto` must be `http` or `https`.
- Requests with invalid or disallowed headers will now log an error and fallback to Client-Side Rendering (CSR). In a future major version, these requests will be rejected with a 400 Bad Request.

Note: Most cloud providers and CDNs already validate these headers before the request reaches the text application, but this change adds an essential layer of defense-in-depth.

**AngularAppEngine Users:**
To exclude safe hosts from validation, configure the `allowedHosts` option in `angular.json` to include all domain names where your application is deployed.

Example configuration in `angular.json`:

```json
"architect": {
  "build": {
    "options": {
      "security": {
        "allowedHosts": ["example.com", "*.trusted-example.com"]
      }
    }
  }
}
```

or

```ts
const appEngine = new AngularAppEngine({
  allowedHosts: ["example.com", "*.trusted-example.com"]
})

const appEngine = new AngularNodeAppEngine({
  allowedHosts: ["example.com", "*.trusted-example.com"]
})
```

**CommonEngine Users:**
If you are using `CommonEngine`, you must now provide the `allowedHosts` option when initializing or rendering your application.

Example:
```typescript
const commonEngine = new CommonEngine({
  allowedHosts: ["example.com", "*.trusted-example.com"]
});
```

The application also respects `NG_ALLOWED_HOSTS` (comma-separated list) and `HOSTNAME` environment variables for authorizing hosts.

Author: alan-agius4

goldens/public-api/angular/ssr/index.api.md

@@ -11,11 +11,17 @@ import { Type } from '@angular/core';
 
 // @public
 export class AngularAppEngine {
+    constructor(options?: AngularAppEngineOptions);
     handle(request: Request, requestContext?: unknown): Promise<Response | null>;
     static ɵallowStaticRouteRender: boolean;
     static ɵhooks: Hooks;
 }
 
+// @public
+export interface AngularAppEngineOptions {
+    allowedHosts?: readonly string[];
+}
+
 // @public
 export function createRequestHandler(handler: RequestHandlerFunction): RequestHandlerFunction;
 

goldens/public-api/angular/ssr/node/index.api.md

@@ -15,8 +15,12 @@ import { Type } from '@angular/core';
 
 // @public
 export class AngularNodeAppEngine {
-    constructor();
-    handle(request: IncomingMessage | Http2ServerRequest, requestContext?: unknown): Promise<Response | null>;
+    constructor(options?: AngularNodeAppEngineOptions);
+    handle(request: IncomingMessage | Http2ServerRequest | Request, requestContext?: unknown): Promise<Response | null>;
+}
+
+// @public
+export interface AngularNodeAppEngineOptions extends AngularAppEngineOptions {
 }
 
 // @public
@@ -27,6 +31,7 @@ export class CommonEngine {
 
 // @public (undocumented)
 export interface CommonEngineOptions {
+    allowedHosts?: readonly string[];
     bootstrap?: Type<{}> | ((context: BootstrapContext) => Promise<ApplicationRef>);
     enablePerformanceProfiler?: boolean;
     providers?: StaticProvider[];

packages/angular/build/src/builders/application/execute-build.ts

@@ -56,6 +56,7 @@ export async function executeBuild(
     verbose,
     colors,
     jsonLogs,
+    security,
   } = options;
 
   // TODO: Consider integrating into watch mode. Would require full rebuild on target changes.
@@ -263,7 +264,7 @@ export async function executeBuild(
   if (serverEntryPoint) {
     executionResult.addOutputFile(
       SERVER_APP_ENGINE_MANIFEST_FILENAME,
-      generateAngularServerAppEngineManifest(i18nOptions, baseHref),
+      generateAngularServerAppEngineManifest(i18nOptions, security.allowedHosts, baseHref),
       BuildOutputFileType.ServerRoot,
     );
   }

packages/angular/build/src/builders/application/options.ts

@@ -400,8 +400,9 @@ export async function normalizeOptions(
     }
   }
 
-  const autoCsp = options.security?.autoCsp;
+  const { autoCsp, allowedHosts = [] } = options.security ?? {};
   const security = {
+    allowedHosts,
     autoCsp: autoCsp
       ? {
           unsafeEval: autoCsp === true ? false : !!autoCsp.unsafeEval,

packages/angular/build/src/builders/application/schema.json

@@ -52,6 +52,14 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "allowedHosts": {
+          "description": "A list of hostnames that are allowed to access the server-side application. For more information, see https://angular.dev/guide/ssr#configuring-allowed-hosts.",
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
         "autoCsp": {
           "description": "Enables automatic generation of a hash-based Strict Content Security Policy (https://web.dev/articles/strict-csp#choose-hash) based on scripts in index.html. Will default to true once we are out of experimental/preview phases.",
           "default": false,

packages/angular/build/src/builders/dev-server/vite/index.ts

@@ -9,7 +9,6 @@
 import type { BuilderContext } from '@angular-devkit/architect';
 import type { Plugin } from 'esbuild';
 import assert from 'node:assert';
-import { builtinModules, isBuiltin } from 'node:module';
 import { join } from 'node:path';
 import type { Connect, ViteDevServer } from 'vite';
 import type { ComponentStyleRecord } from '../../../tools/vite/middlewares';
@@ -21,7 +20,6 @@ import { Result, ResultKind } from '../../application/results';
 import { OutputHashing } from '../../application/schema';
 import {
   type ApplicationBuilderInternalOptions,
-  type ExternalResultMetadata,
   JavaScriptTransformer,
   getSupportedBrowsers,
   isZonelessApp,
@@ -99,8 +97,16 @@ export async function* serveWithVite(
     browserOptions.ssr ||= true;
   }
 
-  // Disable auto CSP.
+  const allowedHosts = Array.isArray(serverOptions.allowedHosts)
+    ? [...serverOptions.allowedHosts]
+    : [];
+
+  // Always allow the dev server host
+  allowedHosts.push(serverOptions.host);
+
   browserOptions.security = {
+    allowedHosts,
+    // Disable auto CSP.
     autoCsp: false,
   };
 

packages/angular/build/src/utils/server-rendering/manifest.ts

@@ -53,11 +53,13 @@ function escapeUnsafeChars(str: string): string {
  *
  * @param i18nOptions - The internationalization options for the application build. This
  * includes settings for inlining locales and determining the output structure.
+ * @param allowedHosts - A list of hosts that are allowed to access the server-side application.
  * @param baseHref - The base HREF for the application. This is used to set the base URL
  * for all relative URLs in the application.
  */
 export function generateAngularServerAppEngineManifest(
   i18nOptions: NormalizedApplicationBuildOptions['i18nOptions'],
+  allowedHosts: string[],
   baseHref: string | undefined,
 ): string {
   const entryPoints: Record<string, string> = {};
@@ -84,6 +86,7 @@ export function generateAngularServerAppEngineManifest(
   const manifestContent = `
 export default {
   basePath: '${basePath}',
+  allowedHosts: ${JSON.stringify(allowedHosts, undefined, 2)},
   supportedLocales: ${JSON.stringify(supportedLocales, undefined, 2)},
   entryPoints: {
     ${Object.entries(entryPoints)

packages/angular/build/src/utils/server-rendering/prerender.ts

@@ -224,6 +224,9 @@ async function renderPages(
       outputMode,
       hasSsrEntry: !!outputFilesForWorker['server.mjs'],
     } as RenderWorkerData,
+    env: {
+      NG_ALLOWED_HOSTS: 'localhost',
+    },
     execArgv: workerExecArgv,
   });
 
@@ -336,6 +339,9 @@ async function getAllRoutes(
       outputMode,
       hasSsrEntry: !!outputFilesForWorker['server.mjs'],
     } as RoutesExtractorWorkerData,
+    env: {
+      NG_ALLOWED_HOSTS: 'localhost',
+    },
     execArgv: workerExecArgv,
   });
 

packages/angular/ssr/node/public_api.ts

@@ -12,7 +12,7 @@ export {
   type CommonEngineOptions,
 } from './src/common-engine/common-engine';
 
-export { AngularNodeAppEngine } from './src/app-engine';
+export { AngularNodeAppEngine, type AngularNodeAppEngineOptions } from './src/app-engine';
 
 export { createNodeRequestHandler, type NodeRequestHandlerFunction } from './src/handler';
 export { writeResponseToNodeResponse } from './src/response';

packages/angular/ssr/node/src/app-engine.ts

@@ -9,9 +9,15 @@
 import { AngularAppEngine } from '@angular/ssr';
 import type { IncomingMessage } from 'node:http';
 import type { Http2ServerRequest } from 'node:http2';
+import { AngularAppEngineOptions } from '../../src/app-engine';
 import { attachNodeGlobalErrorHandlers } from './errors';
 import { createWebRequestFromNodeRequest } from './request';
 
+/**
+ * Options for the Angular Node.js server application engine.
+ */
+export interface AngularNodeAppEngineOptions extends AngularAppEngineOptions {}
+
 /**
  * Angular server application engine.
  * Manages Angular server applications (including localized ones), handles rendering requests,
@@ -21,32 +27,86 @@ import { createWebRequestFromNodeRequest } from './request';
  * application to ensure consistent handling of rendering requests and resource management.
  */
 export class AngularNodeAppEngine {
-  private readonly angularAppEngine = new AngularAppEngine();
+  private readonly angularAppEngine: AngularAppEngine;
+
+  /**
+   * Creates a new instance of the Angular Node.js server application engine.
+   * @param options Options for the Angular Node.js server application engine.
+   */
+  constructor(options?: AngularNodeAppEngineOptions) {
+    this.angularAppEngine = new AngularAppEngine(this.resolveAppEngineOptions(options));
 
-  constructor() {
     attachNodeGlobalErrorHandlers();
   }
 
   /**
    * Handles an incoming HTTP request by serving prerendered content, performing server-side rendering,
    * or delivering a static file for client-side rendered routes based on the `RenderMode` setting.
    *
-   * This method adapts Node.js's `IncomingMessage` or `Http2ServerRequest`
+   * This method adapts Node.js's `IncomingMessage`, `Http2ServerRequest` or `Request`
    * to a format compatible with the `AngularAppEngine` and delegates the handling logic to it.
    *
-   * @param request - The incoming HTTP request (`IncomingMessage` or `Http2ServerRequest`).
+   * @param request - The incoming HTTP request (`IncomingMessage`, `Http2ServerRequest` or `Request`).
    * @param requestContext - Optional context for rendering, such as metadata associated with the request.
    * @returns A promise that resolves to the resulting HTTP response object, or `null` if no matching Angular route is found.
    *
    * @remarks A request to `https://www.example.com/page/index.html` will serve or render the Angular route
    * corresponding to `https://www.example.com/page`.
+   * 
+   * @remarks
+* To prevent potential Server-Side Request Forgery (SSRF), this function verifies the hostname 
+* of the `request.url` against a list of authorized hosts. 
+* If the hostname is not recognized, a Client-Side Rendered (CSR) version of the page is returned.
+
+* Resolution:
+* Authorize your hostname by configuring `allowedHosts` in `angular.json` in:
+* `projects.[project-name].architect.build.options.security.allowedHosts`. 
+* Alternatively, you can define the allowed hostname via environment variables 
+* (`process.env['HOSTNAME']` or `process.env['NG_ALLOWED_HOSTS']`) or pass it directly 
+* through the configuration options of `AngularNodeAppEngine`.
+* 
+* For more information see: https://angular.dev/guide/ssr#configuring-allowed-hosts
    */
   async handle(
-    request: IncomingMessage | Http2ServerRequest,
+    request: IncomingMessage | Http2ServerRequest | Request,
     requestContext?: unknown,
   ): Promise<Response | null> {
-    const webRequest = createWebRequestFromNodeRequest(request);
+    const webRequest =
+      request instanceof Request ? request : createWebRequestFromNodeRequest(request);
 
     return this.angularAppEngine.handle(webRequest, requestContext);
   }
+
+  /**
+   * Resolves the Angular server application engine options.
+   * @param options Options for the Angular server application engine.
+   * @returns Resolved options for the Angular server application engine.
+   */
+  private resolveAppEngineOptions(
+    options: AngularNodeAppEngineOptions | undefined,
+  ): AngularAppEngineOptions {
+    const allowedHosts = options?.allowedHosts ? [...options.allowedHosts] : [];
+    const processEnv = process.env;
+
+    const envNgAllowedHosts = processEnv['NG_ALLOWED_HOSTS'];
+    if (envNgAllowedHosts) {
+      const hosts = envNgAllowedHosts.split(',');
+      for (const host of hosts) {
+        const hostTrimmed = host.trim();
+        if (hostTrimmed) {
+          allowedHosts.push(hostTrimmed);
+        }
+      }
+    }
+
+    const envHostName = processEnv['HOSTNAME']?.trim();
+    if (envHostName) {
+      allowedHosts.push(envHostName);
+    }
+
+    return {
+      ...options,
+      allowedHosts,
+    };
+  }
 }