You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jan 24, 2019. It is now read-only.
Copy file name to clipboardexpand all lines: README.md
+50-50
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,6 @@
1
1
oauth2_proxy
2
2
=================
3
3
4
-
<small>(This project was renamed from Google Auth Proxy - May 2015)</small>
5
-
6
4
A reverse proxy and static file server that provides authentication using Providers (Google, GitHub, and others)
7
5
to validate accounts by email, domain or group.
8
6
@@ -17,7 +15,7 @@ to validate accounts by email, domain or group.
17
15
18
16
## Installation
19
17
20
-
1. Download [Prebuilt Binary](https://github.com/bitly/oauth2_proxy/releases) (current release is `v2.1`) or build with `$ go get github.com/bitly/oauth2_proxy` which will put the binary in `$GOROOT/bin`
18
+
1. Download [Prebuilt Binary](https://github.com/bitly/oauth2_proxy/releases) (current release is `v2.2`) or build with `$ go get github.com/bitly/oauth2_proxy` which will put the binary in `$GOROOT/bin`
21
19
2. Select a Provider and Register an OAuth Application with a Provider
22
20
3. Configure OAuth2 Proxy using config file, command line options, or environment variables
23
21
4. Configure SSL or Deploy behind a SSL endpoint (example provided for Nginx)
@@ -159,54 +157,56 @@ An example [oauth2_proxy.cfg](contrib/oauth2_proxy.cfg.example) config file is i
159
157
160
158
```
161
159
Usage of oauth2_proxy:
162
-
-approval-prompt="force": Oauth approval_prompt
163
-
-authenticated-emails-file="": authenticate against emails via file (one per line)
164
-
-azure-tenant="common": go to a tenant-specific or common (tenant-independent) endpoint.
165
-
-basic-auth-password="": the password to set when passing the HTTP Basic Auth header
166
-
-client-id="": the OAuth Client ID: ie: "123456.apps.googleusercontent.com"
167
-
-client-secret="": the OAuth Client Secret
168
-
-config="": path to config file
169
-
-cookie-domain="": an optional cookie domain to force cookies to (ie: .yourcompany.com)*
170
-
-cookie-expire=168h0m0s: expire timeframe for cookie
171
-
-cookie-httponly=true: set HttpOnly cookie flag
172
-
-cookie-name="_oauth2_proxy": the name of the cookie that the oauth_proxy creates
173
-
-cookie-refresh=0: refresh the cookie after this duration; 0 to disable
174
-
-cookie-secret="": the seed string for secure cookies
175
-
-cookie-secure=true: set secure (HTTPS) cookie flag
176
-
-custom-templates-dir="": path to custom html templates
177
-
-display-htpasswd-form=true: display username / password login form if an htpasswd file is provided
178
-
-email-domain=: authenticate emails with the specified domain (may be given multiple times). Use * to authenticate any email
179
-
-github-org="": restrict logins to members of this organisation
180
-
-github-team="": restrict logins to members of this team
181
-
-google-admin-email="": the google admin to impersonate for api calls
182
-
-google-group=: restrict logins to members of this google group (may be given multiple times).
183
-
-google-service-account-json="": the path to the service account json credentials
184
-
-htpasswd-file="": additionally authenticate against a htpasswd file. Entries must be created with "htpasswd -s" for SHA encryption
185
-
-http-address="127.0.0.1:4180": [http://]<addr>:<port> or unix://<path> to listen on for HTTP clients
186
-
-https-address=":443": <addr>:<port> to listen on for HTTPS clients
187
-
-login-url="": Authentication endpoint
188
-
-pass-access-token=false: pass OAuth access_token to upstream via X-Forwarded-Access-Token header
189
-
-pass-basic-auth=true: pass HTTP Basic Auth, X-Forwarded-User and X-Forwarded-Email information to upstream
190
-
-pass-user-headers=true: pass X-Forwarded-User and X-Forwarded-Email information to upstream
191
-
-pass-host-header=true: pass the request Host Header to upstream
192
-
-profile-url="": Profile access endpoint
193
-
-provider="google": OAuth provider
194
-
-proxy-prefix="/oauth2": the url root path that this proxy should be nested under (e.g. /<oauth2>/sign_in)
195
-
-redeem-url="": Token redemption endpoint
196
-
-redirect-url="": the OAuth Redirect URL. ie: "https://internalapp.yourcompany.com/oauth2/callback"
197
-
-resource="": the resource that is being protected. ie: "https://graph.windows.net". Currently only used in the Azure provider.
0 commit comments