05d516ec15d8c8e0397af95d3350988f435d8d39
[aaf/authz.git] / docs / AAF-API-Documentation / AAF-API-Documentation.rst
1 AT&T Auth Tool \r
2 ==============\r
3 \r
4 --------------\r
5 \r
6 AAF 2.0 RESTful interface\r
7 =========================\r
8 \r
9 --------------\r
10 \r
11 Accessing RESTful\r
12 -----------------\r
13 \r
14 AAF RESTful service is secured by the following:\r
15 \r
16 The Client must utilize HTTP/S. Non Secure HTTP is not acceptable\r
17 \r
18 The Client MUST supply an Identity validated by one of the following mechanisms\r
19 \r
20 -  Valid Global Login Cookie (CSP)\r
21 -  BASIC AUTH protocol using CSO Registered MechID, provisioned in AAF\r
22 -  (Near Future) Application level Certificate & oAuth\r
23 \r
24 Responses\r
25 \r
26 Each API Entity listed shows what structure will be accepted by service (ContentType) or responded with by service (Accept). Therefore, use these in making your call. Critical for PUT/POST.\r
27 \r
28 Each API call may respond with JSON or XML. Choose the ContentType/Accept that has +json after the type for JSON or +xml after the Type for XML\r
29 \r
30 XSDs for Versions\r
31 \r
32 \r
33 AAF can support multiple Versions of the API. Choose the ContentType/Accept that has the appropriate version=?.?\r
34 \r
35 \r
36 Character Restrictions\r
37 \r
38 -  Character Restrictions must depend on the Enforcement Point used\r
39 -  Most AAF usage will be AAF Enforcement Point Characters for Instance and Action are:\r
40     *a-zA-Z0-9,.()\_-=%*\r
41     For Instance, you may declare a multi-dimensional key with : (colon) separator, example:\r
42 \r
43 Ask for a Consultation on how these are typically used, or, if your tool is the only Enforcement Point, if set may be expanded\r
44 \r
45 +--------------------+--------------------+--------------------+--------------------+\r
46 | Entity             | Method             | Path Info          | Description        |\r
47 +====================+====================+====================+====================+\r
48 | PERMISSION         | POST               | /authz/perm        | Create a           |\r
49 |                    |                    |                    | Permission         |\r
50 |                    |                    |                    |                    |\r
51 |                    |                    |                    | Permission         |\r
52 |                    |                    |                    | consists of:       |\r
53 |                    |                    |                    |                    |\r
54 |                    |                    |                    | -  type - a        |\r
55 |                    |                    |                    |    Namespace       |\r
56 |                    |                    |                    |    qualified       |\r
57 |                    |                    |                    |    identifier      |\r
58 |                    |                    |                    |    specifying what |\r
59 |                    |                    |                    |    kind of         |\r
60 |                    |                    |                    |    resource is     |\r
61 |                    |                    |                    |    being protected |\r
62 |                    |                    |                    | -  instance - a    |\r
63 |                    |                    |                    |    key, possibly   |\r
64 |                    |                    |                    |    multi-dimension |\r
65 |                    |                    |                    | al,                |\r
66 |                    |                    |                    |    that identifies |\r
67 |                    |                    |                    |    a specific      |\r
68 |                    |                    |                    |    instance of the |\r
69 |                    |                    |                    |    type            |\r
70 |                    |                    |                    | -  action - what   |\r
71 |                    |                    |                    |    kind of action  |\r
72 |                    |                    |                    |    is allowed      |\r
73 |                    |                    |                    |                    |\r
74 |                    |                    |                    | Note: instance and |\r
75 |                    |                    |                    | action can be an   |\r
76 |                    |                    |                    | \*                 |\r
77 |                    |                    |                    |                    |\r
78 |                    |                    |                    | Expected HTTP Code |\r
79 |                    |                    |                    |                    |\r
80 |                    |                    |                    | 201                |\r
81 |                    |                    |                    |                    |\r
82 |                    |                    |                    | Explicit HTTP      |\r
83 |                    |                    |                    | Error Codes        |\r
84 |                    |                    |                    |                    |\r
85 |                    |                    |                    | 403, 404, 406, 409 |\r
86 |                    |                    |                    |                    |\r
87 |                    |                    |                    | ContentType:       |\r
88 |                    |                    |                    |                    |\r
89 |                    |                    |                    | ` <./example/YXBwb |\r
90 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
91 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
92 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
93 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
94 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
95 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
96 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
97 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
98 |                    |                    |                    | lication/PermReque |\r
99 |                    |                    |                    | st+json;q=1.0;char |\r
100 |                    |                    |                    | set=utf-8;version= |\r
101 |                    |                    |                    | 2.0,application/js |\r
102 |                    |                    |                    | on;q=1.0;version=2 |\r
103 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
104 |                    |                    |                    |                    |\r
105 |                    |                    |                    | ` <./example/YXBwb |\r
106 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
107 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
108 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
109 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
110 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
111 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
112 |                    |                    |                    | jA=>`__\ applicati |\r
113 |                    |                    |                    | on/PermRequest+xml |\r
114 |                    |                    |                    | ;q=1.0;charset=utf |\r
115 |                    |                    |                    | -8;version=2.0,tex |\r
116 |                    |                    |                    | t/xml;q=1.0;versio |\r
117 |                    |                    |                    | n=2.0              |\r
118 +--------------------+--------------------+--------------------+--------------------+\r
119 |                    | PUT                | /authz/perm        | Set Description    |\r
120 |                    |                    |                    | for Permission     |\r
121 |                    |                    |                    |                    |\r
122 |                    |                    |                    | Add Description    |\r
123 |                    |                    |                    | Data to Perm       |\r
124 |                    |                    |                    |                    |\r
125 |                    |                    |                    | Expected HTTP Code |\r
126 |                    |                    |                    |                    |\r
127 |                    |                    |                    | 200                |\r
128 |                    |                    |                    |                    |\r
129 |                    |                    |                    | Explicit HTTP      |\r
130 |                    |                    |                    | Error Codes        |\r
131 |                    |                    |                    |                    |\r
132 |                    |                    |                    | 404, 406           |\r
133 |                    |                    |                    |                    |\r
134 |                    |                    |                    | ContentType:       |\r
135 |                    |                    |                    |                    |\r
136 |                    |                    |                    | ` <./example/YXBwb |\r
137 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
138 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
139 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
140 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
141 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
142 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
143 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
144 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
145 |                    |                    |                    | lication/PermReque |\r
146 |                    |                    |                    | st+json;q=1.0;char |\r
147 |                    |                    |                    | set=utf-8;version= |\r
148 |                    |                    |                    | 2.0,application/js |\r
149 |                    |                    |                    | on;q=1.0;version=2 |\r
150 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
151 |                    |                    |                    |                    |\r
152 |                    |                    |                    | ` <./example/YXBwb |\r
153 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
154 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
155 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
156 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
157 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
158 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
159 |                    |                    |                    | jA=>`__\ applicati |\r
160 |                    |                    |                    | on/PermRequest+xml |\r
161 |                    |                    |                    | ;q=1.0;charset=utf |\r
162 |                    |                    |                    | -8;version=2.0,tex |\r
163 |                    |                    |                    | t/xml;q=1.0;versio |\r
164 |                    |                    |                    | n=2.0              |\r
165 +--------------------+--------------------+--------------------+--------------------+\r
166 |                    | DELETE             | /authz/perm        | Delete a           |\r
167 |                    |                    |                    | Permission         |\r
168 |                    |                    |                    |                    |\r
169 |                    |                    |                    | Delete the         |\r
170 |                    |                    |                    | Permission         |\r
171 |                    |                    |                    | referenced by      |\r
172 |                    |                    |                    | PermKey.           |\r
173 |                    |                    |                    |                    |\r
174 |                    |                    |                    | You cannot         |\r
175 |                    |                    |                    | normally delete a  |\r
176 |                    |                    |                    | permission which   |\r
177 |                    |                    |                    | is still granted   |\r
178 |                    |                    |                    | to roles,          |\r
179 |                    |                    |                    |                    |\r
180 |                    |                    |                    | however the        |\r
181 |                    |                    |                    | "force" property   |\r
182 |                    |                    |                    | allows you to do   |\r
183 |                    |                    |                    | just that. To do   |\r
184 |                    |                    |                    | this: Add          |\r
185 |                    |                    |                    |                    |\r
186 |                    |                    |                    | 'force=true' as a  |\r
187 |                    |                    |                    | query parameter.   |\r
188 |                    |                    |                    |                    |\r
189 |                    |                    |                    | WARNING: Using     |\r
190 |                    |                    |                    | force will ungrant |\r
191 |                    |                    |                    | this permission    |\r
192 |                    |                    |                    | from all roles.    |\r
193 |                    |                    |                    | Use with care.     |\r
194 |                    |                    |                    |                    |\r
195 |                    |                    |                    | Expected HTTP Code |\r
196 |                    |                    |                    |                    |\r
197 |                    |                    |                    | 200                |\r
198 |                    |                    |                    |                    |\r
199 |                    |                    |                    | Explicit HTTP      |\r
200 |                    |                    |                    | Error Codes        |\r
201 |                    |                    |                    |                    |\r
202 |                    |                    |                    | 404, 406           |\r
203 |                    |                    |                    |                    |\r
204 |                    |                    |                    | ContentType:       |\r
205 |                    |                    |                    |                    |\r
206 |                    |                    |                    | ` <./example/YXBwb |\r
207 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
208 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
209 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
210 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
211 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
212 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
213 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
214 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
215 |                    |                    |                    | lication/PermReque |\r
216 |                    |                    |                    | st+json;q=1.0;char |\r
217 |                    |                    |                    | set=utf-8;version= |\r
218 |                    |                    |                    | 2.0,application/js |\r
219 |                    |                    |                    | on;q=1.0;version=2 |\r
220 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
221 |                    |                    |                    |                    |\r
222 |                    |                    |                    | ` <./example/YXBwb |\r
223 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
224 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
225 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
226 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
227 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
228 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
229 |                    |                    |                    | jA=>`__\ applicati |\r
230 |                    |                    |                    | on/PermRequest+xml |\r
231 |                    |                    |                    | ;q=1.0;charset=utf |\r
232 |                    |                    |                    | -8;version=2.0,tex |\r
233 |                    |                    |                    | t/xml;q=1.0;versio |\r
234 |                    |                    |                    | n=2.0              |\r
235 +--------------------+--------------------+--------------------+--------------------+\r
236 |                    | DELETE             | /authz/perm/:name/ | Delete a           |\r
237 |                    |                    | :type/:action      | Permission         |\r
238 |                    |                    |                    |                    |\r
239 |                    |                    |                    | Delete the         |\r
240 |                    |                    |                    | Permission         |\r
241 |                    |                    |                    | referenced by      |\r
242 |                    |                    |                    | :type :instance    |\r
243 |                    |                    |                    | :action            |\r
244 |                    |                    |                    |                    |\r
245 |                    |                    |                    | You cannot         |\r
246 |                    |                    |                    | normally delete a  |\r
247 |                    |                    |                    | permission which   |\r
248 |                    |                    |                    | is still granted   |\r
249 |                    |                    |                    | to roles,          |\r
250 |                    |                    |                    |                    |\r
251 |                    |                    |                    | however the        |\r
252 |                    |                    |                    | "force" property   |\r
253 |                    |                    |                    | allows you to do   |\r
254 |                    |                    |                    | just that. To do   |\r
255 |                    |                    |                    | this: Add          |\r
256 |                    |                    |                    |                    |\r
257 |                    |                    |                    | 'force=true' as a  |\r
258 |                    |                    |                    | query parameter    |\r
259 |                    |                    |                    |                    |\r
260 |                    |                    |                    | WARNING: Using     |\r
261 |                    |                    |                    | force will ungrant |\r
262 |                    |                    |                    | this permission    |\r
263 |                    |                    |                    | from all roles.    |\r
264 |                    |                    |                    | Use with care.     |\r
265 |                    |                    |                    |                    |\r
266 |                    |                    |                    | --------------     |\r
267 |                    |                    |                    |                    |\r
268 |                    |                    |                    | Parameters         |\r
269 |                    |                    |                    |                    |\r
270 |                    |                    |                    | type : string      |\r
271 |                    |                    |                    | (Required)         |\r
272 |                    |                    |                    |                    |\r
273 |                    |                    |                    | instance : string  |\r
274 |                    |                    |                    | (Required)         |\r
275 |                    |                    |                    |                    |\r
276 |                    |                    |                    | action : string    |\r
277 |                    |                    |                    | (Required)         |\r
278 |                    |                    |                    |                    |\r
279 |                    |                    |                    | Expected HTTP Code |\r
280 |                    |                    |                    |                    |\r
281 |                    |                    |                    | 200                |\r
282 |                    |                    |                    |                    |\r
283 |                    |                    |                    | Explicit HTTP      |\r
284 |                    |                    |                    | Error Codes        |\r
285 |                    |                    |                    |                    |\r
286 |                    |                    |                    | 404, 406           |\r
287 |                    |                    |                    |                    |\r
288 |                    |                    |                    | ContentType:       |\r
289 |                    |                    |                    |                    |\r
290 |                    |                    |                    | ` <./example/YXBwb |\r
291 |                    |                    |                    | GljYXRpb24vUGVybUt |\r
292 |                    |                    |                    | leStqc29uO3E9MS4wO |\r
293 |                    |                    |                    | 2NoYXJzZXQ9dXRmLTg |\r
294 |                    |                    |                    | 7dmVyc2lvbj0yLjAsY |\r
295 |                    |                    |                    | XBwbGljYXRpb24vanN |\r
296 |                    |                    |                    | vbjtxPTEuMDt2ZXJza |\r
297 |                    |                    |                    | W9uPTIuMCwqLyo7cT0 |\r
298 |                    |                    |                    | xLjA=>`__\ applica |\r
299 |                    |                    |                    | tion/PermKey+json; |\r
300 |                    |                    |                    | q=1.0;charset=utf- |\r
301 |                    |                    |                    | 8;version=2.0,appl |\r
302 |                    |                    |                    | ication/json;q=1.0 |\r
303 |                    |                    |                    | ;version=2.0,\*/\* |\r
304 |                    |                    |                    | ;q=1.0             |\r
305 |                    |                    |                    |                    |\r
306 |                    |                    |                    | ` <./example/YXBwb |\r
307 |                    |                    |                    | GljYXRpb24vUGVybUt |\r
308 |                    |                    |                    | leSt4bWw7cT0xLjA7Y |\r
309 |                    |                    |                    | 2hhcnNldD11dGYtODt |\r
310 |                    |                    |                    | 2ZXJzaW9uPTIuMCx0Z |\r
311 |                    |                    |                    | Xh0L3htbDtxPTEuMDt |\r
312 |                    |                    |                    | 2ZXJzaW9uPTIuMA==> |\r
313 |                    |                    |                    | `__\ application/P |\r
314 |                    |                    |                    | ermKey+xml;q=1.0;c |\r
315 |                    |                    |                    | harset=utf-8;versi |\r
316 |                    |                    |                    | on=2.0,text/xml;q= |\r
317 |                    |                    |                    | 1.0;version=2.0    |\r
318 +--------------------+--------------------+--------------------+--------------------+\r
319 |                    | PUT                | /authz/perm/:type/ | Update a           |\r
320 |                    |                    | :instance/:action  | Permission         |\r
321 |                    |                    |                    |                    |\r
322 |                    |                    |                    | Rename the         |\r
323 |                    |                    |                    | Permission         |\r
324 |                    |                    |                    | referenced by      |\r
325 |                    |                    |                    | :type :instance    |\r
326 |                    |                    |                    | :action, and       |\r
327 |                    |                    |                    | rename             |\r
328 |                    |                    |                    | (copy/delete) to   |\r
329 |                    |                    |                    | the Permission     |\r
330 |                    |                    |                    | described in       |\r
331 |                    |                    |                    | PermRequest        |\r
332 |                    |                    |                    |                    |\r
333 |                    |                    |                    | --------------     |\r
334 |                    |                    |                    |                    |\r
335 |                    |                    |                    | Parameters         |\r
336 |                    |                    |                    |                    |\r
337 |                    |                    |                    | type : string      |\r
338 |                    |                    |                    | (Required)         |\r
339 |                    |                    |                    |                    |\r
340 |                    |                    |                    | instance : string  |\r
341 |                    |                    |                    | (Required)         |\r
342 |                    |                    |                    |                    |\r
343 |                    |                    |                    | action : string    |\r
344 |                    |                    |                    | (Required)         |\r
345 |                    |                    |                    |                    |\r
346 |                    |                    |                    | Expected HTTP Code |\r
347 |                    |                    |                    |                    |\r
348 |                    |                    |                    | 200                |\r
349 |                    |                    |                    |                    |\r
350 |                    |                    |                    | Explicit HTTP      |\r
351 |                    |                    |                    | Error Codes        |\r
352 |                    |                    |                    |                    |\r
353 |                    |                    |                    | 404, 406, 409      |\r
354 |                    |                    |                    |                    |\r
355 |                    |                    |                    | ContentType:       |\r
356 |                    |                    |                    |                    |\r
357 |                    |                    |                    | ` <./example/YXBwb |\r
358 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
359 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
360 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
361 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
362 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
363 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
364 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
365 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
366 |                    |                    |                    | lication/PermReque |\r
367 |                    |                    |                    | st+json;q=1.0;char |\r
368 |                    |                    |                    | set=utf-8;version= |\r
369 |                    |                    |                    | 2.0,application/js |\r
370 |                    |                    |                    | on;q=1.0;version=2 |\r
371 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
372 |                    |                    |                    |                    |\r
373 |                    |                    |                    | ` <./example/YXBwb |\r
374 |                    |                    |                    | GljYXRpb24vUGVybVJ |\r
375 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
376 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
377 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
378 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
379 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
380 |                    |                    |                    | jA=>`__\ applicati |\r
381 |                    |                    |                    | on/PermRequest+xml |\r
382 |                    |                    |                    | ;q=1.0;charset=utf |\r
383 |                    |                    |                    | -8;version=2.0,tex |\r
384 |                    |                    |                    | t/xml;q=1.0;versio |\r
385 |                    |                    |                    | n=2.0              |\r
386 +--------------------+--------------------+--------------------+--------------------+\r
387 |                    | GET                | /authz/perms/:type | Get Permissions by |\r
388 |                    |                    |                    | Type               |\r
389 |                    |                    |                    |                    |\r
390 |                    |                    |                    | List All           |\r
391 |                    |                    |                    | Permissions that   |\r
392 |                    |                    |                    | match the :type    |\r
393 |                    |                    |                    | element of the key |\r
394 |                    |                    |                    |                    |\r
395 |                    |                    |                    | --------------     |\r
396 |                    |                    |                    |                    |\r
397 |                    |                    |                    | Parameters         |\r
398 |                    |                    |                    |                    |\r
399 |                    |                    |                    | type : string      |\r
400 |                    |                    |                    | (Required)         |\r
401 |                    |                    |                    |                    |\r
402 |                    |                    |                    | Expected HTTP Code |\r
403 |                    |                    |                    |                    |\r
404 |                    |                    |                    | 200                |\r
405 |                    |                    |                    |                    |\r
406 |                    |                    |                    | Explicit HTTP      |\r
407 |                    |                    |                    | Error Codes        |\r
408 |                    |                    |                    |                    |\r
409 |                    |                    |                    | 404, 406           |\r
410 |                    |                    |                    |                    |\r
411 |                    |                    |                    | Accept:            |\r
412 |                    |                    |                    |                    |\r
413 |                    |                    |                    | ` <./example/YXBwb |\r
414 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
415 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
416 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
417 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
418 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
419 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
420 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
421 |                    |                    |                    | w>`__\ application |\r
422 |                    |                    |                    | /Perms+json;q=1.0; |\r
423 |                    |                    |                    | charset=utf-8;vers |\r
424 |                    |                    |                    | ion=2.0,applicatio |\r
425 |                    |                    |                    | n/json;q=1.0;versi |\r
426 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
427 |                    |                    |                    |                    |\r
428 |                    |                    |                    | ` <./example/YXBwb |\r
429 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
430 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
431 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
432 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
433 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
434 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
435 |                    |                    |                    |  application/Perms |\r
436 |                    |                    |                    | +xml;q=1.0;charset |\r
437 |                    |                    |                    | =utf-8;version=2.0 |\r
438 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
439 |                    |                    |                    | rsion=2.0          |\r
440 +--------------------+--------------------+--------------------+--------------------+\r
441 |                    | GET                | /authz/perms/:type | Get Permissions by |\r
442 |                    |                    | /:instance/:action | Key                |\r
443 |                    |                    |                    |                    |\r
444 |                    |                    |                    | List Permissions   |\r
445 |                    |                    |                    | that match key;    |\r
446 |                    |                    |                    | :type, :instance   |\r
447 |                    |                    |                    | and :action        |\r
448 |                    |                    |                    |                    |\r
449 |                    |                    |                    | --------------     |\r
450 |                    |                    |                    |                    |\r
451 |                    |                    |                    | Parameters         |\r
452 |                    |                    |                    |                    |\r
453 |                    |                    |                    | type : string      |\r
454 |                    |                    |                    | (Required)         |\r
455 |                    |                    |                    |                    |\r
456 |                    |                    |                    | instance : string  |\r
457 |                    |                    |                    | (Required)         |\r
458 |                    |                    |                    |                    |\r
459 |                    |                    |                    | action : string    |\r
460 |                    |                    |                    | (Required)         |\r
461 |                    |                    |                    |                    |\r
462 |                    |                    |                    | Expected HTTP Code |\r
463 |                    |                    |                    |                    |\r
464 |                    |                    |                    | 200                |\r
465 |                    |                    |                    |                    |\r
466 |                    |                    |                    | Explicit HTTP      |\r
467 |                    |                    |                    | Error Codes        |\r
468 |                    |                    |                    |                    |\r
469 |                    |                    |                    | 404, 406           |\r
470 |                    |                    |                    |                    |\r
471 |                    |                    |                    | Accept:            |\r
472 |                    |                    |                    |                    |\r
473 |                    |                    |                    | ` <./example/YXBwb |\r
474 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
475 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
476 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
477 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
478 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
479 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
480 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
481 |                    |                    |                    | w>`__\ application |\r
482 |                    |                    |                    | /Perms+json;q=1.0; |\r
483 |                    |                    |                    | charset=utf-8;vers |\r
484 |                    |                    |                    | ion=2.0,applicatio |\r
485 |                    |                    |                    | n/json;q=1.0;versi |\r
486 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
487 |                    |                    |                    |                    |\r
488 |                    |                    |                    | ` <./example/YXBwb |\r
489 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
490 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
491 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
492 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
493 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
494 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
495 |                    |                    |                    |  application/Perms |\r
496 |                    |                    |                    | +xml;q=1.0;charset |\r
497 |                    |                    |                    | =utf-8;version=2.0 |\r
498 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
499 |                    |                    |                    | rsion=2.0          |\r
500 +--------------------+--------------------+--------------------+--------------------+\r
501 |                    | GET                | /authz/perms/ns/:n | Get PermsByNS      |\r
502 |                    |                    | s                  |                    |\r
503 |                    |                    |                    | List All           |\r
504 |                    |                    |                    | Permissions that   |\r
505 |                    |                    |                    | are in Namespace   |\r
506 |                    |                    |                    | :ns                |\r
507 |                    |                    |                    |                    |\r
508 |                    |                    |                    | --------------     |\r
509 |                    |                    |                    |                    |\r
510 |                    |                    |                    | Parameters         |\r
511 |                    |                    |                    |                    |\r
512 |                    |                    |                    | ns : string        |\r
513 |                    |                    |                    | (Required)         |\r
514 |                    |                    |                    |                    |\r
515 |                    |                    |                    | Expected HTTP Code |\r
516 |                    |                    |                    |                    |\r
517 |                    |                    |                    | 200                |\r
518 |                    |                    |                    |                    |\r
519 |                    |                    |                    | Explicit HTTP      |\r
520 |                    |                    |                    | Error Codes        |\r
521 |                    |                    |                    |                    |\r
522 |                    |                    |                    | 404, 406           |\r
523 |                    |                    |                    |                    |\r
524 |                    |                    |                    | Accept:            |\r
525 |                    |                    |                    |                    |\r
526 |                    |                    |                    | ` <./example/YXBwb |\r
527 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
528 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
529 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
530 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
531 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
532 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
533 |                    |                    |                    | j0yLjAsKi8qO3E9MC4 |\r
534 |                    |                    |                    | y>`__\ application |\r
535 |                    |                    |                    | /Perms+json;q=1.0; |\r
536 |                    |                    |                    | charset=utf-8;vers |\r
537 |                    |                    |                    | ion=2.0,applicatio |\r
538 |                    |                    |                    | n/json;q=1.0;versi |\r
539 |                    |                    |                    | on=2.0,\*/\*;q=0.2 |\r
540 |                    |                    |                    |                    |\r
541 |                    |                    |                    | ` <./example/YXBwb |\r
542 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
543 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
544 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
545 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
546 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
547 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
548 |                    |                    |                    |  application/Perms |\r
549 |                    |                    |                    | +xml;q=1.0;charset |\r
550 |                    |                    |                    | =utf-8;version=2.0 |\r
551 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
552 |                    |                    |                    | rsion=2.0          |\r
553 +--------------------+--------------------+--------------------+--------------------+\r
554 |                    | GET                | /authz/perms/role/ | Get Permissions by |\r
555 |                    |                    | :role              | Role               |\r
556 |                    |                    |                    |                    |\r
557 |                    |                    |                    | List All           |\r
558 |                    |                    |                    | Permissions that   |\r
559 |                    |                    |                    | are granted to     |\r
560 |                    |                    |                    | :role              |\r
561 |                    |                    |                    |                    |\r
562 |                    |                    |                    | --------------     |\r
563 |                    |                    |                    |                    |\r
564 |                    |                    |                    | Parameters         |\r
565 |                    |                    |                    |                    |\r
566 |                    |                    |                    | role : string      |\r
567 |                    |                    |                    | (Required)         |\r
568 |                    |                    |                    |                    |\r
569 |                    |                    |                    | Expected HTTP Code |\r
570 |                    |                    |                    |                    |\r
571 |                    |                    |                    | 200                |\r
572 |                    |                    |                    |                    |\r
573 |                    |                    |                    | Explicit HTTP      |\r
574 |                    |                    |                    | Error Codes        |\r
575 |                    |                    |                    |                    |\r
576 |                    |                    |                    | 404, 406           |\r
577 |                    |                    |                    |                    |\r
578 |                    |                    |                    | Accept:            |\r
579 |                    |                    |                    |                    |\r
580 |                    |                    |                    | ` <./example/YXBwb |\r
581 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
582 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
583 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
584 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
585 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
586 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
587 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
588 |                    |                    |                    | w>`__\ application |\r
589 |                    |                    |                    | /Perms+json;q=1.0; |\r
590 |                    |                    |                    | charset=utf-8;vers |\r
591 |                    |                    |                    | ion=2.0,applicatio |\r
592 |                    |                    |                    | n/json;q=1.0;versi |\r
593 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
594 |                    |                    |                    |                    |\r
595 |                    |                    |                    | ` <./example/YXBwb |\r
596 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
597 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
598 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
599 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
600 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
601 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
602 |                    |                    |                    |  application/Perms |\r
603 |                    |                    |                    | +xml;q=1.0;charset |\r
604 |                    |                    |                    | =utf-8;version=2.0 |\r
605 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
606 |                    |                    |                    | rsion=2.0          |\r
607 +--------------------+--------------------+--------------------+--------------------+\r
608 |                    | POST               | /authz/perms/user/ | Get Permissions by |\r
609 |                    |                    | :user              | User, Query AAF    |\r
610 |                    |                    |                    | Perms              |\r
611 |                    |                    |                    |                    |\r
612 |                    |                    |                    | List All           |\r
613 |                    |                    |                    | Permissions that   |\r
614 |                    |                    |                    | match user :user   |\r
615 |                    |                    |                    |                    |\r
616 |                    |                    |                    | 'user' must be     |\r
617 |                    |                    |                    | expressed as full  |\r
618 |                    |                    |                    | identity (ex:      |\r
619 |                    |                    |                    | id@full.domain.com |\r
620 |                    |                    |                    | )                  |\r
621 |                    |                    |                    |                    |\r
622 |                    |                    |                    | Present Queries as |\r
623 |                    |                    |                    | one or more        |\r
624 |                    |                    |                    | Permissions (see   |\r
625 |                    |                    |                    | ContentType Links  |\r
626 |                    |                    |                    | below for format). |\r
627 |                    |                    |                    |                    |\r
628 |                    |                    |                    | If the Caller is   |\r
629 |                    |                    |                    | Granted this       |\r
630 |                    |                    |                    | specific           |\r
631 |                    |                    |                    | Permission, and    |\r
632 |                    |                    |                    | the Permission is  |\r
633 |                    |                    |                    | valid              |\r
634 |                    |                    |                    |                    |\r
635 |                    |                    |                    | for the User, it   |\r
636 |                    |                    |                    | will be included   |\r
637 |                    |                    |                    | in response        |\r
638 |                    |                    |                    | Permissions, along |\r
639 |                    |                    |                    | with               |\r
640 |                    |                    |                    |                    |\r
641 |                    |                    |                    | all the normal     |\r
642 |                    |                    |                    | permissions on the |\r
643 |                    |                    |                    | 'GET' version of   |\r
644 |                    |                    |                    | this call. If it   |\r
645 |                    |                    |                    | is not             |\r
646 |                    |                    |                    |                    |\r
647 |                    |                    |                    | valid, or Caller   |\r
648 |                    |                    |                    | does not have      |\r
649 |                    |                    |                    | permission to see, |\r
650 |                    |                    |                    | it will be removed |\r
651 |                    |                    |                    | from the list      |\r
652 |                    |                    |                    |                    |\r
653 |                    |                    |                    | \*Note: This       |\r
654 |                    |                    |                    | design allows you  |\r
655 |                    |                    |                    | to make one call   |\r
656 |                    |                    |                    | for all expected   |\r
657 |                    |                    |                    | permissions        |\r
658 |                    |                    |                    |                    |\r
659 |                    |                    |                    | The permission to  |\r
660 |                    |                    |                    | be included MUST   |\r
661 |                    |                    |                    | be:                |\r
662 |                    |                    |                    |                    |\r
663 |                    |                    |                    | .access\|:[:key]\| |\r
664 |                    |                    |                    |                    |\r
665 |                    |                    |                    | examples:          |\r
666 |                    |                    |                    |                    |\r
667 |                    |                    |                    | com.onap.myns.acces |\r
668 |                    |                    |                    | s\|:ns\|write      |\r
669 |                    |                    |                    |                    |\r
670 |                    |                    |                    | com.onap.myns.acces |\r
671 |                    |                    |                    | s\|:role:myrole\|c |\r
672 |                    |                    |                    | reate              |\r
673 |                    |                    |                    |                    |\r
674 |                    |                    |                    | com.onap.myns.acces |\r
675 |                    |                    |                    | s\|:perm:mytype:my |\r
676 |                    |                    |                    | instance:myaction\ |\r
677 |                    |                    |                    | |read              |\r
678 |                    |                    |                    |                    |\r
679 |                    |                    |                    | --------------     |\r
680 |                    |                    |                    |                    |\r
681 |                    |                    |                    | Parameters         |\r
682 |                    |                    |                    |                    |\r
683 |                    |                    |                    | user : string      |\r
684 |                    |                    |                    | (Required)         |\r
685 |                    |                    |                    |                    |\r
686 |                    |                    |                    | Expected HTTP Code |\r
687 |                    |                    |                    |                    |\r
688 |                    |                    |                    | 200                |\r
689 |                    |                    |                    |                    |\r
690 |                    |                    |                    | Explicit HTTP      |\r
691 |                    |                    |                    | Error Codes        |\r
692 |                    |                    |                    |                    |\r
693 |                    |                    |                    | 404, 406           |\r
694 |                    |                    |                    |                    |\r
695 |                    |                    |                    | ContentType:       |\r
696 |                    |                    |                    |                    |\r
697 |                    |                    |                    | ` <./example/YXBwb |\r
698 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
699 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
700 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
701 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
702 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
703 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
704 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
705 |                    |                    |                    | w>`__\ application |\r
706 |                    |                    |                    | /Perms+json;q=1.0; |\r
707 |                    |                    |                    | charset=utf-8;vers |\r
708 |                    |                    |                    | ion=2.0,applicatio |\r
709 |                    |                    |                    | n/json;q=1.0;versi |\r
710 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
711 |                    |                    |                    |                    |\r
712 |                    |                    |                    | ` <./example/YXBwb |\r
713 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
714 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
715 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
716 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
717 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
718 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
719 |                    |                    |                    |  application/Perms |\r
720 |                    |                    |                    | +xml;q=1.0;charset |\r
721 |                    |                    |                    | =utf-8;version=2.0 |\r
722 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
723 |                    |                    |                    | rsion=2.0          |\r
724 +--------------------+--------------------+--------------------+--------------------+\r
725 |                    | GET                | /authz/perms/user/ | Get Permissions by |\r
726 |                    |                    | :user              | User               |\r
727 |                    |                    |                    |                    |\r
728 |                    |                    |                    | List All           |\r
729 |                    |                    |                    | Permissions that   |\r
730 |                    |                    |                    | match user :user   |\r
731 |                    |                    |                    |                    |\r
732 |                    |                    |                    | 'user' must be     |\r
733 |                    |                    |                    | expressed as full  |\r
734 |                    |                    |                    | identity (ex:      |\r
735 |                    |                    |                    | id@full.domain.com |\r
736 |                    |                    |                    | )                  |\r
737 |                    |                    |                    |                    |\r
738 |                    |                    |                    | --------------     |\r
739 |                    |                    |                    |                    |\r
740 |                    |                    |                    | Parameters         |\r
741 |                    |                    |                    |                    |\r
742 |                    |                    |                    | user : string      |\r
743 |                    |                    |                    | (Required)         |\r
744 |                    |                    |                    |                    |\r
745 |                    |                    |                    | Expected HTTP Code |\r
746 |                    |                    |                    |                    |\r
747 |                    |                    |                    | 200                |\r
748 |                    |                    |                    |                    |\r
749 |                    |                    |                    | Explicit HTTP      |\r
750 |                    |                    |                    | Error Codes        |\r
751 |                    |                    |                    |                    |\r
752 |                    |                    |                    | 404, 406           |\r
753 |                    |                    |                    |                    |\r
754 |                    |                    |                    | Accept:            |\r
755 |                    |                    |                    |                    |\r
756 |                    |                    |                    | ` <./example/YXBwb |\r
757 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
758 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
759 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
760 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
761 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
762 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
763 |                    |                    |                    | j0yLjAsKi8qO3E9MC4 |\r
764 |                    |                    |                    | y>`__\ application |\r
765 |                    |                    |                    | /Perms+json;q=1.0; |\r
766 |                    |                    |                    | charset=utf-8;vers |\r
767 |                    |                    |                    | ion=2.0,applicatio |\r
768 |                    |                    |                    | n/json;q=1.0;versi |\r
769 |                    |                    |                    | on=2.0,\*/\*;q=0.2 |\r
770 |                    |                    |                    |                    |\r
771 |                    |                    |                    | ` <./example/YXBwb |\r
772 |                    |                    |                    | GljYXRpb24vUGVybXM |\r
773 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
774 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
775 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
776 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
777 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
778 |                    |                    |                    |  application/Perms |\r
779 |                    |                    |                    | +xml;q=1.0;charset |\r
780 |                    |                    |                    | =utf-8;version=2.0 |\r
781 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
782 |                    |                    |                    | rsion=2.0          |\r
783 +--------------------+--------------------+--------------------+--------------------+\r
784 | ROLE               | POST               | /authz/role        | Create Role        |\r
785 |                    |                    |                    |                    |\r
786 |                    |                    |                    | Roles are part of  |\r
787 |                    |                    |                    | Namespaces         |\r
788 |                    |                    |                    |                    |\r
789 |                    |                    |                    | Examples:          |\r
790 |                    |                    |                    |                    |\r
791 |                    |                    |                    | -  com.onap.aaf -   |\r
792 |                    |                    |                    |    The team that   |\r
793 |                    |                    |                    |    created and     |\r
794 |                    |                    |                    |    maintains AAF   |\r
795 |                    |                    |                    | -  com.onap.csp -   |\r
796 |                    |                    |                    |    The team that   |\r
797 |                    |                    |                    |    created Global  |\r
798 |                    |                    |                    |    Login           |\r
799 |                    |                    |                    |                    |\r
800 |                    |                    |                    | Roles do not       |\r
801 |                    |                    |                    | include implied    |\r
802 |                    |                    |                    | permissions for an |\r
803 |                    |                    |                    | App. Instead, they |\r
804 |                    |                    |                    | contain explicit   |\r
805 |                    |                    |                    | Granted            |\r
806 |                    |                    |                    | Permissions by any |\r
807 |                    |                    |                    | Namespace in AAF   |\r
808 |                    |                    |                    | (See Permissions)  |\r
809 |                    |                    |                    |                    |\r
810 |                    |                    |                    | Restrictions on    |\r
811 |                    |                    |                    | Role Names:        |\r
812 |                    |                    |                    |                    |\r
813 |                    |                    |                    | -  Must start with |\r
814 |                    |                    |                    |    valid Namespace |\r
815 |                    |                    |                    |    name,           |\r
816 |                    |                    |                    |    terminated by . |\r
817 |                    |                    |                    |    (dot/period)    |\r
818 |                    |                    |                    | -  Allowed         |\r
819 |                    |                    |                    |    Characters are  |\r
820 |                    |                    |                    |    a-zA-Z0-9.\_-   |\r
821 |                    |                    |                    | -  role names are  |\r
822 |                    |                    |                    |    Case Sensitive  |\r
823 |                    |                    |                    |                    |\r
824 |                    |                    |                    | The right          |\r
825 |                    |                    |                    | questions to ask   |\r
826 |                    |                    |                    | for defining and   |\r
827 |                    |                    |                    | populating a Role  |\r
828 |                    |                    |                    | in AAF, therefore, |\r
829 |                    |                    |                    | are:               |\r
830 |                    |                    |                    |                    |\r
831 |                    |                    |                    | -  'What Job       |\r
832 |                    |                    |                    |    Function does   |\r
833 |                    |                    |                    |    this            |\r
834 |                    |                    |                    |    represent?'     |\r
835 |                    |                    |                    | -  'Does this      |\r
836 |                    |                    |                    |    person perform  |\r
837 |                    |                    |                    |    this Job        |\r
838 |                    |                    |                    |    Function?'      |\r
839 |                    |                    |                    |                    |\r
840 |                    |                    |                    | Expected HTTP Code |\r
841 |                    |                    |                    |                    |\r
842 |                    |                    |                    | 201                |\r
843 |                    |                    |                    |                    |\r
844 |                    |                    |                    | Explicit HTTP      |\r
845 |                    |                    |                    | Error Codes        |\r
846 |                    |                    |                    |                    |\r
847 |                    |                    |                    | 403, 404, 406, 409 |\r
848 |                    |                    |                    |                    |\r
849 |                    |                    |                    | ContentType:       |\r
850 |                    |                    |                    |                    |\r
851 |                    |                    |                    | ` <./example/YXBwb |\r
852 |                    |                    |                    | GljYXRpb24vUm9sZVJ |\r
853 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
854 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
855 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
856 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
857 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
858 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
859 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
860 |                    |                    |                    | lication/RoleReque |\r
861 |                    |                    |                    | st+json;q=1.0;char |\r
862 |                    |                    |                    | set=utf-8;version= |\r
863 |                    |                    |                    | 2.0,application/js |\r
864 |                    |                    |                    | on;q=1.0;version=2 |\r
865 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
866 |                    |                    |                    |                    |\r
867 |                    |                    |                    | ` <./example/YXBwb |\r
868 |                    |                    |                    | GljYXRpb24vUm9sZVJ |\r
869 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
870 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
871 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
872 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
873 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
874 |                    |                    |                    | jA=>`__\ applicati |\r
875 |                    |                    |                    | on/RoleRequest+xml |\r
876 |                    |                    |                    | ;q=1.0;charset=utf |\r
877 |                    |                    |                    | -8;version=2.0,tex |\r
878 |                    |                    |                    | t/xml;q=1.0;versio |\r
879 |                    |                    |                    | n=2.0              |\r
880 +--------------------+--------------------+--------------------+--------------------+\r
881 |                    | PUT                | /authz/role        | Set Description    |\r
882 |                    |                    |                    | for role           |\r
883 |                    |                    |                    |                    |\r
884 |                    |                    |                    | Add Description    |\r
885 |                    |                    |                    | Data to a Role     |\r
886 |                    |                    |                    |                    |\r
887 |                    |                    |                    | Expected HTTP Code |\r
888 |                    |                    |                    |                    |\r
889 |                    |                    |                    | 200                |\r
890 |                    |                    |                    |                    |\r
891 |                    |                    |                    | Explicit HTTP      |\r
892 |                    |                    |                    | Error Codes        |\r
893 |                    |                    |                    |                    |\r
894 |                    |                    |                    | 404, 406           |\r
895 |                    |                    |                    |                    |\r
896 |                    |                    |                    | ContentType:       |\r
897 |                    |                    |                    |                    |\r
898 |                    |                    |                    | ` <./example/YXBwb |\r
899 |                    |                    |                    | GljYXRpb24vUm9sZVJ |\r
900 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
901 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
902 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
903 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
904 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
905 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
906 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
907 |                    |                    |                    | lication/RoleReque |\r
908 |                    |                    |                    | st+json;q=1.0;char |\r
909 |                    |                    |                    | set=utf-8;version= |\r
910 |                    |                    |                    | 2.0,application/js |\r
911 |                    |                    |                    | on;q=1.0;version=2 |\r
912 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
913 |                    |                    |                    |                    |\r
914 |                    |                    |                    | ` <./example/YXBwb |\r
915 |                    |                    |                    | GljYXRpb24vUm9sZVJ |\r
916 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
917 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
918 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
919 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
920 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
921 |                    |                    |                    | jA=>`__\ applicati |\r
922 |                    |                    |                    | on/RoleRequest+xml |\r
923 |                    |                    |                    | ;q=1.0;charset=utf |\r
924 |                    |                    |                    | -8;version=2.0,tex |\r
925 |                    |                    |                    | t/xml;q=1.0;versio |\r
926 |                    |                    |                    | n=2.0              |\r
927 +--------------------+--------------------+--------------------+--------------------+\r
928 |                    | DELETE             | /authz/role        | Delete Role        |\r
929 |                    |                    |                    |                    |\r
930 |                    |                    |                    | Delete the Role    |\r
931 |                    |                    |                    | referenced by      |\r
932 |                    |                    |                    | RoleKey            |\r
933 |                    |                    |                    |                    |\r
934 |                    |                    |                    | You cannot         |\r
935 |                    |                    |                    | normally delete a  |\r
936 |                    |                    |                    | role which still   |\r
937 |                    |                    |                    | has permissions    |\r
938 |                    |                    |                    | granted or users   |\r
939 |                    |                    |                    | assigned to it,    |\r
940 |                    |                    |                    |                    |\r
941 |                    |                    |                    | however the        |\r
942 |                    |                    |                    | "force" property   |\r
943 |                    |                    |                    | allows you to do   |\r
944 |                    |                    |                    | just that. To do   |\r
945 |                    |                    |                    | this: Add          |\r
946 |                    |                    |                    | 'force=true'       |\r
947 |                    |                    |                    |                    |\r
948 |                    |                    |                    | as a query         |\r
949 |                    |                    |                    | parameter.         |\r
950 |                    |                    |                    |                    |\r
951 |                    |                    |                    | WARNING: Using     |\r
952 |                    |                    |                    | force will remove  |\r
953 |                    |                    |                    | all users and      |\r
954 |                    |                    |                    | permission from    |\r
955 |                    |                    |                    | this role. Use     |\r
956 |                    |                    |                    | with care.         |\r
957 |                    |                    |                    |                    |\r
958 |                    |                    |                    | Expected HTTP Code |\r
959 |                    |                    |                    |                    |\r
960 |                    |                    |                    | 200                |\r
961 |                    |                    |                    |                    |\r
962 |                    |                    |                    | Explicit HTTP      |\r
963 |                    |                    |                    | Error Codes        |\r
964 |                    |                    |                    |                    |\r
965 |                    |                    |                    | 404, 406           |\r
966 |                    |                    |                    |                    |\r
967 |                    |                    |                    | ContentType:       |\r
968 |                    |                    |                    |                    |\r
969 |                    |                    |                    | ` <./example/YXBwb |\r
970 |                    |                    |                    | GljYXRpb24vUm9sZVJ |\r
971 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
972 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
973 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
974 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
975 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
976 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
977 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
978 |                    |                    |                    | lication/RoleReque |\r
979 |                    |                    |                    | st+json;q=1.0;char |\r
980 |                    |                    |                    | set=utf-8;version= |\r
981 |                    |                    |                    | 2.0,application/js |\r
982 |                    |                    |                    | on;q=1.0;version=2 |\r
983 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
984 |                    |                    |                    |                    |\r
985 |                    |                    |                    | ` <./example/YXBwb |\r
986 |                    |                    |                    | GljYXRpb24vUm9sZVJ |\r
987 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
988 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
989 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
990 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
991 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
992 |                    |                    |                    | jA=>`__\ applicati |\r
993 |                    |                    |                    | on/RoleRequest+xml |\r
994 |                    |                    |                    | ;q=1.0;charset=utf |\r
995 |                    |                    |                    | -8;version=2.0,tex |\r
996 |                    |                    |                    | t/xml;q=1.0;versio |\r
997 |                    |                    |                    | n=2.0              |\r
998 +--------------------+--------------------+--------------------+--------------------+\r
999 |                    | DELETE             | /authz/role/:role  | Delete Role        |\r
1000 |                    |                    |                    |                    |\r
1001 |                    |                    |                    | Delete the Role    |\r
1002 |                    |                    |                    | named :role        |\r
1003 |                    |                    |                    |                    |\r
1004 |                    |                    |                    | --------------     |\r
1005 |                    |                    |                    |                    |\r
1006 |                    |                    |                    | Parameters         |\r
1007 |                    |                    |                    |                    |\r
1008 |                    |                    |                    | role : string      |\r
1009 |                    |                    |                    | (Required)         |\r
1010 |                    |                    |                    |                    |\r
1011 |                    |                    |                    | Expected HTTP Code |\r
1012 |                    |                    |                    |                    |\r
1013 |                    |                    |                    | 200                |\r
1014 |                    |                    |                    |                    |\r
1015 |                    |                    |                    | Explicit HTTP      |\r
1016 |                    |                    |                    | Error Codes        |\r
1017 |                    |                    |                    |                    |\r
1018 |                    |                    |                    | 404, 406           |\r
1019 |                    |                    |                    |                    |\r
1020 |                    |                    |                    | ContentType:       |\r
1021 |                    |                    |                    |                    |\r
1022 |                    |                    |                    | ` <./example/YXBwb |\r
1023 |                    |                    |                    | GljYXRpb24vUm9sZSt |\r
1024 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
1025 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1026 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
1027 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
1028 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
1029 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
1030 |                    |                    |                    | =>`__\ application |\r
1031 |                    |                    |                    | /Role+json;q=1.0;c |\r
1032 |                    |                    |                    | harset=utf-8;versi |\r
1033 |                    |                    |                    | on=2.0,application |\r
1034 |                    |                    |                    | /json;q=1.0;versio |\r
1035 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
1036 |                    |                    |                    |                    |\r
1037 |                    |                    |                    | ` <./example/YXBwb |\r
1038 |                    |                    |                    | GljYXRpb24vUm9sZSt |\r
1039 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
1040 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
1041 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
1042 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
1043 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
1044 |                    |                    |                    |  application/Role+ |\r
1045 |                    |                    |                    | xml;q=1.0;charset= |\r
1046 |                    |                    |                    | utf-8;version=2.0, |\r
1047 |                    |                    |                    | text/xml;q=1.0;ver |\r
1048 |                    |                    |                    | sion=2.0           |\r
1049 +--------------------+--------------------+--------------------+--------------------+\r
1050 |                    | DELETE             | /authz/role/:role/ | Delete Permission  |\r
1051 |                    |                    | perm               | from Role          |\r
1052 |                    |                    |                    |                    |\r
1053 |                    |                    |                    | Ungrant a          |\r
1054 |                    |                    |                    | permission from    |\r
1055 |                    |                    |                    | Role :role         |\r
1056 |                    |                    |                    |                    |\r
1057 |                    |                    |                    | --------------     |\r
1058 |                    |                    |                    |                    |\r
1059 |                    |                    |                    | Parameters         |\r
1060 |                    |                    |                    |                    |\r
1061 |                    |                    |                    | role : string      |\r
1062 |                    |                    |                    | (Required)         |\r
1063 |                    |                    |                    |                    |\r
1064 |                    |                    |                    | Expected HTTP Code |\r
1065 |                    |                    |                    |                    |\r
1066 |                    |                    |                    | 200                |\r
1067 |                    |                    |                    |                    |\r
1068 |                    |                    |                    | Explicit HTTP      |\r
1069 |                    |                    |                    | Error Codes        |\r
1070 |                    |                    |                    |                    |\r
1071 |                    |                    |                    | 404, 406           |\r
1072 |                    |                    |                    |                    |\r
1073 |                    |                    |                    | ContentType:       |\r
1074 |                    |                    |                    |                    |\r
1075 |                    |                    |                    | ` <./example/YXBwb |\r
1076 |                    |                    |                    | GljYXRpb24vUm9sZVB |\r
1077 |                    |                    |                    | lcm1SZXF1ZXN0K2pzb |\r
1078 |                    |                    |                    | 247cT0xLjA7Y2hhcnN |\r
1079 |                    |                    |                    | ldD11dGYtODt2ZXJza |\r
1080 |                    |                    |                    | W9uPTIuMCxhcHBsaWN |\r
1081 |                    |                    |                    | hdGlvbi9qc29uO3E9M |\r
1082 |                    |                    |                    | S4wO3ZlcnNpb249Mi4 |\r
1083 |                    |                    |                    | wLCovKjtxPTEuMA==> |\r
1084 |                    |                    |                    | `__\ application/R |\r
1085 |                    |                    |                    | olePermRequest+jso |\r
1086 |                    |                    |                    | n;q=1.0;charset=ut |\r
1087 |                    |                    |                    | f-8;version=2.0,ap |\r
1088 |                    |                    |                    | plication/json;q=1 |\r
1089 |                    |                    |                    | .0;version=2.0,\*/ |\r
1090 |                    |                    |                    | \*;q=1.0           |\r
1091 |                    |                    |                    |                    |\r
1092 |                    |                    |                    | ` <./example/YXBwb |\r
1093 |                    |                    |                    | GljYXRpb24vUm9sZVB |\r
1094 |                    |                    |                    | lcm1SZXF1ZXN0K3htb |\r
1095 |                    |                    |                    | DtxPTEuMDtjaGFyc2V |\r
1096 |                    |                    |                    | 0PXV0Zi04O3ZlcnNpb |\r
1097 |                    |                    |                    | 249Mi4wLHRleHQveG1 |\r
1098 |                    |                    |                    | sO3E9MS4wO3ZlcnNpb |\r
1099 |                    |                    |                    | 249Mi4w>`__\ appli |\r
1100 |                    |                    |                    | cation/RolePermReq |\r
1101 |                    |                    |                    | uest+xml;q=1.0;cha |\r
1102 |                    |                    |                    | rset=utf-8;version |\r
1103 |                    |                    |                    | =2.0,text/xml;q=1. |\r
1104 |                    |                    |                    | 0;version=2.0      |\r
1105 +--------------------+--------------------+--------------------+--------------------+\r
1106 |                    | POST               | /authz/role/perm   | Add Permission to  |\r
1107 |                    |                    |                    | Role               |\r
1108 |                    |                    |                    |                    |\r
1109 |                    |                    |                    | Grant a Permission |\r
1110 |                    |                    |                    | to a Role          |\r
1111 |                    |                    |                    |                    |\r
1112 |                    |                    |                    | Permission         |\r
1113 |                    |                    |                    | consists of:       |\r
1114 |                    |                    |                    |                    |\r
1115 |                    |                    |                    | -  type - a        |\r
1116 |                    |                    |                    |    Namespace       |\r
1117 |                    |                    |                    |    qualified       |\r
1118 |                    |                    |                    |    identifier      |\r
1119 |                    |                    |                    |    specifying what |\r
1120 |                    |                    |                    |    kind of         |\r
1121 |                    |                    |                    |    resource is     |\r
1122 |                    |                    |                    |    being protected |\r
1123 |                    |                    |                    | -  instance - a    |\r
1124 |                    |                    |                    |    key, possibly   |\r
1125 |                    |                    |                    |    multi-dimension |\r
1126 |                    |                    |                    | al,                |\r
1127 |                    |                    |                    |    that identifies |\r
1128 |                    |                    |                    |    a specific      |\r
1129 |                    |                    |                    |    instance of the |\r
1130 |                    |                    |                    |    type            |\r
1131 |                    |                    |                    | -  action - what   |\r
1132 |                    |                    |                    |    kind of action  |\r
1133 |                    |                    |                    |    is allowed      |\r
1134 |                    |                    |                    |                    |\r
1135 |                    |                    |                    | Note: instance and |\r
1136 |                    |                    |                    | action can be an   |\r
1137 |                    |                    |                    | \*                 |\r
1138 |                    |                    |                    |                    |\r
1139 |                    |                    |                    | Note: Using the    |\r
1140 |                    |                    |                    | "force" property   |\r
1141 |                    |                    |                    | will create the    |\r
1142 |                    |                    |                    | Permission, if it  |\r
1143 |                    |                    |                    | doesn't exist AND  |\r
1144 |                    |                    |                    | the requesting ID  |\r
1145 |                    |                    |                    | is allowed to      |\r
1146 |                    |                    |                    | create. It will    |\r
1147 |                    |                    |                    | then grant         |\r
1148 |                    |                    |                    |                    |\r
1149 |                    |                    |                    | the permission to  |\r
1150 |                    |                    |                    | the role in one    |\r
1151 |                    |                    |                    | step. To do this:  |\r
1152 |                    |                    |                    | add 'force=true'   |\r
1153 |                    |                    |                    | as a query         |\r
1154 |                    |                    |                    | parameter.         |\r
1155 |                    |                    |                    |                    |\r
1156 |                    |                    |                    | Expected HTTP Code |\r
1157 |                    |                    |                    |                    |\r
1158 |                    |                    |                    | 201                |\r
1159 |                    |                    |                    |                    |\r
1160 |                    |                    |                    | Explicit HTTP      |\r
1161 |                    |                    |                    | Error Codes        |\r
1162 |                    |                    |                    |                    |\r
1163 |                    |                    |                    | 403, 404, 406, 409 |\r
1164 |                    |                    |                    |                    |\r
1165 |                    |                    |                    | ContentType:       |\r
1166 |                    |                    |                    |                    |\r
1167 |                    |                    |                    | ` <./example/YXBwb |\r
1168 |                    |                    |                    | GljYXRpb24vUm9sZVB |\r
1169 |                    |                    |                    | lcm1SZXF1ZXN0K2pzb |\r
1170 |                    |                    |                    | 247cT0xLjA7Y2hhcnN |\r
1171 |                    |                    |                    | ldD11dGYtODt2ZXJza |\r
1172 |                    |                    |                    | W9uPTIuMCxhcHBsaWN |\r
1173 |                    |                    |                    | hdGlvbi9qc29uO3E9M |\r
1174 |                    |                    |                    | S4wO3ZlcnNpb249Mi4 |\r
1175 |                    |                    |                    | wLCovKjtxPTEuMA==> |\r
1176 |                    |                    |                    | `__\ application/R |\r
1177 |                    |                    |                    | olePermRequest+jso |\r
1178 |                    |                    |                    | n;q=1.0;charset=ut |\r
1179 |                    |                    |                    | f-8;version=2.0,ap |\r
1180 |                    |                    |                    | plication/json;q=1 |\r
1181 |                    |                    |                    | .0;version=2.0,\*/ |\r
1182 |                    |                    |                    | \*;q=1.0           |\r
1183 |                    |                    |                    |                    |\r
1184 |                    |                    |                    | ` <./example/YXBwb |\r
1185 |                    |                    |                    | GljYXRpb24vUm9sZVB |\r
1186 |                    |                    |                    | lcm1SZXF1ZXN0K3htb |\r
1187 |                    |                    |                    | DtxPTEuMDtjaGFyc2V |\r
1188 |                    |                    |                    | 0PXV0Zi04O3ZlcnNpb |\r
1189 |                    |                    |                    | 249Mi4wLHRleHQveG1 |\r
1190 |                    |                    |                    | sO3E9MS4wO3ZlcnNpb |\r
1191 |                    |                    |                    | 249Mi4w>`__\ appli |\r
1192 |                    |                    |                    | cation/RolePermReq |\r
1193 |                    |                    |                    | uest+xml;q=1.0;cha |\r
1194 |                    |                    |                    | rset=utf-8;version |\r
1195 |                    |                    |                    | =2.0,text/xml;q=1. |\r
1196 |                    |                    |                    | 0;version=2.0      |\r
1197 +--------------------+--------------------+--------------------+--------------------+\r
1198 |                    | PUT                | /authz/role/perm   | Set a Permission's |\r
1199 |                    |                    |                    | Roles              |\r
1200 |                    |                    |                    |                    |\r
1201 |                    |                    |                    | Set a permission's |\r
1202 |                    |                    |                    | roles to roles     |\r
1203 |                    |                    |                    | given              |\r
1204 |                    |                    |                    |                    |\r
1205 |                    |                    |                    | Expected HTTP Code |\r
1206 |                    |                    |                    |                    |\r
1207 |                    |                    |                    | 201                |\r
1208 |                    |                    |                    |                    |\r
1209 |                    |                    |                    | Explicit HTTP      |\r
1210 |                    |                    |                    | Error Codes        |\r
1211 |                    |                    |                    |                    |\r
1212 |                    |                    |                    | 403, 404, 406, 409 |\r
1213 |                    |                    |                    |                    |\r
1214 |                    |                    |                    | ContentType:       |\r
1215 |                    |                    |                    |                    |\r
1216 |                    |                    |                    | ` <./example/YXBwb |\r
1217 |                    |                    |                    | GljYXRpb24vUm9sZVB |\r
1218 |                    |                    |                    | lcm1SZXF1ZXN0K2pzb |\r
1219 |                    |                    |                    | 247cT0xLjA7Y2hhcnN |\r
1220 |                    |                    |                    | ldD11dGYtODt2ZXJza |\r
1221 |                    |                    |                    | W9uPTIuMCxhcHBsaWN |\r
1222 |                    |                    |                    | hdGlvbi9qc29uO3E9M |\r
1223 |                    |                    |                    | S4wO3ZlcnNpb249Mi4 |\r
1224 |                    |                    |                    | wLCovKjtxPTEuMA==> |\r
1225 |                    |                    |                    | `__\ application/R |\r
1226 |                    |                    |                    | olePermRequest+jso |\r
1227 |                    |                    |                    | n;q=1.0;charset=ut |\r
1228 |                    |                    |                    | f-8;version=2.0,ap |\r
1229 |                    |                    |                    | plication/json;q=1 |\r
1230 |                    |                    |                    | .0;version=2.0,\*/ |\r
1231 |                    |                    |                    | \*;q=1.0           |\r
1232 |                    |                    |                    |                    |\r
1233 |                    |                    |                    | ` <./example/YXBwb |\r
1234 |                    |                    |                    | GljYXRpb24vUm9sZVB |\r
1235 |                    |                    |                    | lcm1SZXF1ZXN0K3htb |\r
1236 |                    |                    |                    | DtxPTEuMDtjaGFyc2V |\r
1237 |                    |                    |                    | 0PXV0Zi04O3ZlcnNpb |\r
1238 |                    |                    |                    | 249Mi4wLHRleHQveG1 |\r
1239 |                    |                    |                    | sO3E9MS4wO3ZlcnNpb |\r
1240 |                    |                    |                    | 249Mi4w>`__\ appli |\r
1241 |                    |                    |                    | cation/RolePermReq |\r
1242 |                    |                    |                    | uest+xml;q=1.0;cha |\r
1243 |                    |                    |                    | rset=utf-8;version |\r
1244 |                    |                    |                    | =2.0,text/xml;q=1. |\r
1245 |                    |                    |                    | 0;version=2.0      |\r
1246 +--------------------+--------------------+--------------------+--------------------+\r
1247 |                    | GET                | /authz/roles/:role | GetRolesByFullName |\r
1248 |                    |                    |                    |                    |\r
1249 |                    |                    |                    | List Roles that    |\r
1250 |                    |                    |                    | match :role        |\r
1251 |                    |                    |                    |                    |\r
1252 |                    |                    |                    | Note: You must     |\r
1253 |                    |                    |                    | have permission to |\r
1254 |                    |                    |                    | see any given role |\r
1255 |                    |                    |                    |                    |\r
1256 |                    |                    |                    | --------------     |\r
1257 |                    |                    |                    |                    |\r
1258 |                    |                    |                    | Parameters         |\r
1259 |                    |                    |                    |                    |\r
1260 |                    |                    |                    | role : string      |\r
1261 |                    |                    |                    | (Required)         |\r
1262 |                    |                    |                    |                    |\r
1263 |                    |                    |                    | Expected HTTP Code |\r
1264 |                    |                    |                    |                    |\r
1265 |                    |                    |                    | 200                |\r
1266 |                    |                    |                    |                    |\r
1267 |                    |                    |                    | Explicit HTTP      |\r
1268 |                    |                    |                    | Error Codes        |\r
1269 |                    |                    |                    |                    |\r
1270 |                    |                    |                    | 404, 406           |\r
1271 |                    |                    |                    |                    |\r
1272 |                    |                    |                    | Accept:            |\r
1273 |                    |                    |                    |                    |\r
1274 |                    |                    |                    | ` <./example/YXBwb |\r
1275 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1276 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
1277 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
1278 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
1279 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
1280 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
1281 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
1282 |                    |                    |                    | w>`__\ application |\r
1283 |                    |                    |                    | /Roles+json;q=1.0; |\r
1284 |                    |                    |                    | charset=utf-8;vers |\r
1285 |                    |                    |                    | ion=2.0,applicatio |\r
1286 |                    |                    |                    | n/json;q=1.0;versi |\r
1287 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
1288 |                    |                    |                    |                    |\r
1289 |                    |                    |                    | ` <./example/YXBwb |\r
1290 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1291 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
1292 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1293 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
1294 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
1295 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
1296 |                    |                    |                    |  application/Roles |\r
1297 |                    |                    |                    | +xml;q=1.0;charset |\r
1298 |                    |                    |                    | =utf-8;version=2.0 |\r
1299 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
1300 |                    |                    |                    | rsion=2.0          |\r
1301 +--------------------+--------------------+--------------------+--------------------+\r
1302 |                    | GET                | /authz/roles/name/ | GetRolesByNameOnly |\r
1303 |                    |                    | :name              |                    |\r
1304 |                    |                    |                    | List all Roles for |\r
1305 |                    |                    |                    | only the Name of   |\r
1306 |                    |                    |                    | Role (without      |\r
1307 |                    |                    |                    | Namespace)         |\r
1308 |                    |                    |                    |                    |\r
1309 |                    |                    |                    | Note: You must     |\r
1310 |                    |                    |                    | have permission to |\r
1311 |                    |                    |                    | see any given role |\r
1312 |                    |                    |                    |                    |\r
1313 |                    |                    |                    | --------------     |\r
1314 |                    |                    |                    |                    |\r
1315 |                    |                    |                    | Parameters         |\r
1316 |                    |                    |                    |                    |\r
1317 |                    |                    |                    | name : string      |\r
1318 |                    |                    |                    | (Required)         |\r
1319 |                    |                    |                    |                    |\r
1320 |                    |                    |                    | Expected HTTP Code |\r
1321 |                    |                    |                    |                    |\r
1322 |                    |                    |                    | 200                |\r
1323 |                    |                    |                    |                    |\r
1324 |                    |                    |                    | Explicit HTTP      |\r
1325 |                    |                    |                    | Error Codes        |\r
1326 |                    |                    |                    |                    |\r
1327 |                    |                    |                    | 404, 406           |\r
1328 |                    |                    |                    |                    |\r
1329 |                    |                    |                    | Accept:            |\r
1330 |                    |                    |                    |                    |\r
1331 |                    |                    |                    | ` <./example/YXBwb |\r
1332 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1333 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
1334 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
1335 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
1336 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
1337 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
1338 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
1339 |                    |                    |                    | w>`__\ application |\r
1340 |                    |                    |                    | /Roles+json;q=1.0; |\r
1341 |                    |                    |                    | charset=utf-8;vers |\r
1342 |                    |                    |                    | ion=2.0,applicatio |\r
1343 |                    |                    |                    | n/json;q=1.0;versi |\r
1344 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
1345 |                    |                    |                    |                    |\r
1346 |                    |                    |                    | ` <./example/YXBwb |\r
1347 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1348 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
1349 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1350 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
1351 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
1352 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
1353 |                    |                    |                    |  application/Roles |\r
1354 |                    |                    |                    | +xml;q=1.0;charset |\r
1355 |                    |                    |                    | =utf-8;version=2.0 |\r
1356 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
1357 |                    |                    |                    | rsion=2.0          |\r
1358 +--------------------+--------------------+--------------------+--------------------+\r
1359 |                    | GET                | /authz/roles/ns/:n | GetRolesByNS       |\r
1360 |                    |                    | s                  |                    |\r
1361 |                    |                    |                    | List all Roles for |\r
1362 |                    |                    |                    | the Namespace :ns  |\r
1363 |                    |                    |                    |                    |\r
1364 |                    |                    |                    | Note: You must     |\r
1365 |                    |                    |                    | have permission to |\r
1366 |                    |                    |                    | see any given role |\r
1367 |                    |                    |                    |                    |\r
1368 |                    |                    |                    | --------------     |\r
1369 |                    |                    |                    |                    |\r
1370 |                    |                    |                    | Parameters         |\r
1371 |                    |                    |                    |                    |\r
1372 |                    |                    |                    | ns : string        |\r
1373 |                    |                    |                    | (Required)         |\r
1374 |                    |                    |                    |                    |\r
1375 |                    |                    |                    | Expected HTTP Code |\r
1376 |                    |                    |                    |                    |\r
1377 |                    |                    |                    | 200                |\r
1378 |                    |                    |                    |                    |\r
1379 |                    |                    |                    | Explicit HTTP      |\r
1380 |                    |                    |                    | Error Codes        |\r
1381 |                    |                    |                    |                    |\r
1382 |                    |                    |                    | 404, 406           |\r
1383 |                    |                    |                    |                    |\r
1384 |                    |                    |                    | Accept:            |\r
1385 |                    |                    |                    |                    |\r
1386 |                    |                    |                    | ` <./example/YXBwb |\r
1387 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1388 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
1389 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
1390 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
1391 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
1392 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
1393 |                    |                    |                    | j0yLjAsKi8qO3E9MC4 |\r
1394 |                    |                    |                    | y>`__\ application |\r
1395 |                    |                    |                    | /Roles+json;q=1.0; |\r
1396 |                    |                    |                    | charset=utf-8;vers |\r
1397 |                    |                    |                    | ion=2.0,applicatio |\r
1398 |                    |                    |                    | n/json;q=1.0;versi |\r
1399 |                    |                    |                    | on=2.0,\*/\*;q=0.2 |\r
1400 |                    |                    |                    |                    |\r
1401 |                    |                    |                    | ` <./example/YXBwb |\r
1402 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1403 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
1404 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1405 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
1406 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
1407 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
1408 |                    |                    |                    |  application/Roles |\r
1409 |                    |                    |                    | +xml;q=1.0;charset |\r
1410 |                    |                    |                    | =utf-8;version=2.0 |\r
1411 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
1412 |                    |                    |                    | rsion=2.0          |\r
1413 +--------------------+--------------------+--------------------+--------------------+\r
1414 |                    | GET                | /authz/roles/perm/ | GetRolesByPerm     |\r
1415 |                    |                    | :type/:instance/:a |                    |\r
1416 |                    |                    | ction              | Find all Roles     |\r
1417 |                    |                    |                    | containing the     |\r
1418 |                    |                    |                    | given              |\r
1419 |                    |                    |                    | Permission.Permiss |\r
1420 |                    |                    |                    | ion                |\r
1421 |                    |                    |                    | consists of:       |\r
1422 |                    |                    |                    |                    |\r
1423 |                    |                    |                    | -  type - a        |\r
1424 |                    |                    |                    |    Namespace       |\r
1425 |                    |                    |                    |    qualified       |\r
1426 |                    |                    |                    |    identifier      |\r
1427 |                    |                    |                    |    specifying what |\r
1428 |                    |                    |                    |    kind of         |\r
1429 |                    |                    |                    |    resource is     |\r
1430 |                    |                    |                    |    being protected |\r
1431 |                    |                    |                    | -  instance - a    |\r
1432 |                    |                    |                    |    key, possibly   |\r
1433 |                    |                    |                    |    multi-dimension |\r
1434 |                    |                    |                    | al,                |\r
1435 |                    |                    |                    |    that identifies |\r
1436 |                    |                    |                    |    a specific      |\r
1437 |                    |                    |                    |    instance of the |\r
1438 |                    |                    |                    |    type            |\r
1439 |                    |                    |                    | -  action - what   |\r
1440 |                    |                    |                    |    kind of action  |\r
1441 |                    |                    |                    |    is allowed      |\r
1442 |                    |                    |                    |                    |\r
1443 |                    |                    |                    | Notes: instance    |\r
1444 |                    |                    |                    | and action can be  |\r
1445 |                    |                    |                    | an \*              |\r
1446 |                    |                    |                    |                    |\r
1447 |                    |                    |                    | You must have      |\r
1448 |                    |                    |                    | permission to see  |\r
1449 |                    |                    |                    | any given role     |\r
1450 |                    |                    |                    |                    |\r
1451 |                    |                    |                    | --------------     |\r
1452 |                    |                    |                    |                    |\r
1453 |                    |                    |                    | Parameters         |\r
1454 |                    |                    |                    |                    |\r
1455 |                    |                    |                    | type : string      |\r
1456 |                    |                    |                    | (Required)         |\r
1457 |                    |                    |                    |                    |\r
1458 |                    |                    |                    | instance : string  |\r
1459 |                    |                    |                    | (Required)         |\r
1460 |                    |                    |                    |                    |\r
1461 |                    |                    |                    | action : string    |\r
1462 |                    |                    |                    | (Required)         |\r
1463 |                    |                    |                    |                    |\r
1464 |                    |                    |                    | Expected HTTP Code |\r
1465 |                    |                    |                    |                    |\r
1466 |                    |                    |                    | 200                |\r
1467 |                    |                    |                    |                    |\r
1468 |                    |                    |                    | Explicit HTTP      |\r
1469 |                    |                    |                    | Error Codes        |\r
1470 |                    |                    |                    |                    |\r
1471 |                    |                    |                    | 404, 406           |\r
1472 |                    |                    |                    |                    |\r
1473 |                    |                    |                    | Accept:            |\r
1474 |                    |                    |                    |                    |\r
1475 |                    |                    |                    | ` <./example/YXBwb |\r
1476 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1477 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
1478 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
1479 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
1480 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
1481 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
1482 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
1483 |                    |                    |                    | w>`__\ application |\r
1484 |                    |                    |                    | /Roles+json;q=1.0; |\r
1485 |                    |                    |                    | charset=utf-8;vers |\r
1486 |                    |                    |                    | ion=2.0,applicatio |\r
1487 |                    |                    |                    | n/json;q=1.0;versi |\r
1488 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
1489 |                    |                    |                    |                    |\r
1490 |                    |                    |                    | ` <./example/YXBwb |\r
1491 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1492 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
1493 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1494 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
1495 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
1496 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
1497 |                    |                    |                    |  application/Roles |\r
1498 |                    |                    |                    | +xml;q=1.0;charset |\r
1499 |                    |                    |                    | =utf-8;version=2.0 |\r
1500 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
1501 |                    |                    |                    | rsion=2.0          |\r
1502 +--------------------+--------------------+--------------------+--------------------+\r
1503 |                    | GET                | /authz/roles/user/ | GetRolesByUser     |\r
1504 |                    |                    | :name              |                    |\r
1505 |                    |                    |                    | List all Roles     |\r
1506 |                    |                    |                    | that match user    |\r
1507 |                    |                    |                    | :name              |\r
1508 |                    |                    |                    |                    |\r
1509 |                    |                    |                    | 'user' must be     |\r
1510 |                    |                    |                    | expressed as full  |\r
1511 |                    |                    |                    | identity (ex:      |\r
1512 |                    |                    |                    | id@full.domain.com |\r
1513 |                    |                    |                    | )                  |\r
1514 |                    |                    |                    |                    |\r
1515 |                    |                    |                    | Note: You must     |\r
1516 |                    |                    |                    | have permission to |\r
1517 |                    |                    |                    | see any given role |\r
1518 |                    |                    |                    |                    |\r
1519 |                    |                    |                    | --------------     |\r
1520 |                    |                    |                    |                    |\r
1521 |                    |                    |                    | Parameters         |\r
1522 |                    |                    |                    |                    |\r
1523 |                    |                    |                    | name : string      |\r
1524 |                    |                    |                    | (Required)         |\r
1525 |                    |                    |                    |                    |\r
1526 |                    |                    |                    | Expected HTTP Code |\r
1527 |                    |                    |                    |                    |\r
1528 |                    |                    |                    | 200                |\r
1529 |                    |                    |                    |                    |\r
1530 |                    |                    |                    | Explicit HTTP      |\r
1531 |                    |                    |                    | Error Codes        |\r
1532 |                    |                    |                    |                    |\r
1533 |                    |                    |                    | 404, 406           |\r
1534 |                    |                    |                    |                    |\r
1535 |                    |                    |                    | Accept:            |\r
1536 |                    |                    |                    |                    |\r
1537 |                    |                    |                    | ` <./example/YXBwb |\r
1538 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1539 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
1540 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
1541 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
1542 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
1543 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
1544 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
1545 |                    |                    |                    | w>`__\ application |\r
1546 |                    |                    |                    | /Roles+json;q=1.0; |\r
1547 |                    |                    |                    | charset=utf-8;vers |\r
1548 |                    |                    |                    | ion=2.0,applicatio |\r
1549 |                    |                    |                    | n/json;q=1.0;versi |\r
1550 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
1551 |                    |                    |                    |                    |\r
1552 |                    |                    |                    | ` <./example/YXBwb |\r
1553 |                    |                    |                    | GljYXRpb24vUm9sZXM |\r
1554 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
1555 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1556 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
1557 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
1558 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
1559 |                    |                    |                    |  application/Roles |\r
1560 |                    |                    |                    | +xml;q=1.0;charset |\r
1561 |                    |                    |                    | =utf-8;version=2.0 |\r
1562 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
1563 |                    |                    |                    | rsion=2.0          |\r
1564 +--------------------+--------------------+--------------------+--------------------+\r
1565 |                    | POST               | /authz/userRole    | Request User Role  |\r
1566 |                    |                    |                    | Access             |\r
1567 |                    |                    |                    |                    |\r
1568 |                    |                    |                    | Create a UserRole  |\r
1569 |                    |                    |                    | relationship (add  |\r
1570 |                    |                    |                    | User to Role)      |\r
1571 |                    |                    |                    |                    |\r
1572 |                    |                    |                    | A UserRole is an   |\r
1573 |                    |                    |                    | object             |\r
1574 |                    |                    |                    | Representation of  |\r
1575 |                    |                    |                    | membership of a    |\r
1576 |                    |                    |                    | Role for limited   |\r
1577 |                    |                    |                    | time.              |\r
1578 |                    |                    |                    |                    |\r
1579 |                    |                    |                    | If a shorter       |\r
1580 |                    |                    |                    | amount of time for |\r
1581 |                    |                    |                    | Role ownership is  |\r
1582 |                    |                    |                    | required, use the  |\r
1583 |                    |                    |                    | 'End' field.       |\r
1584 |                    |                    |                    |                    |\r
1585 |                    |                    |                    | \*\* Note: Owners  |\r
1586 |                    |                    |                    | of Namespaces will |\r
1587 |                    |                    |                    | be required to     |\r
1588 |                    |                    |                    | revalidate users   |\r
1589 |                    |                    |                    | in these roles     |\r
1590 |                    |                    |                    |                    |\r
1591 |                    |                    |                    | before Expirations |\r
1592 |                    |                    |                    | expire. Namespace  |\r
1593 |                    |                    |                    | owners will be     |\r
1594 |                    |                    |                    | notified by email. |\r
1595 |                    |                    |                    |                    |\r
1596 |                    |                    |                    | Expected HTTP Code |\r
1597 |                    |                    |                    |                    |\r
1598 |                    |                    |                    | 201                |\r
1599 |                    |                    |                    |                    |\r
1600 |                    |                    |                    | Explicit HTTP      |\r
1601 |                    |                    |                    | Error Codes        |\r
1602 |                    |                    |                    |                    |\r
1603 |                    |                    |                    | 403, 404, 406, 409 |\r
1604 |                    |                    |                    |                    |\r
1605 |                    |                    |                    | ContentType:       |\r
1606 |                    |                    |                    |                    |\r
1607 |                    |                    |                    | ` <./example/YXBwb |\r
1608 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1609 |                    |                    |                    | vbGVSZXF1ZXN0K2pzb |\r
1610 |                    |                    |                    | 247cT0xLjA7Y2hhcnN |\r
1611 |                    |                    |                    | ldD11dGYtODt2ZXJza |\r
1612 |                    |                    |                    | W9uPTIuMCxhcHBsaWN |\r
1613 |                    |                    |                    | hdGlvbi9qc29uO3E9M |\r
1614 |                    |                    |                    | S4wO3ZlcnNpb249Mi4 |\r
1615 |                    |                    |                    | wLCovKjtxPTEuMA==> |\r
1616 |                    |                    |                    | `__\ application/U |\r
1617 |                    |                    |                    | serRoleRequest+jso |\r
1618 |                    |                    |                    | n;q=1.0;charset=ut |\r
1619 |                    |                    |                    | f-8;version=2.0,ap |\r
1620 |                    |                    |                    | plication/json;q=1 |\r
1621 |                    |                    |                    | .0;version=2.0,\*/ |\r
1622 |                    |                    |                    | \*;q=1.0           |\r
1623 |                    |                    |                    |                    |\r
1624 |                    |                    |                    | ` <./example/YXBwb |\r
1625 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1626 |                    |                    |                    | vbGVSZXF1ZXN0K3htb |\r
1627 |                    |                    |                    | DtxPTEuMDtjaGFyc2V |\r
1628 |                    |                    |                    | 0PXV0Zi04O3ZlcnNpb |\r
1629 |                    |                    |                    | 249Mi4wLHRleHQveG1 |\r
1630 |                    |                    |                    | sO3E9MS4wO3ZlcnNpb |\r
1631 |                    |                    |                    | 249Mi4w>`__\ appli |\r
1632 |                    |                    |                    | cation/UserRoleReq |\r
1633 |                    |                    |                    | uest+xml;q=1.0;cha |\r
1634 |                    |                    |                    | rset=utf-8;version |\r
1635 |                    |                    |                    | =2.0,text/xml;q=1. |\r
1636 |                    |                    |                    | 0;version=2.0      |\r
1637 +--------------------+--------------------+--------------------+--------------------+\r
1638 |                    | GET                | /authz/userRole/:u | Get if User is In  |\r
1639 |                    |                    | ser/:role          | Role               |\r
1640 |                    |                    |                    |                    |\r
1641 |                    |                    |                    | Returns the User   |\r
1642 |                    |                    |                    | (with Expiration   |\r
1643 |                    |                    |                    | date from listed   |\r
1644 |                    |                    |                    | User/Role) if it   |\r
1645 |                    |                    |                    | exists             |\r
1646 |                    |                    |                    |                    |\r
1647 |                    |                    |                    | --------------     |\r
1648 |                    |                    |                    |                    |\r
1649 |                    |                    |                    | Parameters         |\r
1650 |                    |                    |                    |                    |\r
1651 |                    |                    |                    | user : string      |\r
1652 |                    |                    |                    | (Required)         |\r
1653 |                    |                    |                    |                    |\r
1654 |                    |                    |                    | role : string      |\r
1655 |                    |                    |                    | (Required)         |\r
1656 |                    |                    |                    |                    |\r
1657 |                    |                    |                    | Expected HTTP Code |\r
1658 |                    |                    |                    |                    |\r
1659 |                    |                    |                    | 200                |\r
1660 |                    |                    |                    |                    |\r
1661 |                    |                    |                    | Explicit HTTP      |\r
1662 |                    |                    |                    | Error Codes        |\r
1663 |                    |                    |                    |                    |\r
1664 |                    |                    |                    | 403, 404, 406      |\r
1665 |                    |                    |                    |                    |\r
1666 |                    |                    |                    | Accept:            |\r
1667 |                    |                    |                    |                    |\r
1668 |                    |                    |                    | ` <./example/YXBwb |\r
1669 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
1670 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
1671 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
1672 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
1673 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
1674 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
1675 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
1676 |                    |                    |                    | w>`__\ application |\r
1677 |                    |                    |                    | /Users+json;q=1.0; |\r
1678 |                    |                    |                    | charset=utf-8;vers |\r
1679 |                    |                    |                    | ion=2.0,applicatio |\r
1680 |                    |                    |                    | n/json;q=1.0;versi |\r
1681 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
1682 |                    |                    |                    |                    |\r
1683 |                    |                    |                    | ` <./example/YXBwb |\r
1684 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
1685 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
1686 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1687 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
1688 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
1689 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
1690 |                    |                    |                    |  application/Users |\r
1691 |                    |                    |                    | +xml;q=1.0;charset |\r
1692 |                    |                    |                    | =utf-8;version=2.0 |\r
1693 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
1694 |                    |                    |                    | rsion=2.0          |\r
1695 +--------------------+--------------------+--------------------+--------------------+\r
1696 |                    | DELETE             | /authz/userRole/:u | Delete User Role   |\r
1697 |                    |                    | ser/:role          |                    |\r
1698 |                    |                    |                    | Remove Role :role  |\r
1699 |                    |                    |                    | from User :user.   |\r
1700 |                    |                    |                    |                    |\r
1701 |                    |                    |                    | --------------     |\r
1702 |                    |                    |                    |                    |\r
1703 |                    |                    |                    | Parameters         |\r
1704 |                    |                    |                    |                    |\r
1705 |                    |                    |                    | user : string      |\r
1706 |                    |                    |                    | (Required)         |\r
1707 |                    |                    |                    |                    |\r
1708 |                    |                    |                    | role : string      |\r
1709 |                    |                    |                    | (Required)         |\r
1710 |                    |                    |                    |                    |\r
1711 |                    |                    |                    | Expected HTTP Code |\r
1712 |                    |                    |                    |                    |\r
1713 |                    |                    |                    | 200                |\r
1714 |                    |                    |                    |                    |\r
1715 |                    |                    |                    | Explicit HTTP      |\r
1716 |                    |                    |                    | Error Codes        |\r
1717 |                    |                    |                    |                    |\r
1718 |                    |                    |                    | 403, 404, 406      |\r
1719 |                    |                    |                    |                    |\r
1720 |                    |                    |                    | ContentType:       |\r
1721 |                    |                    |                    |                    |\r
1722 |                    |                    |                    | ` <./example/YXBwb |\r
1723 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
1724 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
1725 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1726 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
1727 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
1728 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
1729 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
1730 |                    |                    |                    | =>`__\ application |\r
1731 |                    |                    |                    | /Void+json;q=1.0;c |\r
1732 |                    |                    |                    | harset=utf-8;versi |\r
1733 |                    |                    |                    | on=2.0,application |\r
1734 |                    |                    |                    | /json;q=1.0;versio |\r
1735 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
1736 |                    |                    |                    |                    |\r
1737 |                    |                    |                    | ` <./example/YXBwb |\r
1738 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
1739 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
1740 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
1741 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
1742 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
1743 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
1744 |                    |                    |                    |  application/Void+ |\r
1745 |                    |                    |                    | xml;q=1.0;charset= |\r
1746 |                    |                    |                    | utf-8;version=2.0, |\r
1747 |                    |                    |                    | text/xml;q=1.0;ver |\r
1748 |                    |                    |                    | sion=2.0           |\r
1749 +--------------------+--------------------+--------------------+--------------------+\r
1750 |                    | PUT                | /authz/userRole/ex | Extend Expiration  |\r
1751 |                    |                    | tend/:user/:role   |                    |\r
1752 |                    |                    |                    | ContentType:       |\r
1753 |                    |                    |                    |                    |\r
1754 |                    |                    |                    | ` <./example/YXBwb |\r
1755 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
1756 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
1757 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
1758 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
1759 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
1760 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
1761 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
1762 |                    |                    |                    | =>`__\ application |\r
1763 |                    |                    |                    | /Void+json;q=1.0;c |\r
1764 |                    |                    |                    | harset=utf-8;versi |\r
1765 |                    |                    |                    | on=2.0,application |\r
1766 |                    |                    |                    | /json;q=1.0;versio |\r
1767 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
1768 |                    |                    |                    |                    |\r
1769 |                    |                    |                    | ` <./example/YXBwb |\r
1770 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
1771 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
1772 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
1773 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
1774 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
1775 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
1776 |                    |                    |                    |  application/Void+ |\r
1777 |                    |                    |                    | xml;q=1.0;charset= |\r
1778 |                    |                    |                    | utf-8;version=2.0, |\r
1779 |                    |                    |                    | text/xml;q=1.0;ver |\r
1780 |                    |                    |                    | sion=2.0           |\r
1781 +--------------------+--------------------+--------------------+--------------------+\r
1782 |                    | PUT                | /authz/userRole/ro | Update Users for a |\r
1783 |                    |                    | le                 | role               |\r
1784 |                    |                    |                    |                    |\r
1785 |                    |                    |                    | Set a Role's users |\r
1786 |                    |                    |                    | to the users       |\r
1787 |                    |                    |                    | specified in the   |\r
1788 |                    |                    |                    | UserRoleRequest    |\r
1789 |                    |                    |                    | object.            |\r
1790 |                    |                    |                    |                    |\r
1791 |                    |                    |                    | WARNING: Users     |\r
1792 |                    |                    |                    | supplied will be   |\r
1793 |                    |                    |                    | the ONLY users     |\r
1794 |                    |                    |                    | attached to this   |\r
1795 |                    |                    |                    | role               |\r
1796 |                    |                    |                    |                    |\r
1797 |                    |                    |                    | If no users are    |\r
1798 |                    |                    |                    | supplied, role's   |\r
1799 |                    |                    |                    | users are reset.   |\r
1800 |                    |                    |                    |                    |\r
1801 |                    |                    |                    | Expected HTTP Code |\r
1802 |                    |                    |                    |                    |\r
1803 |                    |                    |                    | 200                |\r
1804 |                    |                    |                    |                    |\r
1805 |                    |                    |                    | Explicit HTTP      |\r
1806 |                    |                    |                    | Error Codes        |\r
1807 |                    |                    |                    |                    |\r
1808 |                    |                    |                    | 403, 404, 406      |\r
1809 |                    |                    |                    |                    |\r
1810 |                    |                    |                    | ContentType:       |\r
1811 |                    |                    |                    |                    |\r
1812 |                    |                    |                    | ` <./example/YXBwb |\r
1813 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1814 |                    |                    |                    | vbGVSZXF1ZXN0K2pzb |\r
1815 |                    |                    |                    | 247cT0xLjA7Y2hhcnN |\r
1816 |                    |                    |                    | ldD11dGYtODt2ZXJza |\r
1817 |                    |                    |                    | W9uPTIuMCxhcHBsaWN |\r
1818 |                    |                    |                    | hdGlvbi9qc29uO3E9M |\r
1819 |                    |                    |                    | S4wO3ZlcnNpb249Mi4 |\r
1820 |                    |                    |                    | wLCovKjtxPTEuMA==> |\r
1821 |                    |                    |                    | `__\ application/U |\r
1822 |                    |                    |                    | serRoleRequest+jso |\r
1823 |                    |                    |                    | n;q=1.0;charset=ut |\r
1824 |                    |                    |                    | f-8;version=2.0,ap |\r
1825 |                    |                    |                    | plication/json;q=1 |\r
1826 |                    |                    |                    | .0;version=2.0,\*/ |\r
1827 |                    |                    |                    | \*;q=1.0           |\r
1828 |                    |                    |                    |                    |\r
1829 |                    |                    |                    | ` <./example/YXBwb |\r
1830 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1831 |                    |                    |                    | vbGVSZXF1ZXN0K3htb |\r
1832 |                    |                    |                    | DtxPTEuMDtjaGFyc2V |\r
1833 |                    |                    |                    | 0PXV0Zi04O3ZlcnNpb |\r
1834 |                    |                    |                    | 249Mi4wLHRleHQveG1 |\r
1835 |                    |                    |                    | sO3E9MS4wO3ZlcnNpb |\r
1836 |                    |                    |                    | 249Mi4w>`__\ appli |\r
1837 |                    |                    |                    | cation/UserRoleReq |\r
1838 |                    |                    |                    | uest+xml;q=1.0;cha |\r
1839 |                    |                    |                    | rset=utf-8;version |\r
1840 |                    |                    |                    | =2.0,text/xml;q=1. |\r
1841 |                    |                    |                    | 0;version=2.0      |\r
1842 +--------------------+--------------------+--------------------+--------------------+\r
1843 |                    | PUT                | /authz/userRole/us | Update Roles for a |\r
1844 |                    |                    | er                 | user               |\r
1845 |                    |                    |                    |                    |\r
1846 |                    |                    |                    | Set a User's roles |\r
1847 |                    |                    |                    | to the roles       |\r
1848 |                    |                    |                    | specified in the   |\r
1849 |                    |                    |                    | UserRoleRequest    |\r
1850 |                    |                    |                    | object.            |\r
1851 |                    |                    |                    |                    |\r
1852 |                    |                    |                    | WARNING: Roles     |\r
1853 |                    |                    |                    | supplied will be   |\r
1854 |                    |                    |                    | the ONLY roles     |\r
1855 |                    |                    |                    | attached to this   |\r
1856 |                    |                    |                    | user               |\r
1857 |                    |                    |                    |                    |\r
1858 |                    |                    |                    | If no roles are    |\r
1859 |                    |                    |                    | supplied, user's   |\r
1860 |                    |                    |                    | roles are reset.   |\r
1861 |                    |                    |                    |                    |\r
1862 |                    |                    |                    | Expected HTTP Code |\r
1863 |                    |                    |                    |                    |\r
1864 |                    |                    |                    | 200                |\r
1865 |                    |                    |                    |                    |\r
1866 |                    |                    |                    | Explicit HTTP      |\r
1867 |                    |                    |                    | Error Codes        |\r
1868 |                    |                    |                    |                    |\r
1869 |                    |                    |                    | 403, 404, 406      |\r
1870 |                    |                    |                    |                    |\r
1871 |                    |                    |                    | ContentType:       |\r
1872 |                    |                    |                    |                    |\r
1873 |                    |                    |                    | ` <./example/YXBwb |\r
1874 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1875 |                    |                    |                    | vbGVSZXF1ZXN0K2pzb |\r
1876 |                    |                    |                    | 247cT0xLjA7Y2hhcnN |\r
1877 |                    |                    |                    | ldD11dGYtODt2ZXJza |\r
1878 |                    |                    |                    | W9uPTIuMCxhcHBsaWN |\r
1879 |                    |                    |                    | hdGlvbi9qc29uO3E9M |\r
1880 |                    |                    |                    | S4wO3ZlcnNpb249Mi4 |\r
1881 |                    |                    |                    | wLCovKjtxPTEuMA==> |\r
1882 |                    |                    |                    | `__\ application/U |\r
1883 |                    |                    |                    | serRoleRequest+jso |\r
1884 |                    |                    |                    | n;q=1.0;charset=ut |\r
1885 |                    |                    |                    | f-8;version=2.0,ap |\r
1886 |                    |                    |                    | plication/json;q=1 |\r
1887 |                    |                    |                    | .0;version=2.0,\*/ |\r
1888 |                    |                    |                    | \*;q=1.0           |\r
1889 |                    |                    |                    |                    |\r
1890 |                    |                    |                    | ` <./example/YXBwb |\r
1891 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1892 |                    |                    |                    | vbGVSZXF1ZXN0K3htb |\r
1893 |                    |                    |                    | DtxPTEuMDtjaGFyc2V |\r
1894 |                    |                    |                    | 0PXV0Zi04O3ZlcnNpb |\r
1895 |                    |                    |                    | 249Mi4wLHRleHQveG1 |\r
1896 |                    |                    |                    | sO3E9MS4wO3ZlcnNpb |\r
1897 |                    |                    |                    | 249Mi4w>`__\ appli |\r
1898 |                    |                    |                    | cation/UserRoleReq |\r
1899 |                    |                    |                    | uest+xml;q=1.0;cha |\r
1900 |                    |                    |                    | rset=utf-8;version |\r
1901 |                    |                    |                    | =2.0,text/xml;q=1. |\r
1902 |                    |                    |                    | 0;version=2.0      |\r
1903 +--------------------+--------------------+--------------------+--------------------+\r
1904 |                    | GET                | /authz/userRoles/r | Get UserRoles by   |\r
1905 |                    |                    | ole/:role          | Role               |\r
1906 |                    |                    |                    |                    |\r
1907 |                    |                    |                    | List all Users     |\r
1908 |                    |                    |                    | that are attached  |\r
1909 |                    |                    |                    | to Role specified  |\r
1910 |                    |                    |                    | in :role           |\r
1911 |                    |                    |                    |                    |\r
1912 |                    |                    |                    | --------------     |\r
1913 |                    |                    |                    |                    |\r
1914 |                    |                    |                    | Parameters         |\r
1915 |                    |                    |                    |                    |\r
1916 |                    |                    |                    | role : string      |\r
1917 |                    |                    |                    | (Required)         |\r
1918 |                    |                    |                    |                    |\r
1919 |                    |                    |                    | Expected HTTP Code |\r
1920 |                    |                    |                    |                    |\r
1921 |                    |                    |                    | 200                |\r
1922 |                    |                    |                    |                    |\r
1923 |                    |                    |                    | Explicit HTTP      |\r
1924 |                    |                    |                    | Error Codes        |\r
1925 |                    |                    |                    |                    |\r
1926 |                    |                    |                    | 404, 406           |\r
1927 |                    |                    |                    |                    |\r
1928 |                    |                    |                    | Accept:            |\r
1929 |                    |                    |                    |                    |\r
1930 |                    |                    |                    | ` <./example/YXBwb |\r
1931 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1932 |                    |                    |                    | vbGVzK2pzb247cT0xL |\r
1933 |                    |                    |                    | jA7Y2hhcnNldD11dGY |\r
1934 |                    |                    |                    | tODt2ZXJzaW9uPTIuM |\r
1935 |                    |                    |                    | CxhcHBsaWNhdGlvbi9 |\r
1936 |                    |                    |                    | qc29uO3E9MS4wO3Zlc |\r
1937 |                    |                    |                    | nNpb249Mi4wLCovKjt |\r
1938 |                    |                    |                    | xPTAuMg==>`__\ app |\r
1939 |                    |                    |                    | lication/UserRoles |\r
1940 |                    |                    |                    | +json;q=1.0;charse |\r
1941 |                    |                    |                    | t=utf-8;version=2. |\r
1942 |                    |                    |                    | 0,application/json |\r
1943 |                    |                    |                    | ;q=1.0;version=2.0 |\r
1944 |                    |                    |                    | ,\*/\*;q=0.2       |\r
1945 |                    |                    |                    |                    |\r
1946 |                    |                    |                    | ` <./example/YXBwb |\r
1947 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1948 |                    |                    |                    | vbGVzK3htbDtxPTEuM |\r
1949 |                    |                    |                    | DtjaGFyc2V0PXV0Zi0 |\r
1950 |                    |                    |                    | 4O3ZlcnNpb249Mi4wL |\r
1951 |                    |                    |                    | HRleHQveG1sO3E9MS4 |\r
1952 |                    |                    |                    | wO3ZlcnNpb249Mi4w> |\r
1953 |                    |                    |                    | `__\ application/U |\r
1954 |                    |                    |                    | serRoles+xml;q=1.0 |\r
1955 |                    |                    |                    | ;charset=utf-8;ver |\r
1956 |                    |                    |                    | sion=2.0,text/xml; |\r
1957 |                    |                    |                    | q=1.0;version=2.0  |\r
1958 +--------------------+--------------------+--------------------+--------------------+\r
1959 |                    | GET                | /authz/userRoles/u | Get UserRoles by   |\r
1960 |                    |                    | ser/:user          | User               |\r
1961 |                    |                    |                    |                    |\r
1962 |                    |                    |                    | List all UserRoles |\r
1963 |                    |                    |                    | for :user          |\r
1964 |                    |                    |                    |                    |\r
1965 |                    |                    |                    | --------------     |\r
1966 |                    |                    |                    |                    |\r
1967 |                    |                    |                    | Parameters         |\r
1968 |                    |                    |                    |                    |\r
1969 |                    |                    |                    | role : string      |\r
1970 |                    |                    |                    | (Required)         |\r
1971 |                    |                    |                    |                    |\r
1972 |                    |                    |                    | Expected HTTP Code |\r
1973 |                    |                    |                    |                    |\r
1974 |                    |                    |                    | 200                |\r
1975 |                    |                    |                    |                    |\r
1976 |                    |                    |                    | Explicit HTTP      |\r
1977 |                    |                    |                    | Error Codes        |\r
1978 |                    |                    |                    |                    |\r
1979 |                    |                    |                    | 404, 406           |\r
1980 |                    |                    |                    |                    |\r
1981 |                    |                    |                    | Accept:            |\r
1982 |                    |                    |                    |                    |\r
1983 |                    |                    |                    | ` <./example/YXBwb |\r
1984 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
1985 |                    |                    |                    | vbGVzK2pzb247cT0xL |\r
1986 |                    |                    |                    | jA7Y2hhcnNldD11dGY |\r
1987 |                    |                    |                    | tODt2ZXJzaW9uPTIuM |\r
1988 |                    |                    |                    | CxhcHBsaWNhdGlvbi9 |\r
1989 |                    |                    |                    | qc29uO3E9MS4wO3Zlc |\r
1990 |                    |                    |                    | nNpb249Mi4wLCovKjt |\r
1991 |                    |                    |                    | xPTAuMg==>`__\ app |\r
1992 |                    |                    |                    | lication/UserRoles |\r
1993 |                    |                    |                    | +json;q=1.0;charse |\r
1994 |                    |                    |                    | t=utf-8;version=2. |\r
1995 |                    |                    |                    | 0,application/json |\r
1996 |                    |                    |                    | ;q=1.0;version=2.0 |\r
1997 |                    |                    |                    | ,\*/\*;q=0.2       |\r
1998 |                    |                    |                    |                    |\r
1999 |                    |                    |                    | ` <./example/YXBwb |\r
2000 |                    |                    |                    | GljYXRpb24vVXNlclJ |\r
2001 |                    |                    |                    | vbGVzK3htbDtxPTEuM |\r
2002 |                    |                    |                    | DtjaGFyc2V0PXV0Zi0 |\r
2003 |                    |                    |                    | 4O3ZlcnNpb249Mi4wL |\r
2004 |                    |                    |                    | HRleHQveG1sO3E9MS4 |\r
2005 |                    |                    |                    | wO3ZlcnNpb249Mi4w> |\r
2006 |                    |                    |                    | `__\ application/U |\r
2007 |                    |                    |                    | serRoles+xml;q=1.0 |\r
2008 |                    |                    |                    | ;charset=utf-8;ver |\r
2009 |                    |                    |                    | sion=2.0,text/xml; |\r
2010 |                    |                    |                    | q=1.0;version=2.0  |\r
2011 +--------------------+--------------------+--------------------+--------------------+\r
2012 | NAMESPACE          | POST               | /authz/ns          | Create a Namespace |\r
2013 |                    |                    |                    |                    |\r
2014 |                    |                    |                    | Namespace consists |\r
2015 |                    |                    |                    | of:                |\r
2016 |                    |                    |                    |                    |\r
2017 |                    |                    |                    | -  name - What you |\r
2018 |                    |                    |                    |    want to call    |\r
2019 |                    |                    |                    |    this Namespace  |\r
2020 |                    |                    |                    | -  responsible(s)  |\r
2021 |                    |                    |                    |    - Person(s) who |\r
2022 |                    |                    |                    |    receive         |\r
2023 |                    |                    |                    |    Notifications   |\r
2024 |                    |                    |                    |    and approves    |\r
2025 |                    |                    |                    |    Requests        |\r
2026 |                    |                    |                    |                    |\r
2027 |                    |                    |                    |    regarding this  |\r
2028 |                    |                    |                    |    Namespace.      |\r
2029 |                    |                    |                    |    Companies have  |\r
2030 |                    |                    |                    |    Policies as to  |\r
2031 |                    |                    |                    |    who may take on |\r
2032 |                    |                    |                    |                    |\r
2033 |                    |                    |                    |    this            |\r
2034 |                    |                    |                    |    Responsibility. |\r
2035 |                    |                    |                    |    Separate        |\r
2036 |                    |                    |                    |    multiple        |\r
2037 |                    |                    |                    |    identities with |\r
2038 |                    |                    |                    |    commas          |\r
2039 |                    |                    |                    |                    |\r
2040 |                    |                    |                    | -  admin(s) -      |\r
2041 |                    |                    |                    |    Person(s) who   |\r
2042 |                    |                    |                    |    are allowed to  |\r
2043 |                    |                    |                    |    make changes on |\r
2044 |                    |                    |                    |    the namespace,  |\r
2045 |                    |                    |                    |                    |\r
2046 |                    |                    |                    |    including       |\r
2047 |                    |                    |                    |    creating Roles, |\r
2048 |                    |                    |                    |    Permissions and |\r
2049 |                    |                    |                    |    Credentials.    |\r
2050 |                    |                    |                    |    Separate        |\r
2051 |                    |                    |                    |    multiple        |\r
2052 |                    |                    |                    |                    |\r
2053 |                    |                    |                    |    identities with |\r
2054 |                    |                    |                    |    commas          |\r
2055 |                    |                    |                    |                    |\r
2056 |                    |                    |                    | Note: Namespaces   |\r
2057 |                    |                    |                    | are dot-delimited  |\r
2058 |                    |                    |                    | (i.e.              |\r
2059 |                    |                    |                    | com.myCompany.myAp |\r
2060 |                    |                    |                    | p)                 |\r
2061 |                    |                    |                    | and must be        |\r
2062 |                    |                    |                    |                    |\r
2063 |                    |                    |                    | created with       |\r
2064 |                    |                    |                    | parent credentials |\r
2065 |                    |                    |                    | (i.e. To create    |\r
2066 |                    |                    |                    | com.myCompany.myAp |\r
2067 |                    |                    |                    | p,                 |\r
2068 |                    |                    |                    | you must           |\r
2069 |                    |                    |                    |                    |\r
2070 |                    |                    |                    | be an admin of     |\r
2071 |                    |                    |                    | com.myCompany or   |\r
2072 |                    |                    |                    | com                |\r
2073 |                    |                    |                    |                    |\r
2074 |                    |                    |                    | Expected HTTP Code |\r
2075 |                    |                    |                    |                    |\r
2076 |                    |                    |                    | 201                |\r
2077 |                    |                    |                    |                    |\r
2078 |                    |                    |                    | Explicit HTTP      |\r
2079 |                    |                    |                    | Error Codes        |\r
2080 |                    |                    |                    |                    |\r
2081 |                    |                    |                    | 403, 404, 406, 409 |\r
2082 |                    |                    |                    |                    |\r
2083 |                    |                    |                    | ContentType:       |\r
2084 |                    |                    |                    |                    |\r
2085 |                    |                    |                    | ` <./example/YXBwb |\r
2086 |                    |                    |                    | GljYXRpb24vTnNSZXF |\r
2087 |                    |                    |                    | 1ZXN0K2pzb247cT0xL |\r
2088 |                    |                    |                    | jA7Y2hhcnNldD11dGY |\r
2089 |                    |                    |                    | tODt2ZXJzaW9uPTIuM |\r
2090 |                    |                    |                    | CxhcHBsaWNhdGlvbi9 |\r
2091 |                    |                    |                    | qc29uO3E9MS4wO3Zlc |\r
2092 |                    |                    |                    | nNpb249Mi4wLCovKjt |\r
2093 |                    |                    |                    | xPTEuMA==>`__\ app |\r
2094 |                    |                    |                    | lication/NsRequest |\r
2095 |                    |                    |                    | +json;q=1.0;charse |\r
2096 |                    |                    |                    | t=utf-8;version=2. |\r
2097 |                    |                    |                    | 0,application/json |\r
2098 |                    |                    |                    | ;q=1.0;version=2.0 |\r
2099 |                    |                    |                    | ,\*/\*;q=1.0       |\r
2100 |                    |                    |                    |                    |\r
2101 |                    |                    |                    | ` <./example/YXBwb |\r
2102 |                    |                    |                    | GljYXRpb24vTnNSZXF |\r
2103 |                    |                    |                    | 1ZXN0K3htbDtxPTEuM |\r
2104 |                    |                    |                    | DtjaGFyc2V0PXV0Zi0 |\r
2105 |                    |                    |                    | 4O3ZlcnNpb249Mi4wL |\r
2106 |                    |                    |                    | HRleHQveG1sO3E9MS4 |\r
2107 |                    |                    |                    | wO3ZlcnNpb249Mi4w> |\r
2108 |                    |                    |                    | `__\ application/N |\r
2109 |                    |                    |                    | sRequest+xml;q=1.0 |\r
2110 |                    |                    |                    | ;charset=utf-8;ver |\r
2111 |                    |                    |                    | sion=2.0,text/xml; |\r
2112 |                    |                    |                    | q=1.0;version=2.0  |\r
2113 +--------------------+--------------------+--------------------+--------------------+\r
2114 |                    | PUT                | /authz/ns          | Set a Description  |\r
2115 |                    |                    |                    | for a Namespace    |\r
2116 |                    |                    |                    |                    |\r
2117 |                    |                    |                    | Replace the        |\r
2118 |                    |                    |                    | Current            |\r
2119 |                    |                    |                    | Description of a   |\r
2120 |                    |                    |                    | Namespace with a   |\r
2121 |                    |                    |                    | new one            |\r
2122 |                    |                    |                    |                    |\r
2123 |                    |                    |                    | Expected HTTP Code |\r
2124 |                    |                    |                    |                    |\r
2125 |                    |                    |                    | 200                |\r
2126 |                    |                    |                    |                    |\r
2127 |                    |                    |                    | Explicit HTTP      |\r
2128 |                    |                    |                    | Error Codes        |\r
2129 |                    |                    |                    |                    |\r
2130 |                    |                    |                    | 403, 404, 406      |\r
2131 |                    |                    |                    |                    |\r
2132 |                    |                    |                    | ContentType:       |\r
2133 |                    |                    |                    |                    |\r
2134 |                    |                    |                    | ` <./example/YXBwb |\r
2135 |                    |                    |                    | GljYXRpb24vTnNSZXF |\r
2136 |                    |                    |                    | 1ZXN0K2pzb247cT0xL |\r
2137 |                    |                    |                    | jA7Y2hhcnNldD11dGY |\r
2138 |                    |                    |                    | tODt2ZXJzaW9uPTIuM |\r
2139 |                    |                    |                    | CxhcHBsaWNhdGlvbi9 |\r
2140 |                    |                    |                    | qc29uO3E9MS4wO3Zlc |\r
2141 |                    |                    |                    | nNpb249Mi4wLCovKjt |\r
2142 |                    |                    |                    | xPTEuMA==>`__\ app |\r
2143 |                    |                    |                    | lication/NsRequest |\r
2144 |                    |                    |                    | +json;q=1.0;charse |\r
2145 |                    |                    |                    | t=utf-8;version=2. |\r
2146 |                    |                    |                    | 0,application/json |\r
2147 |                    |                    |                    | ;q=1.0;version=2.0 |\r
2148 |                    |                    |                    | ,\*/\*;q=1.0       |\r
2149 |                    |                    |                    |                    |\r
2150 |                    |                    |                    | ` <./example/YXBwb |\r
2151 |                    |                    |                    | GljYXRpb24vTnNSZXF |\r
2152 |                    |                    |                    | 1ZXN0K3htbDtxPTEuM |\r
2153 |                    |                    |                    | DtjaGFyc2V0PXV0Zi0 |\r
2154 |                    |                    |                    | 4O3ZlcnNpb249Mi4wL |\r
2155 |                    |                    |                    | HRleHQveG1sO3E9MS4 |\r
2156 |                    |                    |                    | wO3ZlcnNpb249Mi4w> |\r
2157 |                    |                    |                    | `__\ application/N |\r
2158 |                    |                    |                    | sRequest+xml;q=1.0 |\r
2159 |                    |                    |                    | ;charset=utf-8;ver |\r
2160 |                    |                    |                    | sion=2.0,text/xml; |\r
2161 |                    |                    |                    | q=1.0;version=2.0  |\r
2162 +--------------------+--------------------+--------------------+--------------------+\r
2163 |                    | DELETE             | /authz/ns/:ns      | Delete a Namespace |\r
2164 |                    |                    |                    |                    |\r
2165 |                    |                    |                    | Delete the         |\r
2166 |                    |                    |                    | Namespace :ns.     |\r
2167 |                    |                    |                    | Namespaces cannot  |\r
2168 |                    |                    |                    | normally be        |\r
2169 |                    |                    |                    | deleted when there |\r
2170 |                    |                    |                    |                    |\r
2171 |                    |                    |                    | are still          |\r
2172 |                    |                    |                    | credentials        |\r
2173 |                    |                    |                    | associated with    |\r
2174 |                    |                    |                    | them, but they can |\r
2175 |                    |                    |                    | be deleted by      |\r
2176 |                    |                    |                    | setting            |\r
2177 |                    |                    |                    |                    |\r
2178 |                    |                    |                    | the "force"        |\r
2179 |                    |                    |                    | property. To do    |\r
2180 |                    |                    |                    | this: Add          |\r
2181 |                    |                    |                    | 'force=true' as a  |\r
2182 |                    |                    |                    | query parameter    |\r
2183 |                    |                    |                    |                    |\r
2184 |                    |                    |                    | WARNING: Using     |\r
2185 |                    |                    |                    | force will delete  |\r
2186 |                    |                    |                    | all credentials    |\r
2187 |                    |                    |                    | attached to this   |\r
2188 |                    |                    |                    | namespace. Use     |\r
2189 |                    |                    |                    | with care.         |\r
2190 |                    |                    |                    |                    |\r
2191 |                    |                    |                    | if the "force"     |\r
2192 |                    |                    |                    | property is set to |\r
2193 |                    |                    |                    | 'force=move', then |\r
2194 |                    |                    |                    | Permissions and    |\r
2195 |                    |                    |                    | Roles are not      |\r
2196 |                    |                    |                    | deleted,but are    |\r
2197 |                    |                    |                    | retained, and      |\r
2198 |                    |                    |                    | assigned to the    |\r
2199 |                    |                    |                    | Parent Namespace.  |\r
2200 |                    |                    |                    | 'force=move' is    |\r
2201 |                    |                    |                    | not permitted at   |\r
2202 |                    |                    |                    | or below           |\r
2203 |                    |                    |                    | Application Scope  |\r
2204 |                    |                    |                    |                    |\r
2205 |                    |                    |                    | --------------     |\r
2206 |                    |                    |                    |                    |\r
2207 |                    |                    |                    | Parameters         |\r
2208 |                    |                    |                    |                    |\r
2209 |                    |                    |                    | ns : string        |\r
2210 |                    |                    |                    | (Required)         |\r
2211 |                    |                    |                    |                    |\r
2212 |                    |                    |                    | Expected HTTP Code |\r
2213 |                    |                    |                    |                    |\r
2214 |                    |                    |                    | 200                |\r
2215 |                    |                    |                    |                    |\r
2216 |                    |                    |                    | Explicit HTTP      |\r
2217 |                    |                    |                    | Error Codes        |\r
2218 |                    |                    |                    |                    |\r
2219 |                    |                    |                    | 403, 404, 424      |\r
2220 |                    |                    |                    |                    |\r
2221 |                    |                    |                    | ContentType:       |\r
2222 |                    |                    |                    |                    |\r
2223 |                    |                    |                    | ` <./example/YXBwb |\r
2224 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2225 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2226 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2227 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2228 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2229 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2230 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2231 |                    |                    |                    | =>`__\ application |\r
2232 |                    |                    |                    | /Void+json;q=1.0;c |\r
2233 |                    |                    |                    | harset=utf-8;versi |\r
2234 |                    |                    |                    | on=2.0,application |\r
2235 |                    |                    |                    | /json;q=1.0;versio |\r
2236 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2237 |                    |                    |                    |                    |\r
2238 |                    |                    |                    | ` <./example/YXBwb |\r
2239 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2240 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2241 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2242 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2243 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2244 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2245 |                    |                    |                    |  application/Void+ |\r
2246 |                    |                    |                    | xml;q=1.0;charset= |\r
2247 |                    |                    |                    | utf-8;version=2.0, |\r
2248 |                    |                    |                    | text/xml;q=1.0;ver |\r
2249 |                    |                    |                    | sion=2.0           |\r
2250 +--------------------+--------------------+--------------------+--------------------+\r
2251 |                    | POST               | /authz/ns/:ns/admi | Add an Admin to a  |\r
2252 |                    |                    | n/:id              | Namespace          |\r
2253 |                    |                    |                    |                    |\r
2254 |                    |                    |                    | Add an Identity    |\r
2255 |                    |                    |                    | :id to the list of |\r
2256 |                    |                    |                    | Admins for the     |\r
2257 |                    |                    |                    | Namespace :ns      |\r
2258 |                    |                    |                    |                    |\r
2259 |                    |                    |                    | Note: :id must be  |\r
2260 |                    |                    |                    | fully qualified    |\r
2261 |                    |                    |                    |                    |\r
2262 |                    |                    |                    |                    |\r
2263 |                    |                    |                    | --------------     |\r
2264 |                    |                    |                    |                    |\r
2265 |                    |                    |                    | Parameters         |\r
2266 |                    |                    |                    |                    |\r
2267 |                    |                    |                    | ns : string        |\r
2268 |                    |                    |                    | (Required)         |\r
2269 |                    |                    |                    |                    |\r
2270 |                    |                    |                    | id : string        |\r
2271 |                    |                    |                    | (Required)         |\r
2272 |                    |                    |                    |                    |\r
2273 |                    |                    |                    | Expected HTTP Code |\r
2274 |                    |                    |                    |                    |\r
2275 |                    |                    |                    | 201                |\r
2276 |                    |                    |                    |                    |\r
2277 |                    |                    |                    | Explicit HTTP      |\r
2278 |                    |                    |                    | Error Codes        |\r
2279 |                    |                    |                    |                    |\r
2280 |                    |                    |                    | 403, 404, 406, 409 |\r
2281 |                    |                    |                    |                    |\r
2282 |                    |                    |                    | ContentType:       |\r
2283 |                    |                    |                    |                    |\r
2284 |                    |                    |                    | ` <./example/YXBwb |\r
2285 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2286 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2287 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2288 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2289 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2290 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2291 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2292 |                    |                    |                    | =>`__\ application |\r
2293 |                    |                    |                    | /Void+json;q=1.0;c |\r
2294 |                    |                    |                    | harset=utf-8;versi |\r
2295 |                    |                    |                    | on=2.0,application |\r
2296 |                    |                    |                    | /json;q=1.0;versio |\r
2297 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2298 |                    |                    |                    |                    |\r
2299 |                    |                    |                    | ` <./example/YXBwb |\r
2300 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2301 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2302 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2303 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2304 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2305 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2306 |                    |                    |                    |  application/Void+ |\r
2307 |                    |                    |                    | xml;q=1.0;charset= |\r
2308 |                    |                    |                    | utf-8;version=2.0, |\r
2309 |                    |                    |                    | text/xml;q=1.0;ver |\r
2310 |                    |                    |                    | sion=2.0           |\r
2311 +--------------------+--------------------+--------------------+--------------------+\r
2312 |                    | DELETE             | /authz/ns/:ns/admi | Remove an Admin    |\r
2313 |                    |                    | n/:id              | from a Namespace   |\r
2314 |                    |                    |                    |                    |\r
2315 |                    |                    |                    | Remove an Identity |\r
2316 |                    |                    |                    | :id from the list  |\r
2317 |                    |                    |                    | of Admins for the  |\r
2318 |                    |                    |                    | Namespace :ns      |\r
2319 |                    |                    |                    |                    |\r
2320 |                    |                    |                    | Note: :id must be  |\r
2321 |                    |                    |                    | fully qualified    |\r
2322 |                    |                    |                    |                    |\r
2323 |                    |                    |                    |                    |\r
2324 |                    |                    |                    | --------------     |\r
2325 |                    |                    |                    |                    |\r
2326 |                    |                    |                    | Parameters         |\r
2327 |                    |                    |                    |                    |\r
2328 |                    |                    |                    | ns : string        |\r
2329 |                    |                    |                    | (Required)         |\r
2330 |                    |                    |                    |                    |\r
2331 |                    |                    |                    | id : string        |\r
2332 |                    |                    |                    | (Required)         |\r
2333 |                    |                    |                    |                    |\r
2334 |                    |                    |                    | Expected HTTP Code |\r
2335 |                    |                    |                    |                    |\r
2336 |                    |                    |                    | 200                |\r
2337 |                    |                    |                    |                    |\r
2338 |                    |                    |                    | Explicit HTTP      |\r
2339 |                    |                    |                    | Error Codes        |\r
2340 |                    |                    |                    |                    |\r
2341 |                    |                    |                    | 403, 404           |\r
2342 |                    |                    |                    |                    |\r
2343 |                    |                    |                    | ContentType:       |\r
2344 |                    |                    |                    |                    |\r
2345 |                    |                    |                    | ` <./example/YXBwb |\r
2346 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2347 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2348 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2349 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2350 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2351 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2352 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2353 |                    |                    |                    | =>`__\ application |\r
2354 |                    |                    |                    | /Void+json;q=1.0;c |\r
2355 |                    |                    |                    | harset=utf-8;versi |\r
2356 |                    |                    |                    | on=2.0,application |\r
2357 |                    |                    |                    | /json;q=1.0;versio |\r
2358 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2359 |                    |                    |                    |                    |\r
2360 |                    |                    |                    | ` <./example/YXBwb |\r
2361 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2362 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2363 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2364 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2365 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2366 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2367 |                    |                    |                    |  application/Void+ |\r
2368 |                    |                    |                    | xml;q=1.0;charset= |\r
2369 |                    |                    |                    | utf-8;version=2.0, |\r
2370 |                    |                    |                    | text/xml;q=1.0;ver |\r
2371 |                    |                    |                    | sion=2.0           |\r
2372 +--------------------+--------------------+--------------------+--------------------+\r
2373 |                    | DELETE             | /authz/ns/:ns/attr | delete an          |\r
2374 |                    |                    | ib/:key            | Attribute from a   |\r
2375 |                    |                    |                    | Namespace          |\r
2376 |                    |                    |                    |                    |\r
2377 |                    |                    |                    | Delete an          |\r
2378 |                    |                    |                    | attribute in the   |\r
2379 |                    |                    |                    | Namespace          |\r
2380 |                    |                    |                    |                    |\r
2381 |                    |                    |                    | You must be given  |\r
2382 |                    |                    |                    | direct permission  |\r
2383 |                    |                    |                    | for key by AAF     |\r
2384 |                    |                    |                    |                    |\r
2385 |                    |                    |                    | --------------     |\r
2386 |                    |                    |                    |                    |\r
2387 |                    |                    |                    | Parameters         |\r
2388 |                    |                    |                    |                    |\r
2389 |                    |                    |                    | ns : string        |\r
2390 |                    |                    |                    | (Required)         |\r
2391 |                    |                    |                    |                    |\r
2392 |                    |                    |                    | key : string       |\r
2393 |                    |                    |                    | (Required)         |\r
2394 |                    |                    |                    |                    |\r
2395 |                    |                    |                    | Expected HTTP Code |\r
2396 |                    |                    |                    |                    |\r
2397 |                    |                    |                    | 200                |\r
2398 |                    |                    |                    |                    |\r
2399 |                    |                    |                    | Explicit HTTP      |\r
2400 |                    |                    |                    | Error Codes        |\r
2401 |                    |                    |                    |                    |\r
2402 |                    |                    |                    | 403, 404           |\r
2403 |                    |                    |                    |                    |\r
2404 |                    |                    |                    | ContentType:       |\r
2405 |                    |                    |                    |                    |\r
2406 |                    |                    |                    | ` <./example/YXBwb |\r
2407 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2408 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2409 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2410 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2411 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2412 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2413 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2414 |                    |                    |                    | =>`__\ application |\r
2415 |                    |                    |                    | /Void+json;q=1.0;c |\r
2416 |                    |                    |                    | harset=utf-8;versi |\r
2417 |                    |                    |                    | on=2.0,application |\r
2418 |                    |                    |                    | /json;q=1.0;versio |\r
2419 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2420 |                    |                    |                    |                    |\r
2421 |                    |                    |                    | ` <./example/YXBwb |\r
2422 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2423 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2424 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2425 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2426 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2427 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2428 |                    |                    |                    |  application/Void+ |\r
2429 |                    |                    |                    | xml;q=1.0;charset= |\r
2430 |                    |                    |                    | utf-8;version=2.0, |\r
2431 |                    |                    |                    | text/xml;q=1.0;ver |\r
2432 |                    |                    |                    | sion=2.0           |\r
2433 +--------------------+--------------------+--------------------+--------------------+\r
2434 |                    | POST               | /authz/ns/:ns/attr | Add an Attribute   |\r
2435 |                    |                    | ib/:key/:value     | from a Namespace   |\r
2436 |                    |                    |                    |                    |\r
2437 |                    |                    |                    | Create an          |\r
2438 |                    |                    |                    | attribute in the   |\r
2439 |                    |                    |                    | Namespace          |\r
2440 |                    |                    |                    |                    |\r
2441 |                    |                    |                    | You must be given  |\r
2442 |                    |                    |                    | direct permission  |\r
2443 |                    |                    |                    | for key by AAF     |\r
2444 |                    |                    |                    |                    |\r
2445 |                    |                    |                    | --------------     |\r
2446 |                    |                    |                    |                    |\r
2447 |                    |                    |                    | Parameters         |\r
2448 |                    |                    |                    |                    |\r
2449 |                    |                    |                    | ns : string        |\r
2450 |                    |                    |                    | (Required)         |\r
2451 |                    |                    |                    |                    |\r
2452 |                    |                    |                    | key : string       |\r
2453 |                    |                    |                    | (Required)         |\r
2454 |                    |                    |                    |                    |\r
2455 |                    |                    |                    | value : string     |\r
2456 |                    |                    |                    | (Required)         |\r
2457 |                    |                    |                    |                    |\r
2458 |                    |                    |                    | Expected HTTP Code |\r
2459 |                    |                    |                    |                    |\r
2460 |                    |                    |                    | 201                |\r
2461 |                    |                    |                    |                    |\r
2462 |                    |                    |                    | Explicit HTTP      |\r
2463 |                    |                    |                    | Error Codes        |\r
2464 |                    |                    |                    |                    |\r
2465 |                    |                    |                    | 403, 404, 406, 409 |\r
2466 |                    |                    |                    |                    |\r
2467 |                    |                    |                    | ContentType:       |\r
2468 |                    |                    |                    |                    |\r
2469 |                    |                    |                    | ` <./example/YXBwb |\r
2470 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2471 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2472 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2473 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2474 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2475 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2476 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2477 |                    |                    |                    | =>`__\ application |\r
2478 |                    |                    |                    | /Void+json;q=1.0;c |\r
2479 |                    |                    |                    | harset=utf-8;versi |\r
2480 |                    |                    |                    | on=2.0,application |\r
2481 |                    |                    |                    | /json;q=1.0;versio |\r
2482 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2483 |                    |                    |                    |                    |\r
2484 |                    |                    |                    | ` <./example/YXBwb |\r
2485 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2486 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2487 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2488 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2489 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2490 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2491 |                    |                    |                    |  application/Void+ |\r
2492 |                    |                    |                    | xml;q=1.0;charset= |\r
2493 |                    |                    |                    | utf-8;version=2.0, |\r
2494 |                    |                    |                    | text/xml;q=1.0;ver |\r
2495 |                    |                    |                    | sion=2.0           |\r
2496 +--------------------+--------------------+--------------------+--------------------+\r
2497 |                    | PUT                | /authz/ns/:ns/attr | update an          |\r
2498 |                    |                    | ib/:key/:value     | Attribute from a   |\r
2499 |                    |                    |                    | Namespace          |\r
2500 |                    |                    |                    |                    |\r
2501 |                    |                    |                    | Update Value on an |\r
2502 |                    |                    |                    | existing attribute |\r
2503 |                    |                    |                    | in the Namespace   |\r
2504 |                    |                    |                    |                    |\r
2505 |                    |                    |                    | You must be given  |\r
2506 |                    |                    |                    | direct permission  |\r
2507 |                    |                    |                    | for key by AAF     |\r
2508 |                    |                    |                    |                    |\r
2509 |                    |                    |                    | --------------     |\r
2510 |                    |                    |                    |                    |\r
2511 |                    |                    |                    | Parameters         |\r
2512 |                    |                    |                    |                    |\r
2513 |                    |                    |                    | ns : string        |\r
2514 |                    |                    |                    | (Required)         |\r
2515 |                    |                    |                    |                    |\r
2516 |                    |                    |                    | key : string       |\r
2517 |                    |                    |                    | (Required)         |\r
2518 |                    |                    |                    |                    |\r
2519 |                    |                    |                    | Expected HTTP Code |\r
2520 |                    |                    |                    |                    |\r
2521 |                    |                    |                    | 200                |\r
2522 |                    |                    |                    |                    |\r
2523 |                    |                    |                    | Explicit HTTP      |\r
2524 |                    |                    |                    | Error Codes        |\r
2525 |                    |                    |                    |                    |\r
2526 |                    |                    |                    | 403, 404           |\r
2527 |                    |                    |                    |                    |\r
2528 |                    |                    |                    | ContentType:       |\r
2529 |                    |                    |                    |                    |\r
2530 |                    |                    |                    | ` <./example/YXBwb |\r
2531 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2532 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2533 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2534 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2535 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2536 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2537 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2538 |                    |                    |                    | =>`__\ application |\r
2539 |                    |                    |                    | /Void+json;q=1.0;c |\r
2540 |                    |                    |                    | harset=utf-8;versi |\r
2541 |                    |                    |                    | on=2.0,application |\r
2542 |                    |                    |                    | /json;q=1.0;versio |\r
2543 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2544 |                    |                    |                    |                    |\r
2545 |                    |                    |                    | ` <./example/YXBwb |\r
2546 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2547 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2548 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2549 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2550 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2551 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2552 |                    |                    |                    |  application/Void+ |\r
2553 |                    |                    |                    | xml;q=1.0;charset= |\r
2554 |                    |                    |                    | utf-8;version=2.0, |\r
2555 |                    |                    |                    | text/xml;q=1.0;ver |\r
2556 |                    |                    |                    | sion=2.0           |\r
2557 +--------------------+--------------------+--------------------+--------------------+\r
2558 |                    | POST               | /authz/ns/:ns/resp | Add a Responsible  |\r
2559 |                    |                    | onsible/:id        | Identity to a      |\r
2560 |                    |                    |                    | Namespace          |\r
2561 |                    |                    |                    |                    |\r
2562 |                    |                    |                    | Add an Identity    |\r
2563 |                    |                    |                    | :id to the list of |\r
2564 |                    |                    |                    | Responsibles for   |\r
2565 |                    |                    |                    | the Namespace :ns  |\r
2566 |                    |                    |                    |                    |\r
2567 |                    |                    |                    | Note: :id must be  |\r
2568 |                    |                    |                    | fully qualified    |\r
2569 |                    |                    |                    |                        |\r
2570 |                    |                    |                    |                    |\r
2571 |                    |                    |                    | --------------     |\r
2572 |                    |                    |                    |                    |\r
2573 |                    |                    |                    | Parameters         |\r
2574 |                    |                    |                    |                    |\r
2575 |                    |                    |                    | ns : string        |\r
2576 |                    |                    |                    | (Required)         |\r
2577 |                    |                    |                    |                    |\r
2578 |                    |                    |                    | id : string        |\r
2579 |                    |                    |                    | (Required)         |\r
2580 |                    |                    |                    |                    |\r
2581 |                    |                    |                    | Expected HTTP Code |\r
2582 |                    |                    |                    |                    |\r
2583 |                    |                    |                    | 201                |\r
2584 |                    |                    |                    |                    |\r
2585 |                    |                    |                    | Explicit HTTP      |\r
2586 |                    |                    |                    | Error Codes        |\r
2587 |                    |                    |                    |                    |\r
2588 |                    |                    |                    | 403, 404, 406, 409 |\r
2589 |                    |                    |                    |                    |\r
2590 |                    |                    |                    | ContentType:       |\r
2591 |                    |                    |                    |                    |\r
2592 |                    |                    |                    | ` <./example/YXBwb |\r
2593 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2594 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2595 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2596 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2597 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2598 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2599 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2600 |                    |                    |                    | =>`__\ application |\r
2601 |                    |                    |                    | /Void+json;q=1.0;c |\r
2602 |                    |                    |                    | harset=utf-8;versi |\r
2603 |                    |                    |                    | on=2.0,application |\r
2604 |                    |                    |                    | /json;q=1.0;versio |\r
2605 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2606 |                    |                    |                    |                    |\r
2607 |                    |                    |                    | ` <./example/YXBwb |\r
2608 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2609 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2610 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2611 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2612 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2613 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2614 |                    |                    |                    |  application/Void+ |\r
2615 |                    |                    |                    | xml;q=1.0;charset= |\r
2616 |                    |                    |                    | utf-8;version=2.0, |\r
2617 |                    |                    |                    | text/xml;q=1.0;ver |\r
2618 |                    |                    |                    | sion=2.0           |\r
2619 +--------------------+--------------------+--------------------+--------------------+\r
2620 |                    | DELETE             | /authz/ns/:ns/resp | Remove a           |\r
2621 |                    |                    | onsible/:id        | Responsible        |\r
2622 |                    |                    |                    | Identity from      |\r
2623 |                    |                    |                    | Namespace          |\r
2624 |                    |                    |                    |                    |\r
2625 |                    |                    |                    | Remove an Identity |\r
2626 |                    |                    |                    | :id to the list of |\r
2627 |                    |                    |                    | Responsibles for   |\r
2628 |                    |                    |                    | the Namespace :ns  |\r
2629 |                    |                    |                    |                    |\r
2630 |                    |                    |                    | Note: :id must be  |\r
2631 |                    |                    |                    | fully qualified    |\r
2632 |                    |                    |                    |                    |\r
2633 |                    |                    |                    |                    |\r
2634 |                    |                    |                    | Note: A namespace  |\r
2635 |                    |                    |                    | must have at least |\r
2636 |                    |                    |                    | 1 responsible      |\r
2637 |                    |                    |                    | party              |\r
2638 |                    |                    |                    |                    |\r
2639 |                    |                    |                    | --------------     |\r
2640 |                    |                    |                    |                    |\r
2641 |                    |                    |                    | Parameters         |\r
2642 |                    |                    |                    |                    |\r
2643 |                    |                    |                    | ns : string        |\r
2644 |                    |                    |                    | (Required)         |\r
2645 |                    |                    |                    |                    |\r
2646 |                    |                    |                    | id : string        |\r
2647 |                    |                    |                    | (Required)         |\r
2648 |                    |                    |                    |                    |\r
2649 |                    |                    |                    | Expected HTTP Code |\r
2650 |                    |                    |                    |                    |\r
2651 |                    |                    |                    | 200                |\r
2652 |                    |                    |                    |                    |\r
2653 |                    |                    |                    | Explicit HTTP      |\r
2654 |                    |                    |                    | Error Codes        |\r
2655 |                    |                    |                    |                    |\r
2656 |                    |                    |                    | 403, 404           |\r
2657 |                    |                    |                    |                    |\r
2658 |                    |                    |                    | ContentType:       |\r
2659 |                    |                    |                    |                    |\r
2660 |                    |                    |                    | ` <./example/YXBwb |\r
2661 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2662 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2663 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2664 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2665 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2666 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2667 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2668 |                    |                    |                    | =>`__\ application |\r
2669 |                    |                    |                    | /Void+json;q=1.0;c |\r
2670 |                    |                    |                    | harset=utf-8;versi |\r
2671 |                    |                    |                    | on=2.0,application |\r
2672 |                    |                    |                    | /json;q=1.0;versio |\r
2673 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2674 |                    |                    |                    |                    |\r
2675 |                    |                    |                    | ` <./example/YXBwb |\r
2676 |                    |                    |                    | GljYXRpb24vVm9pZCt |\r
2677 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2678 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2679 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2680 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2681 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2682 |                    |                    |                    |  application/Void+ |\r
2683 |                    |                    |                    | xml;q=1.0;charset= |\r
2684 |                    |                    |                    | utf-8;version=2.0, |\r
2685 |                    |                    |                    | text/xml;q=1.0;ver |\r
2686 |                    |                    |                    | sion=2.0           |\r
2687 +--------------------+--------------------+--------------------+--------------------+\r
2688 |                    | GET                | /authz/ns/attrib/: | get Ns Key List    |\r
2689 |                    |                    | key                | From Attribute     |\r
2690 |                    |                    |                    |                    |\r
2691 |                    |                    |                    | Read Attributes    |\r
2692 |                    |                    |                    | for Namespace      |\r
2693 |                    |                    |                    |                    |\r
2694 |                    |                    |                    | --------------     |\r
2695 |                    |                    |                    |                    |\r
2696 |                    |                    |                    | Parameters         |\r
2697 |                    |                    |                    |                    |\r
2698 |                    |                    |                    | key : string       |\r
2699 |                    |                    |                    | (Required)         |\r
2700 |                    |                    |                    |                    |\r
2701 |                    |                    |                    | Expected HTTP Code |\r
2702 |                    |                    |                    |                    |\r
2703 |                    |                    |                    | 200                |\r
2704 |                    |                    |                    |                    |\r
2705 |                    |                    |                    | Explicit HTTP      |\r
2706 |                    |                    |                    | Error Codes        |\r
2707 |                    |                    |                    |                    |\r
2708 |                    |                    |                    | 403, 404           |\r
2709 |                    |                    |                    |                    |\r
2710 |                    |                    |                    | Accept:            |\r
2711 |                    |                    |                    |                    |\r
2712 |                    |                    |                    | ` <./example/YXBwb |\r
2713 |                    |                    |                    | GljYXRpb24vS2V5cyt |\r
2714 |                    |                    |                    | qc29uO3E9MS4wO2NoY |\r
2715 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
2716 |                    |                    |                    | yc2lvbj0yLjAsYXBwb |\r
2717 |                    |                    |                    | GljYXRpb24vanNvbjt |\r
2718 |                    |                    |                    | xPTEuMDt2ZXJzaW9uP |\r
2719 |                    |                    |                    | TIuMCwqLyo7cT0xLjA |\r
2720 |                    |                    |                    | =>`__\ application |\r
2721 |                    |                    |                    | /Keys+json;q=1.0;c |\r
2722 |                    |                    |                    | harset=utf-8;versi |\r
2723 |                    |                    |                    | on=2.0,application |\r
2724 |                    |                    |                    | /json;q=1.0;versio |\r
2725 |                    |                    |                    | n=2.0,\*/\*;q=1.0  |\r
2726 |                    |                    |                    |                    |\r
2727 |                    |                    |                    | ` <./example/YXBwb |\r
2728 |                    |                    |                    | GljYXRpb24vS2V5cyt |\r
2729 |                    |                    |                    | 4bWw7cT0xLjA7Y2hhc |\r
2730 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2731 |                    |                    |                    | zaW9uPTIuMCx0ZXh0L |\r
2732 |                    |                    |                    | 3htbDtxPTEuMDt2ZXJ |\r
2733 |                    |                    |                    | zaW9uPTIuMA==>`__\ |\r
2734 |                    |                    |                    |  application/Keys+ |\r
2735 |                    |                    |                    | xml;q=1.0;charset= |\r
2736 |                    |                    |                    | utf-8;version=2.0, |\r
2737 |                    |                    |                    | text/xml;q=1.0;ver |\r
2738 |                    |                    |                    | sion=2.0           |\r
2739 +--------------------+--------------------+--------------------+--------------------+\r
2740 |                    | GET                | /authz/nss/:id     | Return Information |\r
2741 |                    |                    |                    | about Namespaces   |\r
2742 |                    |                    |                    |                    |\r
2743 |                    |                    |                    | Lists the          |\r
2744 |                    |                    |                    | Admin(s),          |\r
2745 |                    |                    |                    | Responsible        |\r
2746 |                    |                    |                    | Party(s), Role(s), |\r
2747 |                    |                    |                    | Permission(s)      |\r
2748 |                    |                    |                    |                    |\r
2749 |                    |                    |                    | Credential(s) and  |\r
2750 |                    |                    |                    | Expiration of      |\r
2751 |                    |                    |                    | Credential(s) in   |\r
2752 |                    |                    |                    | Namespace :id      |\r
2753 |                    |                    |                    |                    |\r
2754 |                    |                    |                    | --------------     |\r
2755 |                    |                    |                    |                    |\r
2756 |                    |                    |                    | Parameters         |\r
2757 |                    |                    |                    |                    |\r
2758 |                    |                    |                    | id : string        |\r
2759 |                    |                    |                    | (Required)         |\r
2760 |                    |                    |                    |                    |\r
2761 |                    |                    |                    | Expected HTTP Code |\r
2762 |                    |                    |                    |                    |\r
2763 |                    |                    |                    | 200                |\r
2764 |                    |                    |                    |                    |\r
2765 |                    |                    |                    | Explicit HTTP      |\r
2766 |                    |                    |                    | Error Codes        |\r
2767 |                    |                    |                    |                    |\r
2768 |                    |                    |                    | 404, 406           |\r
2769 |                    |                    |                    |                    |\r
2770 |                    |                    |                    | Accept:            |\r
2771 |                    |                    |                    |                    |\r
2772 |                    |                    |                    | ` <./example/YXBwb |\r
2773 |                    |                    |                    | GljYXRpb24vTnNzK2p |\r
2774 |                    |                    |                    | zb247cT0xLjA7Y2hhc |\r
2775 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2776 |                    |                    |                    | zaW9uPTIuMCxhcHBsa |\r
2777 |                    |                    |                    | WNhdGlvbi9qc29uO3E |\r
2778 |                    |                    |                    | 9MS4wO3ZlcnNpb249M |\r
2779 |                    |                    |                    | i4wLCovKjtxPTEuMA= |\r
2780 |                    |                    |                    | =>`__\ application |\r
2781 |                    |                    |                    | /Nss+json;q=1.0;ch |\r
2782 |                    |                    |                    | arset=utf-8;versio |\r
2783 |                    |                    |                    | n=2.0,application/ |\r
2784 |                    |                    |                    | json;q=1.0;version |\r
2785 |                    |                    |                    | =2.0,\*/\*;q=1.0   |\r
2786 |                    |                    |                    |                    |\r
2787 |                    |                    |                    | ` <./example/YXBwb |\r
2788 |                    |                    |                    | GljYXRpb24vTnNzK3h |\r
2789 |                    |                    |                    | tbDtxPTEuMDtjaGFyc |\r
2790 |                    |                    |                    | 2V0PXV0Zi04O3ZlcnN |\r
2791 |                    |                    |                    | pb249Mi4wLHRleHQve |\r
2792 |                    |                    |                    | G1sO3E9MS4wO3ZlcnN |\r
2793 |                    |                    |                    | pb249Mi4w>`__\ app |\r
2794 |                    |                    |                    | lication/Nss+xml;q |\r
2795 |                    |                    |                    | =1.0;charset=utf-8 |\r
2796 |                    |                    |                    | ;version=2.0,text/ |\r
2797 |                    |                    |                    | xml;q=1.0;version= |\r
2798 |                    |                    |                    | 2.0                |\r
2799 +--------------------+--------------------+--------------------+--------------------+\r
2800 |                    | GET                | /authz/nss/admin/: | Return Namespaces  |\r
2801 |                    |                    | user               | where User is an   |\r
2802 |                    |                    |                    | Admin              |\r
2803 |                    |                    |                    |                    |\r
2804 |                    |                    |                    | Accept:            |\r
2805 |                    |                    |                    |                    |\r
2806 |                    |                    |                    | ` <./example/YXBwb |\r
2807 |                    |                    |                    | GljYXRpb24vTnNzK2p |\r
2808 |                    |                    |                    | zb247cT0xLjA7Y2hhc |\r
2809 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2810 |                    |                    |                    | zaW9uPTIuMCxhcHBsa |\r
2811 |                    |                    |                    | WNhdGlvbi9qc29uO3E |\r
2812 |                    |                    |                    | 9MS4wO3ZlcnNpb249M |\r
2813 |                    |                    |                    | i4wLCovKjtxPTEuMA= |\r
2814 |                    |                    |                    | =>`__\ application |\r
2815 |                    |                    |                    | /Nss+json;q=1.0;ch |\r
2816 |                    |                    |                    | arset=utf-8;versio |\r
2817 |                    |                    |                    | n=2.0,application/ |\r
2818 |                    |                    |                    | json;q=1.0;version |\r
2819 |                    |                    |                    | =2.0,\*/\*;q=1.0   |\r
2820 |                    |                    |                    |                    |\r
2821 |                    |                    |                    | ` <./example/YXBwb |\r
2822 |                    |                    |                    | GljYXRpb24vTnNzK3h |\r
2823 |                    |                    |                    | tbDtxPTEuMDtjaGFyc |\r
2824 |                    |                    |                    | 2V0PXV0Zi04O3ZlcnN |\r
2825 |                    |                    |                    | pb249Mi4wLHRleHQve |\r
2826 |                    |                    |                    | G1sO3E9MS4wO3ZlcnN |\r
2827 |                    |                    |                    | pb249Mi4w>`__\ app |\r
2828 |                    |                    |                    | lication/Nss+xml;q |\r
2829 |                    |                    |                    | =1.0;charset=utf-8 |\r
2830 |                    |                    |                    | ;version=2.0,text/ |\r
2831 |                    |                    |                    | xml;q=1.0;version= |\r
2832 |                    |                    |                    | 2.0                |\r
2833 +--------------------+--------------------+--------------------+--------------------+\r
2834 |                    | GET                | /authz/nss/childre | Return Child       |\r
2835 |                    |                    | n/:id              | Namespaces         |\r
2836 |                    |                    |                    |                    |\r
2837 |                    |                    |                    | Lists all Child    |\r
2838 |                    |                    |                    | Namespaces of      |\r
2839 |                    |                    |                    | Namespace :id      |\r
2840 |                    |                    |                    |                    |\r
2841 |                    |                    |                    | Note: This is not  |\r
2842 |                    |                    |                    | a cached read      |\r
2843 |                    |                    |                    |                    |\r
2844 |                    |                    |                    | --------------     |\r
2845 |                    |                    |                    |                    |\r
2846 |                    |                    |                    | Parameters         |\r
2847 |                    |                    |                    |                    |\r
2848 |                    |                    |                    | id : string        |\r
2849 |                    |                    |                    | (Required)         |\r
2850 |                    |                    |                    |                    |\r
2851 |                    |                    |                    | Expected HTTP Code |\r
2852 |                    |                    |                    |                    |\r
2853 |                    |                    |                    | 200                |\r
2854 |                    |                    |                    |                    |\r
2855 |                    |                    |                    | Explicit HTTP      |\r
2856 |                    |                    |                    | Error Codes        |\r
2857 |                    |                    |                    |                    |\r
2858 |                    |                    |                    | 403, 404           |\r
2859 |                    |                    |                    |                    |\r
2860 |                    |                    |                    | Accept:            |\r
2861 |                    |                    |                    |                    |\r
2862 |                    |                    |                    | ` <./example/YXBwb |\r
2863 |                    |                    |                    | GljYXRpb24vTnNzK2p |\r
2864 |                    |                    |                    | zb247cT0xLjA7Y2hhc |\r
2865 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2866 |                    |                    |                    | zaW9uPTIuMCxhcHBsa |\r
2867 |                    |                    |                    | WNhdGlvbi9qc29uO3E |\r
2868 |                    |                    |                    | 9MS4wO3ZlcnNpb249M |\r
2869 |                    |                    |                    | i4wLCovKjtxPTEuMA= |\r
2870 |                    |                    |                    | =>`__\ application |\r
2871 |                    |                    |                    | /Nss+json;q=1.0;ch |\r
2872 |                    |                    |                    | arset=utf-8;versio |\r
2873 |                    |                    |                    | n=2.0,application/ |\r
2874 |                    |                    |                    | json;q=1.0;version |\r
2875 |                    |                    |                    | =2.0,\*/\*;q=1.0   |\r
2876 |                    |                    |                    |                    |\r
2877 |                    |                    |                    | ` <./example/YXBwb |\r
2878 |                    |                    |                    | GljYXRpb24vTnNzK3h |\r
2879 |                    |                    |                    | tbDtxPTEuMDtjaGFyc |\r
2880 |                    |                    |                    | 2V0PXV0Zi04O3ZlcnN |\r
2881 |                    |                    |                    | pb249Mi4wLHRleHQve |\r
2882 |                    |                    |                    | G1sO3E9MS4wO3ZlcnN |\r
2883 |                    |                    |                    | pb249Mi4w>`__\ app |\r
2884 |                    |                    |                    | lication/Nss+xml;q |\r
2885 |                    |                    |                    | =1.0;charset=utf-8 |\r
2886 |                    |                    |                    | ;version=2.0,text/ |\r
2887 |                    |                    |                    | xml;q=1.0;version= |\r
2888 |                    |                    |                    | 2.0                |\r
2889 +--------------------+--------------------+--------------------+--------------------+\r
2890 |                    | GET                | /authz/nss/either/ | Return Namespaces  |\r
2891 |                    |                    | :user              | where User Admin   |\r
2892 |                    |                    |                    | or Owner           |\r
2893 |                    |                    |                    |                    |\r
2894 |                    |                    |                    | Accept:            |\r
2895 |                    |                    |                    |                    |\r
2896 |                    |                    |                    | ` <./example/YXBwb |\r
2897 |                    |                    |                    | GljYXRpb24vTnNzK2p |\r
2898 |                    |                    |                    | zb247cT0xLjA7Y2hhc |\r
2899 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2900 |                    |                    |                    | zaW9uPTIuMCxhcHBsa |\r
2901 |                    |                    |                    | WNhdGlvbi9qc29uO3E |\r
2902 |                    |                    |                    | 9MS4wO3ZlcnNpb249M |\r
2903 |                    |                    |                    | i4wLCovKjtxPTAuOA= |\r
2904 |                    |                    |                    | =>`__\ application |\r
2905 |                    |                    |                    | /Nss+json;q=1.0;ch |\r
2906 |                    |                    |                    | arset=utf-8;versio |\r
2907 |                    |                    |                    | n=2.0,application/ |\r
2908 |                    |                    |                    | json;q=1.0;version |\r
2909 |                    |                    |                    | =2.0,\*/\*;q=0.8   |\r
2910 |                    |                    |                    |                    |\r
2911 |                    |                    |                    | ` <./example/YXBwb |\r
2912 |                    |                    |                    | GljYXRpb24vTnNzK3h |\r
2913 |                    |                    |                    | tbDtxPTEuMDtjaGFyc |\r
2914 |                    |                    |                    | 2V0PXV0Zi04O3ZlcnN |\r
2915 |                    |                    |                    | pb249Mi4wLHRleHQve |\r
2916 |                    |                    |                    | G1sO3E9MS4wO3ZlcnN |\r
2917 |                    |                    |                    | pb249Mi4w>`__\ app |\r
2918 |                    |                    |                    | lication/Nss+xml;q |\r
2919 |                    |                    |                    | =1.0;charset=utf-8 |\r
2920 |                    |                    |                    | ;version=2.0,text/ |\r
2921 |                    |                    |                    | xml;q=1.0;version= |\r
2922 |                    |                    |                    | 2.0                |\r
2923 +--------------------+--------------------+--------------------+--------------------+\r
2924 |                    | GET                | /authz/nss/respons | Return Namespaces  |\r
2925 |                    |                    | ible/:user         | where User is      |\r
2926 |                    |                    |                    | Responsible        |\r
2927 |                    |                    |                    |                    |\r
2928 |                    |                    |                    | Accept:            |\r
2929 |                    |                    |                    |                    |\r
2930 |                    |                    |                    | ` <./example/YXBwb |\r
2931 |                    |                    |                    | GljYXRpb24vTnNzK2p |\r
2932 |                    |                    |                    | zb247cT0xLjA7Y2hhc |\r
2933 |                    |                    |                    | nNldD11dGYtODt2ZXJ |\r
2934 |                    |                    |                    | zaW9uPTIuMCxhcHBsa |\r
2935 |                    |                    |                    | WNhdGlvbi9qc29uO3E |\r
2936 |                    |                    |                    | 9MS4wO3ZlcnNpb249M |\r
2937 |                    |                    |                    | i4wLCovKjtxPTEuMA= |\r
2938 |                    |                    |                    | =>`__\ application |\r
2939 |                    |                    |                    | /Nss+json;q=1.0;ch |\r
2940 |                    |                    |                    | arset=utf-8;versio |\r
2941 |                    |                    |                    | n=2.0,application/ |\r
2942 |                    |                    |                    | json;q=1.0;version |\r
2943 |                    |                    |                    | =2.0,\*/\*;q=1.0   |\r
2944 |                    |                    |                    |                    |\r
2945 |                    |                    |                    | ` <./example/YXBwb |\r
2946 |                    |                    |                    | GljYXRpb24vTnNzK3h |\r
2947 |                    |                    |                    | tbDtxPTEuMDtjaGFyc |\r
2948 |                    |                    |                    | 2V0PXV0Zi04O3ZlcnN |\r
2949 |                    |                    |                    | pb249Mi4wLHRleHQve |\r
2950 |                    |                    |                    | G1sO3E9MS4wO3ZlcnN |\r
2951 |                    |                    |                    | pb249Mi4w>`__\ app |\r
2952 |                    |                    |                    | lication/Nss+xml;q |\r
2953 |                    |                    |                    | =1.0;charset=utf-8 |\r
2954 |                    |                    |                    | ;version=2.0,text/ |\r
2955 |                    |                    |                    | xml;q=1.0;version= |\r
2956 |                    |                    |                    | 2.0                |\r
2957 +--------------------+--------------------+--------------------+--------------------+\r
2958 | USER               | GET                | /authn/basicAuth   | Is given BasicAuth |\r
2959 |                    |                    |                    | valid?             |\r
2960 |                    |                    |                    |                    |\r
2961 |                    |                    |                    | !!!! DEPRECATED    |\r
2962 |                    |                    |                    | without X509       |\r
2963 |                    |                    |                    | Authentication     |\r
2964 |                    |                    |                    | STOP USING THIS    |\r
2965 |                    |                    |                    | API BY DECEMBER    |\r
2966 |                    |                    |                    | 2017, or use       |\r
2967 |                    |                    |                    | Certificates !!!!  |\r
2968 |                    |                    |                    | Use                |\r
2969 |                    |                    |                    | /authn/validate    |\r
2970 |                    |                    |                    | instead Note:      |\r
2971 |                    |                    |                    | Validate a         |\r
2972 |                    |                    |                    | Password using     |\r
2973 |                    |                    |                    | BasicAuth Base64   |\r
2974 |                    |                    |                    | encoded Header.    |\r
2975 |                    |                    |                    | This HTTP/S call   |\r
2976 |                    |                    |                    | is intended as a   |\r
2977 |                    |                    |                    | fast User/Password |\r
2978 |                    |                    |                    | lookup for         |\r
2979 |                    |                    |                    | Security           |\r
2980 |                    |                    |                    | Frameworks, and    |\r
2981 |                    |                    |                    | responds 200 if it |\r
2982 |                    |                    |                    | passes BasicAuth   |\r
2983 |                    |                    |                    | security, and 403  |\r
2984 |                    |                    |                    | if it does not.    |\r
2985 |                    |                    |                    |                    |\r
2986 |                    |                    |                    | Expected HTTP Code |\r
2987 |                    |                    |                    |                    |\r
2988 |                    |                    |                    | 200                |\r
2989 |                    |                    |                    |                    |\r
2990 |                    |                    |                    | Explicit HTTP      |\r
2991 |                    |                    |                    | Error Codes        |\r
2992 |                    |                    |                    |                    |\r
2993 |                    |                    |                    | 403                |\r
2994 |                    |                    |                    |                    |\r
2995 |                    |                    |                    | Accept:            |\r
2996 |                    |                    |                    |                    |\r
2997 |                    |                    |                    | text/plain         |\r
2998 +--------------------+--------------------+--------------------+--------------------+\r
2999 |                    | POST               | /authn/validate    | Is given           |\r
3000 |                    |                    |                    | Credential valid?  |\r
3001 |                    |                    |                    |                    |\r
3002 |                    |                    |                    | Validate a         |\r
3003 |                    |                    |                    | Credential given a |\r
3004 |                    |                    |                    | Credential         |\r
3005 |                    |                    |                    | Structure. This is |\r
3006 |                    |                    |                    | a more             |\r
3007 |                    |                    |                    | comprehensive      |\r
3008 |                    |                    |                    | validation, can do |\r
3009 |                    |                    |                    | more than          |\r
3010 |                    |                    |                    | BasicAuth as       |\r
3011 |                    |                    |                    | Credential types   |\r
3012 |                    |                    |                    | exp                |\r
3013 |                    |                    |                    |                    |\r
3014 |                    |                    |                    | Expected HTTP Code |\r
3015 |                    |                    |                    |                    |\r
3016 |                    |                    |                    | 200                |\r
3017 |                    |                    |                    |                    |\r
3018 |                    |                    |                    | Explicit HTTP      |\r
3019 |                    |                    |                    | Error Codes        |\r
3020 |                    |                    |                    |                    |\r
3021 |                    |                    |                    | 403                |\r
3022 |                    |                    |                    |                    |\r
3023 |                    |                    |                    | ContentType:       |\r
3024 |                    |                    |                    |                    |\r
3025 |                    |                    |                    | ` <./example/YXBwb |\r
3026 |                    |                    |                    | GljYXRpb24vQ3JlZFJ |\r
3027 |                    |                    |                    | lcXVlc3QranNvbjtxP |\r
3028 |                    |                    |                    | TEuMDtjaGFyc2V0PXV |\r
3029 |                    |                    |                    | 0Zi04O3ZlcnNpb249M |\r
3030 |                    |                    |                    | i4wLGFwcGxpY2F0aW9 |\r
3031 |                    |                    |                    | uL2pzb247cT0xLjA7d |\r
3032 |                    |                    |                    | mVyc2lvbj0yLjAsKi8 |\r
3033 |                    |                    |                    | qO3E9MS4w>`__\ app |\r
3034 |                    |                    |                    | lication/CredReque |\r
3035 |                    |                    |                    | st+json;q=1.0;char |\r
3036 |                    |                    |                    | set=utf-8;version= |\r
3037 |                    |                    |                    | 2.0,application/js |\r
3038 |                    |                    |                    | on;q=1.0;version=2 |\r
3039 |                    |                    |                    | .0,\*/\*;q=1.0     |\r
3040 |                    |                    |                    |                    |\r
3041 |                    |                    |                    | ` <./example/YXBwb |\r
3042 |                    |                    |                    | GljYXRpb24vQ3JlZFJ |\r
3043 |                    |                    |                    | lcXVlc3QreG1sO3E9M |\r
3044 |                    |                    |                    | S4wO2NoYXJzZXQ9dXR |\r
3045 |                    |                    |                    | mLTg7dmVyc2lvbj0yL |\r
3046 |                    |                    |                    | jAsdGV4dC94bWw7cT0 |\r
3047 |                    |                    |                    | xLjA7dmVyc2lvbj0yL |\r
3048 |                    |                    |                    | jA=>`__\ applicati |\r
3049 |                    |                    |                    | on/CredRequest+xml |\r
3050 |                    |                    |                    | ;q=1.0;charset=utf |\r
3051 |                    |                    |                    | -8;version=2.0,tex |\r
3052 |                    |                    |                    | t/xml;q=1.0;versio |\r
3053 |                    |                    |                    | n=2.0              |\r
3054 +--------------------+--------------------+--------------------+--------------------+\r
3055 |                    | GET                | /authz/users/:user | Get if User is In  |\r
3056 |                    |                    | /:role             | Role               |\r
3057 |                    |                    |                    |                    |\r
3058 |                    |                    |                    | Accept:            |\r
3059 |                    |                    |                    |                    |\r
3060 |                    |                    |                    | ` <./example/YXBwb |\r
3061 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
3062 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
3063 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
3064 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
3065 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
3066 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
3067 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
3068 |                    |                    |                    | w>`__\ application |\r
3069 |                    |                    |                    | /Users+json;q=1.0; |\r
3070 |                    |                    |                    | charset=utf-8;vers |\r
3071 |                    |                    |                    | ion=2.0,applicatio |\r
3072 |                    |                    |                    | n/json;q=1.0;versi |\r
3073 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
3074 |                    |                    |                    |                    |\r
3075 |                    |                    |                    | ` <./example/YXBwb |\r
3076 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
3077 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
3078 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
3079 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
3080 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
3081 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
3082 |                    |                    |                    |  application/Users |\r
3083 |                    |                    |                    | +xml;q=1.0;charset |\r
3084 |                    |                    |                    | =utf-8;version=2.0 |\r
3085 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
3086 |                    |                    |                    | rsion=2.0          |\r
3087 +--------------------+--------------------+--------------------+--------------------+\r
3088 |                    | GET                | /authz/users/perm/ | Get Users By       |\r
3089 |                    |                    | :type/:instance/:a | Permission         |\r
3090 |                    |                    | ction              |                    |\r
3091 |                    |                    |                    | List all Users     |\r
3092 |                    |                    |                    | that have          |\r
3093 |                    |                    |                    | Permission         |\r
3094 |                    |                    |                    | specified by :type |\r
3095 |                    |                    |                    | :instance :action  |\r
3096 |                    |                    |                    |                    |\r
3097 |                    |                    |                    | --------------     |\r
3098 |                    |                    |                    |                    |\r
3099 |                    |                    |                    | Parameters         |\r
3100 |                    |                    |                    |                    |\r
3101 |                    |                    |                    | type : string      |\r
3102 |                    |                    |                    | (Required)         |\r
3103 |                    |                    |                    |                    |\r
3104 |                    |                    |                    | instance : string  |\r
3105 |                    |                    |                    | (Required)         |\r
3106 |                    |                    |                    |                    |\r
3107 |                    |                    |                    | action : string    |\r
3108 |                    |                    |                    | (Required)         |\r
3109 |                    |                    |                    |                    |\r
3110 |                    |                    |                    | Expected HTTP Code |\r
3111 |                    |                    |                    |                    |\r
3112 |                    |                    |                    | 200                |\r
3113 |                    |                    |                    |                    |\r
3114 |                    |                    |                    | Explicit HTTP      |\r
3115 |                    |                    |                    | Error Codes        |\r
3116 |                    |                    |                    |                    |\r
3117 |                    |                    |                    | 404, 406           |\r
3118 |                    |                    |                    |                    |\r
3119 |                    |                    |                    | Accept:            |\r
3120 |                    |                    |                    |                    |\r
3121 |                    |                    |                    | ` <./example/YXBwb |\r
3122 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
3123 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
3124 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
3125 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
3126 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
3127 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
3128 |                    |                    |                    | j0yLjAsKi8qO3E9MS4 |\r
3129 |                    |                    |                    | w>`__\ application |\r
3130 |                    |                    |                    | /Users+json;q=1.0; |\r
3131 |                    |                    |                    | charset=utf-8;vers |\r
3132 |                    |                    |                    | ion=2.0,applicatio |\r
3133 |                    |                    |                    | n/json;q=1.0;versi |\r
3134 |                    |                    |                    | on=2.0,\*/\*;q=1.0 |\r
3135 |                    |                    |                    |                    |\r
3136 |                    |                    |                    | ` <./example/YXBwb |\r
3137 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
3138 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
3139 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
3140 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
3141 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
3142 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
3143 |                    |                    |                    |  application/Users |\r
3144 |                    |                    |                    | +xml;q=1.0;charset |\r
3145 |                    |                    |                    | =utf-8;version=2.0 |\r
3146 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
3147 |                    |                    |                    | rsion=2.0          |\r
3148 +--------------------+--------------------+--------------------+--------------------+\r
3149 |                    | GET                | /authz/users/role/ | Get Users By Role  |\r
3150 |                    |                    | :role              |                    |\r
3151 |                    |                    |                    | Returns the User   |\r
3152 |                    |                    |                    | (with Expiration   |\r
3153 |                    |                    |                    | date from listed   |\r
3154 |                    |                    |                    | User/Role) if it   |\r
3155 |                    |                    |                    | exists             |\r
3156 |                    |                    |                    |                    |\r
3157 |                    |                    |                    | --------------     |\r
3158 |                    |                    |                    |                    |\r
3159 |                    |                    |                    | Parameters         |\r
3160 |                    |                    |                    |                    |\r
3161 |                    |                    |                    | user : string      |\r
3162 |                    |                    |                    | (Required)         |\r
3163 |                    |                    |                    |                    |\r
3164 |                    |                    |                    | role : string      |\r
3165 |                    |                    |                    | (Required)         |\r
3166 |                    |                    |                    |                    |\r
3167 |                    |                    |                    | Expected HTTP Code |\r
3168 |                    |                    |                    |                    |\r
3169 |                    |                    |                    | 200                |\r
3170 |                    |                    |                    |                    |\r
3171 |                    |                    |                    | Explicit HTTP      |\r
3172 |                    |                    |                    | Error Codes        |\r
3173 |                    |                    |                    |                    |\r
3174 |                    |                    |                    | 403, 404, 406      |\r
3175 |                    |                    |                    |                    |\r
3176 |                    |                    |                    | Accept:            |\r
3177 |                    |                    |                    |                    |\r
3178 |                    |                    |                    | ` <./example/YXBwb |\r
3179 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
3180 |                    |                    |                    | ranNvbjtxPTEuMDtja |\r
3181 |                    |                    |                    | GFyc2V0PXV0Zi04O3Z |\r
3182 |                    |                    |                    | lcnNpb249Mi4wLGFwc |\r
3183 |                    |                    |                    | GxpY2F0aW9uL2pzb24 |\r
3184 |                    |                    |                    | 7cT0xLjA7dmVyc2lvb |\r
3185 |                    |                    |                    | j0yLjAsKi8qO3E9MC4 |\r
3186 |                    |                    |                    | y>`__\ application |\r
3187 |                    |                    |                    | /Users+json;q=1.0; |\r
3188 |                    |                    |                    | charset=utf-8;vers |\r
3189 |                    |                    |                    | ion=2.0,applicatio |\r
3190 |                    |                    |                    | n/json;q=1.0;versi |\r
3191 |                    |                    |                    | on=2.0,\*/\*;q=0.2 |\r
3192 |                    |                    |                    |                    |\r
3193 |                    |                    |                    | ` <./example/YXBwb |\r
3194 |                    |                    |                    | GljYXRpb24vVXNlcnM |\r
3195 |                    |                    |                    | reG1sO3E9MS4wO2NoY |\r
3196 |                    |                    |                    | XJzZXQ9dXRmLTg7dmV |\r
3197 |                    |                    |                    | yc2lvbj0yLjAsdGV4d |\r
3198 |                    |                    |                    | C94bWw7cT0xLjA7dmV |\r
3199 |                    |                    |                    | yc2lvbj0yLjA=>`__\ |\r
3200 |                    |                    |                    |  application/Users |\r
3201 |                    |                    |                    | +xml;q=1.0;charset |\r
3202 |                    |                    |                    | =utf-8;version=2.0 |\r
3203 |                    |                    |                    | ,text/xml;q=1.0;ve |\r
3204 |                    |                    |                    | rsion=2.0          |\r
3205 +--------------------+--------------------+--------------------+--------------------+\r
3206 \r