1.Skapa meddelande

Organisation A

• Meddelandetjänst (verksamhets- och meddelandelager)

I meddelandetjänsten skapas en meddelandestruktur enligt schema (XHE, MessageType) och paketeras i AS4.

• AS4

  • MessagePayload (MessagePayloadType)

    • XHE

    • Message (MessageType)

Meddelandet skapas i en meddelandetjänst.

Steg 1 och steg 2 (steg 3) kan ske samtidigt.

2.Adressera

Organisation A

• Meddelandetjänst

Användare(avsändaren) inom organisationen med tillgång till en SDK funktionsadress söker i en adressbok för att hitta anslutna organisationer och dess funktionsadresser.

Meddelandetjänsten kompletterar meddelandet med adressuppgifter (organisations-id, funktions-id).

Transportadressering:

• AS4

  • originalSender (organisations-id)

  • finalRecipient (organisations-id)

Verksamhetsadressering:

• MessageType

  • Recipient (organisations-id)

    • Attention.Function (funktions-id)

    • Attention.Person (Endast referens: person-id)

  • Sender (organisations-id)

    • Attention.Function (funktion-id)

    • Attention.Person (Endast referens: person-id)

• XHE

  • Receiver (organisations-id)

  • Sender (organisations-id)

  • HandlingServiceID (funktions-id)

Användaren söker i en adressbok för att hitta anslutna organisationer och dess funktionsadresser. Detta kan ske antingen genom integration mot SDK Adressboks Sök-API eller genom en lokal läskopia.

Specifikationer:

• Kuverteringsprofil XHE (Se R8)

3.Kryptera och signera

Organisation A

• Meddelandetjänst

Avsändande användarorganisation krypterar och signerar meddelandet.

• Mottagande användarorganisationens krypteringsnyckel hämtas från SMP (CertPub)

• Meddelandetjänsten Base64-kodar det färdiga meddelandet och överför det till Accesspunkten.

  • Hur ett meddelande överförs till accesspunkten är en produktspecifik fråga; olika ev. APIer kan erbjudas beroende på produkt.

Specifikationer:

• Kuverteringsprofil XHE (Se R8)

• Certifikatspublicering - REST-bindning till SMP (Se R10)

4.Skicka meddelande

Organisation A

• Accesspunkt (AP)

Avsändande Accesspunkt skickar meddelande enligt eDelivery-protokoll.

• DNS ger transportadress till SMP

• SMP ger transportadress AP

Organisation B

• Accesspunkt (AP)

Mottagande Accesspunkt tar emot meddelande för vidare leverans.

Intern routing skall baseras på:

• Organisations-id

• Funktions-id

5.Status

Organisation B

• Accesspunkt (AP)

Transportkvittering: Mottagande Accesspunkt bekräftar överföring synkront enligt eDelivery-protokoll.

• SignalMessage innehåller bl.a. MessageId

6.Validering och kvittering

Organisation B

• Meddelandetjänst

Meddelandekvittering: Mottagande organisations meddelandetjänst validerar meddelande samt kvitterar meddelande.

1. Ursprungskontroll: Validerar sändarens signatur enligt XHE specifikation.

2. Dekrypterar meddelande

   • Ursprungskontroll meddelande: Genom kontroll mot SMP(CertPub) kan mottagaren kontrollera att sändarens identitet är korrekt (Organisations-id)

3. Kvittering sker när meddelandet är validerat (Se B2) och har nått mottagande organisations meddelandetjänst.

   • Kvitteringsmeddelanden skall endast signeras (ej krypteras)

4. Kvittering sker genom att meddelandetjänsten skickar ett kvitteringsmeddelande meddelande till avsändaren.

Observera att kvittensmeddelande skall skapas enligt DIGGs specifikation Meddelandekvittens (R7).

Överföring till mottagande organisations meddelandetjänst är nu garanterad.

Specifikationer:

• Meddelandespecifikation: Meddelandekvittens (Se R7)

  • för utformning av meddelandekvittens

• Certifikatspublicering - REST-bindning till SMP (Se R10)

