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

[Fabian Grünbichler]

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..

> 
> 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
> 
> 
>