HTTP-Authentifizierung

Voraussetzungen

Um eine Verbindung mit dem HTTP-Connector zu erstellen, müssen Sie die für den ausgewählten Authentifizierungstyp erforderlichen Details angeben. In den folgenden Abschnitten finden Sie Informationen zu den für jeden Authentifizierungstyp erforderlichen Details. Informationen zum Abrufen dieser Details finden Sie in der Dokumentation des API-Anbieters.

UiPath-Benutzerzugriffstoken

Stellen Sie eine Verbindung über unterstützte UiPath-Dienste her. Keine Konfiguration erforderlich.

OAuth 2.0: Autorisierungscode

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Client-ID – Die eindeutige Kennung für Ihre Anwendung, die von Ihrem OAuth-Anbieter während der App-Registrierung bereitgestellt wird.
• Client-Geheimnis – Der vertrauliche geheime Schlüssel für Ihre Anwendung, wie von Ihrem OAuth-Anbieter bereitgestellt.
• Autorisierungs-URL – die URL des vollständigen Autorisierungsendpunkts, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/authorize).
• Token-URL – Die Token-Endpunkt-URL, unter der Autorisierungscodes oder Anmeldeinformationen für Zugriffstoken ausgetauscht werden, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/token).
• Scope – Die erforderlichen OAuth-Scopes, basierend auf Ihrem API-Anbieter oder Ihren Integrationsanforderungen.

Zusätzliche Konfiguration:

• URL des Aktualisierungstokens – Die Endpunkt-URL des Aktualisierungstokens, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://example.com/docs/oauth/refresh)
• URL für Tokenwiderruf – Die Endpunkt-URL des Tokenwiderrufs, wie von Ihrem OAuth-Anbieter bereitgestellt (https://example.com/docs/oauth/revoke).
• Aktualisierungsintervall – Zeit in Sekunden zwischen den Aktualisierungsversuchen des OAuth-Tokens.
• OAuth-Basisheader – Aktivieren Sie diese Option, um die Client-ID und den geheimen Schlüssel als einfachen Authentifizierungsheader während des OAuth-Tokenaustauschs zu senden. Bei den meisten Anbietern ist dies aktiviert.

OAuth 2.0-Autorisierungscode mit PKCE

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Client-ID – Die eindeutige Kennung für Ihre Anwendung, die von Ihrem OAuth-Anbieter während der App-Registrierung bereitgestellt wird.
• Client-Geheimnis – Der vertrauliche geheime Schlüssel für Ihre Anwendung, wie von Ihrem OAuth-Anbieter bereitgestellt.
• Autorisierungs-URL – die URL des vollständigen Autorisierungsendpunkts, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/authorize).
• Token-URL – Die Token-Endpunkt-URL, unter der Autorisierungscodes oder Anmeldeinformationen für Zugriffstoken ausgetauscht werden, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/token).
• Scope – Die erforderlichen OAuth-Scopes, basierend auf Ihrem API-Anbieter oder Ihren Integrationsanforderungen.

Zusätzliche Konfiguration:

• URL des Aktualisierungstokens – Die Endpunkt-URL des Aktualisierungstokens, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://example.com/docs/oauth/refresh)
• URL für Tokenwiderruf – Die Endpunkt-URL des Tokenwiderrufs, wie von Ihrem OAuth-Anbieter bereitgestellt (https://example.com/docs/oauth/revoke).
• Aktualisierungsintervall – Zeit in Sekunden zwischen den Aktualisierungsversuchen des OAuth-Tokens.
• OAuth-Basisheader – Aktivieren Sie diese Option, um die Client-ID und den geheimen Schlüssel als einfachen Authentifizierungsheader während des OAuth-Tokenaustauschs zu senden. Bei den meisten Anbietern ist dies aktiviert.

OAuth 2.0: Client-Anmeldeinformationen

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Client-ID – Die eindeutige Kennung für Ihre Anwendung, die von Ihrem OAuth-Anbieter während der App-Registrierung bereitgestellt wird.
• Client-Geheimnis – Der vertrauliche geheime Schlüssel für Ihre Anwendung, wie von Ihrem OAuth-Anbieter bereitgestellt.
• Token-URL – Die Token-Endpunkt-URL, unter der Autorisierungscodes oder Anmeldeinformationen für Zugriffstoken ausgetauscht werden, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/token).
• Scope – Die erforderlichen OAuth-Scopes, basierend auf Ihrem API-Anbieter oder Ihren Integrationsanforderungen.

