Arbeiten mit der App

2024/11/22 • 5 Min. Lesedauer

In diesem Thema

Web Authentifizierung
Authentifizierung Felder
OAuth, Felder
Basic, Felder
Bearer Token, Felder
Verschlüsselung, Felder
API-Schlüssel, Felder
OAuth-extern, Felder
Aktionen
Web Messages
Felder
Funktionen
Web Message Headers
Felder
MultiPart/Form-Data Helper

Web Authentifizierung

In dieser Tabelle werden benötigte Endpunkte und deren Authentifizierungsart hinterlegt.

Authentifizierung Felder
Endpunkt URL	Gibt die Endpunkt URL.
Art	Gibt die Authentifizierungsart an.

OAuth, Felder
Mit dieser Authentifizierungsart können Token von Autorisierungsservern der Microsoft Identy Platform abgerufen werden. Als OAuth2 Flow wird die Option "Client Credentials unterstützt.
OAuth URL	Gibt den OAuth Token Endpunkt.
Client ID	Gibt die Client ID an.
Client Secret	Gibt das Client Secret.

Basic, Felder
Username	Gibt den Benutzernamen für die Basic Authentifizierung an.
Password	Gibt das Passwort für die Basic Authentifizierung an.

Bearer Token, Felder
Bearer Token Login Url	Gibt die Bearer Token Login Url an.
Requires Encryption	Gibt an, ob die Login Url die Anmeldedaten in verschlüsselter Form benötigt.
Bearer Token Json Key	Gibt den Schlüssel des Json Wertes der Http Antwort des Bearer Token Logins an, welcher den Bearer Token beinhaltet.
Username	Gibt den Benutzernamen für die Bearer Token Authentifizierung an.
Password	Gibt das Passwort für die Bearer Token Authentifizierung an.

Verschlüsselung, Felder
Verschlüsselungsalgorithmus	Gibt an, welcher Verschlüsselungsalgorithmus verwendet werden soll.
Kryptografischer Schlüssel	Gibt den Schlüssel einer schlüsselbasierten kryptografischen Funktion an.

API-Schlüssel, Felder
API-Schlüssel Header Name	Gibt den Namen des Header der Anfrage der für den API-Schlüssel verwendet werden soll an.
API-Schlüssel	Gibt den API-Schlüssel an.

OAuth-extern, Felder
Mit dieser Authentifizierungsart können Token von Autorisierungsservern ausßerhalb der Microsoft Identy Platform abgerufen werden. Als OAuth2 Flow wird die Option "Client Credentials unterstützt.
OAuth2 Flow	Gibt an, welchen OAuth 2.0 Flow Sie nutzen wollen.
OAuth URL	Gibt den OAuth Token Endpunkt.
Client ID	Gibt die Client ID an.
Client Secret	Gibt das Client Secret.
Scope	Gibt den Bereich für den Token an. Ist dies leer so wird * verwendet.

Aktionen

Anmeldeinformationen und Verbindung testen
Sendet eine HTTP GET Anfrage mit den angegebenen Anmeldeinformationen an den Endpunkt, um zu prüfen, ob der Endpunkt erreicht werden kann und ob die Anmeldeinformationen korrekt sind. Wenn die Bearer Token oder OAuth2 Authentifizierungsart verwendet wird, wird eine weitere Anfrage an die Token Url mit den gegebenen Anmeldeinformationen gesendet um zu überprüfen, ob diese korrekt sind und einen Authentifizierungstoken zurückliefern. Die Antwort des getesteten Webservices wird in einem Dialog ausgegeben.
Test Webrequest erstellen
Erstellt einen Test Webrequest mit dieser Anmeldeinformation.

Web Messages

Mit dieser Tabelle können HTTP Requests an die, in der Tabelle Web Authentifizierung, hinterlegten Endpunkte erstellt und gesendet werden. Die gesendeten Requests werden hier einen Monat lang gespeichert, dies muss allerdings in den Aufbewahrungsrichtlinien für die Tabelle mit der ID 61483 aktiviert werden.

Felder
Entry No.	Gibt die Nummer des Datensatzes an.
Date and Time	Gibt den Zeitstempel des Datensatzes an.
Method	Gibt die HTTP Request Methode an.
Target URL	Gibt die Ziel URL des Requests an.
Payload	Gibt den gesendeten Payload des Requests an.
Response	Gibt den Payload des empfangenen Responses an.
Response Reason Phrase	Gibt den http-Ursachentext des empfangenen Responses an.
Response Is Success Status	Gibt an, ob der Request akzeptiert oder abgelehnt wurde.
Response Status Code	Gibt den http-Ursachenstatuscode an.

Funktionen

CreateMessage

Parameter

RequestType Enum "Http Request Type" -> die HTTP Methode mit der der Request abgeschickt werden soll
TargetURL Text[250] -> die URL an welche die erstellte Message gesendet werden soll
RequestContent Text -> der Request Body

AddWebMessageHeader

Parameter

HeaderType Enum "WULWebMessageHeaderTypeNVX" -> die Art des HTTP Headers (Request oder Content Header)
Name Text -> der Name des Headers
Value Text -> der Wert des Headers

AddWebMessageAuthorization

Parameter

HeaderType Enum "WULWebMessageHeaderTypeNVX" -> die Art des HTTP Headers (Request oder Content Header)
WebAuthorization Record "WULWebAuthorizationNVX" -> die konfigurierte Anmeldemethode

SendMessage

Parameter

var ResponseMessage: HttpResponseMessage -> die Antwort des Webservices welcher den Request erhalten hat

procedure ExecuteWebService(Payload: Text; WebAuthorization: Record WULWebAuthorizationNVX; EndpointURL: Text)
var
    WebMessage: Record WULWebMessageNVX;
    ResponseMessage: HttpResponseMessage;
    BodyContent: Text;
    ResponseText: Text;
begin
    WebMessage.CreateMessage("Http Request Type"::POST, EndpointURL, BodyContent);
    WebMessage.AddWebMessageHeader(WULWebMessageHeaderTypeNVX::"Content Header", 'Content-Type', 'application/json');
    WebMessage.AddWebMessageAuthorization(WULWebMessageHeaderTypeNVX::"Request Header", WebAuthorization);
    Commit();
    WebMessage.SendMessage(ResponseMessage);
    Commit();
    ResponseText := WebMessage.GetResponse();
end;