#177 forbedret dokumentasjon omkring WS-sec

endret lenker, lagt til mer noe mer info men i hovedsak kun gjort den mer lesbar/tydelig.
difi · Sep 21, 2015 · 196d287 · 196d287
1 parent abd76d6
commit 196d287
Show file tree

Hide file tree

Showing 11 changed files with 127 additions and 55 deletions.
diff --git a/forretningslag/meldingsformat.textile b/forretningslag/meldingsformat.textile
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Struktur på melding
-headtitle: Sikker digital post - Begreper
+headtitle: Sikker digital post
 group: forretningslag
 
 id: Forretningslag/Forretningsmeldingsstruktur
@@ -70,10 +70,4 @@ h2. Standarder benyttet i strukturen
 
 For mer informasjon se relevante deler av dokumentasjonen.
 
-h2. Illustrasjon
-
-En komplett melding slik som den blir overført mellom to punkter i infrastrukturen kan illustreres på følgende måte:
-
-"!(img-responsive)meldingsstruktur_enkel.jpg(Figuren viser en overordnet beskrivelse av meldingen i Sikker digital post)!":meldingsstruktur_enkel.jpg
-
 fn1. Det er brukt organisasjonsnavn i stedet for organisasjonsnummer for å gjøre det litt mer lesevennlig.
diff --git a/transportlag/MeldingsIdentifikatorer.textile b/transportlag/MeldingsIdentifikatorer.textile
@@ -1,12 +1,12 @@
 ---
 layout: default
 title: Meldingsidentifikatorer
-headtitle: Sikker digital post - Standard Business Document Header
+headtitle: Sikker digital post
 group: transportlag
 
 id: Transportlag/Meldingsidentifikatorer
 
-next: Transportlag/Meldingsutveksling
+next: Transportlag/Meldingsutveksling/FormidleDigitalPostForsendelse
 
 ---
 

diff --git a/transportlag/Meldingsformat.textile b/transportlag/Meldingsformat.textile
@@ -1,17 +1,25 @@
 ---
 layout: default
 title: Meldingsformat
-headtitle: Sikker digital post - Begreper
+headtitle: Sikker digital post
 group: transportlag
 
 id: Transportlag/Transportmeldingsstruktur
 
-next: Feilhåndtering
+next: Transportlag/WebserviceSecurity
 
 ---
 
 h2. Meldingsformat
 
-Transportlaget i Sikker Digital Post benytter seg av *AS4 light client conformance profile* som rammeverk for å overføre "Forretningsmeldinger"../forretningslag/meldingsformat. 
+Transportlaget i Sikker Digital Post benytter seg av *AS4 light client conformance profile* som rammeverk for å overføre "Forretningsmeldinger":../forretningslag/meldingsformat. 
 
 I praksis medfører dette at forretningsmeldingen blir pakket inn som en SOAP melding som illustrert i "eksemplene":../eksempler.
+
+h3. Illustrasjon
+
+En komplett melding slik som den blir overført mellom to punkter i infrastrukturen kan illustreres på følgende måte:
+
+"!(img-responsive)meldingsstruktur_enkel.jpg(Figuren viser en overordnet beskrivelse av meldingen i Sikker digital post)!":meldingsstruktur_enkel.jpg
+
+
diff --git a/transportlag/Meldingsutveksling/KvitteringsForespoersel.textile b/transportlag/Meldingsutveksling/KvitteringsForespoersel.textile
@@ -6,7 +6,7 @@ group: transportlag
 
 id: Transportlag/Meldingsutveksling/KvitteringsForespoersel
 
-next: Transportlag/Transportmeldingsstruktur
+next: Transportlag/mpc
 
 ---
 {% include variables.html %}

diff --git a/transportlag/Meldingsutveksling/index.textile b/transportlag/Meldingsutveksling/index.textile
@@ -6,7 +6,7 @@ group: transportlag
 
 id: Transportlag/Meldingsutveksling
 
-next: Transportlag/Meldingsutveksling/FormidleDigitalPostForsendelse
+next: Transportlag/Meldingsidentifikatorer
 
 ---
 

