...

Dette dokument henvender sig til anvendere af Seal.Java. Dette dokument giver en mere overordnet introduktion til Seal.Java og der er nogle undersider der fokuserer på nogle konkreteanvendelser af Seal.Java.

I dette dokument beskrives følgendeFormålet med dokumentet er at give en forståelse af STS som produkt:

• Forudsætninger for at kunne anvende Seal.Java
• Hvad kan Seal.Java anvendes til?
• Hvordan kommer man som anvender i gang med at bruge Seal.Java?
• Give en oversigt over de mest centrale klasser og metoder.
• Forskelle på Seal.Java 2 og Seal.Java 3.

Der findes konkrete kodeeksempler i undersiderne til dette dokument, så man kan se Der findes desuden nogle underdokumenter til denne side hvor der findes konkrete kodeeksempler på hvordan Seal.Java kan anvendes.

Forudsætninger

Seal.Java er i modsætning til de øvrige NSP komponenter et kodebibliotek og anvenderne forventes at have andre og mere tekniske forudsætninge.

...

Seal.Java anvendes til at sikre, at DGWS og IDWS standarden bliver overholdt. Her udbydes en række metoder man kan benytte til at få:

• Bygge requests og responses
• Deserialisering af XML til model objekter
• Serialisering af model objekter til XML
• Signering requests
• Validering af signatur for requests og responses

Seal.Java har følgende tre overordnede anvendelser:

1. Som Consumer, hvor den benyttes til at opbygge DGWS/IDWS requests.
2. Som Provider, hvor den benyttes til at modtage DGWS/IDWS requests.
3. Som Security Token Service, hvor den udsteder et token til en Consumer og som Provider stoler på.

Seal.Java indeholder også funtionalitet til signering, validering og kryptering. (skal dette med i guide til anvendere??)

Anvendelse af Seal.Java som Consumer

...

Service Provider

...

Øvrig funktionalitet

Skal signering, validering og kryptering også beskrives?

Forskelle på Seal.Java 2 og Seal.Java 3

Dette afsnit beskriver hvad man skal være opmærksom på hvis man anvender Seal.Java 2.6.x eller 2.7.x og vil skifte til Seal.Java 3.0.x

Seal.Java 3

Den oprindelige udgave af Seal.Java er baseret på Java 8 og den er afhængig af en række eksterne biblioteker til bla. signering, kryptering og håndtering af XML. Disse biblioteker er centrale for sikkerheden i Seal.Java og det er en udfordrende opgave at holde dem up-to-date hele tiden. Der findes tilsvarende funktionalitet indbygget som standard i Java og hvis man anvender den, så undgår man disse ekstern afhængigheder. I processen med at skifte til at bruge de indbyggede sikkerhedsbiblioteker blev det besluttet at benytte Java 21 i stedet for Java 8, da NSPs måde at anvende dem på ikke var fuldt understøttet i Java 8.

 Overgang til Seal.Java 3

På følgende punkter er der væsentlige ændringer i forhold til Seal.Java 2:

• Følgende moduler Modulet 'demo' er blevet fjernet:
  
• demo
testtools.
• Methoden SignatureUtil.getSignedInfoBytes() er udgået, da det ikke er understøttet i JDK'en at beregne digest værdier på denne måde.
• Der er ikke længere understøttelse for at repræsentere certifikatet som tekst (isAddCertificateAsReference). 

...