Interfaccia SOAP per il recupero delle informazioni crittografiche

GovWay gestisce l’endpoint dedicato all’esposizione delle informazioni crittografiche correnti, messe a disposizione dal servizio, in conformità al formato previsto dalla specifica WSDL riportata di seguito.

L’endpoint consente inoltre di richiedere, tramite un parametro opzionale incluso nella richiesta, le informazioni crittografiche associate a uno specifico signalId, abilitando l’accesso anche a eventuali dati storici correlati.

Listato 2 Specifica WSDL - Risorsa di pseudoanonimizzazione
 1     <?xml version="1.0" encoding="UTF-8"?>
 2     <wsdl:definitions
 3         name="SignalHubTestSOAP12"
 4         targetNamespace="http://govway.org/pdnd/signalhub"
 5         xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
 6         xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
 7         xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 8         xmlns:tns="http://govway.org/pdnd/signalhub">
 9
10         <!-- Types -->
11         <wsdl:types>
12             <xsd:schema targetNamespace="http://govway.org/pdnd/signalhub"
13                         elementFormDefault="qualified">
14
15                 <!-- Input element -->
16                 <xsd:element name="pseudonymization">
17                     <xsd:complexType>
18                         <xsd:sequence>
19                             <xsd:element name="signalId" type="xsd:string" minOccurs="0"/>
20                         </xsd:sequence>
21                     </xsd:complexType>
22                 </xsd:element>
23
24                 <!-- Output element -->
25                 <xsd:element name="pseudonymizationResponse">
26                     <xsd:complexType>
27                         <xsd:sequence>
28                             <xsd:element name="cryptoHashFunction" type="xsd:string"/>
29                             <xsd:element name="seed" type="xsd:string"/>
30                         </xsd:sequence>
31                     </xsd:complexType>
32                 </xsd:element>
33
34             </xsd:schema>
35         </wsdl:types>
36
37         <!-- Messages -->
38         <wsdl:message name="pseudonymization">
39             <wsdl:part name="parameters" element="tns:pseudonymization"/>
40         </wsdl:message>
41
42         <wsdl:message name="pseudonymizationResponse">
43             <wsdl:part name="parameters" element="tns:pseudonymizationResponse"/>
44         </wsdl:message>
45
46         <!-- Port Type -->
47         <wsdl:portType name="SignalHubTestSOAP12">
48             <wsdl:operation name="pseudonymization">
49                 <wsdl:input message="tns:pseudonymization"/>
50                 <wsdl:output message="tns:pseudonymizationResponse"/>
51             </wsdl:operation>
52         </wsdl:portType>
53
54         <!-- Binding -->
55         <wsdl:binding name="CryptoInfoBinding" type="tns:SignalHubTestSOAP12">
56             <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
57             <wsdl:operation name="pseudonymization">
58                 <soap12:operation soapAction="pseudonymization"/>
59                 <wsdl:input>
60                     <soap12:body use="literal"/>
61                 </wsdl:input>
62                 <wsdl:output>
63                     <soap12:body use="literal"/>
64                 </wsdl:output>
65             </wsdl:operation>
66         </wsdl:binding>
67
68         <!-- Service -->
69         <wsdl:service name="SignalHubTestSOAP12">
70             <wsdl:port name="CryptoInfoPort" binding="tns:CryptoInfoBinding">
71                 <soap12:address location="http://localhost:8080/crypto/GetSeed"/>
72             </wsdl:port>
73         </wsdl:service>
74
75     </wsdl:definitions>

Come definito nel WSDL il target namespace degli elementi inerenti alla pseudoanonimizzazione risulta essere http://govway.org/pdnd/signalhub. L’esposizione dell’operazione si adatta automaticamente alla versione del protocollo SOAP utilizzata nella richiesta ricevuta, garantendo piena compatibilità sia con SOAP 1.1 che con SOAP 1.2.

Il namespace utilizzato può essere personalizzato impostando la Proprietà pdnd.signalHub.namespace all’interno della schermata di configurazione dell’erogazione interessata come mostrato nella figura “Fig. 302”

../../../_images/SignalHubErogazioneCustomNamespace.png

Fig. 302 Schermata di configurazione della proprietà per impostare un namespace personalizzato.