https://github.com/system76/recognizer

A authentication and user service
https://github.com/system76/recognizer

authentication elixr-lang guardian microservice phoenix-framework user-management

Last synced: 2 months ago
JSON representation

A authentication and user service

• Host: GitHub
• URL: https://github.com/system76/recognizer
• Owner: system76
• License: gpl-3.0
• Created: 2019-12-30T22:48:14.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-11-04T16:12:52.000Z (2 months ago)
• Last Synced: 2024-11-04T17:19:01.596Z (2 months ago)
• Topics: authentication, elixr-lang, guardian, microservice, phoenix-framework, user-management
• Language: Elixir
• Homepage: https://auth.system76.com
• Size: 585 KB
• Stars: 20
• Watchers: 5
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        


  



# Recognizer

Recognizer is a standalone service designed to provide the functionality of both a centralization authentication service

and the user account service.

### Rationale

At System76 we have multiple applications that use the same underlying data but through differing authentication flows.

In order to decouple our applications from authentication, improve maintainability, and faster feature iteration we have

decided to build a standalone service to replace existing auth flows within our platform.

**_While the best attempts are made to ensure the software herein is suitable for use by others, it is being developed

for use with existing projects at System76. For this reason, modification to the software may be necessary for use

elsewhere._**

## Running

For convenience a `docker-compose.yml` file has been included to manage the MySQL and Redis instances. Before we run

our test suite, or start local development, we need to stand up our instances:

```shell

$ docker-compose up

```

Now we're ready to run our tests:

```shell

$ mix test

Finished in 0.2 seconds

28 tests, 0 failures

```

Or run our local development server:

```shell

$ mix ecto.setup

$ mix phx.server

```

## Releases

This repository includes a continuous integration and deployment. Simply make a PR to the `master` branch, and once it's

merged, it will be deployed to production.

## License

The Recognizer source code is released under GPL3 by [@System76](https://github.com/system76).

See [LICENSE](https://github.com/doomspork/recognizer/blob/master/LICENSE) for more information.