Debian Codegraph @

src/modules/copy/delegation/delegation-1.1.0.wsdl

raw
1 <?xml version="1.0" encoding="UTF-8"?>
2 <wsdl:definitions
3 targetNamespace="http://www.gridsite.org/namespaces/delegation-1"
4 xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
5 xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
6 xmlns:tns="http://www.gridsite.org/namespaces/delegation-1"
7 xmlns:xsd="http://www.w3.org/2001/XMLSchema">
8 <wsdl:types>
9 <xsd:schema targetNamespace="http://www.gridsite.org/namespaces/delegation-1">
10 <xsd:complexType name="DelegationExceptionType">
11 <xsd:sequence>
12 <xsd:element name="message" type="xsd:string" nillable="true">
13 <xsd:annotation>
14 <xsd:documentation>
15 The cause of the delegation exception on the server side.
16 </xsd:documentation>
17 </xsd:annotation>
18 </xsd:element>
19 </xsd:sequence>
20 </xsd:complexType>
21 <xsd:element name="DelegationException" type="tns:DelegationExceptionType"/>
22 <xsd:complexType name="NewProxyReq">
23 <xsd:annotation>
24 <xsd:documentation>
25 New proxy certificate request, containing the certificate
26 request and a generated delegation ID.
27 </xsd:documentation>
28 </xsd:annotation>
29 <xsd:sequence>
30 <xsd:element name="proxyRequest" nillable="true" type="xsd:string">
31 <xsd:annotation>
32 <xsd:documentation>
33 The new RFC 3280 style proxy certificate request
34 in PEM format with Base64 encoding.
35 </xsd:documentation>
36 </xsd:annotation>
37 </xsd:element>
38 <xsd:element name="delegationID" nillable="true" type="xsd:string">
39 <xsd:annotation>
40 <xsd:documentation>
41 The ID associated with the new delegation session.
42 </xsd:documentation>
43 </xsd:annotation>
44 </xsd:element>
45 </xsd:sequence>
46 </xsd:complexType>
47 </xsd:schema>
48 </wsdl:types>
49
50 <wsdl:message name="getProxyReqRequest">
51 <wsdl:part name="delegationID" type="xsd:string">
52 <wsdl:documentation>
53 The ID of the new delegation session, specified by the client.
54 The ID can be empty.
55 </wsdl:documentation>
56 </wsdl:part>
57 </wsdl:message>
58 <wsdl:message name="getProxyReqResponse">
59 <wsdl:part name="getProxyReqReturn" type="xsd:string">
60 <wsdl:documentation>
61 The new RFC 3280 style proxy certificate request
62 in PEM format with Base64 encoding.
63 </wsdl:documentation>
64 </wsdl:part>
65 </wsdl:message>
66
67 <wsdl:message name="putProxyRequest">
68 <wsdl:part name="delegationID" type="xsd:string">
69 <wsdl:documentation>
70 The ID of an already existing delegation session,
71 initiated by getProxyReq() or getNewProxyReq().
72 </wsdl:documentation>
73 </wsdl:part>
74 <wsdl:part name="proxy" type="xsd:string">
75 <wsdl:documentation>
76 RFC 3280 style proxy certificate, signed by the
77 client, in PEM format with Base64 encoding.
78 </wsdl:documentation>
79 </wsdl:part>
80 </wsdl:message>
81 <wsdl:message name="putProxyResponse"/>
82
83 <wsdl:message name="renewProxyReqRequest">
84 <wsdl:part name="delegationID" type="xsd:string">
85 <wsdl:documentation>
86 The ID of an already existing delegation session,
87 where the client wants to renew the delegated
88 credential.
89 </wsdl:documentation>
90 </wsdl:part>
91 </wsdl:message>
92 <wsdl:message name="renewProxyReqResponse">
93 <wsdl:part name="renewProxyReqReturn" type="xsd:string">
94 <wsdl:documentation>
95 The new RFC 3280 style proxy certificate request,
96 which is to replace the existing one,
97 in PEM format with Base64 encoding.
98 </wsdl:documentation>
99 </wsdl:part>
100 </wsdl:message>
101
102 <wsdl:message name="getNewProxyReqRequest"/>
103 <wsdl:message name="getNewProxyReqResponse">
104 <wsdl:part name="getNewProxyReqReturn" type="tns:NewProxyReq">
105 <wsdl:documentation>
106 The server side generated ID of the new delegation
107 session and the new RFC 3280 style proxy certificate
108 request in PEM format with Base64 encoding.
109 </wsdl:documentation>
110 </wsdl:part>
111 </wsdl:message>
112
113 <wsdl:message name="getTerminationTimeRequest">
114 <wsdl:part name="delegationID" type="xsd:string">
115 <wsdl:documentation>
116 The ID of an already existing delegation session to be queried.
117 </wsdl:documentation>
118 </wsdl:part>
119 </wsdl:message>
120 <wsdl:message name="getTerminationTimeResponse">
121 <wsdl:part name="getTerminationTimeReturn" type="xsd:dateTime">
122 <wsdl:documentation>
123 The date and time when the delegated credentials will expire.
124 </wsdl:documentation>
125 </wsdl:part>
126 </wsdl:message>
127
128 <wsdl:message name="destroyRequest">
129 <wsdl:part name="delegationID" type="xsd:string">
130 <wsdl:documentation>
131 The ID of an already existing delegation session to be destroyed.
132 </wsdl:documentation>
133 </wsdl:part>
134 </wsdl:message>
135 <wsdl:message name="destroyResponse"/>
136
137 <wsdl:message name="DelegationException">
138 <wsdl:part name="fault" element="tns:DelegationException"/>
139 </wsdl:message>
140
141 <wsdl:portType name="Delegation">
142 <wsdl:documentation>
143 Delegation interface.
144 </wsdl:documentation>
145
146 <wsdl:operation name="getProxyReq" parameterOrder="delegationID">
147 <wsdl:documentation>
148 <para>
149 Starts the delegation procedure by asking for a certificate
150 signing request from the server. The server answers with a
151 certificate signing request which includes the public key
152 for the new delegated credentials. putProxy() has to be
153 called to finish the procedure.
154 </para>
155 <orderedlist>
156 <listitem><para>
157 Check if a delegation ID was provided. If not, generate a delegation
158 id by hashing the client DN and client VOMS attributes.
159 </para></listitem>
160 <listitem><para>
161 Check if the delegation ID already exists in the
162 <emphasis>storage-area</emphasis>. If it does
163 (a credential renewal is happening), check
164 existing info (DN and VOMS attributes) against client info.
165 Throw exception if they do not match.
166 </para></listitem>
167 <listitem><para>
168 Create a new private/public key-pair (see also <emphasis>Key
169 Generation Semantics</emphasis>).
170 </para></listitem>
171 <listitem><para>
172 Generate a new proxy certificate request.
173 </para></listitem>
174 <listitem><para>
175 Store private key and cert request in
176 <emphasis>storage-cache-area</emphasis>, along with the
177 requesting DN and VOMS attributes.
178 </para></listitem>
179 </orderedlist>
180 </wsdl:documentation>
181 <wsdl:input message="tns:getProxyReqRequest" name="getProxyReqRequest"/>
182 <wsdl:output message="tns:getProxyReqResponse" name="getProxyReqResponse"/>
183 <wsdl:fault message="tns:DelegationException" name="DelegationException">
184 <wsdl:documentation>
185 The client's DN and VOMS attributes do not match the stored ones,
186 i.e. the client is not authorized.
187 </wsdl:documentation>
188 </wsdl:fault>
189 </wsdl:operation>
190
191 <wsdl:operation name="getNewProxyReq">
192 <wsdl:documentation>
193 <para>
194 Starts the delegation procedure by asking for a certificate
195 signing request from the server. The server answers with a
196 certificate signing request which includes the public key
197 for the new delegated credentials. putProxy() has to be
198 called to finish the procedure.
199 </para>
200 <orderedlist>
201 <listitem><para>
202 Generate a delegation
203 ID by hashing the client DN and client VOMS attributes.
204 </para></listitem>
205 <listitem><para>
206 Check if the delegation ID already exists in the
207 <emphasis>storage-area</emphasis>. If it does, check
208 existing info (DN and VOMS attributes) against client info.
209 Throw exception if they do not match, because then this is
210 the rare case of hash collision, i.e. two different clients
211 are mapped to the same delegation ID.
212 </para></listitem>
213 <listitem><para>
214 Create a new private/public key-pair (see also <emphasis>Key
215 Generation Semantics</emphasis>).
216 </para></listitem>
217 <listitem><para>
218 Generate a new certificate request.
219 </para></listitem>
220 <listitem><para>
221 Store private key and cert request in
222 <emphasis>storage-cache-area</emphasis>, along with the
223 requesting DN and VOMS attributes.
224 </para></listitem>
225 </orderedlist>
226 </wsdl:documentation>
227 <wsdl:input message="tns:getNewProxyReqRequest" name="getNewProxyReqRequest"/>
228 <wsdl:output message="tns:getNewProxyReqResponse" name="getNewProxyReqResponse"/>
229 <wsdl:fault message="tns:DelegationException" name="DelegationException">
230 <wsdl:documentation>
231 There were already credentials associated to the delegation ID.
232 </wsdl:documentation>
233 </wsdl:fault>
234 </wsdl:operation>
235
236 <wsdl:operation name="putProxy" parameterOrder="delegationID proxy">
237 <wsdl:documentation>
238 <para>
239 Finishes the delegation procedure by sending the signed
240 proxy certificate to the server.
241 </para>
242 <orderedlist>
243 <listitem><para>
244 Check if a delegation ID was provided. If not, generate a
245 delegation id by hashing the client DN and client VOMS
246 attributes.
247 </para></listitem>
248 <listitem><para>
249 Check if the delegation ID already exists in the
250 <emphasis>storage-area</emphasis>. If it does, check
251 existing info (DN and VOMS attributes) against client info.
252 Throw exception if it does not match.
253 </para></listitem>
254 <listitem><para>
255 Check, if client information matches proxy information.
256 </para></listitem>
257 <listitem><para>
258 Check given proxy against private key of delegation ID in
259 <emphasis>storage-cache-area</emphasis>. If they do not
260 match, throw exception.
261 </para></listitem>
262 <listitem><para>
263 Store proxy in <emphasis>storage-area</emphasis>
264 and clean up the <emphasis>storage-cache-area</emphasis>.
265 </para></listitem>
266 </orderedlist>
267 </wsdl:documentation>
268 <wsdl:input message="tns:putProxyRequest" name="putProxyRequest"/>
269 <wsdl:output message="tns:putProxyResponse" name="putProxyResponse"/>
270 <wsdl:fault message="tns:DelegationException" name="DelegationException">
271 <wsdl:documentation>
272 <para>
273 There were no cached credentials associated to the delegation ID
274 (neither <link linkend="Delegation.getNewProxyReq">
275 getNewProxyReq()</link> nor
276 <link linkend="Delegation.renewProxyReq">
277 renewProxyReq()</link> was called previously),
278 or the client's DN and VOMS attributes do not match the stored ones,
279 i.e. the client is not authorized.
280 </para>
281 </wsdl:documentation>
282 </wsdl:fault>
283 </wsdl:operation>
284
285 <wsdl:operation name="renewProxyReq" parameterOrder="delegationID">
286 <wsdl:documentation>
287 <para>
288 Restarts the delegation procedure by asking for a certificate
289 signing request from the server for an already existing delegation ID.
290 The server answers with a certificate signing request which includes
291 the public key for new delegated credentials. putProxy() has to be
292 called to finish the procedure.
293 </para>
294 <orderedlist>
295 <listitem><para>
296 Check if a delegation ID was provided. If not, generate a delegation
297 id by hashing the client DN and client VOMS attributes.
298 </para></listitem>
299 <listitem><para>
300 Check if the delegation ID already exists in the
301 <emphasis>storage-area</emphasis>. If it does
302 not, then throw an exception.
303 </para></listitem>
304 <listitem><para>
305 Check if the existing info (DN and VOMS attributes) against client info.
306 Throw exception if they do not match.
307 </para></listitem>
308 <listitem><para>
309 Create a new private/public key-pair (see also <emphasis>Key
310 Generation Semantics</emphasis>).
311 </para></listitem>
312 <listitem><para>
313 Generate a new certificate request.
314 </para></listitem>
315 <listitem><para>
316 Store private key and cert request in
317 <emphasis>storage-cache-area</emphasis>, along with the
318 requesting DN and VOMS attributes.
319 </para></listitem>
320 </orderedlist>
321 </wsdl:documentation>
322 <wsdl:input message="tns:renewProxyReqRequest" name="renewProxyReqRequest"/>
323 <wsdl:output message="tns:renewProxyReqResponse" name="renewProxyReqResponse"/>
324 <wsdl:fault message="tns:DelegationException" name="DelegationException">
325 <wsdl:documentation>
326 There were no credentials associated to the delegation ID, or the
327 client's DN and VOMS attributes do not match the stored ones, i.e.
328 the client is not authorized.
329 </wsdl:documentation>
330 </wsdl:fault>
331 </wsdl:operation>
332
333 <wsdl:operation name="getTerminationTime" parameterOrder="delegationID">
334 <wsdl:documentation>
335 Returns the termination (expiration) date and time of the credential,
336 associated with the given delegaion ID. If there was no delegation ID,
337 then generate one by hashing the client DN and client VOMS attributes.
338 </wsdl:documentation>
339 <wsdl:input message="tns:getTerminationTimeRequest" name="getTerminationTimeRequest"/>
340 <wsdl:output message="tns:getTerminationTimeResponse" name="getTerminationTimeResponse"/>
341 <wsdl:fault message="tns:DelegationException" name="DelegationException">
342 <wsdl:documentation>
343 There were no credentials associated to the delegation ID, or the
344 client's DN and VOMS attributes do not match the stored ones, i.e.
345 the client is not authorized.
346 </wsdl:documentation>
347 </wsdl:fault>
348 </wsdl:operation>
349
350
351 <wsdl:operation name="destroy" parameterOrder="delegationID">
352 <wsdl:documentation>
353 Destroys the delegated credentials associated with the
354 given delegation ID immediately. If there was no delegation ID,
355 then generate one by hashing the client DN and client VOMS attributes.
356 </wsdl:documentation>
357 <wsdl:input message="tns:destroyRequest" name="destroyRequest"/>
358 <wsdl:output message="tns:destroyResponse" name="destroyResponse"/>
359 <wsdl:fault message="tns:DelegationException" name="DelegationException">
360 <wsdl:documentation>
361 There were no credentials associated to the delegation ID, or the
362 client's DN and VOMS attributes do not match the stored ones, i.e.
363 the client is not authorized.
364 </wsdl:documentation>
365 </wsdl:fault>
366 </wsdl:operation>
367
368 </wsdl:portType>
369
370 <wsdl:binding name="DelegationSoapBinding" type="tns:Delegation">
371 <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
372
373 <wsdl:operation name="getProxyReq">
374 <wsdlsoap:operation soapAction=""/>
375 <wsdl:input name="getProxyReqRequest">
376 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
377 </wsdl:input>
378 <wsdl:output name="getProxyReqResponse">
379 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
380 </wsdl:output>
381 <wsdl:fault name="DelegationException">
382 <wsdlsoap:fault name="DelegationException" use="literal"/>
383 </wsdl:fault>
384 </wsdl:operation>
385
386 <wsdl:operation name="getNewProxyReq">
387 <wsdlsoap:operation soapAction=""/>
388 <wsdl:input name="getNewProxyReqRequest">
389 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
390 </wsdl:input>
391 <wsdl:output name="getNewProxyReqResponse">
392 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
393 </wsdl:output>
394 <wsdl:fault name="DelegationException">
395 <wsdlsoap:fault name="DelegationException" use="literal"/>
396 </wsdl:fault>
397 </wsdl:operation>
398
399 <wsdl:operation name="renewProxyReq">
400 <wsdlsoap:operation soapAction=""/>
401 <wsdl:input name="renewProxyReqRequest">
402 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
403 </wsdl:input>
404 <wsdl:output name="renewProxyReqResponse">
405 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
406 </wsdl:output>
407 <wsdl:fault name="DelegationException">
408 <wsdlsoap:fault name="DelegationException" use="literal"/>
409 </wsdl:fault>
410 </wsdl:operation>
411
412 <wsdl:operation name="putProxy">
413 <wsdlsoap:operation soapAction=""/>
414 <wsdl:input name="putProxyRequest">
415 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
416 </wsdl:input>
417 <wsdl:output name="putProxyResponse">
418 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
419 </wsdl:output>
420 <wsdl:fault name="DelegationException">
421 <wsdlsoap:fault name="DelegationException" use="literal"/>
422 </wsdl:fault>
423 </wsdl:operation>
424
425 <wsdl:operation name="getTerminationTime">
426 <wsdlsoap:operation soapAction=""/>
427 <wsdl:input name="getTerminationTimeRequest">
428 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
429 </wsdl:input>
430 <wsdl:output name="getTerminationTimeResponse">
431 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
432 </wsdl:output>
433 <wsdl:fault name="DelegationException">
434 <wsdlsoap:fault name="DelegationException" use="literal"/>
435 </wsdl:fault>
436 </wsdl:operation>
437
438 <wsdl:operation name="destroy">
439 <wsdlsoap:operation soapAction=""/>
440 <wsdl:input name="destroyRequest">
441 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
442 </wsdl:input>
443 <wsdl:output name="destroyResponse">
444 <wsdlsoap:body namespace="http://www.gridsite.org/namespaces/delegation-1" use="literal"/>
445 </wsdl:output>
446 <wsdl:fault name="DelegationException">
447 <wsdlsoap:fault name="DelegationException" use="literal"/>
448 </wsdl:fault>
449 </wsdl:operation>
450
451 </wsdl:binding>
452
453 <wsdl:service name="DelegationService">
454 <wsdl:port binding="tns:DelegationSoapBinding" name="gridsite-delegation">
455 <wsdlsoap:address location="https://localhost:8443/glite-security-delegation"/>
456 </wsdl:port>
457 </wsdl:service>
458
459 </wsdl:definitions>