Boards for DX refactor

docs/boards/dx/auth/sso.md

@@ -0,0 +1,31 @@
+### Allow SSO for Boards
+
+!!! tip
+
+    This task is only required if Boards is hosted on a different domain to HCL DX
+
+## Steps
+
+Edit the config to include the following,
+
+1.  haproxy.cfg
+
+    Edit the config using the following command
+
+    `kubectl edit configmap <DX_DEPLOYMENT>-haproxy -n <DX_NAMESPACE> -o yaml`
+
+    For example:
+
+    `kubectl edit configmap hcl-dx-dev1-haproxy -n hcl-dx-dev1 -o yaml`
+
+    Add the following line
+
+        http-response replace-header Set-Cookie ^(.*) \1;\ SameSite=None;\ Secure
+
+    For example:
+
+    ![outcome](./haproxy.png)
+
+1.  httpd.conf
+
+        Header edit Set-Cookie ^(.*)$ "$1; Secure; SameSite=None"

docs/boards/dx/index.md

@@ -6,36 +6,10 @@
 1.  Kubernetes environment
 1.  `kubectl` installed & authenticated
 
-## WebSphere OAuth Config
+## Steps
 
-Please follow the instructions in [WebSphere OAuth Config](./oauth/websphere.md)
+1. Setup [WebSphere OAuth Config](./auth/websphere.md)
 
-## Install Boards portlet
+1. Configure [SSO for Boards](./auth/sso.md)
 
-Please follow the instructions in [Install Boards portlet](./portlet/index.md)
-
-### Allow SSO inside Boards frame
-
-Edit the config to include the following,
-
-1.  haproxy.cfg
-
-    Edit the config using the following command
-
-    `kubectl edit configmap <DX_DEPLOYMENT>-haproxy -n <DX_NAMESPACE> -o yaml`
-
-    For example:
-
-    `kubectl edit configmap hcl-dx-dev1-haproxy -n hcl-dx-dev1 -o yaml`
-
-    Add the following line
-
-        http-response replace-header Set-Cookie ^(.*) \1;\ SameSite=None;\ Secure
-
-    For example:
-
-    ![outcome](./haproxy.png)
-
-1.  httpd.conf
-
-        Header edit Set-Cookie ^(.*)$ "$1; Secure; SameSite=None"
+1. Install the Boards portlet as [described here](./portlet/index.md)

docs/boards/dx/portlet/index.md

@@ -24,17 +24,23 @@ To install the Huddo Boards portlet, follow these steps:
 
 1. Open the `Portlets` page, find Huddo Boards, click `Configure Portlet`
 
-    ![configure portlet](./manage-portlet.png)
+    ![configure portlet](./manage.png)
 
-1. Edit the cfg.BaseURL to `https://<BOARDS_URL`.
+1. Edit the cfg.BaseURL to `https://<BOARDS_URL>`.
 
-    For example `https://boards.company.com` or `https://company.example.com/Boards`
+    For example:
+
+    - `https://boards.company.com` or
+    - `https://company.example.com/boards`
+    - `https://boards.huddo.com` (hybrid customers)
 
     ![edit base url](./configure.png)
 
     Click OK
 
-1. The `Huddo Boards` Portlet should now be accessible under `Edit mode` => `Add` => `Applications`
+1. The `Huddo Boards` Portlet should now be accessible at
+
+    `Edit mode` => `Add` => `Applications`
 
     ![applications](./applications.png)