Zusätzliche Konfiguration:

• Aktualisierungsintervall – Zeit in Sekunden zwischen den Aktualisierungsversuchen des OAuth-Tokens.
• OAuth-Basisheader – Aktivieren Sie diese Option, um die Client-ID und den geheimen Schlüssel als einfachen Authentifizierungsheader während des OAuth-Tokenaustauschs zu senden. Bei den meisten Anbietern ist dies aktiviert.

OAuth 2.0-Kennwort

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Benutzername - Der Benutzername des Endbenutzers für die Authentifizierung.
• Kennwort - Das Kennwort des Endbenutzers für die Authentifizierung.
• Client-ID – Die eindeutige Kennung für Ihre Anwendung, die von Ihrem OAuth-Anbieter während der App-Registrierung bereitgestellt wird.
• Client-Geheimnis – Der vertrauliche geheime Schlüssel für Ihre Anwendung, wie von Ihrem OAuth-Anbieter bereitgestellt.
• Autorisierungs-URL – die URL des vollständigen Autorisierungsendpunkts, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/authorize).
• Token-URL – Die Token-Endpunkt-URL, unter der Autorisierungscodes oder Anmeldeinformationen für Zugriffstoken ausgetauscht werden, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/token).
• Scope – Die erforderlichen OAuth-Scopes, basierend auf Ihrem API-Anbieter oder Ihren Integrationsanforderungen.

Zusätzliche Konfiguration:

• URL des Aktualisierungstokens – Die Endpunkt-URL des Aktualisierungstokens, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://example.com/docs/oauth/refresh).
• URL für Tokenwiderruf – Die Endpunkt-URL des Tokenwiderrufs, wie von Ihrem OAuth-Anbieter bereitgestellt (https://example.com/docs/oauth/revoke).
• Aktualisierungsintervall – Zeit in Sekunden zwischen den Aktualisierungsversuchen des OAuth-Tokens.
• OAuth-Basisheader – Aktivieren Sie diese Option, um die Client-ID und den geheimen Schlüssel als einfachen Authentifizierungsheader während des OAuth-Tokenaustauschs zu senden. Bei den meisten Anbietern ist dies aktiviert.

Einfache Authentifizierung

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Benutzername – Die Benutzernamen-Anmeldeinformationen für Ihr API-Konto.
• Kennwort – Die Kennwort-Anmeldeinformationen für Ihr API-Konto.

Zusätzliche Konfiguration:

• Authentifizierungsvalidierungs-API – Geben Sie den relativen Pfad ein, der zum Überprüfen Ihrer Authentifizierungsanmeldeinformationen verwendet wird (z. B /api/v1/me, /user/profile, /auth/validate). Diese API-Route sollte eine erfolgreiche Antwort zurückgeben, wenn Ihre Anmeldeinformationen gültig sind.

API-Schlüssel

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Parametername – Der genaue Name des API-Schlüsselparameters, wie von Ihrer API benötigt (z. B X-API-Key, api_key, Authorization). Dies wird basierend auf Ihrer Auswahl entweder als Headername oder als Abfrageparametername verwendet.
• Wert – Ihr vollständiger API-Schlüsselwert, wie von Ihrem API-Anbieter bereitgestellt. Dies wird sicher gespeichert und für die Authentifizierung verwendet.

Zusätzliche Konfiguration:

• Hinzufügen zu – Wählen Sie aus, ob der API-Schlüssel im Anforderungsheader oder als Abfrageparameter hinzugefügt werden soll. Header wird für höhere Sicherheit empfohlen.
• Authentifizierungsvalidierungs-API – Geben Sie den relativen Pfad ein, der zum Überprüfen Ihrer Authentifizierungsanmeldeinformationen verwendet wird (z. B /api/v1/me, /user/profile, /auth/validate). Diese API-Route sollte eine erfolgreiche Antwort zurückgeben, wenn Ihre Anmeldeinformationen gültig sind.

OAuth 2.0 JWT Bearer

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Client-ID – Die eindeutige Kennung für Ihre Anwendung, die von Ihrem OAuth-Anbieter während der App-Registrierung bereitgestellt wird.
• Client-Geheimnis – Der vertrauliche geheime Schlüssel für Ihre Anwendung, wie von Ihrem OAuth-Anbieter bereitgestellt.
• JWT: Base64-codierter Schlüssel – Ihr Base64-codierter privater Schlüssel. Stellen Sie sicher, dass Sie die Anweisungen Ihres API-Anbieters zur Schlüsselgenerierung und -codierung befolgen.
• Autorisierungs-URL – die URL des vollständigen Autorisierungsendpunkts, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/authorize).
• Token-URL – Die Token-Endpunkt-URL, unter der Autorisierungscodes oder Anmeldeinformationen für Zugriffstoken ausgetauscht werden, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://login.example.com/oauth2/token).
• Scope – Die erforderlichen OAuth-Scopes, basierend auf Ihrem API-Anbieter oder Ihren Integrationsanforderungen.