diff --git a/transportlag/UserMessage/MessageInfo.textile b/transportlag/UserMessage/MessageInfo.textile
@@ -7,7 +7,7 @@ group: transportlag
 id: MessageInfo
 
 next: PartInfo
-prev: mpc
+prev: Transportlag/mpc
 
 ---
 

diff --git a/transportlag/UserMessage/index.textile b/transportlag/UserMessage/index.textile
@@ -6,7 +6,7 @@ group: transportlag
 
 id: UserMessage
 
-next: mpc
+next: Transportlag/mpc
 prev: transportmeldingsstruktur
 
 ---

diff --git a/transportlag/UserMessage/mpc.textile b/transportlag/UserMessage/mpc.textile
@@ -1,13 +1,12 @@
 ---
 layout: default
-title: Message Partition Channel (mpc)
-headtitle: Begrepskatalog for Sikker digital post - 
+title: Meldingskøer
+headtitle: Sikker digital post
 group: transportlag
 
-id: mpc
+id: Transportlag/mpc
 
-next: MessageInfo
-prev: UserMessage
+next: Transportlag/Transportmeldingsstruktur
 
 ---
 

diff --git a/transportlag/WebserviceSecurity.textile b/transportlag/WebserviceSecurity.textile
@@ -1,38 +1,117 @@
 ---
 layout: default
-title: WebserviceSecurity
-headtitle: Begrepskatalog for Sikker digital post - 
+title: Webservice sikkerhet
+headtitle: Sikker digital post
 group: transportlag
 
-id: WebserviceSecurity
+id: Transportlag/WebserviceSecurity
+
+next: Feilhåndtering
 
-next: transportlag
-prev: SignalMessage
 
 ---
 
 h2. {{page.title}}
 
-- Identifikator := "http://begrep.difi.no{{ page.url  | remove:".html" }}":{{page.title}}
-- Term := {{page.title}}
-- Definisjon := Informasjonsbærer i SOAP-meldinger for å gi melding integritet
-- Datatype := Soap header
-- Kjelde := "OASIS":https://www.oasis-open.org/committees/download.php/21255/wss-v1.1-spec-errata-os-SOAPMessageSecurity.pdf
-- Kommentar := Informasjonsbærer brukt for å sikre integritet i meldingen fra punkt til punkt.
 
-Det er kun implementert signering av SOAP meldingene, ikke kryptering.
 
-h3. Eigenskapar
+h3. Webservice security headere
+
+Webservice security header består av følgende elementer:
 
 table(table table-striped).
 |_. Identifikator |_. Kardinalitet |_. Datatype |
+| BinarySecurityToken | 1..1 | "wsse:BinarySecurityToken":http://docs.oasis-open.org/wss/v1.1/wss-v1.1-spec-errata-os-SOAPMessageSecurity.htm#_Toc118717134 |
 | Timestamp | 1..1 | "wsu:Timestamp":https://www.oasis-open.org/committees/download.php/21256/wss-v1.1-spec-errata-os-SOAPMessageSecurity.htm#_Toc118717167 |
 | Signature | 1..1 | "ds:Signature":https://www.oasis-open.org/committees/download.php/21256/wss-v1.1-spec-errata-os-SOAPMessageSecurity.htm#_Toc118717148 |
 
-For Soap signering skal:
+Meldingen er kun signert på SOAP nivå, ikke kryptert.
+
+h3. Timestamp
+
+* Time-to-live skal være 120 sekunder
+
+På grunn av den korte Time-to-live så kreves det at alle aktører har servere med klokker synkronisert med "NTP":http://www.ntp.org/.
+
+h3. BinarySecurityToken
+
+* Sertifikat for validering av signatur skal inkluderes i SOAP header
 * Security Token være X509 sertifikater 
 * Sertifikatet som brukes skal være et virksomhetssertifikat
