Authentifizierter REST-Aufruf

Das Task Authentifizierter REST-Aufruf führt eine HTTP-Anfrage an einen externen Dienst durch. Es unterstützt anonyme Anfragen, Basic- oder Bearer-Authentifizierung, benutzerdefinierte Header, den Anfragekörper und Proxys.

Konfiguration

Feld	Beschreibung
SSL-Verbindung	Gibt an, ob eine gesicherte Verbindung verwendet werden soll.
Proxy	Verwendet die Systemeinstellung, keinen Proxy oder einen benutzerdefinierten Proxy.
Proxy-Adresse	Nur erforderlich, wenn ein benutzerdefinierter Proxy ausgewählt wird.
URL	Adresse des Dienstes. Kann dynamische Workflow-Parameter enthalten.
Authentifizierung	Keine, Basic oder Bearer.
Benutzername und Passwort	Anmeldeinformationen, die von der Basic-Authentifizierung verlangt werden.
Token	Anmeldeinformation, die von der Bearer-Authentifizierung verlangt wird.
Methode	GET, POST oder PUT.
Header	JSON-Liste der zu sendenden Header.
Body	Anfragekörper; nicht für die Methode GET vorgesehen.

Header werden als Liste von Strings dargestellt:

[
  "Content-Type: application/json",
  "Accept-Language: it-IT"
]

Im Body können Sybot-Parameter verwendet werden. In diesem Beispiel stammen die Werte von vorhergehenden Tasks:

string:{
  "documento": "#>document_name<#",
  "stato": "#>document_status<#"
}

Geben Sie Anmeldeinformationen nicht direkt in Header oder den Body ein, wenn dafür entsprechende Authentifizierungsfelder vorhanden sind. Vermeiden Sie außerdem, Passwörter, Token oder vertrauliche Inhalte in Tasknamen und in den für Logs vorgesehenen Nachrichten zu wiedergeben.

Ergebnisse

Das Task stellt Folgendes zur Verfügung:

• die Header und den Antwortkörper;
• den HTTP-Statuscode;
• das Ergebnis der Operation;
• eine strukturierte Zusammenfassung der Ausführung.

Verwenden Sie den HTTP-Code und den Inhalt der Antwort in nachfolgenden Bedingungen. Ein Code 2xx deutet normalerweise auf eine akzeptierte Anfrage hin, während die Codes 4xx und 5xx eine Fehlerbehandlung erfordern, die im Workflow vorgesehen ist.

Überprüfung

Führen Sie den Aufruf zunächst mit synthetischen Daten durch und überprüfen Sie in Logs die Methode, den Antwortcode und etwaige Diagnosemeldungen. Sensible Daten dürfen nicht in Variablen kopiert werden, die für Benachrichtigungen oder öffentliche Dateien bestimmt sind.