Zusätzliche Konfiguration:

• URL des Aktualisierungstokens – Die Endpunkt-URL des Aktualisierungstokens, wie von Ihrem OAuth-Anbieter bereitgestellt (z. B https://example.com/docs/oauth/refresh).
• URL für Tokenwiderruf – Die Endpunkt-URL des Tokenwiderrufs, wie von Ihrem OAuth-Anbieter bereitgestellt (https://example.com/docs/oauth/revoke).
• Aktualisierungsintervall – Zeit in Sekunden zwischen den Aktualisierungsversuchen des OAuth-Tokens.
• OAuth-Basisheader – Aktivieren Sie diese Option, um die Client-ID und den geheimen Schlüssel als einfachen Authentifizierungsheader während des OAuth-Tokenaustauschs zu senden. Bei den meisten Anbietern ist dies aktiviert.

Persönliches Zugriffstoken

Geben Sie die folgenden Details an:

• Verbindungsname – Ein beschreibender Name, um Ihnen bei der Identifizierung dieser Verbindung zu helfen.
• Basis-URL – Die Basis-URL Ihrer API (z. B https://api.example.com).
• Tokenpräfix – Das Tokenpräfix (z. B Bearer, Token, Basic). Dies wird mit Ihrem Token im Autorisierungsheader kombiniert. Leer lassen, wenn kein Präfix erforderlich ist.
• Token – Der vollständige Wert des persönlichen Zugriffstokens. Dies wird mit dem Tokentyp im Autorisierungsheader kombiniert (z. B Bearer your-token-here).

Zusätzliche Konfiguration:

• Authentifizierungsvalidierungs-API – Geben Sie den relativen Pfad ein, der zum Überprüfen Ihrer Authentifizierungsanmeldeinformationen verwendet wird (z. B /api/v1/me, /user/profile, /auth/validate). Diese API-Route sollte eine erfolgreiche Antwort zurückgeben, wenn Ihre Anmeldeinformationen gültig sind.

Fügen Sie die HTTP-Verbindung hinzu

1. Wählen Sie Integration Service in der linken Leiste.
2. Wählen Sie in der Liste Konnektoren die Option HTTP aus. Sie können auch die Suchleiste verwenden, um den Connector zu finden.
3. Wählen Sie die Schaltfläche Verbindung mit HTTP herstellen aus.
4. Geben Sie auf dem Verbindungsbildschirm die erforderlichen Details an.
5. Select Connect.
6. Ihre Verbindung wurde hinzugefügt.