-* Sertifikat for validering av signatur skal inkluderes i SOAP header
+** sertifikatet skal være utstedt til behandlingsansvarlig eller databehandler.
+** I testmiljøet brukes test-virksomhetssertifikat utstedt fra samme leverandører som i produksjon
+
+h3. Signature
+
 * Signeringsalgoritmen skal være "http://www.w3.org/2001/04/xmldsig-more#rsa-sha256":http://www.w3.org/2001/04/xmldsig-more#rsa-sha256. 
 * Fingeravtrykksalgoritmen i referansene skal være "http://www.w3.org/2001/04/xmlenc#sha256":http://www.w3.org/2001/04/xmlenc#sha256
-* Time-to-live skal være 120 sekunder
+
+Følgende elementer i SOAP meldingen signeres:
+
+* Timestamp
+* Soap body
+* eb:Messaging header
+* Soap attachment
+
+
+h3. eksempel
+
+Under kan er det lagt opp en et eksempel på en gyldig Webservice security header generert fra java klient biblioteket for sending av digital post:
+
+<pre class="brush: xml; toolbar: false">
+   <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" env:mustUnderstand="true">
+      <wsse:BinarySecurityToken EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" wsu:Id="X509-b1149be9-7b9e-4ce6-8cca-1cd915ae4fe9">MIIFOjCCBCKgAwIBAgIKGQqI22LuZ+0U6TANBgkqhkiG9w0BAQsFADBRMQswCQYDVQQGEwJOTzEdMBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIzAhBgNVBAMMGkJ1eXBhc3MgQ2xhc3MgMyBUZXN0NCBDQSAzMB4XDTE0MDYxNjA4NTYyNloXDTE3MDYxNjIxNTkwMFowgaAxCzAJBgNVBAYTAk5PMSwwKgYDVQQKDCNESVJFS1RPUkFURVQgRk9SIEZPUlZBTFROSU5HIE9HIElLVDEhMB8GA1UECwwYU0RQIC0gbWVsZGluZ3N1dHZla3NsaW5nMSwwKgYDVQQDDCNESVJFS1RPUkFURVQgRk9SIEZPUlZBTFROSU5HIE9HIElLVDESMBAGA1UEBRMJOTkxODI1ODI3MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx6IPA2KSAkSupen5fFM1LEnW6CRqSK20wjpBnXf414W03eWUvBlw97c6k5sl2tYdn4aVb6Z9GeDaz1bLKN3XwhFGPk9PnjSIhrFJNAPnWVEBDqGqfeMrEsYdOEgM2veBZDYkhVwipjr8AesmptTRAat61q+6hCJe8UZqjXb4Mg6YKSTAHfJdthAG06weBMgVouQkTkeIIawM+QPcKQ3Wao0gIZi17V0+8xzgDu1PXr90eJ/Xjsw9t0C8Ey/3N7n3j3hplsZkjOJMBNHzbeBG/doroC6uzVURiuEn9Bc9Nk224b+7lOBZ1FvNNrJVUu5Ty3xyMDseCV7z1QTwW7wcpwIDAQABo4IBwjCCAb4wCQYDVR0TBAIwADAfBgNVHSMEGDAWgBQ/rvV4C5KjcCA1X1r69ySgUgHwQTAdBgNVHQ4EFgQU6JguiqDjkgjEGRHhzkbeKeqyWQEwDgYDVR0PAQH/BAQDAgSwMBYGA1UdIAQPMA0wCwYJYIRCARoBAAMCMIG7BgNVHR8EgbMwgbAwN6A1oDOGMWh0dHA6Ly9jcmwudGVzdDQuYnV5cGFzcy5uby9jcmwvQlBDbGFzczNUNENBMy5jcmwwdaBzoHGGb2xkYXA6Ly9sZGFwLnRlc3Q0LmJ1eXBhc3Mubm8vZGM9QnV5cGFzcyxkYz1OTyxDTj1CdXlwYXNzJTIwQ2xhc3MlMjAzJTIwVGVzdDQlMjBDQSUyMDM/Y2VydGlmaWNhdGVSZXZvY2F0aW9uTGlzdDCBigYIKwYBBQUHAQEEfjB8MDsGCCsGAQUFBzABhi9odHRwOi8vb2NzcC50ZXN0NC5idXlwYXNzLm5vL29jc3AvQlBDbGFzczNUNENBMzA9BggrBgEFBQcwAoYxaHR0cDovL2NydC50ZXN0NC5idXlwYXNzLm5vL2NydC9CUENsYXNzM1Q0Q0EzLmNlcjANBgkqhkiG9w0BAQsFAAOCAQEAKOTM1zSdGHWUBKPzDPYCcci9cpbktd2WuBg028bRC0NwKSWUKeuUfWesTiu/P4UlYGe86qd/+z3MNpN89aGA8pr0E0WpI+NM+v+Cb0dQwxHASHtrkVo9CVx6V6/QSBqIUEMfNquDHzxB2/mXbv6GuO5eIl3OSVKg7Ffd/1wdE6zeMmHQO+zRpfj+OVEhNPb5cLa13Ah9+JrMkr1O7VUFbozLQgFPhuI8/5+u8U/6cDOOmcFV4f4IYUmhbcLiW5MQnvaJ8044+uInOQTNtSkKmZAo7Jnm4KUyhFXftJOStOHSlODOQcepVS7csszO5yWQRMTV8doEsaH5p/LBXYF56Q==</wsse:BinarySecurityToken>
+      <wsu:Timestamp wsu:Id="TS-08b9bf59-4914-462c-868d-6277a702c578">
+        <wsu:Created>2015-09-15T06:47:11.672Z</wsu:Created>
+        <wsu:Expires>2015-09-15T06:52:11.672Z</wsu:Expires>
+      </wsu:Timestamp>
+      <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="SIG-35cb96d4-3a9b-4769-ae2b-5c88391c3c75">
+        <ds:SignedInfo>
+          <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#">
+            <ec:InclusiveNamespaces xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList="env"/>
+          </ds:CanonicalizationMethod>
+          <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/>
+          <ds:Reference URI="#soapBody">
+            <ds:Transforms>
+              <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#">
+                <ec:InclusiveNamespaces xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList=""/>
+              </ds:Transform>
+            </ds:Transforms>
+            <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
+            <ds:DigestValue>FNviz1QfCqb4noYySIXZFsvxjmNuyEEmUcMPAu56p1c=</ds:DigestValue>
+          </ds:Reference>
+          <ds:Reference URI="#TS-08b9bf59-4914-462c-868d-6277a702c578">
+            <ds:Transforms>
+              <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#">
+                <ec:InclusiveNamespaces xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList="wsse env"/>
+              </ds:Transform>
+            </ds:Transforms>
+            <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
+            <ds:DigestValue>NQxFSon1NctBZOPD+B4Oq4eF7xNOCqBL7ltQGD1wdgQ=</ds:DigestValue>
+          </ds:Reference>
+          <ds:Reference URI="#id-55daa7c1-e2f8-4026-ae5e-add5643588e0">
+            <ds:Transforms>
+              <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#">
+                <ec:InclusiveNamespaces xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList=""/>
+              </ds:Transform>
+            </ds:Transforms>
+            <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
+            <ds:DigestValue>o05bS7fdRT9wbANXGz+kRFPfVIgXQct+jaj6wmulQkY=</ds:DigestValue>
+          </ds:Reference>
+          <ds:Reference URI="cid:cfbb64c8-be18-4a51-98e6-1a9ef85cab5a@meldingsformidler.sdp.difi.no">
+            <ds:Transforms>
+              <ds:Transform Algorithm="http://docs.oasis-open.org/wss/oasis-wss-SwAProfile-1.1#Attachment-Content-Signature-Transform"/>
+            </ds:Transforms>
+            <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
+            <ds:DigestValue>lTQzlEnR4v0Dkm+JqZdzStEh2l/z0hqU8D5h3aW1m5w=</ds:DigestValue>
+          </ds:Reference>
+        </ds:SignedInfo>
+        <ds:SignatureValue>vyLuoJf7rjNNuE7EQkOZgj50PkbehFZFP6WAeoJnFsCqUzh8AcSUmussxIgb8hUzKQLkYWlq48+ZPutpufI04j1hak64rphHLYKMqxepaCT4Kwv9mvdSPyTTtPOi3ou3IELF4DSo9rCRevB5CJFwDmT6OGrheBIx3H7GY7pqblpbVDRsh+sCT+5NaFEiysEIIQgnYxM9PDKmXtzcojwDt4QTx3huZ8fl10kPs5PFDZqLh0GQlIjSp9Uqq5ZaLHgbAXbA+lsDbfT5omAzUBTpf7ktrtBTUrOra+BEjSUzz0pGGKnYVAuRhnbkRY2hk2DQFAiv32JXMYevyw8l2RiMZQ==</ds:SignatureValue>
+        <ds:KeyInfo Id="KI-d2cd2986-3da9-4127-8523-a8b18197a34d">
+          <wsse:SecurityTokenReference wsu:Id="STR-5407ac8e-44a1-42f5-a9c7-aaca98484352">
+            <wsse:Reference URI="#X509-b1149be9-7b9e-4ce6-8cca-1cd915ae4fe9" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"/>
+          </wsse:SecurityTokenReference>
+        </ds:KeyInfo>
+      </ds:Signature>
+    </wsse:Security>
+</pre>
diff --git a/transportlag/index.textile b/transportlag/index.textile
@@ -7,33 +7,25 @@ group: transportlag
 
 id: Transportlag
 
