About

This web app emulates the Comelit Single Sign-on Service.

Housing Central

Run this emulator to support a development instance of Housing Central.

Configuration

Housing Central Admin app must be configured to point to the emulator. Within the application's appsettings.json configuration file, find the "ComelitAuth" section and set the endpoint addresses appropriately.

Web Pages

When Housing Central Admin is run, it includes links to allow the user to Login, Register and manage their Account. These links use the configured endpoints to redirect to web pages in the emulator.

In addition, Housing Central can generate emails that are sent to customer Operator's inviting them to register or manage their accounts. These emails contain links to web pages in the emulator.

API

Housing Central middleware accesses the Comelit SSO API at the configured endpoint to verify that the user is authenticated. It uses the /check-login and /logout endpoints.

Integration Tests

The ComelitAuth project in Oort has an associated set of integration tests which require the emulator to be running. These tests exercise the integration with the Comelit SSO API.

The tests use additional endpoints such as /register, /login and /unregister in test setup and teardown.

Account Management

The emulator can be used independently of Housing Central. It offers CRUD operations on the Accounts held in a SQLite database.