Zum Inhalt springen

Twitter in Jitterbit App Builder konfigurieren

App Builder bietet keine native Unterstützung für Twitter, weder als Authentifizierungs- noch als Datenprovider. Da die Twitter-API jedoch grundsätzlich eine REST-API ist, die mit dem OAuth Client Credential Flow gesichert wird, lässt sich App Builders generischer HTTP-Sicherheitsprovider nutzen, um Daten von Twitter abzurufen.

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

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

Die wichtigsten Aufgaben sind:

  1. App Builder als Twitter-Anwendung registrieren.
  2. Einen Twitter-HTTP-Sicherheitsprovider erstellen
  3. Eine Twitter-Datenquelle erstellen.

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

App Builder als Twitter-Anwendung registrieren

Melden Sie sich zunächst auf der Twitter Application Management-Website an.

https://apps.twitter.com/

  1. Klicken Sie auf die Schaltfläche Create New App (oben rechts)

  2. Geben Sie die folgenden Informationen ein:

    • Name: Ein aussagekräftiger Name für die App Builder-Umgebung oder -Anwendung.

      Beispiel: ACMEApp BuilderDev

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

      Beispiel: App Builder-Anwendungsentwicklung 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 Create your Twitter application

  5. Notieren Sie sich unter Application Settings die folgenden Eigenschaften:

    • App-only authentication: Dies ist der Wert des TokenEndpoint beim Konfigurieren des HTTP-Sicherheitsproviders in App Builder.

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

  6. Klicken Sie unter Application Settings auf den Link manage keys und access tokens

  7. Notieren Sie sich die folgenden Eigenschaften:

    • Consumer Key (API Key): Dies ist der Wert der ClientId beim Konfigurieren des HTTP-Sicherheitsproviders in App Builder.
    • Consumer Secret (API Secret): Dies ist der Wert der ClientSecret beim Konfigurieren des HTTP-Sicherheitsproviders in App Builder.

Einen Twitter-HTTP-Sicherheitsprovider erstellen

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

  1. Navigieren Sie zur IDE
  2. Wählen Sie die Schaltfläche Security Providers aus
  3. Klicken Sie auf die Schaltfläche + Security Provider

  4. Geben Sie Folgendes ein:

    • Name: Twitter
    • Type: HTTP

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

      Beispiel: 50

    • Enabled: Aktiviert

  5. Klicken Sie auf die Schaltfläche Save

  6. Legen Sie die folgenden Eigenschaften fest. Klicken Sie im Properties-Bereich auf die Schaltfläche + Property → Wählen Sie den Parameter → Geben Sie den Value ein → Klicken Sie auf das Save-Symbol.

    • AuthenticationType: ClientCredentials

    • TokenEndpoint: Der {App-only Authentication}-Endpunkt von Twitter.

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

    • ClientId: Der {Consumer Key} von Twitter

    • ClientSecret: Das {Consumer Secret} von Twitter

Eine Twitter-Datenquelle erstellen

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

  1. Navigieren Sie zur IDE
  2. Wählen Sie die Schaltfläche Data Servers aus
  3. Klicken Sie im Data Servers-Bereich auf die Schaltfläche + Server

  4. Geben Sie Folgendes ein:

    • Name: Twitter
    • Type: REST API
    • URL: https://api.twitter.com/1.1/
    • Security Provider: Twitter

  5. Klicken Sie auf die Schaltfläche Save

  6. Klicken Sie auf das Symbol Tables, um die Endpunktinformationen hinzuzufügen
  7. Klicken Sie im Endpoints-Bereich auf die Schaltfläche + Endpoint

  8. Geben Sie Folgendes ein:

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

  9. Klicken Sie auf die Schaltfläche Save

  10. Klicken Sie auf das Symbol Close (X), um das Endpoint-Popup zu schließen
  11. Klicken Sie im Endpoint Parameters-Bereich auf die Schaltfläche + Parameter

  12. Geben Sie Folgendes ein:

  13. Name: screen_name

  14. Data type: String

  15. Test value: twitterapi

  16. Klicken Sie auf Speichern

  17. Klicken Sie auf das Symbol Schließen (X), um das Popup „Input Parameter" zu schließen
  18. Klicken Sie im Bereich „Web Service Parameters" auf die Schaltfläche + Parameter

  19. Geben Sie Folgendes an:

    • Name: count
    • Data type: Integer
    • Usage: Request Limit

  20. Klicken Sie auf das Symbol Schließen (X), um das Popup „Web Service Parameter" zu schließen

  21. Klicken Sie im Bereich „Endpoints" auf die Schaltfläche Discover

    Dieser Erkennungsprozess füllt den Bereich „Output Tables" auf.

  22. Suchen Sie im Bereich Output Tables die Tabelle user_timeline und klicken Sie auf das Inhaltssymbol.

Falls alles korrekt konfiguriert wurde, sollte ein Zeitstrahl für das Konto twitterapi angezeigt werden.