Page History
...
Ønskes mere information omkring anvendelse kan dette findes på NAP Platform - Guide til anvendere.
Nap-
...
lobby-web
Hvordan fungerer servicen
Single page application med 2 følgende routes:
Key
Value
Route | Funktionalitet |
|---|---|
| /projekter/{id}projects | Laver et kald til nap-administration og administration og viser en projektoversigt. I tilfælde af http fejl vises dette til brugeren. |
| / | kontaktViser informationer om, hvordan der kan oprettes en NSP support sag |
Konfiguration
configurations.json mappes til /pack/webapp/assets/
| admin |
Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.
Håndtering af fejlsituationer og logning
Nap-admin-web er en stateless webapplikation, og der er derfor ingen logning i dette komponent. Fejl vil blive skrevet ud i konsollen. I tilfælde af http fejl bliver klienten præsenteret med en fejl.
Nap-lobby-web
Hvordan fungerer servicen
Single page application med 2 routes:
Route | Funktionalitet |
|---|---|
| /projects | Laver et kald til nap-administration og viser en projektoversigt. I tilfælde af http fejl vises dette til brugeren. Viser admin funktionalitet |
| /admin/projects/edit/{id} | Tilføj redigere i et projekt |
| /help | Viser informationer om, hvordan der kan oprettes en NSP support sag. |
Konfiguration
configurations.json mappes til /pack/webapp/assets/
Key | Value |
|---|---|
| projectsEndpoint | Projekt endpoint |
| serverUrl | Relative path til nap-admin |
Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.
Håndtering af fejlsituationer og logning
nap-lobby-web er en stateless webapplikation, og der er derfor ingen logning i dette komponent. Fejl vil blive skrevet ud i konsollen. I tilfælde af http fejl bliver klienten præsenteret med en fejl.
Nap-test-web
Hvordan fungerer servicen
Nap-test-web fungerer som test-suite til værtsystemer.
Den tester, at kommunikationen over broen fungerer som den skal, og der er således ingen konfiguration, opsætning eller logning.
| sessionEndpoint | Session endpoint |
| logOutEndpoint | OIOSAML logout url på facaden |
Håndtering af fejlsituationer og logning
nap-testlobby-web er en stateless webapplikation, og der er derfor ingen logning i denne dette komponent. Fejl vil dog blive skrevet ud i konsollen. I tilfælde af http fejl bliver klienten præsenteret med en fejl.
...
| Endpoints | Funktionalitet |
|---|---|
| /isAlive | Bruges af loadbalanceren for at tjekke at servicen er deployet. Returnerer en html side med deployment info. Hvis der kan oprettes forbindelse til den database, der er konfigureret i datasource "jboss/datasources/admin", returneres der statuskode 200, ellers statuskode 500. |
Login / logout (OIOSAML)
Endpoints | Funktionalitet |
|---|---|
/saml/SAMLAssertionConsumer | Validerer den indkommende OIOSAML token. |
/saml/Logout | Brugeres til at validere autentifikations requests og registrere en brugers assertion i en threadlocal session. |
Konfiguration
Konfiguration af NAP-reference sker i filerne "compose/configuration" mappen som er beskrevet i NAP Platform - Installationsvejledning. I det følgende gennemgåes konfigurationsfilernes detaljer.
Følgende konfigurationsfiler skal være tilgængelige i classpath under deployment (loades fra applikationsserverens modules/dk/sds/nsp/nap/admin/main).
| Konfigurationsfiler | |
|---|---|
| Filnavn | Indhold |
nap-admin-compose-ds.xml | Datasource beskrivelse. Database opsætning. Eksempel: <datasources xmlns="http://www.jboss.org/ironjacamar/schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.jboss.org/ironjacamar/schema https://docs.jboss.org/ironjacamar/schema/ironjacamar_1_0.xsd"> <datasource jndi-name="java:jboss/datasources/admin" pool-name="MariaDBDS"> <connection-url>jdbc:mysql://napadmindb:3306/administration?autoReconnect=true</connection-url> <driver>mysql</driver> <pool> <max-pool-size>30</max-pool-size> <min-pool-size>5</min-pool-size> </pool> <security> <user-name>root</user-name> <password>pw</password> </security> <validation> <check-valid-connection-sql>select 1</check-valid-connection-sql> <validate-on-match>false</validate-on-match> <background-validation>true</background-validation> <background-validation-millis>10000</background-validation-millis> </validation> <timeout> <idle-timeout-minutes>10</idle-timeout-minutes> </timeout> </datasource> |
| log4j-napadmin.xml | log4j konfiguration |
| nap.jks | JKS fil indeholdende NAP certifikat til audience /nap | nap-admin.properties | # Path to the service provider certificatetrusted-sts-certs.jks | JKS fil med certifikater fra STS providers
| Log4j opsætninger der følger gængs standard på NSP. | |
Konfiguration af oiosaml sker i filerne "compose/configuration/oiosaml".
Der findes en konfiguration til develop / test / og test (release til test1 miljøet). De forskellige konfigurationer adskiller sig primært i logout url og service provider url.
Oiosaml konfigurationerne skal ligeledes være tilgængelig i oiosaml.home (oiosaml.home sættes med JAVA_OPTS i compose filerne og er sat til /pack/oiosaml) under deployment.
Konfigurationsfiler | |
|---|---|
oiosaml-sp.log4j.xml | lndeholder Log4j opsætninger der følger gængs standard på NSP. |
| oiosaml-sp.properties | # Properties used by oiosaml-j oiosaml-sp.certificate.location=
|
| Sundhedsdatastyrelsens nap reference funktionscertifikat | JKS fil indeholdende Sundhedsdatastyrelsen reference funktionscertifikat certifikat. Skal være samme navn som oiosaml-sp.certificate.location i oiosaml-sp.properties |
| metadata/idP/IdPMetadata.xml | OIOSAML identity provider metadata til konfiguration af OIOSAML filteret |
| metadata/SP/SPMetadata.xml | OIOSAML service provider metadata til konfiguration af OIOSAML filteret |
Database
Adgang til nap-admin databasen styres gennem filen "nap-admin-ds.xml" - Denne skal matche det NSP miljø hvor komponenten afvikles i.
Aktiviteter
For at NAP-admin kan deployes skal der være initieret en tabel i den database, der er defineret i nap-admin-ds.xml, da hibernate vil tjekke at database schemaet matcher entiteterne i applikationen.
Følgende scripts skal derfor køres:
| Filnavn | Beskrivelse |
|---|---|
| create_db_example.sql | Opretter Database |
| V1__create_tables.sql | Opretter Tabeller |
Logning
Alle logfiler er at finde i log/ under WildFly. Herunder findes en liste over alle logfiler med en beskrivelse af hvilke komponenter der skriver til dem.
Logfilnavn | Komponenter der skriver til denne |
|---|---|
| nap-admin.log | applikationslog |
| oiosaml-sp.log | OIOSAML log |
| oiosaml-sp-audit.log | OIOSAML audit log |
Fejlhåndtering
Applikationsfejl bliver logget ved hjælp af log4j, med type ERROR, INFO, DEBUG alt efter hvor alvorlig fejlen er.
Nap-test-web
Hvordan fungerer servicen
Nap-test-web fungerer som test-suite til værtsystemer.
Den tester, at kommunikationen over broen fungerer som den skal, og der er således ingen konfiguration, opsætning eller logning.
Håndtering af fejlsituationer og logning
nap-test-web er en stateless webapplikation, og der er derfor ingen logning i denne komponent. Fejl vil dog blive skrevet ud i konsollen. I tilfælde af http fejl bliver klienten præsenteret med en fejl.
Logging
Log4j konfigurationen skal findes i log4j-napadmin.xml på classpath.
Ved default konfiguration skrives alle modul-relaterede fejl til nap-admin.log
Fejlhåndtering
Applikationsfejl bliver logget ved hjælp af log4j, med type ERROR, INFO, DEBUG, alt efter hvor alvorlig fejlen er.
...