Developer preview Not production ready. Preview status
Tracecove Identity

Get started

Start with a local, offline SDK example. No Tracecove or company login is required for this step. Node.js 24 or later and a package manager are required. The Node entry uses the runtime's SQLite reference implementation and may emit its experimental SQLite warning.

Download and install

The current public preview is 0.7.0-preview.1. This is a versioned archive release, not an npm registry publication.

Shell
mkdir identity-example
cd identity-example
npm init -y
npm install https://identity.tracecove.com/downloads/tracecove-identity-0.7.0-preview.1.tgz

For an inspected download, use the SDK download page and verify its published SHA-256 before installing the local archive. Keep the package-manager lockfile so your application retains an exact dependency resolution.

Run an offline example

Save the following as example.mjs, then run node example.mjs.

JavaScript
import { productSessionReference } from '@tracecove/identity';

const reference = productSessionReference({
  tenant: 'example',
  environment: 'development',
  issuer: 'https://issuer.example.test',
  product: 'example-app',
  productSubject: 'example-subject',
  brokerSessionId: 'example-session',
});

console.log(reference);

The result starts with psr1_. The helper performs a local, deterministic hash; it makes no network request. The result is an opaque revocation locator, not a token, proof of a login, or permission to access a product.

Connect an environment

Networked methods require an operator-issued profile for a registered issuer/API and application. The package does not create an environment or provision credentials.

Tracecove's hosted preview requires an explicit application registration and synthetic test accounts. Public docs and the SDK do not enable unrestricted staging access or production use. Contact hello@tracecove.com for registration.

Public preview 0.7.0-preview.1 · Not production ready · Status and releases