ncantu 26a53327a4 Enhance: Complete dashboard documentation and new services integration
**Motivations:**
- Complete documentation for dashboard, domains, ports and environment configuration
- Add new services (ClamAV API, Watermark API) to the infrastructure
- Enhance dashboard with new pages and improved functionality
- Improve deployment scripts and service configurations

**Root causes:**
- Missing comprehensive documentation for infrastructure setup
- Need for antivirus scanning service integration
- Need for watermark service integration
- Dashboard required additional pages and features

**Correctifs:**
- Added comprehensive documentation in docs/ (DASHBOARD.md, DOMAINS_AND_PORTS.md, ENVIRONMENT.md)
- Updated systemd service files with proper environment variables
- Enhanced nginx proxy configuration script
- Updated maintenance documentation

**Evolutions:**
- Added new ClamAV API service (api-clamav) for file scanning
- Added new Watermark API service (api-filigrane) for document watermarking
- Enhanced signet-dashboard with new learn.html page
- Improved dashboard UI with better styles and navigation
- Enhanced app.js with new functionality and better error handling
- Updated API documentation page with complete endpoint descriptions
- Added deployment scripts for watermark and nginx configuration
- Updated hash and UTXO lists with latest data
- Enhanced server.js with new routes and improved Bitcoin RPC integration

**Pages affectées:**
- docs/DASHBOARD.md: New comprehensive dashboard documentation
- docs/DOMAINS_AND_PORTS.md: New infrastructure domains and ports documentation
- docs/ENVIRONMENT.md: New environment variables documentation
- docs/MAINTENANCE.md: Updated maintenance procedures
- docs/README.md: Updated main documentation
- signet-dashboard/public/app.js: Enhanced with new features
- signet-dashboard/public/styles.css: Improved styling
- signet-dashboard/public/index.html: Enhanced main page
- signet-dashboard/public/learn.html: New educational page
- signet-dashboard/public/api-docs.html: Enhanced API documentation
- signet-dashboard/public/hash-list.html: Updated hash list page
- signet-dashboard/public/utxo-list.html: Updated UTXO list page
- signet-dashboard/public/join-signet.html: Updated join signet page
- signet-dashboard/src/server.js: Enhanced server with new routes
- signet-dashboard/start.sh: Updated startup script
- signet-dashboard/signet-dashboard.service: Updated systemd service
- api-anchorage/anchorage-api.service: Updated systemd service
- api-faucet/faucet-api.service: Updated systemd service
- configure-nginx-proxy.sh: Enhanced nginx configuration script
- add-watermark-certificate.sh: New watermark certificate script
- deploy-watermark-nginx.sh: New deployment script
- api-clamav/: New ClamAV API service
- api-filigrane/: New Watermark API service
- hash_list.txt, utxo_list.txt: Updated with latest data
- anchor_count.txt: Updated anchor count
2026-01-25 17:43:05 +01:00

71 lines
2.0 KiB
JavaScript

/**
* Utilitaire pour scanner les fichiers avec ClamAV
*/
import { logger } from './logger.js';
const CLAMAV_API_URL = process.env.CLAMAV_API_URL || 'http://localhost:3023';
/**
* Scanne un buffer avec ClamAV
* @param {Buffer} buffer - Le buffer à scanner
* @param {string} filename - Le nom du fichier (optionnel)
* @returns {Promise<{clean: boolean, infected: boolean, viruses: string[]}>}
*/
export async function scanBuffer(buffer, filename = 'unknown') {
try {
const base64Data = buffer.toString('base64');
const response = await fetch(`${CLAMAV_API_URL}/api/scan/buffer`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
data: base64Data,
filename: filename,
}),
});
if (!response.ok) {
if (response.status === 503) {
// ClamAV non disponible, on log mais on continue (mode dégradé)
logger.warn('ClamAV service unavailable, skipping scan', {
status: response.status,
filename: filename,
});
return { clean: true, infected: false, viruses: [] };
}
const error = await response.json().catch(() => ({ message: 'Unknown error' }));
throw new Error(`ClamAV scan failed: ${error.message || response.statusText}`);
}
const result = await response.json();
if (result.infected) {
logger.warn('File infected by virus', {
filename: filename,
viruses: result.viruses,
});
}
return result;
} catch (error) {
// Si ClamAV n'est pas disponible, on log mais on continue (mode dégradé)
if (error.message.includes('ECONNREFUSED') || error.message.includes('fetch failed')) {
logger.warn('ClamAV service unavailable, skipping scan', {
error: error.message,
filename: filename,
});
return { clean: true, infected: false, viruses: [] };
}
logger.error('ClamAV scan error', {
error: error.message,
filename: filename,
});
throw error;
}
}