Skip to main content

Overview

Supertab Connect enables your bots, AI agents, and automated systems to access web content protected by RSL (Really Simply Licensing). Instead of being blocked or scraping without permission, your agents get legitimate, licensed access while publishers get compensated. This guide walks you through:
  1. Creating a customer account and registering your bot as a System
  2. Generating keys for authentication
  3. Obtaining license tokens to access protected content

How It Works

  1. Your bot fetches the publisher’s license.xml to see their licensing terms
  2. Your bot requests a license token from Supertab Connect
  3. Your bot includes the token when requesting content
  4. The publisher verifies the token and serves the content

Setup Steps

1

Create Account & Register Your System

Sign up for a Supertab Connect customer account and create a System to represent your bot or agent.

Managing Systems

Create your account and register your first System
2

Generate Authentication Keys

Generate a key pair for your System. You have three options: let us generate keys, upload your own public key, or provide a JWKS URL.

Key Management

Set up authentication keys for your System
3

Access Licensed Content

Use the SDK to generate license tokens and access protected content.

Accessing Content

Get license tokens and make authenticated requests

Quick Example

Once set up, accessing licensed content looks like this:
import { SupertabConnect } from "@getsupertab/supertab-connect-sdk";

// Get a license token
const token = await SupertabConnect.generateLicenseToken(
  "urn:stc:customer:system:your-id",  // clientId
  "your-key-id",                       // kid
  "-----BEGIN EC PRIVATE KEY-----\n...", // privateKeyPem
  "https://publisher.com/article",     // resourceUrl
  licenseXml                           // licenseXml
);

// Access content
const response = await fetch("https://publisher.com/article", {
  headers: { "Authorization": `License ${token}` }
});

Next Steps

Ready to get started? Begin by creating your account and registering a System:

Managing Systems

Create your customer account and register your first bot