Janrain Capture/Backplane

I clienti che utilizzano Janrain Capture e Backplane possono utilizzare Livefyre Auth per l’accesso single sign on (SSO), consentendo agli utenti di interagire immediatamente con le app Livefyre quando accedono al tuo sito.

Per beneficiare di questa integrazione incorporata Capture/Backplane, è necessario apportare modifiche alla configurazione sia dell’app Capture che dell’integrazione con Livefyre.js.

Per ulteriori informazioni, consulta la documentazione sul backplane di Janrain's.

1. Impostare Capture.
2. (Facoltativo) Aggiungi Livefyre Defaults alla tua app di acquisizione.
3. Creare l'oggetto AuthDelegate.
4. Sincronizza con Livefyre con Ping per Pull.

Passaggio 1: Imposta acquisizione

Livefyre ha bisogno di alcune credenziali dalla tua app Janrain Capture.

1. Imposta l’app Janrain Capture.

2. Raccogliere le seguenti informazioni per Livefyre:

   • Accedere all'istanza di acquisizione Janrain.
   • Accedi al tuo dashboard di Janrain Engage.
   • Le impostazioni e le credenziali di acquisizione.
   • Le credenziali di coinvolgimento.
   • URL di identità.

Passaggio 2: (Facoltativo) Aggiungi Livefyre Defaults alla tua app di acquisizione

Aggiungi Livefyre per impostazione predefinita agli utenti memorizzati nella tua app Capture per consentirti di inviare notifiche e-mail agli utenti o di consentire loro di seguire automaticamente le conversazioni sulle quali gli utenti commentano.

1. Completa Passaggio 1: Imposta Capture.
2. Aggiungi i seguenti campi predefiniti di Livefyre. Tutti i campi sono facoltativi.

Passaggio 3: Creare l'oggetto AuthDelegate per l'integrazione di Janrain

Livefyre.require fornisce un plug-in che consente ad auth di ascoltare il bus Janrain Backplane.

Login

Quando un messaggio di identità/accesso viene trasmesso sul canale Backplane, auth.authenticate() verrà chiamato con il token di autenticazione Livefyre dell’utente. Devi ancora implementare un AuthDelegate.

Livefyre.require(['auth', 'backplane-auth-plugin#0'], function(auth, backplanePluginFactory) { 
   auth.plugin(backplanePluginFactory('network.fyre.co')); 
   auth.delegate({ 
      login: function (finishLogin) { 
         loginWithCapture(finishLogin); 
      } 
   }); 
});

Di seguito sono riportati alcuni esempi di come un delegato di autenticazione può cercare un'integrazione di Janrain Capture.

• errback: Il callback passato al metodo di login del tuo delegato di autenticazione
• janrain: Il riferimento alla variabile di acquisizione Janrain.
• window.Backplane: Riferimento all'oggetto Backplane.

/** 
* Login function 
* In this case, opens a login modal and triggers Backplane to start listening 
* for login messages 
*/ 
authDelegate.login = function(finishLogin) { 
   var successCallback = function() { 
      // These need to be replaced with the actions that correspond to successful login  
      // and when the Janrain modal is closed. 
      janrain.events.onCaptureLoginSuccess.removeHandler(successCallback); 
      janrain.events.onModalClose.removeHandler(failureCallback); 
      finishLogin(); 
   }; 
  
   var failureCallback = function(e) { 
      janrain.events.onModalClose.removeHandler(failureCallback); 
      janrain.events.onCaptureLoginSuccess.removeHandler(successCallback); 
      finishLogin(e || new Error("Error logging in with Janrain Capture")); 
   }; 
  
   // Open the modal to log a user in 
   janrain.capture.ui.renderScreen('signIn'); 
   // Send a backplane message 
   window.Backplane.expectMessages('identity/login'); 
   // Add handlers to specific janrain events 
   janrain.events.onCaptureLoginSuccess.addHandler(successCallback); 
   janrain.events.onModalClose.addHandler(failureCallback); 
};

Logout

• finishLogout: Il callback passato al metodo di login del tuo delegato di autenticazione.

• window.Backplane: Riferimento all'oggetto Backplane.

/** 
* Logout function 
* In this case, invalidates the session and removes the cookie. 
* Also reloads the page to change state. In order to do this without a reload, 
* it would be necessary to also update the UI. 
*/ 
authDelegate.logout = function(finishLogout) { 
   Backplane.resetCookieChannel(); 
   janrain.capture.ui.endCaptureSession(); 
   finishLogout(); 
}; 

Modifica profilo

Questo può essere collegato a qualsiasi parte del sito che desideri che gli utenti visitano per visualizzare la propria pagina del profilo. In questo esempio viene semplicemente stampato l'oggetto autore passato.

/** 
* Edit profile function 
* @param user - User who would like to edit their profile 
*/ 
authDelegate.editProfile = function(user) { 
   console.log(user); 
}; 

Visualizza profilo

Come Modifica profilo, questo deve essere collegato a una pagina di un utente diversa dall’utente attualmente connesso. Questo può essere implementato come lo ritieni opportuno. In questo esempio il parametro autore viene semplicemente registrato nella console.

