Skip to content

Commit e703764

Browse files
author
epriestley
committed
Clarify how to configure OAuth, particularly for GitHub
Summary: GitHub needs an unguessably specific URI in its configuration for OAuth. Test Plan: Regenerated documentation and read it over. (These instructions are based on the existing applications, which appear to function correctly.) Reviewed By: j3kuntz Reviewers: jungejason, aran, tuomaspelkonen, j3kuntz CC: aran, epriestley, j3kuntz Differential Revision: 307
1 parent c67a749 commit e703764

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

src/docs/configuring_accounts_and_registration.diviner

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,14 @@ To configure Facebook OAuth, create a new Facebook Application:
4949

5050
https://www.facebook.com/developers/createapp.php
5151

52+
You should set these things in your application:
53+
54+
- **Site URL**: Set this to your full domain with protocol, like
55+
"##https://phabricator.example.com/##".
56+
- **Site Domain**: Set this to the entire domain, like ##example.com##. You
57+
might be able to get away with including the subdomain if you want to
58+
scope more tightly.
59+
5260
Once that is set up, edit your Phabricator configuration and set these keys:
5361

5462
- **facebook.auth-enabled**: set this to ##true##.
@@ -72,6 +80,13 @@ To configure GitHub OAuth, create a new GitHub Application:
7280

7381
https://github.com/account/applications/new
7482

83+
You should set these things in your application:
84+
85+
- **URL**: Set this to the full domain with protocol, like
86+
"##https://phabricator.example.com/##".
87+
- **Callback URL**: Set this to your domain plus "##/oauth/github/login/##",
88+
like "##https://phabricator.example.com/oauth/github/login/##".
89+
7590
Once you've created an application, edit your Phabricator configuration and
7691
set these keys:
7792

0 commit comments

Comments
 (0)