Zum Inhalt springen

Twitter in Jitterbit App Builder konfigurieren

Der App Builder unterstützt Twitter nicht nativ, weder als Authentifizierungs- noch als Datenanbieter. Da die Twitter-API jedoch grundsätzlich eine REST-API ist, die mit dem OAuth Client Credential Flow gesichert ist, ist es möglich, den generischen HTTP-Sicherheitsanbieter des App Builders zu verwenden, um Daten von Twitter abzurufen.

Die Dokumentation von Twitter zur Authentifizierung auf Anwendungsebene mit dem OAuth Client Credentials Flow finden Sie hier:

https://dev.twitter.com/oauth/application-only

Die Hauptaufgaben umfassen:

  1. Registrieren Sie den App Builder als Twitter-Anwendung.
  2. Erstellen Sie einen Twitter-HTTP-Sicherheitsanbieter.
  3. Erstellen Sie eine Twitter-Datenquelle.

Es wird davon ausgegangen, dass Ihre Organisation bereits über ein bestehendes Twitter-Konto verfügt.

Registrieren Sie den App Builder als Twitter-Anwendung

Beginnen Sie, indem Sie sich auf der Website zur Verwaltung von Twitter-Anwendungen anmelden.

https://apps.twitter.com/

  1. Klicken Sie auf die Schaltfläche Neue App erstellen (oben rechts)

  2. Geben Sie die folgenden Informationen ein:

    • Name: Ein logischer Name für die App Builder-Umgebung oder -Anwendung.

      Beispiel: ACMEApp BuilderDev

    • Beschreibung: Eine Beschreibung der App Builder-Umgebung oder -Anwendung.

      Beispiel: Entwicklung von App Builder-Anwendungen bei ACME.

    • Website: URL der App Builder-Webanwendung.

      Beispiel: https://dev.example.com/Vinyl/

  3. Stimmen Sie der Entwicklervereinbarung zu

  4. Klicken Sie auf die Schaltfläche Ihre Twitter-Anwendung erstellen

  5. Notieren Sie sich unter Anwendungseinstellungen die folgenden Eigenschaften:

    • Nur-App-Authentifizierung: Dies wird der Wert des TokenEndpoint sein, wenn Sie den HTTP-Sicherheitsanbieter im App Builder konfigurieren.

      Beispiel: https://api.twitter.com/oauth2/token

  6. Klicken Sie unter Anwendungseinstellungen auf den Link Schlüssel und Zugriffstoken verwalten

  7. Notieren Sie sich die folgenden Eigenschaften:

    • Consumer Key (API-Schlüssel): Dies wird der Wert des ClientId sein, wenn Sie den HTTP-Sicherheitsanbieter im App Builder konfigurieren.
    • Consumer Secret (API-Geheimnis): Dies wird der Wert des ClientSecret sein, wenn Sie den HTTP-Sicherheitsanbieter im App Builder konfigurieren.

Erstellen eines Twitter-HTTP-Sicherheitsanbieters

Um einen HTTP-Sicherheitsanbieter zu erstellen, melden Sie sich zunächst als Administrator bei App Builder an.

  1. Navigieren Sie zum IDE
  2. Wählen Sie die Schaltfläche Sicherheitsanbieter
  3. Klicken Sie im Panel Benutzerauthentifizierung auf die Schaltfläche + Benutzerauthentifizierung

  4. Geben Sie Folgendes an:

    • Name: Twitter
    • Typ: HTTP

    • Priorität: Eine eindeutige Ganzzahl zwischen 10 und 100. Beachten Sie, dass dieser Wert eindeutig sein muss.

      Beispiel: 50

    • Aktiviert: Ankreuzen

  5. Klicken Sie auf die Schaltfläche Speichern

  6. Legen Sie die folgenden Eigenschaften fest. Klicken Sie im Panel Eigenschaften auf die Schaltfläche + Eigenschaft → Wählen Sie den Parameter aus → Geben Sie den Wert an → Klicken Sie auf das Speichern-Symbol.

    • AuthenticationType: ClientCredentials

    • TokenEndpoint: Der {App-only Authentication} Endpunkt, der von Twitter bereitgestellt wird.

      Beispiel: https://api.twitter.com/oauth2/token

    • ClientId: Der {Consumer Key}, der von Twitter bereitgestellt wird

    • ClientSecret: Der {Consumer Secret}, der von Twitter bereitgestellt wird

Erstellen einer Twitter-Datenquelle

Um eine Twitter-Datenquelle zu erstellen, melden Sie sich zunächst als Administrator bei App Builder an.

  1. Navigieren Sie zum IDE
  2. Wählen Sie die Schaltfläche Datenserver
  3. Klicken Sie im Panel Datenserver auf die Schaltfläche + Server

  4. Geben Sie Folgendes an:

    • Name: Twitter
    • Typ: REST API
    • URL: https://api.twitter.com/1.1/
    • Sicherheitsanbieter: Twitter

  5. Klicken Sie auf die Schaltfläche Speichern

  6. Klicken Sie auf das Tabellen-Symbol, um die Endpunktinformationen hinzuzufügen
  7. Klicken Sie im Panel Endpunkte auf die Schaltfläche + Endpunkt

  8. Geben Sie Folgendes an:

    • Name: user_timeline
    • Endpunkt: statuses/user_timeline.json

  9. Klicken Sie auf die Schaltfläche Speichern

  10. Klicken Sie auf das Schließen-Symbol (X), um das Endpunkt-Popup zu schließen
  11. Klicken Sie im Panel Endpunktparameter auf die Schaltfläche + Parameter

  12. Geben Sie Folgendes an:

    • Name: screen_name
    • Datentyp: String
    • Testwert: twitterapi

  13. Klicken Sie auf Speichern

  14. Klicken Sie auf das Schließen-Symbol (X), um das Popup für Eingabeparameter zu schließen
  15. Klicken Sie im Panel für Webdienstparameter auf die Schaltfläche + Parameter

  16. Geben Sie Folgendes an:

    • Name: count
    • Datentyp: Integer
    • Verwendung: Anfragegrenze

  17. Klicken Sie auf das Schließen-Symbol (X), um das Popup für Webdienstparameter zu schließen

  18. Klicken Sie im Panel für Endpunkte auf die Schaltfläche Entdecken

    Dieser Entdeckungsprozess füllt das Panel für Ausgabetabellen aus.

  19. Suchen Sie im Panel Ausgabetabellen die Tabelle user_timeline und klicken Sie auf das Inhaltsymbol.

Wenn alles korrekt konfiguriert wurde, sollten Sie eine Timeline für das twitterapi-Konto sehen.