[1.3.x] RHIDP-3874 Authenticating with the guest user (#494)

Co-authored-by: Fabrice Flore-Thébault <[email protected]>

Author: openshift-cherrypick-robot

assemblies/assembly-authenticationg-with-the-guest-user.adoc

@@ -0,0 +1,12 @@
+:_mod-docs-content-type: PROCEDURE
+[id="authenticating-with-the-guest-user_{context}"]
+= Authenticating with the Guest user
+
+To explore {product-short} features, you can skip configuring authentication and authorization.
+You can configure {product-short} to log in as a Guest user and access {product-short} features.
+
+include::modules/authentication/proc-authenticationg-with-the-guest-user-on-an-operator-based-installation.adoc[leveloffset=+1]
+
+
+include::modules/authentication/proc-authenticationg-with-the-guest-user-on-a-helm-based-installation.adoc[leveloffset=+1]
+

assemblies/assembly-enabling-authentication.adoc

@@ -34,6 +34,10 @@ For each provider that you want to use, follow the dedicated procedure to comple
 . Set up the shared secret that the authentication provider and {product} require to communicate.
 . Configure {product} to use the authentication provider.
 
+
+include::assembly-authenticationg-with-the-guest-user.adoc[leveloffset=+1]
+
+
 include::modules/auth/proc-adding-azure-as-an-authentication-provider.adoc[leveloffset=+1]
 
 

modules/authentication/proc-authenticationg-with-the-guest-user-on-a-helm-based-installation.adoc

@@ -0,0 +1,32 @@
+:_mod-docs-content-type: PROCEDURE
+[id="authenticating-with-the-guest-user-on-a-helm-based-installation_{context}"]
+= Authenticating with the Guest user on a Helm-based installation
+
+On a Helm-based installation, you can configure {product-short} to log in as a Guest user and access {product-short} features.
+
+.Prerequisites
+* You link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}#Install%20and%20Upgrade[Installed {product-short} by using the Helm Chart].
+
+.Procedure
+* To enable the guest user in your {product-short} custom configuration, link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/administration_guide_for_red_hat_developer_hub/index#proc-add-custom-app-file-openshift-helm_admin-rhdh[configure your {product} Helm Chart] with following content:
++
+.{product} Helm Chart configuration fragment
+[source,yaml]
+----
+upstream:
+  backstage:
+    appConfig:
+      app:
+        baseUrl: 'https://{{- include "janus-idp.hostname" . }}'
+      auth:
+        environment: development
+        providers:
+          guest:
+            dangerouslyAllowOutsideDevelopment: true
+----
+
+.Verification
+. Go to the {product-short} login page.
+. To log in with the Guest user account, click **Enter** in the **Guest** tile.
+. In the {product-short} **Settings** page, your profile name is **Guest**.
+. You can use {product-short} features.

modules/authentication/proc-authenticationg-with-the-guest-user-on-an-operator-based-installation.adoc

@@ -0,0 +1,28 @@
+:_mod-docs-content-type: PROCEDURE
+[id="authenticating-with-the-guest-user-on-an-operator-based-installation_{context}"]
+= Authenticating with the Guest user on an Operator-based installation
+
+After an Operator-based installation, you can configure {product-short} to log in as a Guest user and access {product-short} features.
+
+.Prerequisites
+* You link:[installed {product-short} by using the Operator].
+* You link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/administration_guide_for_red_hat_developer_hub/index#proc-add-custom-app-config-file-ocp-operator_admin-rhdh[added a custom {product-short} application configuration], and have sufficient permissions to modify it.
+
+.Procedure
+* To enable the guest user in your {product-short} custom configuration, link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/administration_guide_for_red_hat_developer_hub/index#proc-add-custom-app-config-file-ocp-operator_admin-rhdh[edit your {product-short} application configuration] with following content:
++
+.`app-config-rhdh.yaml` fragment
+[source,yaml]
+----
+auth:
+  environment: development
+  providers:
+    guest:
+      dangerouslyAllowOutsideDevelopment: true
+----
+
+.Verification
+. Go to the {product-short} login page.
+. To log in with the Guest user account, click **Enter** in the **Guest** tile.
+. In the {product-short} **Settings** page, your profile name is **Guest**.
+. You can use {product-short} features.