Versions Compared

Old Version 9

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

Saved on

compared with

New Version Current

changes.mady.by.user Henrik Eidnes Nielsen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: SDS-6136 Tilføj release note
Navitabs
rootNSP Test Service (NTS) - Leverancebeskrivelse
includeroottrue

Version 1.0 August 2013

...


Version 1.0 August 2013
Excerpt
hiddentrue

Overblik over NSP Service: NSP Test Service (NTS)

Confluencetable width
TWidth100%

Kort introduktion til service

NSP Test Service (NTS) bruges til at verificere korrektheden af et DGWS 1.0.1 SOAP-request.

Ved henvendelser fra anvendere, hvor der, for anvendere, opleves problemer med at kalde en service på NSP kan NTS bringes i anvendelse, som et værktøj til at hjælpe anvenderen videre. Dette gøres i praksis ved, at anvenderes request sendes til NTS istedet for til den oprindelige service. NTS afleverer et svar der uddyber, hvad der måtte være forkert i requestet. Svaret kan enten bruges direkte af supportfunktionen i dialogen med anvender eller som yderligere information videre i supportkæden. I sidstnævnte tilfælde skal NTS svaret indsættes i supportsagen.

NTS validerer det DGWS-specifikke information i SOAP-headeren for det SOAP-request, som sendes til den. Indholdet i SOAPbody er udenfor valideringen. Der udføres kontrol på følgende:

  1. UTF-8 character encoding for requestet
  2. valid XML i requestet
  3. SOAP 1.1 namespace i requestet
  4. SOAP envelope og body har indhold
  5. eksistens af obligatoriske DGWS header-elementer
  6. korrekt orden på DGWS header-elementer
  7. overholdelse af ID-kort indhold, som specificeret i DGWS 1.0 specifikationen bilag 2 og 4
  8. certifikatoplysninger, herunder:
    • certifikatets gyldighed
    • korrekt signatur (ikke-self signed)
    • udstedt af kendt STS
  9. ID-kortet i requestet validerer med SEAL-biblioteket
  10. ID-kortet er formatteret korrekt mht. tabs, linebreaks og white spaces (ved pretty printing)
 

Ved henvendelser fra anvendere, hvor der, for anvendere, opleves problemer med at kalde en service på NSP kan NTS bringes i anvendelse, som et værktøj til at hjælpe anvenderen videre. Dette gøres i praksis ved, at anvenderes request sendes til NTS

istedet for til den oprindelige service. NTS afleverer et svar der uddyber, hvad der måtte være forkert i requestet. Svaret kan enten bruges direkte af supportfunktionen i dialogen med anvender eller som yderligere information videre i supportkæden. I

sidstnævnte tilfælde skal NTS svaret indsættes i supportsagen.

 


Komponent og versioner

NTS er tilgængelig på URL’en: http://<host>/nts/service, hvor <host> erstattes med konkrete miljø, f.eks.:test2.ekstern-test.nspop.dk:8080.

Tilsvarende er WSDL for servicen tilgængelig på http://<host>/nts/service?wsdl 

NTS kan kaldes som enhver anden WebService på den nævnte eller tilsvarende URL. Det kan i praksis foregå med det værktøj anvender finder belejligt, eksempelvis curl, SOAP-UI eller egen kode. DGWS SOAP-requestet skal indeholde, hvad anvender ellers ville sende til enhver anden service på NSP. I svaret fra NTS vil resultatet af valideringen af DGWS SOAP-requestet fremgåi SOAP-body på response.

 


Kontaktoplysninger, servicebeskrivelse og testforhold

Et eksempel på kald til NTS med brug af curl, hvor SOAP-body i DGWS SOAP-requestet er tom:

code
Info
theme
icon
Confluence
false
languagenone
curl --header ’Content-Type: application/soap+xml; charset=utf-8’ -d @modules/web/src/test/-
	java/dk/nsi/nsp/nts/web/checks/testxml/idcard-valid.xml http://test2.ekstern-test.nspop. 
	dk:8080/nts/service | xmllint --format -

hvilket giver følgende resultat:

