Vai al contenuto principale

Guida all'integrazione: Auth0

Invia OTP automatici e notifiche SMS sicure direttamente dalla tua app Auth0 utilizzando ClickSend.

Aggiornato oggi

Cosa è incluso

Quando integri ClickSend con Auth0, otterrai:

  • Verifica OTP – Invia password monouso per il login o la registrazione

  • Notifiche SMS – Invia notifiche in tempo reale per l'autenticazione a più fattori (MFA)


Prerequisiti

  • Un account ClickSend

  • Un account Auth0

  • Le tue credenziali API ClickSend (nome utente + chiave API)


Installazione

  1. Configura ClickSend in Auth0:

    • Accedi al tuo pannello di controllo Auth0.

    • Vai al Marketplace e clicca su Aggiungi integrazione.

    • Scegli il tuo tenant e concedi le autorizzazioni necessarie.

    • Verrai reindirizzato alla Libreria dove dovrai inserire le tue credenziali API di ClickSend (nome utente e chiave API).

    • La chiave API può essere trovata nel tuo pannello di controllo ClickSend: Chiave API di ClickSend.

    • Clicca su Crea per salvare la connessione.

  2. Configura le impostazioni OTP in Auth0:

    • Vai a Pannello di controllo > Sicurezza > Autenticazione a più fattori.

    • Abilita la password monouso (OTP).

    • Scorri fino a Define Policies e imposta Require multi-factor authentication su Always, quindi clicca su Salva.

  3. Configura Phone Message per gli SMS:

    • In Sicurezza, configura Phone Message Factor per la consegna degli SMS.

    • Abilita Phone Message e salva le modifiche.

  4. Aggiungi l'azione ClickSend al flusso:

    • Clicca su Add to Flow nella finestra pop-up che appare.

    • Trascina l'azione ClickSend nella posizione desiderata nel tuo flusso MFA.


Autenticazione

Per attivare il componente SMS:

  1. Nelle impostazioni del componente di Auth0, vai a API Credentials.

  2. Inserisci:

    • Nome utente – Il tuo nome utente ClickSend

    • Chiave API – La chiave che si trova nel tuo pannello di controllo ClickSend


Verifica OTP (Password monouso)

Verifica gli utenti durante il login o la registrazione utilizzando password monouso (OTP).

Configurazione

  1. Vai al Menu di verifica > Corpo del messaggio.

  2. Includi %otp% dove vuoi che l'OTP appaia nel tuo messaggio.

  3. Esempio: Il tuo codice di verifica è %otp%.

  4. Suggerimento: usa Magic Text per estrarre automaticamente i numeri di telefono salvati dal database degli utenti.

  5. Personalizza: modifica il testo del pulsante “Ottieni OTP”, l'aspetto e il flusso in base alle tue esigenze.


Notifica SMS

Invia avvisi via SMS per l'autenticazione a più fattori o altri trigger in-app (ad es., tentativi di login dell'utente).

Configurazione

  1. In Phone Message Factor, aggiungi un messaggio statico o dinamico nel campo Message Body.

  2. Facoltativamente, imposta un messaggio di conferma dopo l'invio dell'SMS, come “SMS inviato”.

  3. Consenti agli utenti di modificare il messaggio in tempo reale prima dell'invio.


Risoluzione dei problemi

Se l'invio dei messaggi non va a buon fine, prova quanto segue:

  • Verifica le credenziali API:

    • Conferma di aver inserito il nome utente e la chiave API di ClickSend corretti (non la tua password).

  • Assicurati di avere credito sufficiente:

    • Controlla se il tuo account ClickSend ha abbastanza credito. Ricarica il tuo account qui.

  • Compila i campi obbligatori:

    • Assicurati che tutti i campi obbligatori (ad es., numero di telefono destinatario, corpo del messaggio) siano compilati correttamente.


Problemi con l'Alpha Tag:

Se utilizzi un nome aziendale (Alpha Tag) come mittente:

  • Assicurati che sia di massimo 11 caratteri senza spazi.

  • Alcuni paesi non supportano gli Alpha Tag. Controlla l'elenco supportato qui.

  • Assicurati che l'Alpha Tag sia registrato e approvato nel pannello di controllo ClickSend.


FAQ

Posso utilizzare il nome della mia azienda come mittente?

Sì, ma solo nei paesi che supportano gli Alpha Tag. Assicurati che l'Alpha Tag sia:

  • Di 11 caratteri o meno

  • Senza spazi

  • Registrato e approvato tramite la tua pagina ID mittente in ClickSend

Come posso configurare un Alpha Tag?

Vai a API Credentials nel pannello di controllo ClickSend e abilita l'opzione Modifica Alpha Tag/ID mittente.

Hai ricevuto la risposta alla tua domanda?