![Maverics Multi-Cloud Identity](https://github.com/maverics-org/maverics/raw/d3aec4ae2cfd/assets/logo_maverics.png)
![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)
Maverics is an open source abstraction layer for creating a modern, cloud native, distributed identity system.
What is Maverics?
Maverics provides a Migration Service that connects together identity domains and moves policies, configurations, users, and credentials from a source identity domain to a target identity domain.
In this initial iteration of the Migration Service, the Orchestrator acts as an Authentication Broker to one or more identity domains by coordinating with worker nodes that proxy requests and allow incremental migration of users and credentials from the source identity domain to the target identity domain.
Maverics provides a Synchronization Service to keep identity data in sync across multiple identity domains during periods of coexistence.
Installation
Maverics can be run on Linux, macOS, Windows, and Docker. Maverics can be used as a standalone micro-service or integrated into an existing application.
Quickstart Guide
Follow this guide to get started using Maverics. When you complete this guide you will have:
- Set up a Maverics development environment
- Downloaded a sample authentication application
- Built and run the sample application
1. Set up Maverics development environment:
- Install Go (1.12 or above)
- Install Docker
2. Download the sample authentication application:
The sample application shows how to wire a componentized authentication service using Maverics.
Download Maverics:
git clone git@github.com:maverics-org/maverics.git
Go to the sample application directory:
cd maverics/examples/authn/
3. Build and run the sample application:
See the sample app's README for instructions.
Use Cases
Authentication Broker
Post credentials via HTTP, encode to an LDAP bind request, authenticate against an LDAP server and return the result of the authentication.
![Authentication Broker Architecture](https://github.com/maverics-org/maverics/raw/d3aec4ae2cfd/assets/authentication_broker_ldap.png)
Future Direction
Migration
Add functionality to Maverics to migrate credentials, extract identity metadata from a source identity domain, and migrate credentials and identity metadata to a destination identity domain.
Contributing
Please see CONTRIBUTING.md