authentik fork
This repository has been archived on 2024-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Jens Langhammer 26613b6ea9 core: fix application overview 2020-07-05 22:58:52 +02:00
.github Merge branch 'master' into azure-pipelines 2020-07-03 09:33:04 +02:00
docker docker: fix import order on wait_for_db 2020-05-16 22:56:14 +02:00
docs docs: clarify post-installation login 2020-06-18 23:26:15 +02:00
e2e flows: FlowStageBinding: rename .flow to .target to fix select_subclasses() 2020-07-04 00:14:21 +02:00
gatekeeper gatekeeper: update upstream docker image 2020-06-09 09:26:03 +02:00
helm new release: 0.9.0-pre4 2020-07-01 09:50:21 +02:00
passbook core: fix application overview 2020-07-05 22:58:52 +02:00
scripts Merge branch 'master' into azure-pipelines 2020-07-03 09:33:04 +02:00
.bumpversion.cfg new release: 0.9.0-pre4 2020-07-01 09:50:21 +02:00
.coveragerc policy(minor): add unittests for policy engine 2019-10-14 16:08:24 +02:00
.dockerignore ui: update static docker image to download NPM modules 2020-02-21 15:33:54 +01:00
.editorconfig repo cleanup, switch to new docker registry 2019-04-29 17:05:39 +02:00
.fossa.yml root: add fossa 2020-05-08 21:08:36 +02:00
.gitignore e2e: Add denied tests for oauth and oidc provider 2020-07-02 21:55:02 +02:00
.isort.cfg root: add process ID to logging output 2020-02-24 13:20:32 +01:00
.prospector.yaml root: fix pylint not correctly ignoring migrations 2020-05-27 11:15:10 +02:00
.pylintrc root: fix pylint not correctly ignoring migrations 2020-05-27 11:15:10 +02:00
Dockerfile root: rewrite bootstrap in python, remove management command 2020-05-16 22:46:17 +02:00
LICENSE repo cleanup, switch to new docker registry 2019-04-29 17:05:39 +02:00
Pipfile sources/oauth: fix facebook provider 2020-06-25 10:24:53 +02:00
Pipfile.lock build(deps): bump django-prometheus from 2.1.0.dev42 to 2.1.0.dev46 2020-07-03 06:53:47 +00:00
README.md Merge branch 'master' into azure-pipelines 2020-07-03 09:33:04 +02:00
SECURITY.md root: update readme 2020-05-27 17:26:35 +02:00
azure-pipelines.yml ci: final cleanup 2020-07-03 10:17:24 +02:00
docker-compose.yml root: fix docker-compose not correctly redirecting to https 2020-06-16 21:34:48 +02:00
docker.env.yml e2e: add apply_default_data to load data from migrations after tables have been truncated 2020-06-07 19:31:16 +02:00
manage.py e2e: add OIDC Provider test against grafana, more formatting, minor bug fixes 2020-06-19 19:45:27 +02:00
mkdocs.yml *: make email naming consistent 2020-06-18 19:35:59 +02:00
pyproject.toml WIP Use Flows for Sources and Providers (#32) 2020-06-07 16:35:08 +02:00
pyrightconfig.json stages/password: fix possibility of password in logs 2020-05-09 20:53:32 +02:00
setup.cfg core: cleanup 2018-12-09 21:07:38 +01:00
static.Dockerfile providers/oidc: fix skip_authorization not being synced to oidc_client 2020-03-02 17:40:38 +01:00
swagger.yaml stages/user_login: Allow changing of session duration 2020-07-04 15:20:45 +02:00

README.md

passbook logopassbook

======= CI Build status Docker pulls Docker pulls (gatekeeper) Latest version LGTM Grade Code Coverage

What is passbook?

passbook is an open-source Identity Provider focused on flexibility and versatility. You can use passbook in an existing environment to add support for new protocols. passbook is also a great solution for implementing signup/recovery/etc in your application, so you don't have to deal with it.

Installation

For small/test setups it is recommended to use docker-compose.

wget https://raw.githubusercontent.com/BeryJu/passbook/master/docker-compose.yml
# Optionally enable Error-reporting
# export PASSBOOK_ERROR_REPORTING=true
# Optionally deploy a different version
# export PASSBOOK_TAG=0.8.15-beta
# If this is a productive installation, set a different PostgreSQL Password
# export PG_PASS=$(pwgen 40 1)
docker-compose pull
docker-compose up -d
docker-compose exec server ./manage.py migrate

For bigger setups, there is a Helm Chart in the helm/ directory. This is documented here

Screenshots

Development

To develop on passbook, you need a system with Python 3.7+ (3.8 is recommended). passbook uses pipenv for managing dependencies.

To get started, run

python3 -m pip install pipenv
git clone https://github.com/BeryJu/passbook.git
cd passbook
pipenv shell
pipenv sync -d

Since passbook uses PostgreSQL-specific fields, you also need a local PostgreSQL instance to develop. passbook also uses redis for caching and message queueing. For these databases you can use Postgres.app and Redis.app on macOS or use it the docker-compose file in scripts/docker-compose.yml.

To tell passbook about these databases, create a file in the project root called local.env.yml with the following contents:

debug: true
postgresql:
  user: postgres

log_level: debug
error_reporting: false

Security

See SECURITY.md