Erste Schritte

Sie können einen benutzerdefinierten Connector aus einer leeren Canvas oder einer API-Spezifikation erstellen.

Bevor Sie einen Connector erstellen, machen Sie sich zunächst mit den verfügbaren Authentifizierungstypen vertraut.

Authentifizierungstypen

In diesem Abschnitt werden die gängigsten Authentifizierungstypen erläutert, die im Connector Builder verfügbar sind. Er beinhaltet einen Vergleich zwischen drei Authentifizierungstypen in Bezug auf Anwendungsfall, Authentifizierungsfluss und Sicherheit. Weitere Informationen finden Sie unter Authentifizierungstypen.

Flow des OAuth 2.0-Autorisierungscodes

• Ideal für Anwendungen, die im Namen des Benutzers auf Benutzerdaten zugreifen müssen.
• Hohe Sicherheit: Das Zugriffstoken wird nie dem Benutzer-Agenten ausgesetzt und von Server zu Server ausgetauscht.

Ablauf:

1. Benutzerautorisierung: Der Benutzer wird zum Autorisierungsserver umgeleitet, um Zugriff zu gewähren.
2. Autorisierungscode: Wenn der Benutzer Zugriff gewährt, wird ein Autorisierungscode an den Client zurückgegeben.
3. Tokenaustausch: Der Client tauscht den Autorisierungscode für ein Zugriffstoken am Tokenendpunkt aus.

OAuth 2.0: Code-Flow für Client-Anmeldeinformationen

• Geeignet für Server-zu-Server-Interaktionen, bei denen keine Benutzerinteraktion beteiligt ist.
• Moderate Sicherheit: Sie hängt davon ab, dass die Client-Anmeldeinformationen sicher aufbewahrt werden.

Ablauf:

1. Direkte Tokenanforderung: Der Client fordert ein Zugriffstoken direkt vom Autorisierungsserver mithilfe seiner Client-Anmeldeinformationen an.
2. Zugriffstoken: Der Autorisierungsserver gibt ein Zugriffstoken zurück

API-Schlüssel

• Einfach und schnell zu implementieren, wird häufig für öffentliche APIs verwendet.
• Niedrige Sicherheit: API-Schlüssel können einfach freigegeben oder offengelegt werden.

Ablauf:

Verwendung des API-Schlüssels: Der Benutzer gibt in jeder Anforderung zur Authentifizierung einen API-Schlüssel an.

Auswählen eines Authentifizierungsflows

In Beispiel A: Erstellen eines Connectors aus einer leeren Canvas mit Authentifizierung mit persönlichem Zugriffstoken verwenden wir den Authentifizierungstyp „Personal Access Token (PAT)“. Das Bild-API-Beispiel generieren folgt der Standardpraktiken der Verwendung des Autorisierungsheaders mit dem Bearer-Schema für den API-Schlüssel, insbesondere für OAuth 2.0-Token.

Einige APIs, z. B. SAP S4 ODataV2-Ressourcen, verwenden einen benutzerdefinierten Header wie den API-Schlüssel, um die Anwendung zu authentifizieren. Dies wird in Beispiel B verwendet: Erstellen eines Connectors aus einer leeren Canvas mit API-Schlüsselauthentifizierung.

Beispiel C: Erstellen eines Connectors aus einer API-Spezifikation mit der Authentifizierung der OAuth 2.0-Client-Anmeldeinformationen verwendet den OAuth 2.0-Flow der Client-Anmeldeinformationen mit einer OAuth 2.0-Anwendung.