Skip to content

Connections Header Integration

Important

This step is only required if you are hosting Huddo Boards on a different domain to HCL Connections.

Outcome


Connections Header via SSO

If you are running Boards on a standalone domain we recommend integrating with the Connections Header using SSO. Please follow these steps:

  1. Allow CORS - follow these instructions.

  2. Enable in Boards

    Open the Boards admin page, select your Organisation, and then the Connections client

    example

    Tick the checkbox for Load Connections Header via SSO and click Save

    example

    Once you reload the page you should see the Connections header!


iFrame App (Deprecated)

Warning

This option is no longer recommended.

  1. Download the Application

    The latest .ear from here

  2. Login to WebSphere ISC

    This is usually accessible through a URL like:

    https://[DEPLOY_MANAGER_ALIAS]:9043/ibm/console/logon.jsp
    

    example

  3. Open Environment -> WebSphere variables

    Ensure the scope is selected as the Cell

    Click New

    example

  4. Set the following details and click OK

    EXTERNAL_APPS_CONFIG
    {"boards":"https://[BOARDS_URL]/auth/connections"}
    

    Where [BOARDS_URL] is the URL of the Boards installation specified previously

    example

  5. The config may require saving. Click Save if presented

    example

  6. Open Applications -> Application Types -> WebSphere enterprise applications

    Click Install

    example

  7. Select the file and click Next

    example

  8. You can rename the App if you wish, then click Next

    example

  9. Select the checkbox for the module

    Hold shift while selecting both the WebServer and the AppsCluster from the list

    Click Apply

    The Servers should update on the right hand side

    Click Next

    example

  10. Click Next

    example

  11. Click Finish

    example

  12. The config may prompt to save. Click Save

    example

    The application should now be installed

  13. Start the Header App

    Tick the box next to the app name, and click Start

    example

    The app should now start. Congratulations, you have installed the app!

    example

  14. Open Boards

    You should now be able to load the Boards app with HCL Connections header at this path:

    https://[CONNECTIONS_URL]/boards
    

    For example:

    https://connections.example.com/boards