...
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.
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
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 | ||
---|---|---|
|
Download
chefs_build.zip
which contains directory structure and docker file for building CHEFS.
View file | ||
---|---|---|
|
Open
realm-export.json
located atchefs_build/docker/imports/keycloak
and search forXXXXXXXXXXXX
.
...
This value must match the
clientSecret
value inlocal.json
so that the CHEFS API can connect to your Keycloak instance.
...
Do this by searching for
XXXXXXXXXXXX
inlocal.json
and
...
replacing it with the
...
value used in
realm-export.json
.In the same
realm-export.json
file, search forYYYYYYYYYYYY
and replace it with the client id (resource) you obtained from the Pathfinder SSO page. Search forZZZZZZZZZZZZ
and replace it with the client secret.
View file | ||
---|---|---|
|
View file | ||
---|---|---|
|
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
...