Merge branch 'main' into RHIDP-4896

Author: themr0c

.github/pull_request_template.md

@@ -6,23 +6,7 @@
 
 **Version(s):**
 <!--- Specify the version(s) of RHDH that your PR applies to. -->
-
+Add the relevant labels to the Pull Request.
 **Issue:**
-<!--- Add a link to the Bugzilla, Jira, or GitHub issue. --->
-
-**Link to docs preview:**
-<!--- Add direct link(s) to the exact page(s) that contain the updated content from the preview build. --->
-
-**Reviews:**
-- [ ] SME: @ mention assignee
-- [ ] QE: @ mention assignee
-- [ ] Docs review: @ mention assignee
-- [ ] Additional review: @mention assignee (by writer)
-<!--- SME approval is required to merge a PR unless the changes are made by a subject matter expert. --->
-<!--- QE approval is required to merge a PR unless there are no technical changes to the content. --->
-<!--- Docs team approval is required for ALL PRs. --->
-
-**Additional information:**
-<!--- Optional: Include additional context or expand the description here.--->
+<!--- Add a link to the Jira issue. --->
 
-<!--- After you open your PR, request reviews from all required stakeholders via Slack GitHub, or Jira. --->

assemblies/assembly-configuring-authorization-in-rhdh.adoc

@@ -35,6 +35,9 @@ include::modules/authorization/proc-determining-permission-policy-and-role-confi
 include::assembly-managing-authorizations-by-using-the-rhdh-web-ui.adoc[leveloffset=+1]
 
 
+include::assembly-managing-authorizations-by-using-the-rest-api.adoc[leveloffset=+1]
+
+
 include::modules/authorization/ref-rbac-permission-policies.adoc[leveloffset=+1]
 
 
@@ -57,17 +60,8 @@ include::modules/authorization/ref-rbac-conditional-policy-definition.adoc[level
 include::modules/authorization/proc-rbac-config-conditional-policy-file.adoc[leveloffset=+2]
 
 
-
 include::modules/authorization/con-user-stats-rhdh.adoc[leveloffset=+1]
 
 
 include::modules/authorization/proc-download-user-stats-rhdh.adoc[leveloffset=+2]
 
-
-include::modules/authorization/con-rbac-rest-api.adoc[leveloffset=+1]
-
-
-include::modules/authorization/proc-rbac-send-request-rbac-rest-api.adoc[leveloffset=+2]
-
-
-include::modules/authorization/ref-rbac-rest-api-endpoints.adoc[leveloffset=+2]

assemblies/assembly-managing-authorizations-by-using-the-rest-api.adoc

@@ -0,0 +1,25 @@
+[id='managing-authorizations-by-using-the-rest-api']
+= Managing authorizations by using the REST API
+
+To automate the maintenance of {product} permission policies and roles, you can use {product-short} role-based access control (RBAC) REST API.
+
+You can perform the following actions with the REST API:
+
+* Retrieve information about:
+** All permission policies
+** Specific permission policies
+** Specific roles
+** Static plugins permission policies
+* Create, update, or delete:
+** Permission policy
+** Role
+
+
+include::modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-curl.adoc[leveloffset=+1]
+
+
+include::modules/authorization/proc-sending-request-to-the-rbac-rest-api-by-using-a-rest-client.adoc[leveloffset=+1]
+
+
+include::modules/authorization/ref-rbac-rest-api-endpoints.adoc[leveloffset=+1]
+

modules/authorization/con-rbac-rest-api.adoc

@@ -0,0 +1,33 @@
+[id='proc-rbac-sending-requests-to-the-rbac-rest-api-by-using-a-rest-client_{context}']
+= Sending requests to the RBAC REST API by using a REST client
+
+You can send RBAC REST API requests using any REST client.
+
+.Prerequisites
+* xref:enabling-and-giving-access-to-rbac[You have access to the RBAC feature].
+
+.Procedure
+include::snip-finding-bearer-token.adoc[]
+
+. In your REST client, run a command with the following parameters and review the response:
++
+--
+Authorization::
+Enter your saved authorization token.
+
+HTTP method::
+Enter the HTTP method for your xref:ref-rbac-rest-api-endpoints_{context}[API endpoint].
+
+* `GET`: To retrieve specified information from a specified resource endpoint.
+* `POST`: To create or update a resource.
+* `PUT`: To update a resource.
+* `DELETE`: To delete a resource.
+
+URL::
+Enter your {product-short} URL and xref:ref-rbac-rest-api-endpoints_{context}[API endpoint]: pass:c,a,q[{my-product-url}/__<endpoint>__], such as
+`pass:c,a,q[{my-product-url}/api/permission/policies]`.
+
+Body::
+Enter the JSON body with data that your xref:ref-rbac-rest-api-endpoints_{context}[API endpoint] might need with the HTTP `POST` request.
+--
+