Overview

This section explains how you can authenticate your application to our API. It is split into the following pages:

• Basic Authentication: How to use our legacy authentication system. Basic authentication is being deprecated in favor of OAuth 2.0.
• Creating and Managing Credentials: Everything you need to create and maintain your application's credentials.
• Using API Credentials: How to use the credentials you just created in your application.
• Exploring Ocrolus With Postman: How to use the credentials you just created to play around with our API.
• Migrating from Basic Authentication to OAuth 2.0 Credentials: Everything you need to know to migrate to our newer, more secure authentication system.

🚧

Looking for our page on basic authentication?

We've moved our documentation on Basic HTTP authentication to here. Note that we're deprecating Basic authentication in favor of OAuth 2.0. This page describes the steps needed to migrate your application to the new authentication system.

We support authentication via OAuth 2.0's Client Credentials Flow, as defined in RFC 6749, section 4.4. Access tokens are granted as JSON Web Tokens (JWTs) as defined in RFC 7519.

In a Nutshell...

1. Log in to the Ocrolus Dashboard and create an API credential, as described here
2. Use your new credential to generate an access token, as described here (or here if you just want to play around in Postman).
3. Provide your access token to all future API calls to Ocrolus.
4. When the token expires, go to Step 2 and repeat.

Video Guide

Prefer having a video walk you through it? We've got you covered.