Skip to content
LogoLogo

Serve access keys

An API serves the access key endpoint, so that the user signs the access key at the approval.

Overview

An access key endpoint is an API route that returns a new access key's public key. Tempo ID calls it during the approval, so the Tempo Account's owner signs the access key there. A passkey signs only with the user present, so a Tempo Account that only a passkey owns connects only this way.

PolicyAccess keyTempo Account that only a passkey owns
With an access key endpointTempo ID requests it at the approvalConnects
Without oneThe API creates it at its next requestRefused with webauthn_required

The demo runs the Pay for users demo beside a log of this site's access key endpoint, which shows each request of Tempo ID and marks the access key that signs the payment.

Serve an access keyDemo

Walkthrough

The API of Pay for users already serves the endpoint, since the policy of its metadata names the handler's route. The steps show the route and the policy that names it.

Mount the handler

accounts.handler serves the endpoint at POST /access-keys, under basePath, which defaults to /api. The API's client ID also sits under it, so a new basePath makes a new app, which holds none of the earlier connections.

api.ts
import { Accounts, Store } from 'accounts'
import { viem } from 'accounts/plugins'
import { Hono } from 'hono'
 
const accounts = Accounts.create({
  chain: 'testnet',
  connections: {
    metadata: {
      accessKey: { limits: [{ limit: '25', token: 'ousd' }] },
      privateKey: JSON.parse(process.env.API_PRIVATE_KEY!),
    },
    resource: 'https://api.example/pay',
    store: Store.memory(),
  },
  plugins: [viem()],
})
 
const app = new Hono()
 
app.all('/api/*', (c) => accounts.handler.fetch(c.req.raw)) 
app.get('/.well-known/oauth-protected-resource/*', (c) =>
  accounts.handler.fetch(c.req.raw),
)
 
export default app

The handler verifies Tempo ID's signed request token, and refuses a repeated one with 401. It then generates an access key, keeps its private key in the store, and returns its public key.

Tempo ID calls the route without the app's session, so no sign-in guards it. Tempo ID waits 5 seconds for the response, and never retries.

Check the policy

The access key policy of metadata names the route's URL as its access key endpoint, such as https://api.example/api/access-keys. Tempo ID reads it at the next sign-in after 5 minutes.

The API's routes do not change: connections.connect claims the access key that the connection's first access token names.

Use cases

Each use case sets one property of the connections option, which the handler's access key endpoint reads.

Discard unclaimed access keys sooner

The API never learns whether the user approved, so pendingLifetime sets how long, in milliseconds, a prepared access key waits for a token that names it. After it, the store discards the access key, and the user approves again. It defaults to 7 days.

api.ts
import { Accounts, Store } from 'accounts'
import { viem } from 'accounts/plugins'
import { Hono } from 'hono'
 
const accounts = Accounts.create({
  chain: 'testnet',
  connections: {
    metadata: {
      accessKey: { limits: [{ limit: '25', token: 'ousd' }] },
      privateKey: JSON.parse(process.env.API_PRIVATE_KEY!),
    },
    pendingLifetime: 24 * 60 * 60 * 1000, 
    resource: 'https://api.example/pay',
    store: Store.memory(),
  },
  plugins: [viem()],
})
 
const app = new Hono()
 
app.all('/api/*', (c) => accounts.handler.fetch(c.req.raw))
app.get('/.well-known/oauth-protected-resource/*', (c) =>
  accounts.handler.fetch(c.req.raw),
)
 
export default app

Next steps