Acquire Licenses for Protected Content

​

Before You Start

1. Create your account — sign up at customer-connect.supertab.co
2. Register a System — in the dashboard, go to Systems → Create System and give it a descriptive name (e.g., “Production RAG Agent”, “News Indexer”)
3. Generate credentials — on the System Details page, generate a client_id and client_secret
4. Save your credentials — you will need both the client_id and client_secret to obtain license tokens

• The exact protected resource URL you want to access, for example https://publisher.com/premium/article-123
• An active license agreement between your organization and the publisher

​

Acquire Licenses

1. Your system identifies the exact URL it wants to access
2. The SDK fetches and evaluates the publisher’s license.xml
3. It finds the best matching content rule for the requested resource.
4. The SDK then requests a license token for the appropriate content pattern from the License Server using your credentials.
5. Send your license token as an Authorization: License <token> heade on subsequent requests.

import { SupertabConnect } from "@getsupertab/supertab-connect-sdk";

const CLIENT_ID = "...your customer system client_id...";
const CLIENT_SECRET = "...your customer system client_secret...";
const resourceUrl = "https://publisher.com/premium/article-123";

const accessToken = await SupertabConnect.obtainLicenseToken({
clientId: CLIENT_ID,
clientSecret: CLIENT_SECRET,
resourceUrl,
});

const response = await fetch("https://publisher.com/premium/article-123", {
headers: {
Authorization: `License ${accessToken}`,
},
});

​

Full Example

import { SupertabConnect } from "@getsupertab/supertab-connect-sdk";

const resourceUrl = "https://publisher.com/premium/article-123";

const accessToken = await SupertabConnect.obtainLicenseToken({
  clientId: process.env.SUPERTAB_CLIENT_ID!,
  clientSecret: process.env.SUPERTAB_CLIENT_SECRET!,
  resourceUrl,
});

const response = await fetch(resourceUrl, {
  headers: {
    Authorization: `License ${accessToken}`,
  },
});

if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const content = await response.text();

​

Related Docs