Skip to content

Latest commit

 

History

History
65 lines (47 loc) · 7.14 KB

README.md

File metadata and controls

65 lines (47 loc) · 7.14 KB

Node Web

Description

Node Web is a frontend service used together with node-api. It is also a template for Node Web applications developed at KTH.

Installation

Install Dependencies

$ npm install

Environment Variables

Sensible defaults are set and the application can run locally with a minimal .env file. Only OIDC_APPLICATION_ID and OIDC_CLIENT_SECRET need to be set. They can be retrieved from a key vault in Azure.

Name Description Default Value
SERVER_HOST_URL Address to application http://localhost: + environment variable SERVER_PORT
SERVER_PORT The HTTP server port 3000
SERVICE_PUBLISH Root path for the application /node
NODE_API_KEY API key to connect to node-api 1234
NODE_API_URI URI to connect to node-api, and additional connection parameters http://localhost:3001/api/node?defaultTimeout=10000
OIDC_CONFIGURATION_URL URL to OpenID Connect server, used by dependency @kth/kth-node-passport-oidc https://login.ref.ug.kth.se/adfs/.well-known/openid-configuration
OIDC_APPLICATION_ID Application clientID, used by dependency @kth/kth-node-passport-oidc null
OIDC_CLIENT_SECRET Application secret, used by dependency @kth/kth-node-passport-oidc null
OIDC_TOKEN_SECRET Application token secret, used for encrypting token for session storage, used by dependency @kth/kth-node-passport-oidc tokenSecretString
OIDC_CALLBACK_URL Application’s URL to callback function for standard login, used by dependency @kth/kth-node-passport-oidc http://localhost:3000${prefixPath}/auth/login/callback, where prefixPath is environment variable SERVER_PUBLISH
OIDC_CALLBACK_SILENT_URL Application’s URL to callback function for silent login, used by dependency @kth/kth-node-passport-oidc http://localhost:3000${prefixPath}/auth/silent/callback, where prefixPath is environment variable SERVER_PUBLISH
OIDC_CALLBACK_LOGOUT_URL Application’s URL to callback function for logout, used by dependency @kth/kth-node-passport-oidc http://localhost:3000${prefixPath}/auth/logout/callback, where prefixPath is environment variable SERVER_PUBLISH
CM_HOST_URL URL to CMS, used by dependency @kth/cortina-block https://www-r.referens.sys.kth.se/cm/
LOGGING_ACCESS_LOG Enables or disabled application access log, used by dependency kth-node-access-log true
LOGGING_LEVEL Application logging level, used by dependency @kth/log debug
SESSION_SECRET Application’s session secret, used by dependency @kth/session 1234567890
SESSION_KEY Application’ session key, used by dependency @kth/session node-web.sid
REDIS_URI URL to Redis, used to store data from CMS and sessions redis://localhost:6379/
SESSION_USE_REDIS Enables or disables saving sessions to Redis true
SESSION_SECURE_COOKIE Enables or disables using secure cookies for sessions, should be true unless in local development false
TOOLBAR_URL URL to KTH’s personal menu, KPM https://www-r.referens.sys.kth.se/social/toolbar/widget.js

Local Databases

  • It is recommended to use a local document database (and Redis) with kth-node-backend

Usage

Start the application in local development mode:

$ npm run start-dev

Running Tests

Tests are setup with Jest. Run them with:

$ npm test

Contact

Node Web is developed and maintained by Team KTH Web.