Skip to main content
Authsome ships with 31 bundled API-key providers. Each is a service with a single long-lived secret rather than an OAuth flow. Authsome collects the key through a local browser form (or masked terminal input on headless machines) and stores it encrypted in the vault.

​
Bundled API-key providers

For all providers (OAuth and API-key) in one CLI view:

​
How the API-key flow works

There is no OAuth dance. The flow is:
1

Run the login

2

Paste the key into the browser form

Authsome opens http://127.0.0.1:7998 with a masked input. The key never goes through the shell.
3

Pattern validation (where applicable)

Some providers ship a regex (key_pattern). If your input doesn’t match, authsome rejects it with a hint.
4

Encrypted store

The key is encrypted in the active vault and written to the vault.
On a headless machine without a graphical session, authsome falls back to masked terminal input via getpass. See Use API keys.

​
Use the key

​
Through the proxy

Authsome sets a placeholder like OPENAI_API_KEY=authsome-proxy-managed in the child’s environment so the SDK initializes. The real key is added to outbound requests at the proxy layer. The child process never sees the actual key.

​
As an environment variable

export prints KEY=value lines suitable for shell sourcing. The names come from each provider’s export.env map.

​
From Python

Run under the proxy (recommended) or export into the environment before launching your script. See Python library.

​
Add an API-key provider

For a service authsome doesn’t bundle (Anthropic, Stripe, Twilio, and many others):
  1. Find the header shape (Authorization: Bearer ..., X-API-Key: ..., etc.).
  2. Write a JSON definition. See Custom providers for the template.
  3. authsome register ./<name>.json.

​
What’s next

Use API keys

The full API-key login walkthrough.

OAuth providers

The other half of the bundled set.

Custom providers

Add an API-key provider authsome doesn’t ship.

Run agents with the proxy

Inject API keys into outbound requests without exposing them.