This is the full version of JP Project. It provide SSO and an Api where it's possible to manage both IdentityServer4 and ASP.NET Identity.
Windows users:
- download jpproject-docker.zip
- Unzip and execute
docker-run.bat
(As administrator)
Linux users:
- Download jpproject-docker.zip
- Add
127.0.0.1 jpproject-sso
entry to hosts file (/etc/hosts
) - unzip and execute
docker-compose up
- Installation
- Presentation
- How to start?
- Demo
- Technologies
- Give a Star! ⭐
- Docs
- 3.2.0
- What comes next?
- License
The main goal of JP Project is to be a Management Ecosystem for IdentityServer4 and ASP.NET Identity. Helping Startup's and companies to Speed Up Microservices Environment. Providing tools for an OAuth 2.0 Server and User Management. It's highly modular and easy to change for .NET teams.
Built with IdentityServer4. An OpenID Connect and OAuth 2.0 framework for ASP.NET Core.
SSO Features:
- Single Sign On
- Register users
- Recover password flow
- MFA
- Federation Gateway (Login by Google, Facebook.. etc)
- Argon2 password hashing
- CSP Headers
- Event monitoring (For compliance scenarios)
- Key Material Management
- ASP.NET Core Dataprotection keys management
Admin UI is an administrative panel where it's possible to manage both OAuth2 Server and Identities.
From OAuth 2.0 panel it's possible to manage:
Clients
Identity Resources
Api Resources
Persisted Grants
For Identity panel it's possible to manage
Users
Roles
- Events
- Server Settings:
- Create custom e-mail for Confirm Account and Forgot Password. It's also possible to configure E-mail settings and a blob Storage to store Users pictures (Azure Blob, AWS S3 and Filesystem).
It's open source and free. From community to community.
Screenshots
First you need to choose.
-
You need everything (Best choice)? JP Project provide a complete SSO with an Administration panel. Check it at SSO - Full Version. This version has some additional Tables:
- Template - store e-mail template
- Email - An instance of template with e-mail settings
- GlobalSettings - It store settings like E-mail credentials, S3 / Azure Blob settings. Logo / Version settings
- StoredEvent and EventDetails - Store everything that is happening in your SSO.
- DataProtectionKeys and SecurityKeys - Special tables to store Key Material (JWK) and ASP.NET Dataprotection Keys
-
You already have an IdentityServer4 Up and running and don't wanna any changes to your current model. Only the admin panel? Go to Admin Panel - Light version
These options above requires almost no code. If you already have an ASP.NET IdentitySystem it's possible to connect SSO to use your users, but requires some modifications:
- Check Argon2 implementation at
Startup.cs
- You UserIdentity must implement
IDomainUser
(No additional fields will be added to your ASP.NET Identity)- All SSO fields are users claims
- If your Users have custom fields, you can implement
IIdentityFactory<TUser>
andIRoleFactory<TUser>
. These classes will help you in Register / Update user flow. It give you hability to intercept the request before add / update user or role to database.
Check our demo online.
Check it now at Admin Panel.
You can check also SSO and Profile Manager
New users are readonly
Check docs to see how to and some examples:
- Azure App Service
- Docker Swarm + Nginx in Linux.
- Docker compose + nginx in linux
- Make a PR and show how you have done your environment!
Check below how it was developed.
Written in ASP.NET Core 3.1 and Angular 8.
- Angular 8
- Rich UI interface
- ASP.NET Core 3.0
- ASP.NET MVC Core
- ASP.NET WebApi Core
- ASP.NET Identity Core
- Argon2 Password Hashing
- MySql Ready
- Sql Ready
- Postgres Ready
- SQLite Ready
- Entity Framework Core
- .NET Core Native DI
- AutoMapper
- FluentValidator
- MediatR
- Swagger UI
- High customizable
- Translation for 7 different languages
It respect the IdentityServer4 base classes and was built in the same way, for better compatibility and minimize impacts for future versions.
- Architecture with responsibility separation concerns, SOLID and Clean Code
- Hexagonal architecture (Layers and Domain Model Pattern)
- Domain Events
- Domain Notification
- CQRS (Imediate Consistency)
- Event Sourcing
- Unit of Work
- Repository and Generic Repository
The Cryptography Keys (JWKS) are stored within Database and auto refresh it every 90 days. It uses ECDSA using P-256 and SHA-256 (ES256) by default.
The dataprotection keys are stored with database, like Key Material.
Do you love it? give us a Star!
Jp Project is built against ASP.NET Core 3.1.
- Install the latest .NET Core 3.10 SDK
src/JPProject.SSO.sln
Contains SSO and API
For UI's use VSCode.
- User Management -> Inside VSCode open folder
rootFolder/src/Frontend/Jp.UserManagement
, then terminal andnpm install && npm start
Wait for ng to complete his proccess then go to http://localhost:5000!
Any doubts? Go to docs
Wanna start? please Read the docs
Thank you all!
We'll love it! Please Read the docs
If you need help building or running your Jp Project platform There are several ways we can help you out.
- ASP.NET Identity - Now you can plug your running Identity to use SSO. It need to made some changes at you IdentityUser with more data, like Name, Url, Bio.
- Changes in Events - Now all events are attached at his Aggregate Roots. Now events are very strong source of analysis.
- Event search at Admin Panel
- OAuth 2.0 Best practices
- Jwa with Elliptic Curves
- Jwk using ECDSA using P-256 and SHA-256 (ES256) by default
- Changed how clients are created by default. Using Authorization Code with PKCE or Client Credentials only.
- Key Material management - Key material now available at Database. Now it's possible to Scale Horizontal without any "Unprocted ticket failed" error
- ASP.NET Core 3.0 support
- Separated repositories, for better management. Improving tests, integration tests. And to support more scenarios.
Breaking change: Argon2 password hashing. Be careful before update. If you are using the old version all users must need to update their passwords.
- Bug fixes:
- Tooltip for admin-ui
- Argon2 Password Hasher
- Show version at footer
Check Changelog.md for a complete list of changes.
- An easy way to insert Client, IdentityResources and Api Resources by JSON - Aiming teams who needs to take data from Staging to past it to production
- Key Material Management from Admin UI
- Code coverage
- UI for Device codes
- CI with SonarCloud
Jp Project is Open Source software and is released under the MIT license. This license allow the use of Jp Project in free and commercial applications and libraries without restrictions.