Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Request an SSO Integration from the Common Hosted Single Sign-on page in order to obtain a resource and secret that will be used for authentication when building CHEFS. View the detailed documentation about requesting the Pathfinder SSO integration. 

  2. Ensure that Docker is installed on your local machine. Using Docker allows for a quick CHEFS build on your local machine however this is not how the production environment is hosted. 

Setup

  1. Start by cloning the CHEFS source code onto your local machine and download the local.json file below such that the directory structure follows /common-hosted-form-service/app/config/local.json 

View file
namelocal.json

  1. Download chefs_build.zip which contains directory structure and docker file for building CHEFS.

View file
namechefs_build.zip

  1. Open realm-export.json located at chefs_build/docker/imports/keycloak and search for XXXXXXXXXXXX.

...

  1. This value must match the clientSecret value in local.json so that the CHEFS API can connect to your Keycloak instance.

...

  1. Do this by searching for XXXXXXXXXXXX in local.json and

...

  1. replacing it with the

...

  1. value used in realm-export.json

  2. In the same realm-export.json file, search for YYYYYYYYYYYY and replace it with the client id (resource) you obtained from the Pathfinder SSO page. Search for ZZZZZZZZZZZZ and replace it with the client secret

View file
namechefs_build.zip
View file
namelocal.json

All the files are now configured and you can run Keycloak and PostgreSQL.

Start Docker, open a terminal in the /chefs_build directory, and run the following command:

...

This will start the process for the CHEFS frontendfront end.

Additional Resources

Common Services API Access

...