A reverse proxy that provides authentication with Google, Azure, OpenID Connect and many more identity providers.
Go to file
Dan Bond 9d0a0c7426
remove unnecessary validator tests (#288)
* remove unnecessary validator tests

* fix WriteString error
2019-10-18 08:49:33 -07:00
.github Add Bitbucket provider. (#201) 2019-08-16 14:53:22 +01:00
contrib Fix repo link 2019-06-01 05:36:28 +03:00
docs Merge branch 'master' into feature/azure-idtoken 2019-10-04 13:32:29 +01:00
pkg Some code improvements 2019-10-09 15:44:26 +03:00
providers Merge branch 'master' into feature/azure-idtoken 2019-10-14 11:04:04 +01:00
.dockerignore Ignore Dockerfile.dev 2019-01-22 02:54:17 +09:00
.gitignore Add make targets for serving docs locally 2019-05-10 12:07:16 +01:00
.golangci.yml Remove TODO vetshadow as it's part of govet 2019-07-01 16:27:19 +01:00
.travis.yml Support Go 1.13.x and allow to override REGISTRY (#273) 2019-10-07 13:53:46 -07:00
CHANGELOG.md Merge branch 'master' into feature/azure-idtoken 2019-10-14 11:04:04 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md (#277) 2019-10-09 09:57:59 -07:00
Dockerfile docker: build from debian buster 2019-10-07 17:03:15 -07:00
Dockerfile.arm64 docker: build from debian buster 2019-10-07 17:03:15 -07:00
Dockerfile.armv6 docker: build from debian buster 2019-10-07 17:03:15 -07:00
LICENSE add MIT license for google_auth_proxy 2014-06-09 16:25:26 -04:00
MAINTAINERS Add MAINTAINERS and update CODEOWNERS 2019-07-23 16:20:45 +01:00
Makefile Support Go 1.13.x and allow to override REGISTRY (#273) 2019-10-07 13:53:46 -07:00
README.md Update README - add more badges (#281) 2019-10-13 15:33:18 -07:00
configure Merge branch 'master' into go-mod 2019-07-15 21:38:55 +01:00
dist.sh distribution: remove gpm references and update to use dep 2017-12-04 09:54:31 -05:00
env_options.go Some code improvements 2019-10-09 15:44:26 +03:00
env_options_test.go Allow embedded structs in env_options 2019-05-18 13:09:58 +02:00
go.mod Support Go 1.13.x and allow to override REGISTRY (#273) 2019-10-07 13:53:46 -07:00
go.sum Support Go 1.13.x and allow to override REGISTRY (#273) 2019-10-07 13:53:46 -07:00
htpasswd.go Move logger to pkg/logger 2019-06-15 11:33:58 +02:00
htpasswd_test.go Lint for non-comment linter errors 2018-11-29 14:26:41 +00:00
http.go Move logger to pkg/logger 2019-06-15 11:33:58 +02:00
http_test.go Fix lint errors 2019-06-23 21:39:13 +01:00
logging_handler.go Add silence ping logging flag 2019-07-16 09:42:24 +12:00
logging_handler_test.go logger.go ExcludedPaths changed to slice of paths. 2019-07-16 10:04:09 +12:00
main.go Merge branch 'master' into keycloak-provider 2019-08-17 08:10:37 +01:00
oauthproxy.go Some code improvements 2019-10-09 15:44:26 +03:00
oauthproxy_test.go New flag "-ssl-upstream-insecure-skip-validation" (#234) 2019-08-07 17:48:53 +01:00
options.go Merge branch 'master' into keycloak-provider 2019-08-17 08:10:37 +01:00
options_test.go added better tests for gcp healthcheck stuff 2019-03-25 09:56:56 -07:00
string_array.go Implement Getter interface for StringArray (#104) 2019-03-20 13:58:14 +00:00
templates.go Move logger to pkg/logger 2019-06-15 11:33:58 +02:00
templates_test.go Swap out bmizerany/assert package that is deprecated in favor of stretchr/testify/assert 2017-10-23 12:24:17 -04:00
validator.go Move logger to pkg/logger 2019-06-15 11:33:58 +02:00
validator_test.go remove unnecessary validator tests (#288) 2019-10-18 08:49:33 -07:00
version.go Introduce Makefile 2019-01-04 10:58:30 +00:00
watcher.go Move logger to pkg/logger 2019-06-15 11:33:58 +02:00
watcher_unsupported.go Move logger to pkg/logger 2019-06-15 11:33:58 +02:00

README.md

oauth2_proxy

Build Status Go Report Card GoDoc MIT licensed

A reverse proxy and static file server that provides authentication using Providers (Google, GitHub, and others) to validate accounts by email, domain or group.

Note: This repository was forked from bitly/OAuth2_Proxy on 27/11/2018. Versions v3.0.0 and up are from this fork and will have diverged from any changes in the original fork. A list of changes can be seen in the CHANGELOG.

Sign In Page

Installation

  1. Choose how to deploy:

    a. Download Prebuilt Binary (current release is v4.0.0)

    b. Build with $ go get github.com/pusher/oauth2_proxy which will put the binary in $GOROOT/bin

    c. Using the prebuilt docker image quay.io/pusher/oauth2_proxy (AMD64, ARMv6 and ARM64 tags available)

Prebuilt binaries can be validated by extracting the file and verifying it against the sha256sum.txt checksum file provided for each release starting with version v3.0.0.

sha256sum -c sha256sum.txt 2>&1 | grep OK
oauth2_proxy-4.0.0.linux-amd64: OK
  1. Select a Provider and Register an OAuth Application with a Provider
  2. Configure OAuth2 Proxy using config file, command line options, or environment variables
  3. Configure SSL or Deploy behind a SSL endpoint (example provided for Nginx)

Docs

Read the docs on our Docs site.

OAuth2 Proxy Architecture

Getting Involved

If you would like to reach out to the maintainers, come talk to us in the #oauth2_proxy channel in the Gophers slack.

Contributing

Please see our Contributing guidelines.