Arsharth/dex
1
0
Fork 0
forked from mystiq/dex
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
333 commits 27 branches 73 tags 23 MiB
Go 97.8%
CSS 0.6%
HTML 0.6%
Makefile 0.5%
Dockerfile 0.2%
Other 0.2%
Find a file
Eric Chiang d87a4c35b9 *: add 'make revendor' and tests to catch incorrect glide usage 
Introducing glide-vc caused us to unknowingly removed our Go
protobuf compiler (since it's a main). Add flags to glide-vc usage
to remedy this.

Since we now require several glide and glide-vc flags, add a Makfile
target and tests to catch when PRs don't use the correct flags.
2016-12-22 11:52:24 -08:00
api api: adding a gRPC call for listing passwords. 2016-11-17 16:56:54 -08:00
cmd server: use UTC timestamps in dex. 2016-12-16 16:13:51 -08:00
connector server: modify error messages to use logrus. 2016-12-13 11:52:44 -08:00
Documentation *: add 'make revendor' and tests to catch incorrect glide usage 2016-12-22 11:52:24 -08:00
examples replace bcrypt hash with a working one 2016-12-20 15:21:05 +01:00
scripts sh has no arrays 2016-12-22 14:29:04 +01:00
server server: add error HTML templates with error description. 2016-12-16 10:42:54 -08:00
storage storage: fix postgres timezone handling 2016-12-16 11:46:49 -08:00
vendor vendor: revendor 2016-12-12 15:56:50 -08:00
version *: determine version from git 2016-08-09 14:38:09 -07:00
web server: add error HTML templates with error description. 2016-12-16 10:42:54 -08:00
.gitignore *: prepare build scripts for a release 2016-10-05 23:43:44 -07:00
.travis.yml *: update travis to use Go 1.7.4. 2016-12-01 20:28:21 -08:00
DCO *: add DCO and LICENSE 2016-10-13 11:33:32 -07:00
Dockerfile *: add theme based frontend configuration 2016-11-30 17:20:21 -08:00
glide.lock vendor: revendor 2016-12-12 15:56:50 -08:00
glide.yaml *: add logrus package. 2016-12-12 15:56:50 -08:00
glide_test.go *: add 'make revendor' and tests to catch incorrect glide usage 2016-12-22 11:52:24 -08:00
LICENSE *: add DCO and LICENSE 2016-10-13 11:33:32 -07:00
Makefile *: add 'make revendor' and tests to catch incorrect glide usage 2016-12-22 11:52:24 -08:00
README.md *: add go report card to README 2016-12-13 12:24:27 -08:00

README.md

dex - A federated OpenID Connect provider

Travis GoDoc Go Report Card

logo

Dex is an OpenID Connect server that connects to other identity providers. Clients use a standards-based OAuth2 flow to login users, while the actual authentication is performed by established user management systems such as Google, GitHub, FreeIPA, etc.

OpenID Connect is a flavor of OAuth that builds on top of OAuth2 using the JOSE standards. This allows dex to provide:

  • Short-lived, signed tokens with standard fields (such as email) issued on behalf of users.
  • "well-known" discovery of OAuth2 endpoints.
  • OAuth2 mechanisms such as refresh tokens and revocation for long term access.
  • Automatic signing key rotation.

Standards-based token responses allows applications to interact with any OpenID Connect server instead of writing backend specific "access_token" dances. Systems that can already consume ID Tokens issued by dex include:

Kubernetes + dex

Dex's main production use is as an auth-N addon in CoreOS's enterprise Kubernetes solution, Tectonic. Dex runs natively on top of any Kubernetes cluster using Third Party Resources and can drive API server authentication through the OpenID Connect plugin. Clients, such as the Tectonic Console and kubectl, can act on behalf users who can login to the cluster through any identity provider dex supports.

More docs for running dex as a Kubernetes authenticator can be found here.

Documentation

Getting help

  • For bugs and feature requests (including documentation!), file an issue.
  • For general discussion about both using and developing dex, join the dex-dev mailing list.
  • For more details on dex development plans, check out the GitHub milestones.