Open-source identity for people & agents

Know who’s
behind the request.

Remember browsers. Connect people and agents to the accounts they use. Add that context to PostHog or Mixpanel, with optional Jev scoring to help you understand unfamiliar activity.

Runs in your app. Uses your database. AI is optional.

Who’s coming in?
A human
A little illustration of a bigger identity question. No tracking in this animation.

Doorman 0.13 is available on npm and Hex.Add it to your app →

A browser client.
An endpoint.
Your database.

Install the packages, connect your database and add one endpoint. Doorman creates its tables automatically. No migration commands, dashboard or separate service.

  1. Choose your serverUse Node, Next.js, Cloudflare Workers or native Elixir.
  2. Connect storageKeep visitor history in your own Postgres or D1 database.
  3. Call identify()Get a browser ID. Read confidence and risk privately on the server.
See the complete setup
client.ts
import { createDoormanClient } from "@aarondovturkel/doorman-browser";

const visitor = createDoormanClient({
  endpoint: "/api/visitor",
});

const identity = await visitor.identify();

// { visitorId, sessionId, isReturning }
// Scores stay on your server.
// Destroy the client when collection should stop.
visitor.destroy();
Identity meets activity

One account.
Different operators.

A login tells you which account is open. Doorman keeps track of the browsers, signed-in people and authenticated agents using it.

When you need an estimate, Jev can score whether activity looks human, assistant-operated or scripted. A guess stays separate from a verified identity.

Explore agent classification
01 / Remember

Recognize returning browsers.

A first-party cookie remembers each browser. A short history helps assess possible connections when signals change or the cookie disappears.

What is collected →
02 / Connect

Connect users after login.

Pass the user your server has authenticated. Doorman remembers that browser relationship without confusing a shared account with a single person.

Connect your login →
03 / Understand

Your analytics, with context.

Call identify once through Doorman. PostHog and Mixpanel keep their existing funnels and gain browser, session and account properties on events.

Connect your analytics →

Activity labels are experimental. They do not reliably identify an agent’s brand or count people sharing one login. Read the results and limits →

Browsers change.
The connection can stay.

Doorman gives a browser a random visitor ID and saves a small history of its signals, such as screen size and browser family.

A first-party cookie remembers that ID. If it disappears, Doorman compares the next visit with past observations. The recommended flow keeps a possible match private and gives the browser a fresh ID.

Understand browser matching
Try it with an example browser

Change a signal.
Follow the identity.

Try browser matching with made-up data. This experiment enables ID recovery to show the matcher’s behavior. The recommended API keeps cookie-less matches private and issues a fresh ID. No real signals are collected.

⌘ Simulated browser
Chrome on macOS1440 × 900 · 8 cores

Synthetic signals only.
No browser data is collected.

visitor.identify()Initializing
Visitor identityvis_…

Starting the local matching engine.

Identity confidence—
0Match needed: 0.901
// Run a scenario to inspect the response.

Each option starts from the same example history. All except “Return with cookie” remove the cookie first. The scores shown here normally stay on your server; they demonstrate the matching rules, not real-world accuracy. How matching works ↗

Optional AI, powered by Jev

Small questions.
Useful context.

Jev is an AI model from TypeSafe. It compares browser history and scores automation and suspicious signals. With enough activity, it also estimates whether a human, assistant or script is operating the browser.

Use those estimates to inform your own checks, such as when to request a CAPTCHA. Doorman returns information; your app decides what happens next.

Meet Jev and the scores

Optional cross-device matching compares anonymous visits with earlier sessions confirmed by login. A suggestion stays private; only a real login connects that person to your analytics. Enable cross-device suggestions →

Browser matching and risk
Does this browser look familiar?sameVisitor
Compares this visit with recent history, allowing for ordinary changes.
Does the session look automated?automation
Uses available signals and aggregate event counts.
Do the signals look inconsistent?suspicious
Looks for unusual technical combinations, not a person’s intent.

Scores are experimental estimates. Missing signals alone do not mean abuse.

A browser is one thing.
A person is another.

Two people can share a laptop. One person can use a laptop and a phone. An AI assistant can act with that person’s permission.

After your app verifies a login or agent credential, Doorman can connect those visits to a known identity. It records who is making a request and whose account they are using.

Learn the few terms you’ll need
Optional agent permissions demo

Same account.
Different hands.

Here your app has already verified who is making the request. Try the optional permission checks below. These are sample credentials, not predictions about who is using your browser.

Example people and credentials.Real permission checks.Runs in your browser.

identities.assess(context)Loading
◎Acting asaccount_owner
—DelegationNot required

Enable JavaScript to run the local scenarios.

Account evidence—
Actor kind—
Requested scope—
Inspect the actual response
Real permission checksNo AI calls · your app decides access

In an application, your login system verifies these identities. Doorman checks the permission you recorded; it does not guess who is at the keyboard.Understand people and agents ↗

Prepare your analytics
for the agentic era.

Keep your analytics. Let Doorman handle identification. Connect it to your existing login and logout flow, then keep using PostHog or Mixpanel as usual. You do not need to identify through both SDKs.

Build funnels for signed-in users, group activity by account, and count verified agents separately from people. Send private activity estimates from your server when you want to explore uncertain cases.

Connect your analytics

Agents can also use your API directly. Add optionalAPI activity middleware to bring those requests into the picture, with private Jev risk assessments.

An example workspace
  • AlexPerson
  • SamPerson
  • Alex’s assistantAgent

Illustrative data. Your app supplies verified identities.

Useful context.
Clear boundaries.

Doorman stores history in your database. If you enable Jev, a compact set of signals goes to your chosen AI provider. Doorman respects browser privacy restrictions and never captures form values, actual keystrokes or browsing history.

Risk scores stay on your server by default. Doorman does not replace login, prove who is at the keyboard, or automatically block anyone.

See exactly what is collected

Start with
one returning browser.

Run a local example, see a returning browser, then add private activity scores and analytics context as your application needs them.

Get startedExplore the source on GitHub ↗

Search documentation

Search setup instructions, examples and the API reference.

Local search. No query leaves your browser.