View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0010575 | Taler | documentation | public | 2025-11-10 20:35 | 2026-01-25 15:24 |
| Reporter | htgoebel | Assigned To | schanzen | Resolution deadline | |
| Implementer | Reviewer | ||||
| Release signed by | Deployed by | ||||
| Verifier | Communicator | ||||
| Data protection authority notification required | No | ||||
| CSIRT notification required | No | ||||
| Estimated effort (hours) | Actual effort (hours) | 0 | |||
| Fast-track | No | ||||
| Work package | none | ||||
| Priority | normal | Severity | text | Reproducibility | have not tried |
| Status | implementing | Resolution | open | ||
| Product Version | 1.0 | ||||
| Target Version | 1.9 | ||||
| Summary | 0010575: Enhance documentation for Authentication | ||||
| Description | The section "Authentication" in the merchant backend documentations currently is confusing and would befit from some improvements. It is confusing since it writes about "the /private/auth/ API" but not about private endpoints in general, Also the description about how to obtain a "login token" is not obvious. - Don't mention "the /private/auth/ API" here since the authentication schemes apply to all endpoints. - Deprecated method behind current ones. - Mention Basic Auth (and that it is only valid for /private/auth and /private/token) - Deprecated "token", last sentence: "login token", but this term was not used before. - Non-deprected "token" uses "bearer token", "authentication token" - How to retrieve a token should be more prominent. Since this is the only non-deprected way of authentication, I suggest putting this into (short) section of its own. - "A login token is commonly only valid for a limited period of time": Mention that this period can be defined when retrieving a token. - Endpoint releated to authentication (/private/auth, /private/token) should go into this section. At least they should go into a separrate section "Authentication Management" in "Instance Management" and not be hidden under "Setting up instances". | ||||
| Tags | No tags attached. | ||||
| related to | 0010172 | closed | Christian Grothoff | should not be able to create to create tokens with a token |
| Date Modified | Username | Field | Change |
|---|---|---|---|
| 2025-11-10 20:35 | htgoebel | New Issue | |
| 2025-11-11 11:29 | Christian Grothoff | Assigned To | => schanzen |
| 2025-11-11 11:29 | Christian Grothoff | Status | new => assigned |
| 2025-11-11 11:30 | Christian Grothoff | Severity | feature => text |
| 2025-11-11 11:30 | Christian Grothoff | Product Version | => 1.0 |
| 2025-11-11 11:30 | Christian Grothoff | Target Version | => 1.5 |
| 2025-11-11 11:30 | Christian Grothoff | Note Added: 0026373 | |
| 2025-11-25 09:58 | schanzen | Relationship added | related to 0010172 |
| 2025-12-21 21:03 | Christian Grothoff | Target Version | 1.5 => 1.8 |
| 2026-01-25 15:24 | Christian Grothoff | Status | assigned => implementing |
| 2026-01-25 15:24 | Christian Grothoff | Target Version | 1.8 => 1.9 |