Help > Chat Room > Generale > Integrazione Single Sign On

Integrazione Single Sign On

È possibile utilizzare l'API Single Sign On (SSO) per registrare automaticamente i visitatori nella chat room. Questo può essere utile se hai un'area di accesso separata sul tuo sito web e non vuoi far accedere i tuoi visitatori due volte.

L'API SSO consente di inviare una richiesta HTTP dall'interno dell'applicazione per accedere un utente all'interno o all'esterno della chat room. Un token viene restituito dall'API, che viene quindi utilizzato in un piccolo tag IMG nella pagina successiva per memorizzare i cookie necessari del browser.

Se si utilizza PHP, si consiglia vivamente di utilizzare il nostro Libreria SSO. Contiene un file con tutto il codice della libreria di cui hai bisogno e altri file con esempio di utilizzo.

Se stai utilizzando WordPress per il tuo sito web, abbiamo un Plugin WordPress che integra automaticamente il tuo processo di accesso e registrazione.

Segui le istruzioni riportate di seguito per integrare l'API SSO nel tuo sito web.

Ottenere la chiave API

La chiave API viene passata come parametro nelle chiamate API per verificare di essere un utente autorizzato dell'API della chat room. La chiave API è come una password per il tuo account e deve essere tenuta privata e protetta.

È possibile ottenere la chiave API chat Toolbox Website seguendo le istruzioni riportate di seguito:

  1. Accedi al tuo account Website Toolbox.
  2. Fare clic sul collegamento Impostazioni.
  3. Copiare la chiave API menzionata accanto all'opzione Chiave API.

Effettuare la richiesta per generare il token di accesso

Nello script di accesso per il sito Web, effettuare una richiesta HTTP all'URL di accesso dell'API SSO:

http://CLIENT.discussionchatroom.com/sso/token/generate?apikey=APIKEY&username=USERNAME&email=EMAIL&avatarUrl=AVATARURL&password=PASSWORD

Sostituire APIKEY con la chiave API segreta.

Sostituire USERNAME con il nome utente dell'utente da effettuare l'accesso.

Sostituire EMAIL con l'ID di posta elettronica dell'utente da effettuare l'accesso.

Sostituire AVATARURL con l'URL dell'immagine del profilo dell'utente. Questo è facoltativo. In caso contrario, l'utente può sempre impostare il proprio avatar nella chat room stessa.

Sostituire PASSWORD con la password non crittografata dell'utente da effettuare l'accesso.

Il nome utente e la password sono parametri facoltativi che verranno utilizzati solo se l'account deve essere creato perché non esiste già. Se l'account viene creato senza password, l'utente non sarà in grado di accedere direttamente alla chat room a meno che non abbia prima reimpostato la password nella pagina di accesso. L'accesso SSO funzionerebbe senza problemi anche senza che l'account dell'utente disponga di una password.

Analizzare la risposta per recuperare il token di accesso

Analizzare la risposta JSON della richiesta inviata a genera token di accesso per recuperare il token di autenticazione, cioè «access_token». La risposta JSON sarà simile al seguente:

{
  "success" : true,
  "message" : "This is success or failure message.",
  "access_token" : "88SngRlfrqL"
}

successo - corrisponde allo stato della richiesta. È vero, se il token di autenticazione viene generato correttamente. Altrimenti è falso.

messaggio: si tratta di un messaggio condiviso nella risposta. È più utile per la risposta agli errori.

access_token - è il token di accesso generato per l'utente dopo l'autenticazione riuscita. Questo token verrà scaduto in 60 minuti per garantire la sicurezza.

Richiesta di accesso alla Chat Room

Sul tuo sito web, aggiungi il seguente tag HTML IMG alla tua pagina di destinazione «Accedi con successo»:

<img border="0" width="1" height="1" alt="" src= "//CLIENT.discussionchatroom.com/sso/token/login?access_token=ACCESS_TOKEN&rememberMe=REMEMBERME" >

Sostituire ACCESS_TOKEN con access_token, recuperato nel passaggio Analizza la risposta per recuperare il token di accesso>..

Sostituire REMEMEMORME con il valore 0 o 1. Per far ricordare al browser le informazioni di accesso dell'utente anche dopo la chiusura del browser, sostituire REMEMEMORME con 1, altrimenti sostituirlo con 0 per cancellare le informazioni di accesso una volta chiuso il browser.

La finestra del browser che carica il tag IMG verrà registrata nella chat room come utente con il nome utente fornito durante la richiesta a genera token di accesso.

Il browser Safari viene fornito con una politica sui cookie conservativa che limita i cookie scritti solo alle pagine scelte («navigate a») dall'utente. Questo impedisce che il cookie di accesso del forum venga impostato sulla pagina di destinazione «log in riuscito». Pertanto, l'unico modo per far funzionare Single Sign On sul browser Safari è quello di passare anche il token di autenticazione nel link della chat room sul tuo sito web. Ad esempio:

<a href="http://CLIENT.discussionchatroom.com/?access_token=ACCESS_TOKEN&rememberMe=REMEMBERME">Chat Room</a>

Esci dalla Chat Room

Nel caso in cui l'utente desideri disconnettersi dalla chat room o quando l'utente si disconnette dal sito web, aggiungere il seguente tag HTML IMG alla pagina di destinazione «log out successful»:

<img border="0" width="1" height="1" alt="" src="//CLIENT.discussionchatroom.com/sso/token/logout?access_token=ACCESS_TOKEN" >

Sostituire ACCESS_TOKEN con access_token, recuperato nel passaggio Analizzare la risposta per recuperare il token di accesso.

Se non si dispone del token di autenticazione restituito durante l'accesso, può essere recuperato o rigenerato (se scaduto) effettuando la richiesta a genera token di accesso API.

Impostazioni URL

Puoi impostare gli URL del tuo sito web seguendo le istruzioni riportate di seguito:

  1. Accedi al tuo account Website Toolbox.
  2. Fare clic sul collegamento Impostazioni.
  3. Nella sezione «Single Sign On, specificare gli URL del sito Web per le pagine seguenti:
    • Pagina di accesso: Specificare l'indirizzo della pagina di Login del vostro sito web per assicurarsi che tutti gli accessi alla chat room avvengano utilizzando il modulo di accesso del vostro sito web.
    • Pagina di log out: Specificare l'indirizzo della pagina di log out del tuo sito web per assicurarsi che gli utenti siano mostrati la pagina di log out del tuo sito web una volta che sono stati disconnessi dalla chat room.
    • Pagina di registrazione: Specificare l'indirizzo della pagina di registrazione del vostro sito web per assicurarsi che gli utenti siano mostrati la pagina di registrazione del vostro sito web cliccando sul link «Crea account» nella pagina di accesso della chat room.

Registra un utente nella Chat Room

Per registrare un utente nella chat room, effettuare una richiesta HTTP all'URL di registrazione dell'utente dell'API SSO:

http://CLIENT.discussionchatroom.com/sso/user/register?apikey=APIKEY&username=USERNAME&email=EMAIL&password=PASSWORD&avatarUrl=AVATARURL

Sostituire APIKEY con la chiave API segreta.

Sostituisci USERNAME con il nome utente dell'utente da registrare.

Sostituire EMAIL con l'ID di posta elettronica dell'utente da registrare.

Sostituire PASSWORD con la password non crittografata dell'utente da registrare. Questo è un parametro facoltativo. Nei casi in cui un account viene creato senza password, l'utente non sarà in grado di accedere direttamente alla chat room a meno che non abbia prima reimpostato la password nella pagina di accesso. L'accesso SSO funzionerebbe senza problemi anche senza che l'account dell'utente disponga di una password.

Sostituire AVATARURL con essere registrato utente? s profilo URL immagine. Questo è facoltativo.

L'invio di una richiesta di registrazione è facoltativo poiché gli account verranno creati automaticamente se non esistono già durante un single sign on log in richiesta.

La risposta JSON restituirà anche un token di accesso che può essere utilizzato per accedere all'utente. Seguire la procedura descritta in Analizzare la risposta per recuperare il token di accesso e Richiesta di accesso alla Chat Room per accedere all'utente appena registrato.

Elimina un utente

Per eliminare gli utenti dalla chat room, effettuare una richiesta HTTP all'URL di eliminazione utente API SSO:

http://CLIENT.discussionchatroom.com/sso/user/delete?apikey=APIKEY&emails=EMAILS

Sostituire APIKEY con la chiave API segreta.

Sostituire EMAIL con gli indirizzi e-mail degli utenti da eliminare. Può contenere sia un singolo indirizzo e-mail o più indirizzi e-mail separati da virgole.

Modifica dettagli utente

Per modificare i dettagli dell'utente della chat room, effettuare una richiesta HTTP all'URL utente di modifica dell'API SSO:

http://CLIENT.discussionchatroom.com/sso/user/edit?apikey=APIKEY&user=USER&username=NEWUSERNAME&email=NEWEMAIL&password=NEWPASSWORD&avatarUrl=NEWAVATARURL

Sostituire APIKEY con la chiave API segreta.

Sostituire l'utente con l'indirizzo di posta elettronica corrente dell'utente.

Sostituisci NEWUSERNAME con il nuovo nome utente che deve essere impostato.

Sostituisci NEWEMAIL con la nuova e-mail che deve essere impostata.

Sostituire NEWPASSWORD con la nuova password che deve essere impostata.

Sostituire NEWAVATARURL con il nuovo URL dell'avatar che deve essere impostato.

I parametri apikey e utente sono campi obbligatori. Gli altri campi sono facoltativi. Non aggiungere parametri nell'URL il cui valore non deve essere aggiornato per l'utente. Il valore per «username» e «email» non verrà aggiornato se è vuoto.

Note importanti

  • Hai bisogno di aiuto? I nostri sviluppatori possono configurare l'integrazione Single Sign On sul tuo sito web per soli 149 $.Contattaci
  • Per accedere alla chat room, dovrebbe esserci un link di chat room sulla tua pagina come:

    <a href=”http://CLIENT.discussionchatroom.com/”>Launch chat room</a>

  • CLIENTE deve essere sostituito dal nome utente della chat room Website Toolbox.
  • Le risposte possono essere analizzate a scopo di debug. La risposta JSON sarà simile a questo.
  • La stringa di query deve essere codificata con URL.


If you still need help, please contact us.