-next: Transportlag/Meldingsidentifikatorer
-
-children:
- - name: Transportlag/Meldingsidentifikatorer
- - name: Transportlag/Meldingsutveksling 
- - name: Transportlag/Meldingsutveksling/FormidleDigitalPostForsendelse
- - name: Transportlag/Meldingsutveksling/FormidleFysiskPostForsendelse 
- - name: Transportlag/Meldingsutveksling/KvitteringsForespoersel
- - name: Transportlag/Transportmeldingsstruktur
- - name: Transportlag/Messaging
- - name: Transportlag/UserMessage
- - name: Transportlag/SignalMessage
- - name: Transportlag/WebserviceSecurity
+next: Transportlag/Meldingsutveksling
 
 ---
 
+h2. Transport av meldinger i sikker digital post
+
+* "Les om meldingsutvekslingsrammeverket som brukes og generelle":Meldingsutveksling/
+* "Identifikatorer for transport av meldinger":MeldingsIdentifikatorer 
+* "Meldingsformatet på de tekniske meldingene som sendes":Meldingsformat
+* "Bruk av meldingskøer":UserMessage/mpc
+* "Hvordan er meldingen sikret under transport - Webservice security":WebserviceSecurity
+
+
 Transportlaget er bygd opp av følgende kapitler:
 
 table(table table-striped).
