Forked Dex to convert GitHub usernames to lowercase
This repository has been archived on 2023-08-14. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Eric Chiang 18bbd94fba *: check go version before building
Add a script to check the Go version before building dex. This
gives a nice error message rather than just failing to compile.

With changes:

    $ go version
    go version go1.6.4 linux/amd64
    $ make
    ERROR: dex requires Go version 1.7+. Please update your Go installation: https://golang.org/dl/
    Makefile:93: recipe for target 'check-go-version' failed
    make: *** [check-go-version] Error 2

Checks only added for building the actual binary, not tests, since
this is aimed at users just starting off with the project.
2016-12-13 12:03:27 -08:00
Documentation Documentation: add notes on patch release branches 2016-12-12 15:29:00 -08:00
api api: adding a gRPC call for listing passwords. 2016-11-17 16:56:54 -08:00
cmd cmd/example-app: use a non-empty state 2016-12-01 09:05:56 -08:00
connector connector/ldap: default email_verified to true 2016-12-09 13:22:19 -08:00
examples *: add theme based frontend configuration 2016-11-30 17:20:21 -08:00
scripts *: check go version before building 2016-12-13 12:03:27 -08:00
server *: add theme based frontend configuration 2016-11-30 17:20:21 -08:00
storage storage/kubernetes: remove unused method 2016-12-08 16:42:18 -08:00
vendor vendor: revendor using glide-vc 2016-12-07 13:23:19 -08:00
version *: determine version from git 2016-08-09 14:38:09 -07:00
web Address PR comments 2016-12-01 14:06:08 -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
LICENSE *: add DCO and LICENSE 2016-10-13 11:33:32 -07:00
Makefile *: check go version before building 2016-12-13 12:03:27 -08:00
README.md Merge pull request #736 from ericchiang/kubernetes-integration-readme 2016-12-12 14:21:44 -08:00
glide.lock vendor: revendor using glide-vc 2016-12-07 13:23:19 -08:00
glide.yaml glide.yaml: update inline comments 2016-12-07 13:23:19 -08:00
glide_test.go initial commit 2016-07-26 15:51:24 -07:00

README.md

dex - A federated OpenID Connect provider

Travis GoDoc

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.