Skip to main content

Quick Start

Clone the daikon-web-client-core github to your local workspace

git clone https://github.com/saclab/daikon-core-webapp.git

The webclient needs to be configured with the following minimum details

  • Microsoft Azure AD Parameters or Keycloak Parameters (Must be the same identity provider as configured in daikon-core-server)
  • Address of daikon server core web api
ParamaterDescription
REACT_APP_MSAL_CLIENT_IDAzure AD App client id
REACT_APP_MSAL_CLIENT_SCOPEAzure AD App client scope
REACT_APP_MSAL_TENANT_AUTHORITY_URIAzure AD App client tenant authority uri
REACT_APP_MSAL_CACHE_LOCATIONCookie or Session
REACT_APP_MSAL_LOGIN_REDIRECT_URIRoot of domain where web-client is hosted
REACT_APP_WEB_API_BASE_URIAddress of daikon server /api
REACT_APP_KEYCLOAK_URIAddress of the keycloak server
REACT_APP_KEYCLOAK_REALMKeycloak Realm to use
REACT_APP_KEYCLOAK_CLIENT_IDClient ID for the app registration in Keycloak

The configuration must be places in src/config.js
Example Configuration:

export const appConfig = {
  REACT_APP_WEB_API_BASE_URI: "http://localhost:5005/api",

  // Which Identity/Authentication Provider to use
  SSO: "azure",

  // AZURE Settings
  azure: {
    REACT_APP_MSAL_CLIENT_ID: "",
    REACT_APP_WEB_API_BASE_URI: "http://localhost:5005/api",
    REACT_APP_MSAL_CLIENT_SCOPE: "",
    REACT_APP_MSAL_TENANT_AUTHORITY_URI: "",
    REACT_APP_MSAL_CACHE_LOCATION: "sessionStorage",
    REACT_APP_MSAL_AUTH_STATE_IN_COOKIE: "false",
    REACT_APP_MSAL_LOGIN_REDIRECT_URI: "http://localhost:3000",
    REACT_APP_MSAL_LOGOUT_REDIRECT_URI: "http://localhost:3000",
  },

  // Keycloak Settings
  keycloak: {
    REACT_APP_KEYCLOAK_URL: "",
    REACT_APP_KEYCLOAK_REALM: "",
    REACT_APP_KEYCLOAK_CLIENT_ID: "",
    REACT_APP_KEYCLOAK_LOGIN_REDIRECT_URI: "http://localhost:3000",
    REACT_APP_KEYCLOAK_LOGOUT_REDIRECT_URI: "http://localhost:3000",
  },
};

The container is ready to be built up.
Start up with docker. 

docker compose -f docker-compose-dev.yml up

At this point, the daikon-core-webapp runs with the bare minimum configurations in a development env.
Note that an instance of daikon-core-server must be running to make API calls.