-| "Meldingsidentifikatorer":MeldingsIdentifikatorer | Identifikatorer for transport av meldinger |
-| "Meldingsutveksling":Meldingsutveksling/ | Beskrivelse av den tekniske meldingsutvekslingen |
-| "Meldingsformat":Meldingsformat | Meldingsformatet på de tekniske meldingene som sendes  |
 | "ebMS pmode: Formidle digital post":Meldingsutveksling/FormidleDigitalPostForsendelse | ebMS pmodes for formidling av Digital Post |
 | "ebMS pmode: Formidle fysisk post":Meldingsutveksling/FormidleFysiskPostForsendelse | ebMS pmodes for formidling av Fysisk Post |
 | "ebMS pmode: Kvitteringsforespørsel":Meldingsutveksling/KvitteringsForespoersel | ebMS pmodes for henting av kvitteringer |
 | "eb:Messaging":Messaging | beskrivelse av ebMS Messaging headeren |
 | "eb:Usermessage":UserMessage/ | ebMS UserMessage brukt for transport av forretningsmeldinger |
 | "eb:SignalMessage":SignalMessage/ | ebMS Signalmessage brukt for henting av kvitteringer og signalering av feil |
-| "Webservice security header":WebserviceSecurity | Beskrivelse av kravene til Webservice security instillingene |
-
diff --git a/forretningslag/meldingsstruktur_enkel.jpg → transportlag/meldingsstruktur_enkel.jpg b/forretningslag/meldingsstruktur_enkel.jpg → transportlag/meldingsstruktur_enkel.jpg