Skip to main content

Getting Started

Learn the process of integrating AuthN into your application

Enable the service and create a token​

When you enable the AuthN service, you will also create a token.

Expand for details

To enable the AuthN service and create a token:

  1. Click AuthN on the left-hand navigation. A dialog with details about authentication will appear. Click Next.
  2. You will be prompted to create a token to access the AuthN service. Click Next.
  3. An additional dialog with token details will appear. Type a Token name and select an Expiration Date, or just keep the default values. Click Done.

The AuthN Overview page should appear.

Configure your app for communication with the Pangea service​

For your app to communicate with the Pangea service, you must set the following environment variables:

  • token
  • domain

All of these variables are created when you enable AuthN and can be found on the AuthN Overview page.

Set environment variables​

To set each variable in bash:

export PANGEA_DOMAIN="yourServiceDomain"
export PANGEA_AUTHN_TOKEN="AuthNDefaultToken"

Test the service​

The interactive AuthN API Reference allows you to test API endpoints from the documentation. This is an easy way to play around with different endpoints and see what they return.

Configure the authentication experience for your users​

important

For non-production environments, Pangea recommends you use the Developer Environment Settings (see Terminologies) to get started with AuthN.

Customize your hosted pages with your brand visuals​

On the AuthN Overview page, go to Customization in the left-hand navigation menu and play around with different styles so your hosted pages match your app’s look and feel. For more details, check out Branding & Customization.

Integrate AuthN into your app integration​

Use hosted pages​

Pangea provides various hosted pages, which you can style with your brand, that can be seamlessly integrated into your cloud application.

  1. Once you configure the authentication experience for your users, you'll have access to Pangea-hosted pages.
  2. You'll take these pages, and add your brand visuals. Once that's done, you will take the hosted page URLs and integrate them into your app.
  3. Then, your user will attempt to log in via the hosted app. Pangea will authenticate them, using the method you configured in the Pangea User Console, and direct them to your app.

Embed AuthN directly into your app​

Perform a native, custom integration by using the AuthN API endpoints.

  1. Configure the authentication experience for your users in the Pangea User Console .
  2. Move on to the AuthN API Reference and build your own custom authentication flow.

Share your implementation​

Reach out to the Pangea community on our

Discourse to let us know how you've integrated AuthN into your application.

Was this article helpful?

Contact us