Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions assemblies/assembly-configuring-authorization-in-rhdh.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,9 @@ include::assembly-managing-authorizations-by-using-the-rest-api.adoc[leveloffset
include::assembly-managing-authorizations-by-using-external-files.adoc[leveloffset=+1]


include::assembly-configuring-guest-access-with-rbac-ui.adoc[leveloffset=+1]


include::modules/authorization/ref-rbac-permission-policies.adoc[leveloffset=+1]


Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
[id="configuring-guest-access-with-rbac-ui_{context}"]
= Configuring guest access with RBAC UI

Use guest access for the Role-Based Access Control (RBAC) frontend plugin only during initial testing and development, and not for production. To enable the guest access for the RBAC frontend, configure the backend plugin and set up the guest authentication provider.

Check warning on line 4 in assemblies/assembly-configuring-guest-access-with-rbac-ui.adoc

View workflow job for this annotation

GitHub Actions / Linting with Vale

[vale] reported by reviewdog 🐶 [RedHat.CaseSensitiveTerms] Use 'role-based access control' rather than 'Role-Based Access Control'. Raw Output: {"message": "[RedHat.CaseSensitiveTerms] Use 'role-based access control' rather than 'Role-Based Access Control'.", "location": {"path": "assemblies/assembly-configuring-guest-access-with-rbac-ui.adoc", "range": {"start": {"line": 4, "column": 26}}}, "severity": "WARNING"}

Check warning on line 4 in assemblies/assembly-configuring-guest-access-with-rbac-ui.adoc

View workflow job for this annotation

GitHub Actions / Linting with Vale

[vale] reported by reviewdog 🐶 [RedHat.Hyphens] Use 'front end' or 'front-end' rather than 'frontend'. Raw Output: {"message": "[RedHat.Hyphens] Use 'front end' or 'front-end' rather than 'frontend'.", "location": {"path": "assemblies/assembly-configuring-guest-access-with-rbac-ui.adoc", "range": {"start": {"line": 4, "column": 59}}}, "severity": "WARNING"}

Check warning on line 4 in assemblies/assembly-configuring-guest-access-with-rbac-ui.adoc

View workflow job for this annotation

GitHub Actions / Linting with Vale

[vale] reported by reviewdog 🐶 [RedHat.Hyphens] Use 'front end' or 'front-end' rather than 'frontend'. Raw Output: {"message": "[RedHat.Hyphens] Use 'front end' or 'front-end' rather than 'frontend'.", "location": {"path": "assemblies/assembly-configuring-guest-access-with-rbac-ui.adoc", "range": {"start": {"line": 4, "column": 184}}}, "severity": "WARNING"}


include::modules/authorization/proc-configuring-the-RBAC-backend-plugin.adoc[leveloffset=+1]

include::modules/authorization/proc-setting-up-the-guest-authentication-provider.adoc[leveloffset=+1]
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
[id="configuring-the-rbac-backend-plugin_{context}"]
= Configuring the RBAC backend plugin

You can configure the RBAC backend plugin by updating the `app-config.yaml` file to enable the permission framework.

.Prerequisites
* You have installed the `@janus-idp/backstage-plugin-rbac` plugin in {product-short}. For more information, see link:{plugins-configure-book-url}[{plugins-configure-book-title}].

.Procedure
* Update the `app-config.yaml` file to enable the permission framework as shown:

[source,yaml,subs=+quotes]
----
permission
enabled: true
rbac:
admin:
users:
- name: user:default/guest
pluginsWithPermission:
- catalog
- permission
- scaffolder
----

[NOTE]
====
The `pluginsWithPermission` section of the `app-config.yaml` section includes only three plugins by default. Update the section as needed to include any additional plugins that also incorporate permissions.
====
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
[id="setting-up-the-guest-authentication-provider_{context}"]
= Setting up the guest authentication provider

You can enable guest authentication and use it alongside the RBAC frontend plugin.

.Prerequisites
* You have installed the `@janus-idp/backstage-plugin-rbac` plugin in {product-short}. For more information, see link:{plugins-configure-book-url}[{plugins-configure-book-title}].

.Procedure

* In the `app-config.yaml` file, add the user entity reference to resolve and enable the `dangerouslyAllowOutsideDevelopment` option, as shown in the following example:

[source,yaml,subs="+attributes,+quotes"]
----
auth:
environment: development
providers:
guest:
userEntityRef: user:default/guest
dangerouslyAllowOutsideDevelopment: true
----

[NOTE]
====
You can use `user:default/guest` as the user entity reference to match the added user under the `permission.rbac.admin.users` section of the `app-config.yaml` file.
====