Stellen Sie eine Verbindung zu Diensten und APIs von Drittanbietern her (generisch)

Um eine Verbindung zu Diensten von Drittanbietern herzustellen, verwenden Sie den API-Konnektor

1. Wählen Sie im linken Navigationsbereich im Abschnitt Verwalten die Option Connectors aus. Sie werden zu einer Seite weitergeleitet, auf der eine Liste der vorhandenen Konnektoren mit einigen Details zu den einzelnen Konnektoren angezeigt wird.

2. Wählen Sie + Connector erstellen.

3. Wählen Sie API-Connector. Konfigurieren Sie nun Ihren Connector, indem Sie die folgenden Felder ausfüllen.

4. Connectorname: Geben Sie einen Namen für Ihren Connector ein.

5. Beschreibung des Connectors: Geben Sie eine Beschreibung für Ihren Connector ein.

6. Basis-URL: Die Website oder der Host der Drittanbieter-Verbindung. Beispiel, www.slack.com.

7. Authentifizierungsmethode: Wählen Sie die Methode für die Authentifizierung beim Zieldienst.

   • Keine: Greifen Sie ohne Authentifizierung auf den Zieldienst zu.

   • Einfach: Greifen Sie mit einem Benutzernamen und einem Passwort auf den Zieldienst zu, mit dem eine Verbindung hergestellt wird.

   • Bearer-Token: Greifen Sie mithilfe des Token-Werts eines Authentifizierungstokens auf den Zieldienst zu, der über das Benutzerkonto oder die API-Einstellungen des Dienstes abgerufen wurde.

   • OAuth 2.0: Greifen Sie mit dem OAuth 2.0-Protokoll auf den Zieldienst zu, das App Studio Zugriff auf den Dienst und die Ressourcen gewährt, ohne Anmeldeinformationen oder Identitäten weiterzugeben. Um die OAuth 2.0-Authentifizierungsmethode zu verwenden, müssen Sie zunächst eine Anwendung aus dem Dienst erstellen, mit dem eine Verbindung hergestellt wird und die App Studio repräsentiert, um die erforderlichen Informationen zu erhalten. Füllen Sie mit diesen Informationen die folgenden Felder aus:

     1. Übertragung von Client-Anmeldeinformationen: Ideal für System-zu-System-Interaktionen, bei denen die Anwendung in eigenem Namen ohne Benutzerinteraktion handelt. Zum Beispiel eine CRM-App, die Salesforce-Datensätze automatisch auf der Grundlage neuer Datensätze aktualisiert, die von Benutzern hinzugefügt wurden, oder eine App, die Transaktionsdaten abruft und in Berichten anzeigt.

        1. Geben Sie im Feld Client-ID die ID ein, die Sie von der im Zieldienst erstellten OAuth-App erhalten haben.

        2. Geben Sie im Feld Client Secret den Schlüssel ein, den Sie von der im Zieldienst erstellten OAuth-App erhalten haben.

        3. Geben Sie im Feld Zugriffstoken-URL die Token-URL ein, die Sie von der im Zieldienst erstellten OAuth-App erhalten haben.

        4. Geben Sie optional im Feld Bereiche die Bereiche für die Anwendung ein. Bereiche sind Berechtigungen oder Zugriffsebenen, die für die Anwendung erforderlich sind. Lesen Sie in der API-Dokumentation des Zieldienstes nach, um deren Bereiche zu verstehen, und konfigurieren Sie nur die Bereiche, die Ihre App Studio-App benötigt.

        Wählen Sie Verbindung verifizieren, um die Authentifizierung und Verbindung zu testen.

     2. Ablauf des Autorisierungscodes: Ideal für Anwendungen, bei denen im Namen eines Benutzers gehandelt werden muss. Zum Beispiel eine Kundensupport-App, bei der sich Benutzer anmelden und Supporttickets einsehen und aktualisieren, oder eine Vertriebs-App, bei der sich jedes Teammitglied anmeldet, um seine Verkaufsdaten einzusehen und zu verwalten.

        1. Geben Sie im Feld Client-ID die ID ein, die Sie von der im Zieldienst erstellten OAuth-App erhalten haben.

        2. Geben Sie im Feld Client Secret den Schlüssel ein, den Sie von der im Zieldienst erstellten OAuth-App erhalten haben.

        3. Geben Sie im Feld Autorisierungs-URL die Autorisierungs-URL des Zieldienstes ein.

        4. Geben Sie im Feld Zugriffstoken-URL die Token-URL ein, die Sie von der im Zieldienst erstellten OAuth-App erhalten haben.

        5. Geben Sie optional im Feld Bereiche die Bereiche für die Anwendung ein. Bereiche sind Berechtigungen oder Zugriffsebenen, die für die Anwendung erforderlich sind. Lesen Sie in der API-Dokumentation des Zieldienstes nach, um deren Bereiche zu verstehen, und konfigurieren Sie nur die Bereiche, die Ihre App Studio-App benötigt.

8. Header: Fügen Sie HTTP-Header hinzu, die verwendet werden, um Metadaten zur Anfrage oder Antwort bereitzustellen. Sie können sowohl Schlüssel als auch Werte hinzufügen oder nur einen Schlüssel angeben, für den der Builder einen Wert in der Anwendung bereitstellen kann.

9. Abfrageparameter: Fügen Sie Abfrageparameter hinzu, die verwendet werden, um Optionen, Filter oder Daten als Teil der Anforderungs-URL zu übergeben. Wie bei Headern können Sie sowohl einen Schlüssel als auch einen Wert angeben oder nur einen Schlüssel angeben, für den der Builder in der Anwendung einen Wert bereitstellen kann.

10. Wählen Sie Erstellen aus. Der neu erstellte Connector wird in der Connectors-Liste angezeigt.