code
Info
theme
icon
Confluence
false
languagenone
<?xml version="1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header>
      <Header xmlns="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
         <Linking>
            <FlowID>9489</FlowID>
            <MessageID>9489:10173889505080905</MessageID>
         </Linking>
         <FlowStatus>syntax_error</FlowStatus>
      </Header>
      <NTS xmlns="http://nspop.dk/nts/2013/05">
         <Environment>TEST</Environment>
         <NTS-Version>1.0.0</NTS-Version>
         <SEAL-Version>2.1.6</SEAL-Version>
      </NTS>
   </SOAP-ENV:Header>
   <SOAP-ENV:Body>
      <SOAP-ENV:Fault>
         <faultcode>Server</faultcode>
         <faultstring>Consult detailed errors in medcom:FaultCode</faultstring>
         <detail xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
            <medcom:FaultCode>ERROR [SOAP1.1]: SOAP element: ’Body’ is empty. (&lt;S:Body xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"/>)</medcom:FaultCode>
         </detail>
      </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Værd at bemærke er følgende header-element:

code
Info
theme
icon
Confluencelanguage
false
none
<NTS xmlns="http://nspop.dk/nts/2013/05">
   <Environment>TEST</Environment>
   <NTS-Version>1.0.0</NTS-Version>
   <SEAL-Version>2.1.6</SEAL-Version>
</NTS>

Det kan her ses, at <Environment>-elementet angiver, hvilken miljø-type NTS befinder sig på. Mulighederne er TEST eller PRODUCTION. Endvidere kan det bemærkes at NTS benytter sig af SEAL version 2.1.6, som det ses i tagget <SEAL-Version>,

  og

  og er selv version 1.0.0, som det ses i tagget <NTS-Version>.

Resultatet af valideringen ses i responsets SOAP-body, som værdi for et eller

flere <medcom

flere <medcom:FaultCode>-tags.

 

 


Fejl er opdelt i kategorier, som vedrører bestemte tekniske områder i DGWS SOAP-requestet, eksempelvis:

  • [XML]: vedrører fejl ifbm. brug af XML generelt
  • [SOAP1.1]: vedrører fejl ifbm. anvendelsen af SOAP 1.1 
  • [STS Signed]: vedrører fejl ifbm. anvendelsen af STS eller SEAL-biblioteket NTS Anvender-guide 3 / 3
  • [DGWS Schema]: vedrører fejl ifbm. strukturen af ID-kortet elementer
  • [DGWS IDCard]: vedrører fejl ifbm. indhold af ID-kortet 

Et eksempel på et resultat, hvor der optræder flere samtidige fejlbeskeder:

code
Info
theme
icon
Confluence
false
languagenone

<?xml

version="1.0"?>


<SOAP-ENV:Envelope

xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">


  

<SOAP-ENV:Header>


     

<Header

xmlns="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">


        

<Linking>


           

<FlowID>urn:uuid:fe6eb0b0-d95f-414e-b6a5-f343503bc103</FlowID>


           

<MessageID>A998:10179430363102375</MessageID>


           

<InResponseToMessageID>AAABPqK6kjpf6XN9a05H4lNPU0k=</InResponseToMessageID>


        

</Linking>


        

<FlowStatus>syntax_error</FlowStatus>


     

</Header>


     

<NTS

xmlns="http://nspop.dk/nts/2013/05">


        

<Environment>TEST</Environment>


        

<NTS-Version>1.0.0</NTS-Version>


        

<SEAL-Version>2.1.6</SEAL-Version>


     

</NTS>


  

</SOAP-ENV:Header>


  

<SOAP-ENV:Body>


     

<SOAP-ENV:Fault>


        

<faultcode>Server</faultcode>


        

<faultstring>Consult

detailed

errors

in

medcom:FaultCode</faultstring>


        

<detail

xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">


           

<medcom:FaultCode>ERROR

[DGWS

IDCard]:

IDCard

Conditions

NotOnOrAfter

exceeded

(&lt;ns9:Conditions

xmlns:ns9="urn:oasis:names:tc:SAML:2.0:assertion"

NotBefore=" 

-


2013-05-14T11:03:56Z"

NotOnOrAfter="2013-05-15T11:03:56Z"/>).

Server

time:2013-07-15T16:47:00.751</medcom:FaultCode>


           

<medcom:FaultCode>ERROR

[STS

Signed]:

SEAL

(Test

Federation):

Invalid

signature:

’dk.sosi.seal.modelbuilders.SignatureInvalidModelBuildException:

Signature

could 

-


not

be

validated’</medcom:FaultCode>


           

<medcom:FaultCode>ERROR

[STS

Signed]:

IDCard

contains

more

than

4

spaces

in

a

row.

This

indicates

that

the

IDCard

XML

has

been

pretty

printed</medcom:FaultCode>


        

</detail>


     

</SOAP-ENV:Fault>


  

</SOAP-ENV:Body>


</SOAP-ENV:

Envelope> 

  

Her

Envelope>

 Her ses, at der er problemer med ID-kortets gyldighed:

Info
iconfalse
ERROR [DGWS IDCard]: IDCard Conditions NotOnOrAfter exceeded

og signaturen på ID-kortet kan ikke valideres: 

Info
iconfalse
ERROR [STS Signed]: SEAL (Test Federation): Invalid signature

 og der er problemer med formateringen af XML’en i ID-kortet:

Info
iconfalse
ERROR [STS Signed]: IDCard contains more than 4 spaces in a row

 

Der findes en mængde andre fejlbeskeder, som

ligger udenfor dette dokument at give eksempel på.

 

 

 

der her ikke gives eksempler på.

Releases

1.1.0

Jira
serverNSI JIRA
columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIde64c3bc3-001c-3439-bc53-f7a235a8cd61
keySDS-2536

Jira
serverNSI JIRA
serverIde64c3bc3-001c-3439-bc53-f7a235a8cd61
keySDS-6136

1.0.5

https://svn.nspop.dk/svn/components/nts/tags/nts-1.0.5/

Jira
serverNSI JIRA
serverIde64c3bc3-001c-3439-bc53-f7a235a8cd61
keySDS-6050

Kommandolinje klienten er blevet fjernet efter aftale.

Anvenderguiden er opdateret: NTS - Guide til anvendere

1.0.4

https://svn.nspop.dk/svn/components/nts/tags/release-1.0.4/

Jira
serverNSI JIRA
serverIde64c3bc3-001c-3439-bc53-f7a235a8cd61
keySDS-4921

1.0.3

https://svn.nspop.dk/svn/components/nts/tags/release-1.0.3/

Jira
serverNSI JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIde64c3bc3-001c-3439-bc53-f7a235a8cd61
keySDS-3818

Jira
serverNSI JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIde64c3bc3-001c-3439-bc53-f7a235a8cd61
keySDS-3237

NTS er containerized og afvikles nu på Wildfly 8.2