discourse
/
discourse-auth-proxy
mirror of https://github.com/discourse/discourse-auth-proxy.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
An http proxy that uses the DiscourseConnect protocol to authenticate users
30 Commits 5 Branches 0 Tags 129 KiB
Go 100%
Go to file
Andrew Schleifer 2ed757a038 new build regime 
* use new makefile style, remove two previous build systems
* multi-stage build for the tiniest image
 		2018-09-21 15:01:58 +08:00
.gitignore Initial commit 2015-04-15 13:18:18 +10:00
Dockerfile new build regime 2018-09-21 15:01:58 +08:00
Makefile new build regime 2018-09-21 15:01:58 +08:00
README.md new build regime 2018-09-21 15:01:58 +08:00
main.go FIX: Discourse groups now are in CSV format instead of an array 2018-07-23 22:48:33 -03:00
main_unit_test.go Initial commit 2015-04-15 13:18:18 +10:00
start.sh new build regime 2018-09-21 15:01:58 +08:00

README.md

Discourse Auth Proxy

This package allows you to use Discourse as an SSO endpoint for an arbitrary site.

Discourse SSO is invoked prior to serving the proxied site. This allows you to reuse Discourse Auth in a site that ships with no auth.

Usage:

Usage of ./discourse-auth-proxy:
  -listen-url="": uri to listen on eg: localhost:2001. leave blank to set equal to proxy-url
  -origin-url="": origin to proxy eg: http://localhost:2002
  -proxy-url="": outer url of this host eg: http://secrets.example.com
  -sso-secret="": SSO secret for origin
  -sso-url="": SSO endpoint eg: http://discourse.forum.com
  -allow-all: don't restrict access to "admin" users on the SSO endpoint
  -timeout="10": Read/Write timeout


  +--------+    proxy-url   +---------+    listen-url    +----------------------+
  |  User  |  ============> |  Nginx  |  ==============> | discourse-auth-proxy |
  +--------+                +---------+                  +----------------------+
      |                                                             |
      | sso-url                                          origin-url |
      |                                                             |
      v                                                             v
  +-----------+                                          +----------------------+
  | Discourse |                                          | Protected web server |
  +-----------+                                          +----------------------+

Note: you may use ENV vars as well to pass configuration EG:

ORIGIN_URL=http://somesite.com PROXY_URL=http://listen.com SSO_SECRET="somesecret" SSO_URL="http://somediscourse.com" ./discourse-auth-proxy

Docker Image

You may run using docker using

docker run discourse/discourse-auth-proxy

Running will display configuration instructions