• SDK Specifikation Validering, felhantering och kvittens (Se B2)

  • för tillämpning av SDKs regelverk

7.Meddelandestatus

Organisation A

Meddelandekvittens mottages

• Unik identifierare

  • ID

• Datum

  • CreationDateTime

Unikt identifierare av meddelandet/nyttolast.

• ID: Unik identifierare. Ska vara samma som för nyttolasten

• CreationDateTime: Datum när XHE skapadess. Kan vara samma som för nyttolasten.

<XHEVersionID>1.0</XHEVersionID>
  <xha:Header>
    <ID>862693f7-53d4-4d96-b35c-470055710092</ID>
    <CreationDateTime>2019-08-15T17:52:58.1Z</CreationDateTime>
    ..
  <xha:Header>

• Avsändare

  • FromParty

• Mottagare

  • ToParty

FromParty.PartyIdentification

• Sändande användaroganisation (Organisations-id)

  • SKA vara samma som AS4 originalSender

  • SKA vara samma som MessageType.MessageHeaderType.SenderType

ToParty.PartyIdentification

• Mottagande användarroganisation (Organisations-id)

  • SKA vara samma som AS4 finalRecipient

  • SKA vara samma som MessageType.MessageHeaderType.RecipientType

<xha:FromParty>
      <xha:PartyIdentification>
        <ID schemeID="iso6523-actorid-upis">0203:habo.se</ID>
      </xha:PartyIdentification>
    </xha:FromParty>
    <xha:ToParty>
      <xha:PartyIdentification>
        <ID schemeID="iso6523-actorid-upis">0203:arbetsformedlingen.se</ID>
      </xha:PartyIdentification>
    </xha:ToParty>

Meddelandets struktur

Payloads.Payload.DocumentTypeCode

• SKA motsvara rotelementet dvs “Q{urn:riv:infrastructure:messaging:MessageWithAttachments:3}messagePayload”

Payloads.Payload.ContentTypeCode

• SKA sättas till “application/xml“

<xha:Payloads>
    <xha:Payload>
      <DocumentTypeCode>Q{urn:riv:infrastructure:messaging:MessageWithAttachments:3}messagePayload</DocumentTypeCode>
      <ContentTypeCode>application/xml</ContentTypeCode>

Funktionsadress (egen identifierare)

Payloads.Payload.HandlingServiceID

Nyttolastens funktionsadress, kan används för att underlätta meddelandehantering i meddelandetjänst/meddelandeväxel.

SDK Meddelande och Meddelandekvittens (OBS! Meddelandekvittens är ett separat meddelande som har en egen specifikation. Se R7 Meddelandespecifikation: Meddelandekvittensavser):

• Mottagarens Id för att identifiera funktion/enheter.

  • SKA vara samma som attention.subOrganization.organizationId.extension

• SKA även sättas i XHE kuvert på kvittensmeddelandet för detta meddelande.

<xha:Payloads>
    <xha:Payload>
      <DocumentTypeCode>Q{urn:riv:infrastructure:messaging:MessageWithAttachments:3}messagePayload</DocumentTypeCode>
      <ContentTypeCode>application/xml</ContentTypeCode>
      <HandlingServiceID>sub-funktion-org-id</HandlingServiceID>
      <InstanceEncryptionIndicator>true</InstanceEncryptionIndicator>
      <xha:PayloadContent>

../contentText

(ContentAsText)

characterSequence

1..1

Fritext (UTF-8).

Text kan formateras med följande MarkDown koder enligt RFC 7763.

Headers:

# H1
## H2
### H3
#### H4
##### H5
###### H6

Strong/bold
**xyz**
__xyz__

Italic:
*xyz*
_xyz_

Bullet:
* xyz

Number:
1.
2.

*Two or more line breaks*

This is the first line

This is the second line

---

*Two or more spaces, and then type return*

This is the first line  
This is the second line

Grafiskt gränssnitt i meddelandeklient (verksamhetssystem) tjänst skall rendera ovanstående MarkDown-koder.

Om ett värde skickas skall Meddelandeklient(MK) hantera värdet.

Meddelandet inklusive bifogade filer får ej överstiga 30 MB.

1..1