The authentication service provides basic token based single sign on authentication for different applications. It can manage a number of applications, their users and roles.

Installation

In order to run the service simply download the latest assemblies and host them with your ASP.NET MVC 5 compatible server (apache, nginx). The hibernate.cfg.xml file needs to be adjusted with the desired database connection. Use the same configuration file (or a different one with priviledges to create database tables) for the AuthenticationControl tool. You can simply put the file into the bin folder of the tool or reference it with the –c flag for each command.

Create the database and an admin user for the service itself:

mono AuthenticationControl.exe -c <path to hibernate config file> tables create

After the tables and the admin are created the commandline tool will print the application key for the service itself. It needs to be added to the applications web.config:

<configuration>
  <appSettings>
    <add key="AppKey" value="{printed-token}" />
  </appSettings>
</configuration>

Creating applications, users and roles works the same way, simply replace tables with what you want to create and provide the additional arguments. The tool can provide you with descriptions of the required arguments for each command.

Documentation

Development documentation can be found here.

Code documentation can be found at https://apidocs.norsecorby.de.

The OpenAPI documentation for the services can be found at the "/swagger" endpoint when the application is running.

Tests

Tests can be run using NUnit by using the projects in the test folder. The easiest way to run all tests is to use the test-run.sh script from the scripts folder:

sh test-run.sh

Build and tests will soon also automatically run on the Jenkins CI server at https://ci.norsecorby.de/.