forked from oauth2-proxy/oauth2-proxy
-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
doc: readme overhaul and azure sponsorship (oauth2-proxy#2826)
* new readme structure * add adopters file * add microsoft sponsorship * add reference to adopter file * add gopher slack invite link * slightly rephrase nightly image section * add sponsor request for action * better formatting for contributor wall * add longer wait time for stale PRs and issues and allow for exemption through bug and high-priority labels * apply review suggestion Co-authored-by: Joel Speed <[email protected]> --------- Co-authored-by: Joel Speed <[email protected]>
- Loading branch information
Showing
8 changed files
with
93 additions
and
50 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,28 @@ | ||
| # Adopters | ||
|
|
||
| This list showcases organizations that leverage OAuth2-Proxy within their | ||
| infrastructure. If your organization uses OAuth2-Proxy and isn't yet listed, we | ||
| encourage you to add it! | ||
|
|
||
| This list aims to be a comprehensive and trusted resource for the OAuth2-Proxy | ||
| community, demonstrating successful adoption across all kinds of industries. | ||
|
|
||
| Contributing to this list is a simple way to impact the project's growth, | ||
| maturity, and momentum. Thank you to all adopters and contributors of the | ||
| OAuth2-Proxy project! | ||
|
|
||
| ## Updating this list | ||
|
|
||
| To add your organization to this list, you can just [open a PR](https://github.com/oauth2-proxy/oauth2-proxy/pulls) | ||
| to directly update this list. | ||
|
|
||
| Add your organization name, your github username and if you desire a short | ||
| description on how you utilize oauth2-proxy. | ||
|
|
||
| ## OAuth2-Proxy Adopters | ||
|
|
||
| This list is sorted in the order that organizations were added to it. | ||
|
|
||
| | Organization | Contact | Description of Use | | ||
| | ------------ | ------- | ------------------ | | ||
| | | | | |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,78 +1,86 @@ | ||
|  | ||
|
|
||
| [](https://github.com/oauth2-proxy/oauth2-proxy/actions/workflows/ci.yaml) | ||
| [](https://goreportcard.com/report/github.com/oauth2-proxy/oauth2-proxy) | ||
| [](https://godoc.org/github.com/oauth2-proxy/oauth2-proxy) | ||
| [](./LICENSE) | ||
| [](https://codeclimate.com/github/oauth2-proxy/oauth2-proxy/maintainability) | ||
| [](https://codeclimate.com/github/oauth2-proxy/oauth2-proxy/test_coverage) | ||
|
|
||
| A reverse proxy and static file server that provides authentication using Providers (Google, Keycloak, GitHub and others) | ||
| to validate accounts by email, domain or group. | ||
|  | ||
|
|
||
| OAuth2-Proxy is a flexible, open-source tool that can act as either a standalone reverse proxy or a middleware component integrated into existing reverse proxy or load balancer setups. It provides a simple and secure way to protect your web applications with OAuth2 / OIDC authentication. As a reverse proxy, it intercepts requests to your application and redirects users to an OAuth2 provider for authentication. As a middleware, it can be seamlessly integrated into your existing infrastructure to handle authentication for multiple applications. | ||
|
|
||
| OAuth2-Proxy supports a lot of OAuth2 as well as OIDC providers. Either through a generic OIDC client or a specific implementation for Google, Microsoft Entra ID, GitHub, login.gov and others. Through specialised provider implementations oauth2-proxy can extract more details about the user like preferred usernames and groups. Those details can then be forwarded as HTTP headers to your upstream applications. | ||
|
|
||
| **Note:** This repository was forked from [bitly/OAuth2_Proxy](https://github.com/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](CHANGELOG.md). | ||
|  | ||
|
|
||
| **Note:** This project was formerly hosted as `pusher/oauth2_proxy` but has been renamed as of 29/03/2020 to `oauth2-proxy/oauth2-proxy`. | ||
| Going forward, all images shall be available at `quay.io/oauth2-proxy/oauth2-proxy` and binaries will be named `oauth2-proxy`. | ||
| ## Get Started | ||
|
|
||
|  | ||
| OAuth2-Proxy's [Installation Docs](https://oauth2-proxy.github.io/oauth2-proxy/installation) cover how to install and configure your setup. Additionally you can take a further look at the [example setup files](https://github.com/oauth2-proxy/oauth2-proxy/tree/master/contrib/local-environment). | ||
|
|
||
| ## Installation | ||
| ## Releases | ||
|
|
||
| 1. Choose how to deploy: | ||
| ### Binaries | ||
| We publish oauth2-proxy as compiled binaries on GitHub for all major architectures as well as more exotic ones like `ppc64le` as well as `s390x`. | ||
|
|
||
| a. Using a [Prebuilt Binary](https://github.com/oauth2-proxy/oauth2-proxy/releases) (current release is `v7.6.0`) | ||
| Check out the [latest release](https://github.com/oauth2-proxy/oauth2-proxy/releases/latest). | ||
|
|
||
| b. Using Go to install the latest release | ||
| ```bash | ||
| $ go install github.com/oauth2-proxy/oauth2-proxy/v7@latest | ||
| ``` | ||
| This will install the binary into `$GOPATH/bin`. Make sure you include `$GOPATH` in your `$PATH`. Otherwise your system won't find binaries installed via `go install` | ||
| ### Images | ||
|
|
||
| c. Using a [Prebuilt Docker Image](https://quay.io/oauth2-proxy/oauth2-proxy) (AMD64, PPC64LE, S390x, ARMv6, ARMv7, and ARM64 available) | ||
| From `v7.6.0` and up the base image has been changed from Alpine to [GoogleContainerTools/distroless](https://github.com/GoogleContainerTools/distroless). | ||
| This image comes with even fewer installed dependencies and thus should improve security. The image therefore is also slightly smaller than Alpine. | ||
| For debugging purposes (and those who really need it. e.g. `armv6`) we still provide images based on Alpine. The tags of these images are suffixed with `-alpine`. | ||
|
|
||
| Since 2023-11-18 we build nightly images directly from the `master` branch and provide them at `quay.io/oauth2-proxy/oauth2-proxy-nightly`. | ||
| These images are considered unstable and therefore should **NOT** be used for production purposes unless you know what you're doing. | ||
|
|
||
| d. Using a [Pre-Release Nightly Docker Image](https://quay.io/oauth2-proxy/oauth2-proxy-nightly) (AMD64, PPC64LE, S390x, ARMv6, ARMv7, and ARM64 available) | ||
| ## Sponsors | ||
|
|
||
| e. Using the official [Kubernetes manifest](https://github.com/oauth2-proxy/manifests) (Helm) | ||
|  | ||
| Microsoft Azure credits for open source projects | ||
|
|
||
| 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`. | ||
| Would you like to sponsor the project then please contact us at [[email protected]](mailto:[email protected]) | ||
|
|
||
| ## Getting Involved | ||
| [](https://gophers.slack.com/archives/CM2RSS25N) | ||
|
|
||
| ``` | ||
| sha256sum -c sha256sum.txt 2>&1 | grep OK | ||
| oauth2-proxy-x.y.z.linux-amd64: OK | ||
| ``` | ||
| Join the #oauth2-proxy [Slack channel](https://gophers.slack.com/archives/CM2RSS25N) to chat with other users of oauth2-proxy or reach out to the maintainers directly. Use the [public invite link](https://invite.slack.golangbridge.org/) to get an invite for the Gopher Slack space. | ||
|
|
||
| 2. [Select a Provider and Register an OAuth Application with a Provider](https://oauth2-proxy.github.io/oauth2-proxy/configuration/providers/) | ||
| 3. [Configure OAuth2 Proxy using config file, command line options, or environment variables](https://oauth2-proxy.github.io/oauth2-proxy/configuration/overview) | ||
| 4. [Configure SSL or Deploy behind a SSL endpoint](https://oauth2-proxy.github.io/oauth2-proxy/configuration/tls) (example provided for Nginx) | ||
| OAuth2-Proxy is a community-driven project. We rely on the contribut️ions of our users to continually improve it. While review times can vary, we appreciate your patience and understanding. As a volunteer-driven project, we strive to keep this project stable and might take longer to merge changes. | ||
|
|
||
| If you want to contribute to the project. Please see our [Contributing](https://oauth2-proxy.github.io/oauth2-proxy/community/contribution) guide. | ||
|
|
||
| Who uses OAuth2-Proxy? Have a look at our new [ADOPTERS](ADOPTERS.md) file and | ||
| feel free to open a PR to add your organisation. | ||
|
|
||
| Thanks to all the people who already contributed ❤ | ||
|
|
||
| <a href="https://github.com/oauth2-proxy/oauth2-proxy/graphs/contributors"> | ||
| <img src="https://contrib.rocks/image?repo=oauth2-proxy/oauth2-proxy&columns=15&max=75" /> | ||
| <img src="https://img.shields.io/github/contributors/oauth2-proxy/oauth2-proxy" /> | ||
| </a> | ||
|
|
||
| Made with [contrib.rocks](https://contrib.rocks). | ||
|
|
||
| ## Security | ||
|
|
||
| If you are running a version older than v6.0.0 we **strongly recommend you please update** to a current version. | ||
| See [open redirect vulnerability](https://github.com/oauth2-proxy/oauth2-proxy/security/advisories/GHSA-5m6c-jp6f-2vcv) for details. | ||
| If you believe you have found a vulnerability within OAuth2 Proxy or any of its dependencies, please do **NOT** open an issue or PR on GitHub, please do **NOT** post any details publicly. | ||
|
|
||
| ## Docs | ||
| Security disclosures **MUST** be done in private. If you have found an issue that you would like to bring to the attention of the maintainers, please compose an email and send it to the list of people listed in our [MAINTAINERS](MAINTAINERS) file. | ||
|
|
||
| Read the docs on our [Docs site](https://oauth2-proxy.github.io/oauth2-proxy/). | ||
| For more details read our full [Security Docs](https://oauth2-proxy.github.io/oauth2-proxy/community/security#security-disclosures) | ||
|
|
||
|  | ||
| ### Security Notice for v6.0.0 and older | ||
|
|
||
| ## Images | ||
| If you are running a version older than v6.0.0 we **strongly recommend** to the current version. | ||
|
|
||
| From `v7.6.0` and up the base image has been changed from Alpine to [GoogleContainerTools/distroless](https://github.com/GoogleContainerTools/distroless). | ||
| This image comes with even fewer installed dependencies and thus should improve security. The image therefore is also slightly smaller than Alpine. | ||
| For debugging purposes (and those who really need it (i.e. `armv6`)) we still provide images based on Alpine. The tags of these images are suffixed with `-alpine`. | ||
| See [open redirect vulnerability](https://github.com/oauth2-proxy/oauth2-proxy/security/advisories/GHSA-5m6c-jp6f-2vcv) for details. | ||
|
|
||
| Since 2023-11-18 we provide nightly images. These images are build and pushed nightly to `quay.io/oauth2-proxy/oauth2-proxy-nightly` from `master`. | ||
| These images should be considered alpha and therefore *should not* be used for production purposes unless you know what you're doing. | ||
| ## Repository History | ||
|
|
||
| ## Getting Involved | ||
| **2018-11-27:** This repository was forked from [bitly/OAuth2_Proxy](https://github.com/bitly/oauth2_proxy). 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](CHANGELOG.md). | ||
|
|
||
| If you would like to reach out to the maintainers, come talk to us in the `#oauth2-proxy` channel in the [Gophers slack](http://gophers.slack.com/). | ||
| **2020-03-29:** This project was formerly hosted as `pusher/oauth2_proxy` but has been renamed to `oauth2-proxy/oauth2-proxy`. Going forward, all images shall be available at `quay.io/oauth2-proxy/oauth2-proxy` and binaries will be named `oauth2-proxy`. | ||
|
|
||
| ## Contributing | ||
| ## License | ||
|
|
||
| Please see our [Contributing](CONTRIBUTING.md) guidelines. For releasing see our [release creation guide](RELEASE.md). | ||
| OAuth2-Proxy is distributed under [The MIT License](LICENSE). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters