README.md 1.72 KB
Newer Older
1
2
3
4
5
6
7
---
description: >-
  Rocket.Chat supports several different ways to authenticate, beyond the basic
  username/password authentication. Most authentication providers require a
  clientID and a secret.
---

Sing Li's avatar
Sing Li committed
8
# OAuth
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
9

10
To set up your desired provider:
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
11

12
13
14
15
16
17
18
1. Go to **Administration.**

![](../../../../.gitbook/assets/image%20%2830%29.png)

2. Search '**OAuth'** in **Settings** and open it.

![](../../../../.gitbook/assets/image%20%28150%29.png)
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
19

20
## Facebook
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
21

22
* Callback URL: `<<website_url>>/_oauth/facebook?close`
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
23

24
## GitHub
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
25

26
* Callback URL: `<<website_url>>/_oauth/github?close`
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
27

28
### GitHub Set up
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
29

30
31
32
33
34
1. Go to your [Application Settings](https://github.com/settings/applications)
2. Under the `Developer applications` tab, click the **Register new application** button
3. Fill in the form, and make sure you use the correct callback URL.

**Note**: If your callback URL is wrong, GitHub does not display any error. Instead of logging in, you receive an error message saying "No matching login attempt found."
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
35

36
## Google
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
37

38
* Callback URL: `<<website_url>>/_oauth/google?close`
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
39

40
### Google Set up
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
41

42
1. Go to the [Google Developer Console](https://console.developers.google.com), and create a new project
43
2. Set up your project by creating an "OAuth 2.0 client ID" \(under `APIs & Auth` and `Credentials`\)
44
3. After that, make sure you define a **Product Name** in the OAuth consent screen, and select **Web App** as application type. Otherwise, you won't be able to provide a callback URL
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
45

46
## Apple
47

Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
48
49


50
## LinkedIn
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
51

52
* Callback URL: `<<website_url>>/_oauth/linkedin`
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
53

54
## Twitter
Marcelo Schmidt's avatar
Docs    
Marcelo Schmidt committed
55

56
57
* Callback URL: `<<website_url>>/_oauth/twitter`

58
## Wordpress
59

60
Please follow the instructions [here](https://docs.rocket.chat/guides/administrator-guides/authentication/oauth/wordpress).
61