LibreChat/packages/api/src/app/cdn.ts
Ravi Kumar L 05d4e90f91
🌩️ feat: Strict CloudFront signed cookie enforcement via requireSignedAccess (#13078)
* feat(cloudfront): add requireSignedAccess to enforce strict signed access

Introduces cloudfront.requireSignedAccess (default false). When enabled,
initializeCloudFront requires both CLOUDFRONT_KEY_PAIR_ID and
CLOUDFRONT_PRIVATE_KEY, rejects the unimplemented imageSigning="url"
mode, and initializeFileStorage throws to block startup on any
CloudFront init failure. OSS path is unchanged: missing keys still
log-and-continue when requireSignedAccess is false.

Adds low-noise startup and cookie-issuance logs without leaking signed
URLs, policies, signatures, private keys, or cookie values.

* fix(cloudfront): reject requireSignedAccess unless imageSigning is "cookies"

Previously requireSignedAccess=true was accepted with imageSigning="none"
or "url", but setCloudFrontCookies() only runs for "cookies" — leaving
strict mode toothless: CloudFront stayed publicly accessible, or image
delivery broke on a distribution that actually requires signed access.

Adds a Zod refinement plus a runtime guard in initializeCloudFront so
the only currently-functional strict configuration is imageSigning
"cookies". Signed URL mode can lift this restriction once implemented.

* fix(cloudfront): resolve strict access type checks

* chore(cloudfront): reduce strict startup log noise

---------

Co-authored-by: Danny Avila <danny@librechat.ai>
2026-05-11 23:30:01 -04:00

64 lines
2.1 KiB
TypeScript

import { logger } from '@librechat/data-schemas';
import { FileSources } from 'librechat-data-provider';
import type { AppConfig } from '@librechat/data-schemas';
import { initializeAzureBlobService } from '~/cdn/azure';
import { initializeFirebase } from '~/cdn/firebase';
import { initializeS3 } from '~/cdn/s3';
import { initializeCloudFront } from '~/cdn/cloudfront';
function initializeStrategy(strategy: FileSources, appConfig: AppConfig): void {
if (strategy === FileSources.firebase) {
initializeFirebase();
} else if (strategy === FileSources.azure_blob) {
initializeAzureBlobService().catch((error) => {
logger.error('Error initializing Azure Blob Service:', error);
});
} else if (strategy === FileSources.s3) {
initializeS3();
} else if (strategy === FileSources.cloudfront) {
const cloudfrontConfig = appConfig.cloudfront;
if (!cloudfrontConfig) {
logger.error(
'[initializeFileStorage] CloudFront strategy requires cloudfront config in librechat.yaml',
);
return;
}
const initialized = initializeCloudFront(cloudfrontConfig);
if (!initialized) {
if (cloudfrontConfig.requireSignedAccess === true) {
throw new Error(
'[initializeFileStorage] CloudFront initialization failed and cloudfront.requireSignedAccess=true; refusing to start.',
);
}
logger.error(
'[initializeFileStorage] CloudFront initialization failed. CloudFront operations will not work.',
);
}
}
}
/**
* Initializes file storage clients based on the configured file strategies.
* Handles both the main fileStrategy and granular fileStrategies config.
*/
export function initializeFileStorage(appConfig: AppConfig): void {
const { fileStrategy, fileStrategies } = appConfig;
const strategiesToInit = new Set<FileSources>();
if (fileStrategy) {
strategiesToInit.add(fileStrategy);
}
if (fileStrategies) {
for (const value of Object.values(fileStrategies)) {
if (value) {
strategiesToInit.add(value);
}
}
}
for (const strategy of strategiesToInit) {
initializeStrategy(strategy, appConfig);
}
}