New — Iris AI drafts your firewall, routing & rate-limit rules. Explore AI features →
Changelog
CLI & MCPSecurity

Key login for your tunnels (Preview)

Log your tunnels in with a private key instead of an auth token. The key never leaves your machine; you sign a code from the dashboard once to add it.

Key login for your tunnels (Preview)

A tunnel logged in with an auth token: a secret in a config file, which anyone who copies the file can use.

With key login, the tunnel proves who it is with a private key that stays on your machine. Above, Maya signs the code the dashboard showed her under Security → Agent keys, pastes the signature back there, and points ngris at her key. Her next tunnel logs in with it.

What changed

  • Add a key once. In the dashboard, open Security → Agent keys, click Upload key and copy the code it shows. ngris key sign <code> signs it with your key; you paste its output back into the dashboard.
  • Log in with it. ngris auth --private-key-file <file> checks the key and saves it as your login method. Start your tunnel as usual.
  • Supported keys: ed25519, or RSA from 2048 to 4096 bits, without a passphrase. A key file that other users can read is refused.
  • A token as a backup. If you also keep a token, it is used when the key is refused. For full protection, remove the token from your config and revoke it in the dashboard. --auth-method key|token picks which one logs in first.
  • For tunnels. App commands use an API key or account key. Edge protection set when you start a tunnel (--basic-auth, --mutual-tls, traffic policies) still needs your auth token: the CLI says so when you set up key login.

Get started

  1. Update ngris to 0.5.0.
  2. In the dashboard, open Security → Agent keys and click Upload key.
  3. Run ngris key sign <code> with the code it shows, and paste the output into the dashboard.
  4. Run ngris auth --private-key-file <your key file>, then start your tunnel.
  5. Read the docs: Key login.

Read the docs

Ask an AI to summarise this page
Deploy
App hosting Edge functions Domains & certificates
Connect
Secure tunnels API gateway Multi-region edge
Protect
Bot protection & challenge WAF & firewall Edge login
Observe & AI
Monitoring Inspector & replay Iris AI MCP server AI Gateway
Developers
Developer tools Docs ngrok policy converter Blog Changelog
Compare
Ngris vs ngrok Ngris vs Cloudflare Tunnel Ngris vs Vercel Ngris vs Netlify Expose localhost guide
More
Solutions Pricing Enterprise Sign in Get Started Free