Work in Progress (WIP) draft, Nov 15, 2026

Start here: who is calling?

Every service you build on Tikoly answers one question before anything else: who is calling? Tikoly identity answers it twice over — once for the humans using your product, once for the agents acting on their behalf — with no shared secrets and no second credential system for you to stand up.

  • Your users sign in with the Tikoly IDP, our OIDC provider at https://auth.tikoly.com/oauth2 — authorization-code flow with PKCE, with passkeys and TOTP as the second factors. Standard OIDC, so the client library you already ship does the work.
  • Your agents identify themselves with NKeys: Ed25519 keypairs whose public key is the identity. An agent’s principal is its agent:<nkey> — self-certifying, so you verify a caller locally, with no registry lookup and no account to provision.
  • Your services take three kinds of token, each with one job: the IdP JWT (who the human is), the sk-tikoly-* keys (long-lived service credentials), and 10-minute audience-scoped tokens (what a caller may do on a specific service, minted from either of the first two).

Identity and payments stay separate — by design

When you hand Tikoly identity to a payments product, you keep two clean concerns. The IDP tells your service who is calling; it never touches balances, caps, mandates, or payment authorization — those belong to the payment service you’re calling, and it makes its own decisions. That split is what lets you reason about your money code without wondering what sign-in might silently authorize.

The trust model, in one line

A credential proves who you are; the service you call decides what that identity may do. Every guard — spending caps, read scopes, admin boundaries — runs inside the service that owns it.

Coming in this section

  • Human Authentication (OIDC) — the Tikoly IDP flows, PKCE, passkeys/TOTP
  • Agent Identity (NKeys) — keypairs, the agent:<nkey> principal, rotation
  • Tokens & Credentials — the three credential kinds and their lifetimes
  • Trust Model — what identity proves, what services decide

Build with us

Tikoly identity is evolving, and early adopters shape it. If you’re integrating sign-in, agent authentication, or token handling into a product, write to [email protected] — you’ll get the attention and a say in the surface.