Application configuration¶
Configuration is loaded from appsettings.json (required, reloadable), appsettings.Development.json and environment variables through the default host builder. No secrets are stored in the repository.
Application settings¶
| Setting | Value | Purpose |
|---|---|---|
AppSettings:ApplicationName |
NDReimbursementWebApp |
Application name; must match the path base in Startup (BR-APP-008) |
AppSettings:ApplicationHost |
entsit |
Host track label used by the inherited start-up† |
Ssl:Disabled |
"true" | SSL toggle (TD-APP-011) |
OneIncApiClientOptions:SystemType |
WebApp |
Read by RegisterOneIncApiClient |
AllowedHosts |
* |
Host filtering is open |
Logging |
Default levels | Standard logging |
BasicAppMap:AppMenuCategory |
NDR |
Menu category for the BOL layout † |
BasicAppMap page ids |
HomePage = NDReimbursement, NDReimbursement = NDR-NDREIMBURSEMENT |
Menu page identifiers † |
appsettings.Development.json turns on DetailedErrors.
Environment API¶
No Environment API keys are read from the application's source code. The application never calls IEnvironmentClient to read a setting. It only passes the client to the DocumentsCoreClient constructor in Startup.cs. Any Environment API keys in use are read inside the dependency packages (for example the inherited start-up and the API clients) and are not enumerated here.
Developer settings¶
developersettings.json contains one API address entry for a test track. The EnvApiDeveloperSettingsOverride switch that would use it is commented out, so the file has no effect while the switch stays off.
Hosting¶
| Item | Value |
|---|---|
| Framework | net8.0 |
| Hosting model | IIS in-process (web.config) |
| Path base | /NDReimbursementWebApp |
| Environment | web.config sets ASPNETCORE_ENVIRONMENT to Development (TD-APP-011) |
| CORS headers | Access-Control-Allow-Origin: http://localhost, Access-Control-Allow-Credentials: true |
| Local launch | Windows authentication on, anonymous off; ports 1578 and 1579; IIS Express port 49520 |
Build¶
The front-end style build is gulp sass, compiling main.scss to css/main.css. Dev dependencies are gulp, gulp-sass and sass. The sass-kendo task and compilerconfig.json are stale (TD-APP-013). NuGet package versions are listed in Dependencies.
Start-up options¶
Startup sets EnableNewtonsoftJsonSerializer and EnableSessionMiddleware to true. The NDReimbursement API client timeout is 300 seconds. See Architecture.
Note: Statements marked with
†are derived from dependency library documentation via the Legends CLI. They describe inherited behavior from the indicated origin library and should be verified if the dependency version changes.
Related documentation¶
- Application index
- Overview
- Architecture
- Dependencies
- Hosted endpoints
- Operations and processes
- Business rules
- Security and authorization
- Data model
- Tech debt
Sources¶
- src/NDReimbursementWebApp/appsettings.json
- src/NDReimbursementWebApp/appsettings.Development.json
- src/NDReimbursementWebApp/developersettings.json
- src/NDReimbursementWebApp/web.config
- src/NDReimbursementWebApp/Properties/launchSettings.json
- src/NDReimbursementWebApp/Startup.cs
- src/NDReimbursementWebApp/package.json
- src/NDReimbursementWebApp/gulpfile.js