Pliro Docs
Homepage
  • Introduction
  • Pliro Site
    • The customer account page
    • The offers page
    • The subscribe page
    • Offer pages
    • Offer subscribe pages
    • The free offering page
    • The free offering subscribe page
  • Pliro Connect
    • Sign in customers
    • Update customer information
    • Silent re-authentication
    • Sign customers out of Pliro
    • Sign-out notifications
    • Example integration
    • Signing keys
  • API
    • Authentication
    • Errors
      • Error codes
    • Pagination
    • Versioning
    • Endpoint reference
  • Test environment
Powered by GitBook
On this page
  • Prerequisites
  • Supported application types
  • Learn how to:

Pliro Connect

Allow customers to sign into your website and manage their access to protected content.

PreviousThe free offering subscribe pageNextSign in customers

Last updated 11 months ago

Pliro Connect provides an authentication solution that makes it possible to sign customers into your website, e-magazine, app or other service and grant them access to protected content. The solution is based on and .

Here's an overview of how it works:

  1. When a customer clicks the sign in button on your website, you redirect them to Pliro's sign in-flow.

  2. After completing the flow, they are redirected back to your website with a code you can use to request an ID token and an access token. The ID token contains information about the signed in customer in the form of a . The access token can be used to retrieve updated information about the customer.

  3. You sign the customer into your website and store the tokens in their session.

  4. When a customer clicks the sign out button on your website, you end their session. If you'd like, you can then redirect them to Pliro to end their Pliro session as well.

  5. When a customer clicks the sign out button on their account page in Pliro, you can optionally receive a notification over HTTP, and end their session on your website.

We also provide that demonstrates all of these flows.

Prerequisites

To get started you'll need to create an OAuth application in Pliro. This can be done from the Pliro dashboard by navigating to "Settings > OAuth applications > New application". We recommend using while building out your integration. If you are working on your local machine you can set your application's Redirect URI to http://localhost:3000/callback or something similar.

After creating an OAuth application, the application's client ID and client secret will be shown. You'll need these credentials to authenticate your requests to Pliro.

Supported application types

Pliro currently only supports OAuth applications that can securely store a client secret, i.e., server-side web apps. In the future, we hope to extend support to client-side web apps (SPAs) as well as mobile and native apps.

Learn how to:

OpenID Connect
OAuth 2.0
JSON Web Token
an example integration
Pliro's test environment

Sign in customers

Sign customers into your website and grant them access to protected content.

Update customer information

Respond to customer actions within Pliro.

Silently re-authenticate customers

Check if a customer is still signed into Pliro.

Sign customers out of Pliro

Notify Pliro when signing customers out of your website.

Sign-out notifications

Be notified when customers sign out of Pliro.