5.2.3.1. Allgemeine Webservices

BA.Login.JWT

Dies ist ein allgemeiner Authentifizierungs-Webservice zur Authentifizierung an der Standard-REST-Schnittstelle einer Business App Instanz, bzw. zur Authentifizierung an allen REST-Webservices, die Benutzerdaten annehmen und in irgendeiner Form ein Bearer-Token zurückgeben.

Die Definition setzt voraus, dass dieser Webservice durch eine Modifizierung vervollständigt wird, bevor er verwendet werden kann. Diese Vervollständigung beinhaltet die Angabe einer URL und Benutzerdaten, mit welchen dieser Webservice aufgerufen werden soll.

Die ausgelieferte Definition dieses Webservices lautet:

<WebService id="BA.Login.JWT" displayName="4c7e8116-5543-4f02-aec0-be843b62883e" selectable="false" inboundModelType="BA.DataIntegration.WebServices.Impl.Authentication.JWTBearerToken">
    <Method>POST</Method>
    <Url/>
    <InboundMappings>
      <Mapping>
        <From>$.token</From>
        <To>Token</To>
      </Mapping>
    </InboundMappings>
</WebService>

Eine geeignete Modifizierung wäre zum Beispiel:

<WebServiceModification id="BA.Login.JWT">
    <Url>https://bapfud03.intraware.de/bacrm_jer3/api/auth/login</Url>
    <OutboundMappings>
      <Mapping>
        <From type="text">(Benutzer)</From>
        <To>Username</To>
      </Mapping>
      <Mapping>
        <From type="text">(Passwort)</From>
        <To>Password</To>
      </Mapping>
    </OutboundMappings>
</WebServiceModification>

Selbstverständlich können auch Mappings des Typs „formula“ verwendet werden, um die Zugangsdaten zum Beispiel aus den Anwendungseinstellungen auszulesen.

!Dieser Webservice kann nur mit einer bestimmten Instanz eines externen Systems verknüpft werden. Sollten sie JWT-Authentifizierung an mehreren externen Systemen benötigen, müssen Sie diesen Webservice zunächst kopieren und mit einer neuen ID versehen. Wir empfehlen, die IDs bei Anpassungen mit dem Begriff “Custom.” zu beginnen.