Konfiguration des JS-Bibliothek
Die sociallyveConfig.js muss angelegt und mit folgenden Parametern konfiguriert werden (die angegebenen Werte sind nur Beispiele):
Die applicationId
Hier muss der von allyve ausgestellte API-Key (applicationId) für die Kommunikation mit der API eingetragen werden.
sociallyveConfig['applicationId'] = "5a84f4h104g83de6";
Die apiUrl
Der Pfad zum Autorisierungs Gateway des allyve Backends ist
sociallyveConfig['apiUrl'] = "https://api.allyve.com/api/sociallyve/";
Die URLs, an die der Userdatensatz weitergereicht werden soll
sociallyveConfig['loginUrl'] = "/request/ajax_get_Login.php";
An diese URL wird das Logintoken (Parameter “sltoken”) des Users weitergereicht. Diese URL ist Teil IHRES Backends. Hier müssen Sie die Signatur überprüfen und dann die Userdaten als LoginObject in einem weiteren Call abrufen (getData). Anhand der Userdaten kann Ihr Backend z.B. einen Login im eigenen System durchführen und eine Antwort im JSON Format zurückgeben. Diese Antwort wird im Anschluss an eine weitere Callbackfunktion weitergereicht, die wiederum z.B. die Seite neu laden, ein Login-Formular anzeigen könnte, etc.
Ihr Backend kann folgende Parameter zur eindeutigen Identifizierung eines Users nutzen:
- allyveUserId: eine vom allyve Backend generierte, eindeutige Nutzer-ID
- externalUserId: die vormals von der Consuming-Party übermittelte BenutzeId für diesen Nutzer (siehe öffentliche Methode setExternalId). (Diese muss nicht eindeutig sein, da verschiedene allyve Nutzer auf denselben Consuming-Party Nutzer zeigen können.)
- uid + provider: Die uid (durch den Login-Provider festgelegt) zusammen mit dem provider sind eindeutig
Zum Mechanismus des Aufrufs dieser statisch konfigurierten URL gibt es eine Alternative. Sie können eigene JS-Funktionen, an Stelle der vorgegebenen Login/Import Methoden, nutzen. Siehe Initialisierung)
Import-URL
sociallyveConfig['importUrl'] = "/request/ajax_get_Data.php";
An diese URL werden zwei Token (sltoken und sltokenext) weitergereicht. Diese URL ist Teil IHRES Backends. Hier müssen Sie die Signatur überprüfen und können dann anhand eines Backend zu Backend Calls – unter Benutzung der Tokens – die Kontaktdaten des Users anfordern (siehe öffentliche Methode getData) und eine Antwort im JSON Format zurückgeben. Diese Antwort wird im Anschluss an eine weitere Callbackfunktion weitergereicht.
In Abhängigkeit des verwendeten Tokens werden zwei unterschiedliche Datentypen gelifert. Ruft man unter Verwendung des Tokens “sltoken” die Daten ab, wird lediglich eine Liste von Kontakten geliefert. Verwendet man das Token “sltokenext”, so werden ein Objekt mit zwei Eigenschaften geliefert: “contactList” (die Liste der Kontakte) und “loginData” (ein LoginData Objekt mit Informationen über den User, der den Import ausgeführt hat).
An die URL werden folgende Parameter per GET-Request übermittelt:
provider, signature, sltoken, sltokenext, timestamp
Url zur Weiterleitung auf das Login-Gateway definieren
Hier muss der Pfad zur xd_allyzer.html angegeben werden.
sociallyveConfig['pathToForwarder'] = "/libraries/sociallyve/html/xd_allyzer.html";
Zuletzt aktualisiert am 8. Mai 2012 von admin - Anmelden