Autenticazione degli utenti (SSO)

Questo articolo descrive i metodi di autenticazione degli utenti disponibili in SMARTFENSE, insieme alla configurazione di ciascuna opzione, inclusa l'autenticazione propria della piattaforma, Microsoft Entra ID, Google, Auth0, Okta e Keycloak.

Configurazione disponibile nella nostra piattaforma nella sezione Utenti e gruppi > Autenticazione

Selezione del metodo di autenticazione

In questa sezione è possibile selezionare il metodo di autenticazione che gli utenti utilizzeranno per accedere a SMARTFENSE:

Propria della piattaforma SMARTFENSE
Microsoft Entra ID
Google
Auth0
Okta
Keycloak
SAML 2.0

Autenticazione propria di SMARTFENSE

Configurazione dell'autenticazione propria di SMARTFENSE

L'autenticazione propria di SMARTFENSE può essere utilizzata in due modi:

Autenticazione con credenziali

Ogni utente deve inserire una combinazione di nome utente o e-mail e password per accedere alla piattaforma.

Autenticazione senza credenziali

Gli utenti finali non necessitano di credenziali.
Ricevono un link unico in ogni notifica, che consente loro di accedere direttamente alle proprie campagne.

Opzioni:

• Autenticazione con credenziali

• Autenticazione senza credenziali

Autenticazione tramite Microsoft Entra ID

Configurazione dell'autenticazione tramite Microsoft Entra ID

L'autenticazione con Microsoft Entra ID può essere configurata in due modalità:

Tutti gli utenti possono autenticarsi utilizzando Microsoft Entra ID.

• Gli utenti amministrativi possono anche accedere con le proprie credenziali SMARTFENSE.

• Gli utenti finali non richiedono credenziali: sono identificati da un ID unico incluso nei link che ricevono nelle notifiche di SMARTFENSE.

• Questa modalità impedisce agli utenti finali di fare un uso proattivo della piattaforma (possono accedere solo alle campagne assegnate e non possono vedere né configurare il proprio profilo).

Opzioni:

• Autenticazione tramite Microsoft Entra ID per utenti finali e amministrativi

• Autenticazione tramite Microsoft Entra ID per utenti amministrativi

Autenticazione da Google

Dati di configurazione

Per collegare Google con SMARTFENSE, è necessario inserire:

• ID client

• Chiave segreta client

È possibile consultare la guida per ottenere questi dati al seguente link: Importare utenti e gruppi da Google Workspace

Configurazione di Auth0

1. Accedere a https://auth0.com/.

2. Fare clic su New Client per creare una nuova applicazione.

3. Scegliere Single Page Web Applications e fare clic su Create.

4. Nella scheda Settings, configurare:

   • Nome dell'applicazione: SMARTFENSE

   • Copiare i valori di Domain, Client ID e Client Secret

5. Inserire questi dati in SMARTFENSE nei campi corrispondenti.

6. In Allowed Callback URLs, inserire:
   https://instancia.takesecurity.com/complete/auth0/

7. Fare clic su Save Changes.

Configurazione di Okta

1. Accedere alla console di amministrazione di Okta.

2. Andare su Applications > Applications e fare clic su Create App Integration.

3. Selezionare:

   • OpenID Connect in Sign-in method

   • Web Application in Application type

4. Completare General Settings con un nome e opzionalmente un logo.

5. In Grant Type, selezionare Authorization Code.

6. Aggiungere Sign-in redirect URIs:
   https://instancia.takesecurity.com/complete/okta-openidconnect/

7. Aggiungere Sign-out redirect URIs:
   https://instancia.takesecurity.com/disconnect/okta-openidconnect/

8. Selezionare l'opzione desiderata in Assignments e fare clic su Save.

9. Copiare Client ID e Client Secret e incollarli in SMARTFENSE.

Configurazione aggiuntiva per l'accesso dal dashboard di Okta

1. In General settings, selezionare Either Okta or App in Login initiated by.

2. Andare su Security > API e fare clic su Add Authorization Server.

