Personalizzazione dei provider di e-mail e SMS

Modifica online

È possibile personalizzare il mittente dell'e-mail e il fornitore di SMS per i messaggi di notifica 'IBM® Verify.

Prima di iniziare

I clienti che desiderano integrare il proprio provider di SMS per le notifiche OTP di IBM Verify devono configurare un endpoint webhook esterno che accetti richieste POST da IBM Verify.

Requisiti di configurazione dei webhook esterni
  • Il fornitore esterno di SMS deve esporre un endpoint webhook HTTP POST per ricevere le richieste di notifica OTP da IBM Verify.
  • L'endpoint deve mettere immediatamente in coda le richieste e restituire una risposta HTTP.
Esempio di carico utile della richiesta JSON
{
  "destinationPhoneNumber": "18005551212",
  "content": "Your passcode is 6439-123456. It expires in 5 minutes.",
  "category": "OTP",
  "language": "en-US",
  "otp": "123456",
  "correlation": "6439",
  "expiry": 5
}
Descrizioni a livello di campo
destinationPhoneNumber
Il numero di telefono del destinatario nel formato E.164.
content
Il testo completo dell'SMS che viene mostrato all'utente.
category
OTP
language
Il codice del locale o della lingua, ad esempio en-US.
otp
Il valore del codice di accesso unico.
correlation
L'ID per correlare l'OTP a un flusso di verifica; in genere è indicato nel messaggio.
expiry
La durata della validità in minuti.
Requisiti della risposta Webhook
202 Accettato
Richiesta accodata con successo.
400 richiesta non valida
Formato del carico utile non valido.
500 errori server interni
Il fornitore non è in grado di elaborare.
Esempio di risposta di successo
{
"status": "accepted",
"statusMessage": "Message accepted by provider"
}
Esempio di risposta al fallimento
{
"status": "failed",
"statusMessage": "The destination phone number is invalid."
}

Informazioni su questa attività

IBM è il mittente di posta elettronica e il fornitore di SMS predefinito per 'Verify.

Procedura

  1. Accedere a Configurazione globale > Comunicazione e selezionare la scheda Mittenti.
  2. Per modificare il mittente dell'e-mail, fai clic matita sull'icona nel riquadro E-mail.
    1. Modificare i valori predefiniti delle seguenti opzioni e-mail.
      Tabella 1.

      La tabella descrive gli attributi delle notifiche via e-mail.
      Attributo Descrizione
      Indirizzo del mittente Modificare questo campo per riflettere l'indirizzo e-mail che si desidera sia indicato come mittente della notifica.
      Nome email del mittente Modificare questo campo per riflettere la persona o l'organizzazione che sta inviando la notifica. Ad esempio, la vostra azienda.
    2. Opzionale: seleziona la casella di controllo Usa server e-mail SMTP personalizzato.
      Per il server SMTP personalizzato, specificare le seguenti informazioni:
      • Host SMTP
      • Porta
      • Nome utente
      • Password
      • Selezionare il protocollo di connessione, TLS o SSL.
    3. Fare clic su Salva.
  3. Se il tuo inquilino utilizza i servizi IBM SMS e desideri modificare l'ID mittente degli SMS, clicca matita sull'icona sul riquadro del provider SMS.
    È possibile modificare l'attributo per riflettere la propria azienda o organizzazione.
    1. Modificare il valore predefinito della seguente opzione.
      Tabella 2.

      La tabella descrive gli attributi per le notifiche SMS.
      Attributo Descrizione
      ID mittente alfanumerico Modificare questo campo per riflettere l'identificativo alfanumerico (A-Z, a-z, 0-9) che identifica il mittente del messaggio. Il valore deve iniziare con un carattere alfabetico, non può includere spazi o caratteri speciali e ha una lunghezza massima di 11 caratteri.
      Nota: il " Verify non supporta la messaggistica SMS.
    2. Fare clic su Salva modifiche.
  4. Se il tenant non utilizza i servizi SMS IBM e si desidera utilizzare un provider SMS esterno, fare clic su Aggiungi provider SMS esterno nel riquadro Provider SMS.
    1. Indicare un nome per il provider di SMS.
      È inoltre possibile specificare un proprietario e le informazioni di contatto via e-mail.
    2. Specificare l' URL di richiesta.
      L' URL punta all'endpoint del provider di SMS esterno che il Servizio di notifica chiama per inviare un SMS.
    3. Selezionare il tipo di autenticazione.
      Base
      Specificare il nome utente e la password.
      Intestazione
      Specificare il nome dell'intestazione e il segreto di autenticazione. Se il segreto è sensibile alle maiuscole, selezionare la casella di controllo Sensibile.
      Nessuno
      Non sono necessarie informazioni di autenticazione.
      OAuth
      Specificare l'endpoint del token. Selezionare se il segreto del client è post o basic. Immettere l'ID e il segreto del client.
      Nota: Il post del client indica che il segreto è memorizzato come attributo. Client basic indica che il segreto è memorizzato nell'intestazione.
      JWT (JSON Web Token)
      Specificare il valore dell'intestazione HTTP, la rivendicazione secondaria, la durata massima valida del JWT e l'algoritmo di firma. Se si desidera, è possibile specificare anche un prefisso del valore dell'intestazione JWT, le chiavi dell'intestazione JWT e i nomi delle richieste.
      TLS reciprocomTLS)
      Specificare l'etichetta del certificato MTLS.
    4. Fare clic su Salva.
      Il provider di SMS è stato creato, ma è disattivato per impostazione predefinita.
    5. Per verificare se l'inquilino è connesso al provider di SMS, fare clic su Prova connessione.
      È possibile inviare un payload di prova al provider di SMS per testare la connessione.
    6. Dopo un test di connessione riuscito e quando si è pronti a utilizzare il provider di SMS esterno, fare clic sulla levetta Configurazione per attivarlo.
    7. Opzionale: per verificare lo stato del tuo provider SMS, clicca su Visualizza statistiche di integrità.
      Lo stato di salute fornisce un riepilogo della connessione, la cronologia della connessione e le statistiche per l' URL del provider SMS