Przejdź do głównej zawartości

Tokeny

Użyj auth.tokens, gdy uwierzytelniony kontekst ma tworzyć albo wycofywać tokeny KSeF dla automatyzacji. Wartości wygenerowanych tokenów traktuj jak sekrety.

Wygeneruj token

Dział zatytułowany „Wygeneruj token”
token = auth.tokens.generate(
    permissions=["invoice_read"],
    description="nightly export",
    timeout=60.0,
)


print(token.reference_number)
print(token.token)

Listuj i sprawdzaj tokeny

Dział zatytułowany „Listuj i sprawdzaj tokeny”
for page in auth.tokens.list_all():
    for item in page.tokens:
        print(item.reference_number, item.status, item.description)

Cofnij token

Dział zatytułowany „Cofnij token”
auth.tokens.revoke(reference_number="token-reference")

Zalecany przepływ

Dział zatytułowany „Zalecany przepływ”

  1. Wybierz najmniejszy zestaw uprawnień wymagany przez automatyzację.

  2. Wygeneruj token w kontekście uwierzytelnionym właściciela.

  3. Zapisz wartość tokena w magazynie sekretów, a referencję w metadanych.

  4. Listuj albo sprawdzaj referencje podczas audytów.

  5. Cofaj nieużywane albo naruszone tokeny.

Referencja

Dział zatytułowany „Referencja”