[pbs-devel] [PATCH proxmox-datacenter-manager v3 2/2] docs: document API token-cache TTL effects

[Samuel Rufinatscha]

On 1/14/26 11:44 AM, Fabian Grünbichler wrote:
> On January 2, 2026 5:07 pm, Samuel Rufinatscha wrote:
>> Documents the effects of the added API token-cache in the
>> proxmox-access-control crate. This patch is part of the
>> series that fixes bug #7017 [1].
>>
>> This patch is part of the series which fixes bug #7017 [1].
>>
>> [1] https://bugzilla.proxmox.com/show_bug.cgi?id=7017
> 
> please try to read your commit messages at least once before sending.
> the bug is referenced three times here, and it is not necessary to
> mention it at all..
>

Fair point — the duplication here is a copy/paste slip. I’ll resend v4
with a cleaned-up commit message for this docs only patch and remove
the "part of the series" boilerplate from the other commits. Thanks.

>>
>> Signed-off-by: Samuel Rufinatscha <s.rufinatscha at proxmox.com>
>> ---
>> Changes from v2 to v3:
>>
>> * Reword documentation warning for clarity.
>>
>>   docs/access-control.rst | 4 ++++
>>   1 file changed, 4 insertions(+)
>>
>> diff --git a/docs/access-control.rst b/docs/access-control.rst
>> index adf26cd..18e57a2 100644
>> --- a/docs/access-control.rst
>> +++ b/docs/access-control.rst
>> @@ -47,6 +47,10 @@ place of the user ID (``user at realm``) and the user password, respectively.
>>   The API token is passed from the client to the server by setting the ``Authorization`` HTTP header
>>   with method ``PDMAPIToken`` to the value ``TOKENID:TOKENSECRET``.
>>   
>> +.. WARNING:: Direct/manual edits to ``token.shadow`` may take up to 60 seconds (or
>> +   longer in edge cases) to take effect due to caching. Restart services for
>> +   immediate effect of manual edits.
>> +
>>   .. _access_control:
>>   
>>   Access Control
>> -- 
>> 2.47.3
>>
>>
>>
>> _______________________________________________
>> pbs-devel mailing list
>> pbs-devel at lists.proxmox.com
>> https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel
>>
>>
>>
> 
> 
> _______________________________________________
> pbs-devel mailing list
> pbs-devel at lists.proxmox.com
> https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel
> 
>