summaryrefslogtreecommitdiffstats
path: root/docs/xacml/decision-api.rst
diff options
context:
space:
mode:
authorPamela Dragosh <pdragosh@research.att.com>2020-04-21 15:30:35 -0400
committerPamela Dragosh <pdragosh@research.att.com>2020-04-23 16:04:57 -0400
commitb4a8ef2502418370f048f944e14ff49d0f824446 (patch)
treeeddfd7ad17afded0c8e8afa4ea2efd5b9145e4e9 /docs/xacml/decision-api.rst
parent3602c18a581fd99b12fb8ef298d581bc39225b65 (diff)
Fix documentation errors
This also updates the XACML PDP documentation. Issue-ID: POLICY-2500 Change-Id: Ice086fa39040fbee899652faa0a079192a122f03 Signed-off-by: Pamela Dragosh <pdragosh@research.att.com>
Diffstat (limited to 'docs/xacml/decision-api.rst')
-rw-r--r--docs/xacml/decision-api.rst45
1 files changed, 45 insertions, 0 deletions
diff --git a/docs/xacml/decision-api.rst b/docs/xacml/decision-api.rst
new file mode 100644
index 00000000..e0d4f446
--- /dev/null
+++ b/docs/xacml/decision-api.rst
@@ -0,0 +1,45 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+.. _decision-api-label:
+
+Decision API
+#######################
+
+The Decision API is used by ONAP components that enforce policies and need a decision on which policy to enforce for a specific situation. The Decision API mimics closely the XACML request standard in that it supports a subject, action and resource.
+
+.. csv-table::
+ :header: "Field", "Required", "XACML equivalent", "Description"
+
+ "ONAPName", "True", "subject", "The name of the ONAP project making the call"
+ "ONAPComponent", "True", "subject", "The name of the ONAP sub component making the call"
+ "ONAPInstance", "False", "subject", "An optional instance ID for that sub component"
+ "action", "True", "action", "The action being performed"
+ "resource", "True", "resource", "An object specific to the action that contains properties describing the resource"
+
+It is worth noting that we use basic authorization for API access with username and password set to *healthcheck* and *zb!XztG34* respectively.
+Also, the new APIs support both *http* and *https*.
+
+For every API call, the client is encouraged to insert an uuid-type requestID as parameter. It is helpful for tracking each http transaction
+and facilitates debugging. Most importantly, it complies with Logging requirements v1.2. If the client does not provide the requestID in the API call,
+one will be randomly generated and attached to the response header *x-onap-requestid*.
+
+In accordance with `ONAP API Common Versioning Strategy Guidelines <https://wiki.onap.org/display/DW/ONAP+API+Common+Versioning+Strategy+%28CVS%29+Guidelines>`_,
+in the response of each API call, several custom headers are added::
+
+ x-latestversion: 1.0.0
+ x-minorversion: 0
+ x-patchversion: 0
+ x-onap-requestid: e1763e61-9eef-4911-b952-1be1edd9812b
+
+x-latestversion is used only to communicate an API's latest version.
+
+x-minorversion is used to request or communicate a MINOR version back from the client to the server, and from the server back to the client.
+
+x-patchversion is used only to communicate a PATCH version in a response for troubleshooting purposes only, and will be provided to the client on request.
+
+x-onap-requestid is used to track REST transactions for logging purpose, as described above.
+
+.. swaggerv2doc:: swagger.json
+
+
+End of Document