3. Configurare:

   • Nome: SMARTFENSE

   • Audience: api://default

   • Descrizione: SMARTFENSE Server

4. In Access Policies, creare una nuova policy chiamata SMARTFENSE Login.

5. In Rules, creare una regola che includa gli scopes:

   • openid

   • profile

   • email

6. Tornare a Security > API, copiare l'Issuer URI e incollarlo in SMARTFENSE.

Configurazione di Keycloak

1. Accedere alla Console di Amministrazione di Keycloak e selezionare il Realm corrispondente.

2. Copiare il nome del realm e incollarlo in SMARTFENSE nel campo Realm.

3. In Clients → Create, assegnare un Client ID (senza spazi né caratteri speciali).

4. Salvare, copiare il Client ID e incollarlo in SMARTFENSE.

5. In Clients → smartfense-client → Settings → Capability config, attivare:

   • Client authentication

   • Authorization

6. In Clients → smartfense-client → Credentials, scegliere Client Id and Secret e copiare il Secret.

7. In Fine Grain OpenID Connect Configuration, impostare:

   • User Info Signed Response Algorithm: RS256

   • Request Object Signature Algorithm: RS256

8. In Valid Redirect URIs, aggiungere:
   https://instancia.takesecurity.com/complete/keycloak/*

9. In Valid Post Logout Redirect URIs, aggiungere:
   https://instancia.takesecurity.com/disconnect/keycloak/*

10. In Client Scopes → smartfense-client-dedicated → Mappers → Create, creare un mapper di tipo Audience.

11. In Realm Settings → Keys, copiare la Public Key (RS256) e incollarla in SMARTFENSE.

Campi da completare in SMARTFENSE:

• Realm

• Keycloak Domain

• Client ID

• Client Secret

• Public Key

Configurazione SAML 2.0

1. Accedere alla console di amministrazione del proprio Identity Provider (IdP) e creare una nuova applicazione di tipo SAML 2.0.

2. Configurare i seguenti dati del Service Provider (SMARTFENSE) nel proprio IdP:

   • Entity ID (SP): copiare il valore mostrato nel campo Entity ID (SP) di questa schermata.

   • ACS URL (Assertion Consumer Service): copiare il valore mostrato nel campo ACS URL di questa schermata.

3. Configurare il formato del Name ID nel proprio IdP. È obbligatorio utilizzare Email come formato di Name ID, in modo che l’identificatore dell’utente corrisponda all’indirizzo email registrato in SMARTFENSE.

4. Assicurarsi che il proprio IdP invii almeno l’attributo email nell’asserzione SAML. Questo attributo verrà utilizzato per associare l’utente al proprio account SMARTFENSE.

5. Dal proprio IdP, ottenere i seguenti dati e completarli nei campi corrispondenti di questa schermata:

   • Entity ID dell’IdP: identificatore univoco del provider di identità (noto anche come Issuer).

   • Single Sign-On Service URL: URL dell’endpoint di accesso SAML dell’IdP (HTTP-Redirect o HTTP-POST).

   • Certificato Pubblico X.509: certificato dell’IdP utilizzato per firmare le asserzioni SAML. Incollarlo in formato PEM senza le righe BEGIN/END CERTIFICATE.

Campi forniti da SMARTFENSE: Dati del Service Provider

Configurare i seguenti dati nel proprio Identity Provider.

• Entity ID (SP):

• ACS URL:

Campi da completare in SMARTFENSE: Dati dell’Identity Provider

• Entity ID dell’IdP, esempio: https://idp.example.com/metadata

• Single Sign-On Service URL, esempio: https://idp.example.com/sso/saml

• Certificato Pubblico X.509 dell’IdP.

💡 Best practice

• Scegliere il metodo di autenticazione in base alla struttura di identità dell'organizzazione.

• Per integrazioni con SSO, verificare sempre le callback URL prima di salvare.

• Mantenere le chiavi (Client Secret, Public Key, ecc.) in un repository sicuro.

• Revisionare periodicamente le sincronizzazioni (Google, Okta, Keycloak) per assicurare coerenza tra le directory.