Anwendung initialisieren

Nach dem Definieren der OAuth-Konfigurationsdatei und der OAuth-Persistenz-Handler-Klasse für Ihre App kann diese initialisiert werden.

Erzeugen von Gewährungs-Token

Für einen einzelnen Benutzer

Die Entwicklerkonsole bietet eine Option zum Erzeugen eines Gewährungs-Tokens für einen Benutzer. Diese Option kann nützlich sein, wenn Ihre Anwendung nur einen Satz CRM-Benutzeranmeldedaten für alle Vorgänge oder zum Testen Ihrer Entwicklung verwendet.

  1. Melden Sie sich am Benutzerkonto an.
  2. Besuchen Sie https://accounts.zoho.com/developerconsole
  3. Klicken Sie auf die Option Optionen → Eigener Client des Clients, für den die Autorisierung durchgeführt werden soll.
  4. Geben Sie im Feld „Bereich“ einen oder mehrere (durch Komma getrennte) gültige Zoho CRM-Bereiche an, die Sie autorisieren möchten. Wählen Sie dann das Ablaufdatum.
  5. Kopieren Sie das angezeigte Gewährungs-Token.

Hinweis:

  • Das erzeuge Gewährungs-Token gilt nur für die beim Erzeugen definierte Dauer. Daher müssen das Zugriffs- und Aktualisierungs-Token innerhalb dieses Zeitraums erzeugt werden.
  • Die OAuth-Client-Registrierung und das Erzeugen des Gewährungs-Tokens müssen mit der Entwicklerkonsole des gleichen Zoho-Kontos (Anmeldung) erfolgen.

Für mehrere Benutzer

Bei mehreren Benutzern liegt es in der Verantwortung Ihrer Client-App, das Gewährungs-Token für Benutzer zu erzeugen, die einen Anmeldungsversuch unternehmen.

  • Die Benutzerschnittstelle Ihrer Anwendung muss die Option „Anmelden mit Zoho“ aufweisen, um die Gewährungs-Token-URL von Zoho zu öffnen, die die Zoho-Anmeldedaten des Benutzers abruft.
  • Nach erfolgreicher Anmeldung des Benutzers wird das Gewährungs-Token als Parameter an Ihre registrierte Weiterleitungs-URL gesendet.

Erzeugen von Zugriffs- und Aktualisierungs-Token

Nach dem Erhalt des Gewährungs-Token muss das folgende Code-Snippet in eine Java-Datei eingefügt und von Ihrer Hauptklasse ausgeführt werden, um Zugriffs- und Aktualisierungs-Token abzurufen. 

ZCRMRestClient.initialize();
ZohoOAuthClient cli = ZohoOAuthClient.getInstance();
String grantToken = “paste_the_self_authorized_grant_token_here”;
ZohoOAuthTokens tokens = cli.generateAccessToken(grantToken);
String accessToken = tokens.getAccessToken();
String refreshToken = tokens.getRefreshToken();
System.out.println("access token = " + accessToken + " & refresh token = " + refreshToken);

Zugriffs- und Aktualisierungs-Token werden erzeugt und in der Dateioauth_tokens.properties gespeichert, wenn Sie ZohoOAuthFilePersistenceverwenden. Die Speicherung erfolgt auch in Ihrer Mysql-Datenbanktabelle „oauthtokens“, wenn Sie ZohoOAuthDBPersistence bei der Ausführung des oben genannten Java-Codes verwenden.

Hinweis:

  1. Das obige Code-Snippet ist nur einmal pro Gewährungs-Token gültig. Nach der erfolgreichen Ausführung blieben die erzeugten Zugriffs- und Aktualisierungs-Token durch ihre Persistenz-Handler-Klasse erhalten.
  2. Sobald die OAuth-Token gespeichert sind, verwenden die folgenden API-Aufrufe die persistierenden Zugriffs- und Aktualisierungs-Token. Das SDK sorgt für die Aktualisierung des Zugriffs-Tokens mithilfe des Aktualisierungs-Tokens, sofern und wenn erforderlich.