Files

SmartRootsSrl 2a13365871 feat: integrazione hCaptcha nel form contatti

- contatti.astro: widget hCaptcha, token incluso nel payload,
  messaggio di errore se challenge non completata
- docs/INFRA.md: documentata configurazione hCaptcha (site key,
  secret key in appSettings, flusso di verifica)

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

2026-05-21 14:11:08 +02:00

3.6 KiB

Raw Blame History

Infrastruttura — SmartRootsSite

Overview

Sito istituzionale statico generato con Astro 4, deployato su IIS / Windows Server 2016 presso Hetzner.

URL: https://www.smart-roots.net/
Cartella sul server: C:\inetpub\wwwroot\smartroots-site\
Backend API: https://api.smart-roots.net/ (progetto SmartRootsServices)

Struttura IIS — Site `smart-roots`

Il Site IIS smart-roots ha come Physical Path C:\inetpub\wwwroot\smartroots-site\. Sotto di esso convivono due tipi di nodi:

Virtual Applications (webapp con proprio App Pool)

Sopravvivono automaticamente al cambio di Physical Path del Site.

/investirehub, /mantis, /motoregrafico, /olympiadocs, /reports, /services, /smartreports, /smartwiki, /testblazor, /tradingview, /wiki, /zertimporter

Virtual Directories (contenuto statico, nessun App Pool)

Vanno ricreate manualmente se si cambia la Physical Path del Site. Puntano tutte a sottocartelle di C:\inetpub\wwwroot\smart-roots.net\.

Alias	Physical path
`.well-known`	`...\smart-roots.net\.well-known\` — ⚠️ necessario per rinnovo SSL
`allegati`	`...\smart-roots.net\allegati\`
`Images`	`...\smart-roots.net\Images\`
`Pdf`	`...\smart-roots.net\Pdf\`
`PricerApi`	`...\smart-roots.net\PricerApi\`
`PricerApp`	`...\smart-roots.net\PricerApp\`
`PricerApp2`	`...\smart-roots.net\PricerApp2\`
`video`	`...\smart-roots.net\video\`

Deploy (da ripetere ad ogni aggiornamento)

npm run build
Copy-Item -Path "dist\*" -Destination "C:\inetpub\wwwroot\smartroots-site\" -Recurse -Force

Nessuna modifica IIS necessaria per i deploy ordinari.

web.config — nota critica

Il file public/web.config (copiato da Astro in dist/ durante la build) contiene:

Redirect HTTP→HTTPS
Astro static routing — fallback catch-all che riscrive URL senza file fisico a /{path}/index.html
httpErrors 404 — serve /index.html per qualsiasi 404

L'intera sezione <system.webServer> è avvolta in:

<location path="." inheritInChildApplications="false">

Questo wrapper è fondamentale. Senza di esso, le regole di rewrite e il gestore 404 vengono ereditati dalle Virtual Applications figlie, che ricevono traffico riscritto o risposte sostituite con la homepage Astro invece dei loro contenuti.

Sintomo senza il wrapper: endpoint dinamici delle webapp (es. /smartreports/api/report?p=...) restituiscono la homepage Astro invece del contenuto atteso.

Pagine

URL	File
`/`	`src/pages/index.astro`
`/contatti`	`src/pages/contatti.astro`
`/privacy`	`src/pages/privacy.astro`
`/termini`	`src/pages/termini.astro`

API usate dal frontend

Endpoint	Metodo	Scopo
`https://api.smart-roots.net/api/contatti`	POST	Invio form contatti

Il controller è in SmartRootsServices/SRServices/Controllers/SmartRootsSite/ContattiController.cs.

Validazioni lato server: campi obbligatori, messaggio minimo 10 caratteri, rate limiting (3 invii/ora per IP), honeypot anti-bot, verifica hCaptcha.

hCaptcha

Il form contatti è protetto da hCaptcha (piano gratuito).

Site key (pubblica, nel frontend): 813a0980-869a-42f4-9a7c-abaae7dccd96
Secret key (privata, solo server): configurata in <appSettings> nel web.config di SmartRootsServices sul server — non è in source control

<add key="HcaptchaSecret" value="..." />

Il controller verifica il token chiamando https://hcaptcha.com/siteverify prima di processare il form. Se la verifica fallisce restituisce HTTP 400.

3.6 KiB Raw Blame History