Versions Compared

Old Version 5

changes.mady.by.user Unknown User (jgg)

Saved on

compared with

New Version 6

changes.mady.by.user Unknown User (jgg)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Navitabs
rootPlatformsservices (NAP) - Leverancebeskrivelse
includeroottrue



1. Introduktion

...

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter aspekter af komponenten.
Driftsvejledningen indeholder information od hensyn til eksterne afhængigheder, standard placering af logfiler og konfigurationsfiler.

...

Nap-admin-web

...

Hvordan fungerer servicen

Single page application med 3 routes:

Route

Funktionalitet

/projekter/{id}

Laver et kald til nap-admin 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/

...

Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.

...

Nap-lobby-web

...

Hvordan fungerer servicen

Single page application med 3 routes:

Route

Funktionalitet

/projects

Laver et kald til nap-admin og viser en projektoversigt.

I tilfælde af http fejl vises dette til brugeren.

/helpViser informationer om, hvordan der kan oprettes en NSP support sag.

...

Konfiguration

configurations.json  mappes til /pack/webapp/assets/

...

Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.

...

Nap-test-web

...

Hvordan fungerer servicen

Nap-test-web fungerer som test-suite til værtsystemer. Den tester, at kommunikationen over broen fungere som den skal, og der er således ingen konfiguration, opsætning eller logning.

...

 Nap-admin

...

Hvordan fungerer servicen

Servicen kalder en database med projekter og udstiller dem på en REST snitfalde.

Endpoints

Funktionalitet

/projekter/{id}Validerer den indkommende SAMLassertion, kalder databasen og henter Projekt(er) baseret på det dit cvr nummer.
/webapps/{id}Validerer den indkommende SAMLassertion, kalder databasen og henter WebApp(er) baseret
/isAlive

Bruges af loadbalanceren for at tjekke at servicen er deployet. Returnerer en html side med deployment info.

Returnere 200, Hvis der kan oprettes forbindelse til den database, der er konfigureret i datasource "jboss/datasources/admin". Ellers returnes 500.

...

Konfiguration

Følgende konfigurations filer skal være tilgængelige i classpath under deployment (loades fra applikationsserverens modules/dk/sds/nsp/nap/admin/main).

Konfigurationsfiler
FilnavnIndhold
nap-admin-compose-ds.xml

Datasource beskrivelse.

<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>
</datasources>

log4j-napadmin.xmllog4j konfiguration
nap.jksJKS fil indeholdende NAP certifikat til audience /nap
nap-admin.properties
# Path to the service provider certificate
keystorePath=nap.jks

# Password to the service provider certificate
keystorePassword=Test1234

#  Path where public certificates of trusted STS services are stored
trustedStsCert=trusted-sts-certs.jks

# Password for the trusted sts certifikate keystore
trustedStsCertPassword=Test1234


# The audience, SAML-tokens are required to have
expectedAudience=https://audience.nspop.dk/nap

# Max clock skew
allowedClockDrift=3
trusted-sts-certs.jksJKS fil med certifikater fra STS providers.

...


Logging

Log4j konfigurationen skal findes i log4j-napadmin.xml på classpath.

...