NginxProxyManager / NginxProxyManager/nginx-proxy-manager

TOTP API login workflow

Open
#5,198 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug stale
Dominant language
TypeScript
Stars
34.2k
Forks
3.9k
Avg merge
21h 12m
Merged PRs (30d)
20

Description

Checklist

  • Have you pulled and found the error with jc21/nginx-proxy-manager:latest docker image?
    • Yes
  • Are you sure you're not using someone else's docker image?
    • Yes
  • Have you searched for similar issues (both open and closed)?
    • Yes

Describe the bug
How works the API login workflow after enabled the TOTP?

Nginx Proxy Manager Version
v2.13.6

Additional context
When call the /api/tokens when a user have the 2fa, I got:

[
  {
    "requires_2fa": true,
    "challenge_token": "REDACTED"
  }
]

Before:

[
  {
    "token": "REDACTED",
    "expires": "2026-01-21T08:40:58.825Z"
  }
]

@piotrfx how proceed from to get the token to use the API? I have to keep the 2fa turned off to use the API or is possible to send the code somehow?

PS: will be nice to have API token in NPM to allow use the API.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue identifies /api/tokens as the entry point and shows the requires_2fa/challenge_token response. Start by tracing that API workflow in the repository and checking any existing API authentication documentation. Done means the TOTP follow-up request and token retrieval are explicitly documented, or the issue is narrowed to a concrete implementation change.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, authentication
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.