---

Branch	Build status
master
develop

Let's go for the better, Collectively​​.

Collectively is an open platform to enhance communication between counties and its residents​. It's made as a fully open source & cross-platform solution by Noordwind.

Find out more at becollective.ly

Collectively.Services.Identity

The Collectively.Services.Identity is a service responsible for managing the users identities and providing authentication tokens JWT valid in the whole system to authenticate and authorize the requests to the API.

Quick start

Docker way

Collectively is built as a set of microservices, therefore the easiest way is to run the whole system using the docker-compose.

Clone the Collectively.Docker repository and run the start.sh script:

git clone https://github.com/noordwind/Collectively.Docker
./starth.sh

For the list of available services and their endpoints click here.

Classic way

In order to run the Collectively.Services.Identity you need to have installed:

• .NET Core
• MongoDB
• RabbitMQ

Clone the repository and start the application via dotnet run command:

git clone https://github.com/noordwind/Collectively.Services.Identity
cd Collectively.Services.Identity/Collectively.Services.Identity
dotnet restore --source https://api.nuget.org/v3/index.json --source https://www.myget.org/F/collectively/api/v3/index.json --no-cache
dotnet run --urls "http://*:5050"

Once executed, you shall be able to access the service at http://localhost:5050

Please note that the following solution will only run the Identity Service which is merely one of the many parts required to run properly the whole Collectively system.

Configuration

Please edit the appsettings.json file in order to use the custom application settings. To configure the docker environment update the dockerfile - if you would like to change the exposed port, you need to also update it's value that can be found within Program.cs. For the local testing purposes the .local or .docker configuration files are being used (for both appsettings and dockerfile), so feel free to create or edit them.

Tech stack

• .NET Core - an open source & cross-platform framework for building applications using C# language.
• Nancy - an open source framework for building HTTP API.
• MongoDB - an open source library for integration with MongoDB database.
• RawRabbit - an open source library for integration with RabbitMQ service bus.

Solution structure

• Collectively.Services.Identity - core and executable project via dotnet run command.
• Collectively.Services.Identity.Tests - unit & integration tests executable via dotnet test command.