FSS Backend installieren

Bitte installieren Sie zunächst das FSS Backend Security Server Installation (REST).

Das Backend muss über Keycloak abgesichert werden, siehe unten.

FSS-UI mit Nginx installieren

Fügen Sie folgende Konfiguration zu der nginx.conf im Ordner nginx\conf hinzu

location /FSS-UI {
    alias  html/FSS-UI/;    
        try_files $uri$args $uri$args/ /FSS-UI/index.html;
}

location /FSS-UI/portalConfig/ {
    alias   html/B2B-Portal-UI/assets/config/portal-config.json;
}

location /FSS-UI/api/ {
    proxy_pass   http://localhost:2222/fss/api/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header        X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
}

location /FSS-UI/api/b2b-user-messages/system-messages {
    proxy_pass  <User Messages backend application url>/system-messages;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header        X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
}

Kopieren sie die FSS-UI-Daten in den Ordner nginx\html

Keycloak Konfiguration

Keycloak Client Konfiguration

FSS Service

Für den FSS-Backend-Service muss ein Keycloak Client angelegt werden.

Die ClientId kann von Ihnen selbst gewählt werden, z.B. fss.

Das Client Protocol bleibt auf openid-connect gestellt.

Beispiel für eine Redirect-URI: https://my-fss-server.

Es ist der Standardflow zu nutzen (standardmäßig aktiv).

Der Access Type ist auf confidential zu stellen.

Nachfolgend muss eine keycloak.json Datei aus Keycloak exportiert werden und in den conf Ordners des FSS Backends abgelegt werden.

WICHTIG: Die Keycloak-Einstellungen für das Backend sollten entweder in der application-secure.yml Datei oder in der keycloak.json Datei gemacht werden. Nicht in beiden! Wenn die keycloak.json Datei verwendet wird, dann darf in der application.yml das Profil nicht mehr auf secure stehen.

FSS-UI

Für die FSS-UI muss ein Keycloak Client angelegt werden.

Die ClientId kann von Ihnen selbst gewählt werden, z.B. fss-ui.

Die RootURL entspricht der externen Adresse des Frontends, z.B. https://my-fss-ui-server/FSS-UI.

Das Client Protocol bleibt auf openid-connect gestellt.

Es ist der Standardflow zu nutzen (standardmäßig aktiv).

Der Access Type ist public.

Als Login-Theme kann das nli Thema gewählt werden.

Passen Sie die Datei keycloak.json unter nginx\html\FSS-UI\assets\config mit der korrekten Konfiguration an. Beispiel: Konfiguration von keycloak.json a. Falls die Konfiguration unter fss-ui client für den Zugriffstyp public ist

{
  "auth-server-url": "http://localhost:8081/auth/",
  "realm": "b2b-qa",
  "resource": "fss-ui",
  "ssl-required": "none",
  "public-client": true,
  "confidential-port": 0
}

Keycloak Rollen & Attribute

Die Konfiguration der benötigten Rollen und Attribute wird hier beschrieben.

UI Komponenten werden nur angezeigt, wenn die entsprechenden Rollen den Usern zugewiesen worden sind.

b. Falls die Konfiguration unter fss-ui client für den Zugriffstyp confidential ist, muss der Inhalt für die keycloak.json aus Keycloack exportiert werden:

![](images/securityserver/40_it_admin/NUI/FSS_UI/nginx_keycloak_client_cridential_export.png)

c. Ansicht nach der Anmeldung

![](images/securityserver/40_it_admin/NUI/FSS_UI/nginx_result.png)

Konfiguration des FSS-UI-Systemnamens und der Hintergrundfarbe

Systemname und Hintergrundfarbe werden in der Datei system.json unter assets\config konfiguriert:

{
  "systemName": "FSS Testsystem",
  "backgroundColor": "#008ECC",
}

Die Änderungen werden nach einem Neustart der FSS Frontend Applikation sichtbar.