Merge pull request #47381 from DebarghoGhosh/spec-sso-api-4112

RHDEVDOCS-4112 - Updated spec.sso operator documentation

Author: JStickler

cicd/gitops/configuring-sso-on-argo-cd-using-dex.adoc

@@ -16,6 +16,8 @@ include::modules/gitops-dex-role-mappings.adoc[leveloffset=+2]
 
 include::modules/gitops-disable-dex.adoc[leveloffset=+1]
 
+include::modules/gitops-disable-dex-using-spec-sso.adoc[leveloffset=+1]
+
 ////
 [role="_additional-resources"]
 .Additional resources

modules/gitops-disable-dex-using-spec-sso.adoc

@@ -0,0 +1,27 @@
+// Module is included in the following assemblies:
+//
+// * configuring-sso-for-argo-cd-using-dex
+
+:_content-type: PROCEDURE
+[id="gitops-disable-dex-using-spec-sso_{context}"]
+= Enabling or disabling Dex using .spec.sso
+
+You can configure {gitops-title} to use Dex as its SSO authentication provider by setting the `.spec.sso` parameter.
+
+.Procedure
+
+. To enable Dex, set the `.spec.sso.provider: dex` parameter in the YAML resource of the Operator:
+
++
+[source,yaml]
+----
+...
+spec:
+  sso:
+    provider: dex
+    dex:
+      openShiftOAuth: true
+...
+----
++
+. To disable dex, either remove the `spec.sso` element from the Argo CD custom resource, or specify a different SSO provider.

modules/gitops-disable-dex.adoc

@@ -1,22 +1,29 @@
 // Module is included in the following assemblies:
 //
-// * configuring-sso-for-argo-cd-on-openshift
+// * configuring-sso-for-argo-cd-using-dex
 
 :_content-type: PROCEDURE
 [id="gitops-disable-dex_{context}"]
 = Disabling Dex
 
-Dex is installed by default for all the Argo CD instances created by the Operator. You can disable Dex.
+Dex is installed by default for all the Argo CD instances created by the Operator. You can configure {gitops-title} to use Dex as the SSO authentication provider by setting the `.spec.dex` parameter. 
+
+[IMPORTANT]
+====
+In {gitops-title} v1.6.0, `DISABLE_DEX` is deprecated and is planned to be removed in {gitops-title} v1.9.0. Consider using the `.spec.sso.dex` parameter instead. See "Enabling or disabling Dex using .spec.sso".
+====
 
 .Procedure
 
-* Set the environmental variable `DISABLE_DEX` to true in the *YAML* resource of the Operator:
+* Set the environmental variable `DISABLE_DEX` to `true` in the YAML resource of the Operator:
 +
 [source,yaml]
 ----
-  spec:
+...
+spec:
   config:
     env:
     - name: DISABLE_DEX
       value: "true"
+...
 ----