Jämförda versioner

Gammal version 2

changes.mady.by.user Hans Bragman

Sparat den

jämfört med

Ny version Aktuell

changes.mady.by.user Björn Pettersson

Sparat den

Nyckel

  • Dessa rader lades till.
  • Denna rad togs bort.
  • Formateringen ändrades.

HTTP Headers hanterade av VP

Http header

Kodblock
x-vp-sender-id

obligatorisk vid interna http anrop *)

Konsumentens hsa id, används för behörighetskontroll i VP

Kodblock
x-vp-auth-cert

obligatorisk vid http anrop från proxyserver *)

Certifikat från inkommande https-anrop från konsument.

Från VP version 4.4.0 är namnet på headern konfigurerbar genom parametern http.forwarded.header.auth_cert. Se även SKLTP VP - Konfiguration

Kodblock
x-vp-instance-id

obligatorisk vid interna http anrop *)

För att VP skall kunna avgöra om http anropen kommer från den egna SKLTP instansen eller från en annan SKLTP-instans. VP jämför inkommande header
med konfigurations-propertyn VP_INSTANCE_ID och om dessa skiljer sig

år

åt så ignoreras andra x-vp-* headrar i anropet.

Kodblock
x-rivta-original-serviceconsumer-hsaid

valfri

Identifierar ursprungsavsändare

, om headern bifogas i anropet kommer VP säkerställ

. VP kontrollerar om anropande applikation har behörighet att sätta headern. Om så är fallet kommer VP säkerställa att informationen förs vidare orörd i samtliga utgående anrop

Headers för att stödja WSDL-lookup

. Om inte, kastas en exception.

Kodblock
http.forwarded.header.xfor
http.forwarded.header.host
http.forwarded.header.port
http.forwarded.header.proto

valfria, men obligatoriska för att stödja WSDL-lookup om SLL/TLS trafik termineras framför VP

Se vidare under kapitlet Terminering av SSL/TLS framför VP, följ:
SKLTP VP -

Lastbalanserare / Reverse-proxy

Konfiguration

Kodblock
 x-skltp-correlation-id

Är default ett UUID.

Själva nyckeln till en loggpost är en korrelationsidentitet. Denna identitet exponeras också till konsumenter och producenter

*) används ej vid https-anrop då konsumenten tas från certifikat.

Exempelanrop till PingForConfiguration

Givet att VP är konfigurerat med följande i vp-config-overide.properties:

VP_INSTANCE_ID=VP_INSTANCEID

IP_WHITE_LIST=<Konsumentens ip adress>

Och klienten bifogar följande http headers och värde:

Kodblock
x-vp-sender-id=KLIENTS HSAID (en konsumentens med behörighet i VPs TAK)
x-vp-instance-id=VP_INSTANCEID (matchar VP instansens id ovan)
 

Request

curl till PingForConfiguration med korrekta http headers angivna

Kodblock
curl -H "Content-Type: text/xml; charset=utf-8" -H "x-vp-sender-id: KLIENTS HSAID" -H "x-vp-instance-id: VP_INSTANCEID" -d @PingForConfigurationRequest.xml -X POST http://localhost:8080/vp/itintegration/monitoring/PingForConfiguration/1/rivtabp21

PingForConfigurationRequest.xml

Kodblock
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:riv:itintegration:registry:1" xmlns:urn1="urn:riv:itintegration:monitoring:PingForConfigurationResponder:1">
  <soapenv:Header>
    <urn:LogicalAddress>Test</urn:LogicalAddress>
  </soapenv:Header>
  <soapenv:Body>
  <urn1:PingForConfiguration>
    <urn1:serviceContractNamespace>?</urn1:serviceContractNamespace>
    <urn1:logicalAddress>?</urn1:logicalAddress>
    <!--You may enter ANY elements at this point-->
    </urn1:PingForConfiguration>
  </soapenv:Body>
</soapenv:Envelope>

Response

PingForConfigurationResponse

Kodblock<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <mule:header xmlns:mule="http://www.muleumo.org/providers/soap/1.0"> <mule:MULE_CORRELATION_ID>06ce8dfa-adb6-11e3-80b1-812a0d6458ec </mule:MULE_CORRELATION_ID> <mule:MULE_CORRELATION_GROUP_SIZE>1 </mule:MULE_CORRELATION_GROUP_SIZE> <mule:MULE_CORRELATION_SEQUENCE>-1</mule:MULE_CORRELATION_SEQUENCE> </mule:header> </soap:Header> <soap:Body> <PingForConfigurationResponse xmlns="urn:riv:itintegration:monitoring:PingForConfigurationResponder:1" xmlns:ns2="urn:riv:itintegration:registry:1"> <version>V1.0</version> <pingDateTime>20140317102506</pingDateTime> <configuration> <name>Applikation</name> <value>VP</value> </configuration> <configuration> <name>Anropsbehörigheter</name> <value>219</value> </configuration> <configuration> <name>Logiska-adresser</name> <value>154</value> </configuration> </PingForConfigurationResponse> </soap:Body> </soap:Envelope>

, för att underlätta spårning.

Kodblock
 x-rivta-routing-history

Ej obligatorisk för närvarande.

Fr.o.m. VP version 4.0.1. Lista med HSAID för nationella/regionala plattformar, separerade med tecknet '#'. Används för att upptäcka rundgång. Se https://inera.atlassian.net/wiki/spaces/RTA/pages/3632863/RIV+Tekniska+Anvisningar+Tj+nsteplattform#Regel-#11:-Vidarebefordran-av-anropskedja-i-RIV-header

Kodblock
x-rivta-acting-on-behalf-of-hsaid

valfri

Från VP version 4.4.0. Uppdragsgivande verksamhet. Loggas av VP för att möjliggöra uppföljning. Se https://inera.atlassian.net/wiki/spaces/RTA/pages/3632875/RIV+Tekniska+Anvisningar+Basic+Profile+2.1#Regel-%2324%3A-Information-om-uppdragsgivande-part

*) används ej vid https-anrop då konsumenten tas från certifikat.