/** 
* View profile function 
* @param user - User or userId whose profile should be displayed 
*/ 
authDelegate.viewProfile = function(user) { 
   console.log(author); 
};

Passaggio 4: Sincronizzazione con Livefyre con Ping per l'integrazione con Janrain

Mantenere i profili remoti Livefyre sincronizzati con il sistema di gestione degli utenti Capture comporta una serie di passaggi denominati Ping for Pull. Questo processo richiede che venga ottenuto un token di accesso valido da Janrain, quindi lo si passi a un endpoint specificato al punto 3, qui sotto.

1. Ottieni un codice di accesso da Janrain.

   Per ottenere il codice di accesso, fornisci le credenziali necessarie, specifica user_type come "user" e l’uuid come uuid dell’utente corrente da aggiornare. Per ulteriori informazioni, consulta https://developers.janrain.com/rest-api/methods/authentication/access-codes-and-tokens/getauthorizationcode/.

2. Scambiare il codice di accesso per un token di accesso. Immetti le credenziali necessarie, il codice di accesso ricevuto dal passaggio 1 e specifica il tipo_sovvenzione come "codice_autorizzazione".

   Per ulteriori informazioni, consulta https://developers.janrain.com/rest-api/methods/authentication/oauth/token/.

3. Colpire l’endpoint "Ping to Pull Capture" di Livefyre.

   URL endpoint: https://{networkName}/api/v1.1/private/capture/profile_updated/?jrtoken={token} dove {networkName} è il nome di rete fornito da Livefyre e il jrtoken è il token ricevuto da Janrain al passaggio 2.

   Una volta raggiunto questo endpoint, si riceve una risposta 202 e Livefyre inizia un processo asincrono.

Come funziona tutto

Per usufruire di questa integrazione incorporata Capture/Backplane, è necessario apportare alcune modifiche alla configurazione sia dell’app Capture che dell’integrazione con Livefyre.js.

Janrain invia messaggi di login/logout riusciti tramite il bus Backplane, sul quale viene ascoltata l’app Livefyre, se configurata correttamente. Questi messaggi contengono tutte le informazioni necessarie per mostrare agli utenti dell'app come connessi o disconnessi. Gli sviluppatori possono visualizzare i messaggi degli autobus Backplane controllando la scheda Rete nella console per sviluppatori del browser.

Esempio di codice di accesso

Richiesta:

https://backplane1.janrainbackplane.com//bus/{CUSTOMER_NAME}/channel/{CHANNEL}?callback=Backplane.response&rnd=0.15930617856793106

Risposta:

Backplane.response([{ 
  "id": "2014-05-06T22:51:55.406Z-eZp1HB1F7B", 
  "channel_name": "{CHANNEL_NAME}", 
  "message": { 
    "source": "https://{CUSTOMER_DOMAIN}", 
    "type": "identity/login", 
    "sticky": true, 
    "payload": { 
      "context": "https://{CUSTOMER_DOMAIN}", 
      "identities": { 
        "startIndex": 0, 
        "itemsPerPage": 1, 
        "totalResults": 1, 
        "entry": { 
          "id": "https://{CUSTOMER}.janraincapture.com/oauth/public_profile?uuid={UNIQUE_USER_ID}", 
          "displayName": "{USER_DISPLAY_NAME}", 
          "accounts": [ 
            { 
              "username": "{USER_DISPLAY_NAME}", 
              "identityUrl": "https://{CUSTOMER}.janraincapture.com/oauth/public_profile?uuid={UNIQUE_USER_ID}", 
              "photos": [ 
                { 
                  "id": 48570146, 
                  "value": "https://lh3.googleusercontent.com/-h8poqH8hlgw/AAA/AAA1/QuHtbeHMJzc/photo.jpg?sz=50", 
                  "type": "other" 
                }, 
                { 
                  "id": 48570147, 
                  "value": "https://lh3.googleusercontent.com/-h8poqH8hlgw/AAA/AAA1/QuHtbeHMJzc/photo.jpg?sz=50", 
                  "type": "original" 
                }, 
                { 
                  "id": 48570148, 
                  "value": "https://lh3.googleusercontent.com/-h8poqH8hlgw/AAA/AAA1/QuHtbeHMJzc/photo.jpg?sz=50", 
                  "type": "large" 
                }, 
                { 
                  "value": "https://lh3.googleusercontent.com/-h8poqH8hlgw/AAA/AAA1/QuHtbeHMJzc/photo.jpg?sz=50", 
                  "type": "avatar" 
                } 
              ] 
            }, 
            { 
              "identityUrl": "{USER_PROFILE_LINK}" 
            } 
          ] 
        } 
      } 
    } 
  } 
} 
]);

Risposta vuota:

Backplane.response([]);

Esempio di codice di disconnessione

Richiesta:

https://backplane1.janrainbackplane.com/v1.2/bus/{CUSTOMER}/channel/new?callback=Backplane.finishInit&rnd=0.1057701709214598

Risposta:

Backplane.finishInit("{CHANNEL}");

Se questi messaggi non compaiono nelle richieste di rete, Livefyre non sarà a conoscenza dei tentativi di accesso/logout e, pertanto, Livefyre non sarà in grado di integrare l’utente nell’app.