Getting Started

This guide will walk you through getting started with RemoteAuth.

This is intended for developers who are integrating RemoteAuth into their Application.


You must create a Team before you can create an Application. All Applications belong to a Team and do not belong to an individual User.

Creating a Team

Creating Applications

You can create as many Applications as you want in RemoteAuth. If you have multiple clients for your Application (such as a native mobile app, a web app, etc) - you only need to create a single Application. You can create multiple OAuth Clients (see OAuth Clients for more information).

Creating an Application

  • Navigate to the Teams list page,
  • Click "View" on the Team row that will own the Application.
  • Under the "Applications Owned by Team Name" panel, click the "Create Application" button.
  • Fill out the form and click "Save".
  • See Applications definition for more information on Applications.

OAuth Clients

An OAuth Client must be created in order for your Application to authenticate with RemoteAuth. You can create as many OAuth Clients as you want. We recommend creating one OAuth Client for each of your Application's clients (native mobile app, web app, etc).

Creating an OAuth Client

  • Navigate to the Applications list page,
  • Click "View" on the Application row that you want to add the OAuth Client to.
  • Click "OAuth Clients" in the navigation menu on the left side of the page.
  • Click "Create OAuth Client" at the top of the page.
  • Fill out the form and click "Save".

Generating an OAuth Client Secret Token

After creating the OAuth Client, you will need to generate a secret token to use when authenticating with RemoteAuth.

Note: Generating a new secret token will permanently erase any existing secret tokens for that OAuth Client.

  • On the OAuth Client's page, click the "Regenerate Secret Token" button.
  • If you're certain you want to generate a new secret token, click "Regenerate Secret".
  • The secret token will be regenerated and displayed on the screen. This is the only time the secret token is visible. Make sure you copy it to a secure place right away.

RemoteAuth OAuth 2 Configuration

Logging into RemoteAuth

Handling successful login

Fetching user's profile

Fetching user's Application Members

Creating Application Members