Altova MapForce 2024 Enterprise Edition

Navigation: Komplexe Mappings > Ausführen von Mappings mit Authentifizierung

Dynamische Authentifizierung

Bei der dynamischen Authentifizierung werden Benutzername und Passwort zur Laufzeit als Input-Parameter an das Mapping übergeben. Die dynamische Authentifizierung wird für Mappings unterstützt, die Webservices aufrufen, für die eine einfache HTTP-Authentifizierung erforderlich ist.

So richten Sie eine dynamische Authentifizierung ein:

1.Öffnen Sie ein Mapping, das einen Webservice-Aufruf enthält oder fügen Sie einen Webservice zu einem neuen Mapping hinzu. Nähere Informationen dazu finden Sie unter Hinzufügen eines Webservice-Aufrufs (REST) und Hinzufügen eines (SOAP)-Webservice-Aufrufs.

2.Doppelklicken Sie auf die Titelleiste der Webservice-Komponente, um das Einstellungsdialogfeld zu öffnen.

3.Klicken Sie neben "HTTP-Sicherheitseinstellungen" auf Bearbeiten..

4.Wählen Sie die Option Dynamische Authentifizierung aus.

5.Klicken Sie auf OK.

Sobald die dynamische Authentifizierung aktiviert wurde, erhält die "Request"-Seite der Webservice-Komponente zwei neue Input-Konnektoren: HTTP-Benutzername und HTTP-Passwort. Um die tatsächlichen Werte bereitzustellen, fügen Sie mit dem Menübefehl Einfügen | Input-Komponente einfügen zwei neue Input-Komponenten zum Mapping hinzu und verbinden Sie diese mit dem HTTP-Benutzernamen bzw. dem HTTP-Passwort.

Um in MapForce eine Vorschau auf das Mapping anzuzeigen, können Sie den Benutzernamen und das Passwort optional als "Design-time-Ausführungswerte" bereitstellen. Doppelklicken Sie dazu auf die Titelleiste der jeweiligen Input-Komponente und geben Sie den Benutzernamen bzw. das Passwort in das Textfeld Wert ein. Nähere Informationen dazu finden Sie unter Bereitstellen von Parametern für das Mapping.

Benutzername und Passwort werden genau wie jeder andere Design-Time-Ausführungswert behandelt. Daher werden sie in der Mapping-Design-Datei in Form von Klartext gespeichert. Um dies zu verhindern, geben Sie gar keine Design-Time-Ausführungswerte ein oder verwenden Sie die Methode "Anmeldeinformationen".

Dynamische Authentifizierung in MapForce Server

Wenn Sie das Mapping für eine dynamische Authentifizierung konfiguriert haben, müssen der entsprechende Benutzername und das entsprechende Passwort zur Mapping-Laufzeit genau wie bei der Bereitstellung anderer Parameterarten als Parameter bereitgestellt werden. Wenn Sie z.B. MapForce Server über die Befehlszeile aufrufen, lautet die Syntax für ein Mapping wie das oben beschriebene folgendermaßen:

<exec> run mapping.mfx --p=username:admin --p=password:dj9JaVax

Wobei:

•<exec> der Pfad zur ausführbaren MapForce Server-Datei ist. Dabei kann es sich entweder um einen absoluten Pfad handeln oder Sie können einfach nur den Namen der ausführbaren Datei angeben, wenn das aktuelle Verzeichnis dasselbe wie das der ausführbaren Datei ist.

•username und password die Namen der entsprechenden Input-Parameter im MapForce Mapping sind.

Bei Aufruf der MapForce Server API können Sie das Mapping durch Aufruf der Methode AddParameter authentifizieren, bevor Sie die Methode Run aufrufen. Der Code dafür in C#, könnte folgendermaßen aussehen:

try
{
Altova.MapForceServer.Server mfs = new Altova.MapForceServer.Server();
mfs.AddParameter("username", "admin");
mfs.AddParameter("password", "dj9JaVax");
mfs.WorkingDirectory = "C:\\Work";
if(mfs.Run("C:\\Work\\mapping.mfx"))
{
Console.WriteLine("Success");
}
else
{
Console.WriteLine(mfs.LastExecutionMessage);
}
Console.ReadLine();
}
catch(Exception ex)
{
Console.WriteLine(ex);
}

Auch hier müssen username und password (das erste Argument für die Methode AddParameter) mit den Namen der entsprechenden Input-Parameter im MapForce-Mapping identisch sein.

Dynamische Authentifizierung in FlowForce Server

Wenn Sie ein Mapping, das eine dynamische Authentifizierung enthält, auf FlowForce Server bereitstellen, werden der Benutzername und das Passwort zu Input-Parametern für die Mapping-Funktion. In jedem FlowForce Server-Auftrag, in dem eine solche Mapping-Funktion aufgerufen wird, werden vor einer erfolgreichen Ausführung der Benutzername und das Passwort benötigt, z.B:

Im oben gezeigten Beispiel werden der Benutzername und das Passwort einfach in die entsprechenden Textfelder eingegeben. Sie können diese jedoch auch in Form von Input-Parametern für den Auftrag bereitstellen. Nähere Informationen dazu finden Sie in der FlowForce Server-Dokumentation (https://www.altova.com/de/documentation).