- Print
- DarkLight
- PDF
Third-party Login
- Print
- DarkLight
- PDF
Rocket.Chat's Third-party login allows you to access custom applications through OAuth using your Rocket.Chat account. For example, you can log in to platforms using your Rocket.Chat credentials. You can add and view the third-party login apps linked with your workspace.
Example
This guide walks you through the example of adding a Zapier integration as a third-party login application. With this, you can log in to Zapier using your Rocket.Chat workspace credentials.
Create Zapier integration
Create a developer account on the Zapier platform and follow these steps:
Go to the My Integrations tab.
On the Create Integration page, enter the integration details according to your requirements. Click Create.
In the newly created integration, click Authentication > OAuth v2.
Note the redirect URL from the Step 2 Copy your OAuth Redirect URL section.
Let's move on to adding an application to the Rocket.Chat workspace.
Add new application
To add a new app in the Rocket.Chat workspace, follow these steps:
Go to Administration > Workspace > Third-party login to access the third-party login tab.
Click New application at the top-right.
Enter the following details of the app:
Active: Enable this to activate the app.
Application Name: The name of the application. It will be displayed to your users. For example,
Zapier login
.Redirect URI: After OAuth2 authentication, users will be redirected to a URL on this list. You can add one URL per line. For this scenario, paste the URL value you got from the OAuth v2 authentication integration. For example,
https://zapier.com/dashboard/auth/oauth/return/App201062CLIAPI/
Click Save.
Configure the Zapier integration
Now we will configure the integration that we created in Zapier. This will let us connect the OAuth integration with the Rocket.Chat workspace application. We can then log in to Zapier using the Rocket.Chat credentials.
In your Rocket.Chat workspace, click the application you created. The Active status, Application Name, and Redirect URI values are displayed. Additional configuration fields—Client ID, Client Secret, Authorization URL, and Access Token URL—are also displayed. The values are automatically filled. You can edit the values to suit your requirements. Make sure to save the application.
Copy the Client ID and Client Secret values. Paste these values in the Zapier integration “Step 3 Enter your Application Credentials” section. For example, Client ID:
zapier
Client secret:RTK6TlndaCIolhQhZ7_KHIGOKnlaOq_o-7J
Copy the Authorization URL and Access Token URL values. Paste these values in the Zapier integration “Step 4 Add OAuth v2 Endpoint Configuration” section. For example, the Authorization URL:
https://example.rocket.chat/oauth/authorize
Access token URL:https://example.dev.rocket.chat/oauth/token
Save the values and test the authentication.
A pop-up window opens to request access to your Rocket.Chat workspace account. Grant the access and your connection is complete!