Identity Provider Integration Security Guidelines
Security guidelines for integrating external Identity Providers (OIDC, OAuth 2.0, SAML 2.0).
Versione: 1.0
Ultimo aggiornamento: Luglio 2026
1. Scopo
Il presente documento descrive le linee guida per la configurazione sicura dell'integrazione tra la piattaforma Flowvenue e gli Identity Provider (IdP) utilizzati dalle organizzazioni clienti.
Le indicazioni si applicano alle integrazioni basate sui protocolli standard:
- OpenID Connect (OIDC)
- OAuth 2.0
- SAML 2.0
e costituiscono le configurazioni raccomandate da Flowvenue per ridurre il rischio di spoofing, redirection attack e utilizzo improprio dei token di autenticazione.
2. Architettura
Flowvenue utilizza una piattaforma centralizzata di Identity & Access Management conforme agli standard OpenID Connect e SAML 2.0.
La piattaforma IAM attualmente adottata è Auth0.
Le integrazioni con Identity Provider esterni vengono realizzate mediante le funzionalità standard di federazione offerte dalla piattaforma IAM.
A seconda dell'Identity Provider dell'organizzazione cliente possono essere utilizzati:
- OpenID Connect
- SAML 2.0
La configurazione viene eseguita con il supporto del team tecnico Flowvenue.
3. Requisiti di sicurezza
Callback URI
Devono essere configurate esclusivamente Callback URI appartenenti ai domini autorizzati.
Non devono essere utilizzate wildcard.
Ogni ambiente (sviluppo, test, produzione) deve utilizzare esclusivamente le proprie Callback URI dedicate.
Redirect URI
L'Identity Provider deve consentire esclusivamente Redirect URI preventivamente registrate.
Qualsiasi Redirect URI non presente nella whitelist deve essere rifiutata.
Logout URI
Devono essere configurate esclusivamente Logout URI appartenenti agli ambienti autorizzati.
Allowed Web Origins
Devono essere autorizzati esclusivamente i domini utilizzati dall'applicazione.
Non devono essere autorizzati domini generici o wildcard.
Allowed Origins (CORS)
Le Allowed Origins devono essere limitate esclusivamente alle origini utilizzate dalla piattaforma.
4. Configurazione OAuth / OpenID Connect
Per le integrazioni OIDC devono essere adottate almeno le seguenti configurazioni.
- Authorization Code Flow
- PKCE (S256) raccomandato per SPA e Mobile
- RS256
- RFC 9068
- Audience Validation
- Issuer Validation
- JWKS Validation
- OIDC Conformant
5. Configurazione SAML
Per integrazioni basate su SAML 2.0 devono essere adottate le configurazioni previste dall'Identity Provider.
Qualora l'Identity Provider richieda la firma delle Authentication Request (AuthnRequest), Flowvenue supporta la relativa configurazione tramite le funzionalità di federazione offerte dalla piattaforma IAM.
6. Sicurezza del canale
Le comunicazioni devono avvenire esclusivamente mediante HTTPS.
Sono supportate esclusivamente connessioni TLS 1.2 o superiori.
7. Multi Factor Authentication
Qualora previsto dalle policy dell'organizzazione cliente è raccomandata l'abilitazione della Multi Factor Authentication (MFA).
8. Gestione dei certificati
I certificati utilizzati dall'Identity Provider devono essere mantenuti validi e aggiornati.
Eventuali rotazioni dei certificati devono essere comunicate preventivamente.
9. Hardening raccomandato
Flowvenue raccomanda inoltre:
- RS256
- rotazione periodica delle chiavi
- Access Token lifetime limitata
- Refresh Token Rotation
- MFA
- TLS 1.2 / TLS 1.3
10. Supporto tecnico
Flowvenue fornisce supporto specialistico durante tutte le attività di integrazione.
Sono comprese:
- configurazione OIDC
- configurazione SAML
- Callback URI
- Redirect URI
- Logout URI
- Allowed Web Origins
- CORS
- Issuer
- Audience
- certificati
- algoritmi di firma
- configurazione della firma delle Authentication Request qualora richiesta dall'Identity Provider
- test
- collaudo
11. Responsabilità condivise
La sicurezza dell'integrazione dipende dalla corretta configurazione sia della piattaforma Flowvenue sia dell'Identity Provider dell'organizzazione.
Flowvenue garantisce supporto tecnico e linee guida.
L'organizzazione mantiene la responsabilità operativa del proprio Identity Provider.
Contatti
Per informazioni relative alla sicurezza o alle integrazioni con Identity Provider: