- Moved generateShareId from shareChecksum.ts to locationActions.ts as a server action - Updated LocationCard to use shareID with checksum for proof of payment download link - Replaced Link with AsyncLink to handle async shareID generation - Commented out debug console.log in Pdf417Barcode Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
77 lines
2.1 KiB
TypeScript
77 lines
2.1 KiB
TypeScript
import crypto from 'crypto';
|
|
|
|
/**
|
|
* Checksum length in hex characters (16 chars = 64 bits of entropy)
|
|
*/
|
|
export const CHECKSUM_LENGTH = 16;
|
|
|
|
/**
|
|
* Generate share link checksum for location
|
|
* Uses HMAC-SHA256 for cryptographic integrity
|
|
*
|
|
* SECURITY: Prevents location ID enumeration while allowing stateless validation
|
|
*/
|
|
export function generateShareChecksum(locationId: string): string {
|
|
const secret = process.env.SHARE_LINK_SECRET;
|
|
|
|
if (!secret) {
|
|
throw new Error('SHARE_LINK_SECRET environment variable not configured');
|
|
}
|
|
|
|
return crypto
|
|
.createHmac('sha256', secret)
|
|
.update(locationId)
|
|
.digest('hex')
|
|
.substring(0, CHECKSUM_LENGTH);
|
|
}
|
|
|
|
/**
|
|
* Validate share link checksum
|
|
* Uses constant-time comparison to prevent timing attacks
|
|
*
|
|
* @param locationId - The location ID from URL
|
|
* @param providedChecksum - The checksum from URL
|
|
* @returns true if checksum is valid
|
|
*/
|
|
export function validateShareChecksum(
|
|
locationId: string,
|
|
providedChecksum: string
|
|
): boolean {
|
|
try {
|
|
const expectedChecksum = generateShareChecksum(locationId);
|
|
|
|
// Convert to buffers for timing-safe comparison
|
|
const expected = Buffer.from(expectedChecksum);
|
|
const provided = Buffer.from(providedChecksum);
|
|
|
|
// Length check (prevents timing attack on different lengths)
|
|
if (expected.length !== provided.length) {
|
|
return false;
|
|
}
|
|
|
|
// Constant-time comparison (prevents timing attacks)
|
|
return crypto.timingSafeEqual(expected, provided);
|
|
} catch {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Extract location ID and checksum from combined share ID
|
|
* @param shareId - Combined ID (locationId + checksum)
|
|
* @returns Object with locationId and checksum, or null if invalid format
|
|
*/
|
|
export function extractShareId(shareId: string): { locationId: string; checksum: string } | null {
|
|
// MongoDB ObjectID is 24 chars, checksum is 16 chars = 40 total
|
|
const expectedLength = 24 + CHECKSUM_LENGTH;
|
|
|
|
if (shareId.length !== expectedLength) {
|
|
return null;
|
|
}
|
|
|
|
const locationId = shareId.substring(0, 24);
|
|
const checksum = shareId.substring(24);
|
|
|
|
return { locationId, checksum };
|
|
}
|