> For the complete documentation index, see [llms.txt](https://docs.polyteia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.polyteia.com/web/konto/zugriffsschlussel-pak.md).

# Zugriffsschlüssel (PAK)

Schlüssel für den automatischen Zugriff auf die Plattform.

### Was ist das?

Ein persönlicher Zugriffsschlüssel ist eine lange Zeichenkette. Damit kann ein Programm auf die Plattform zugreifen, ohne dass Sie sich jedes Mal anmelden. Der Schlüssel hat dieselben Berechtigungen wie Sie.

**Der Vorteil:** Sie automatisieren wiederkehrende Datenflüsse. Ein anderes System liefert Daten regelmäßig von selbst in Ihre Datensätze, ohne manuelle Arbeit. Das spart Zeit und hält Ihre Daten aktuell.

### Vergleich aus dem Alltag

Stellen Sie sich einen Zweitschlüssel für ein Schließfach vor. Sie geben ihn einem Programm, das für Sie arbeitet. Das Programm öffnet das Schließfach, wann immer es nötig ist. Sie müssen nicht jedes Mal selbst kommen.

### Wann braucht man das?

Ein Zugriffsschlüssel ist nützlich, wenn Sie:

* Daten aus einem anderen Programm automatisch übertragen möchten
* wiederkehrende Aufgaben ohne manuelle Anmeldung erledigen möchten
* die Plattform mit Ihren eigenen Systemen verbinden möchten

{% hint style="info" %}
Der Schlüssel gehört zu Ihrem Konto. Er kann nur das, was auch Sie dürfen.
{% endhint %}

{% hint style="info" %}
Ob Sie Zugriffsschlüssel nutzen dürfen, legt Ihr Mandant fest. Ein Mandanten-Admin aktiviert sie in der **Mandanten-Konsole** unter **Sicherheit → Persönliche Zugriffsschlüssel**.
{% endhint %}

### Wo finde ich die Schlüssel?

1. **Klicken** Sie unten links in der Seitenleiste auf Ihren Namen.
2. **Wählen** Sie **Konto**.
3. **Öffnen** Sie links den Bereich **Zugriffsschlüssel**.

### Einen Schlüssel erstellen

{% stepper %}
{% step %}
**Auf „Schlüssel erstellen" klicken**

Klicken Sie oben rechts auf **Schlüssel erstellen**. Ein Fenster öffnet sich.
{% endstep %}

{% step %}
**Namen vergeben**

Geben Sie einen **Namen** ein. So erkennen Sie später, wofür der Schlüssel ist. Zum Beispiel „Monatsbericht" oder „Import Haushalt".
{% endstep %}

{% step %}
**Ablaufdatum wählen**

Wählen Sie, wie lange der Schlüssel gültig ist: **30 Tage**, **90 Tage**, **365 Tage** oder **Kein Ablaufdatum**. Ein Ablaufdatum erhöht die Sicherheit. Nach Ablauf funktioniert der Schlüssel nicht mehr.
{% endstep %}

{% step %}
**Schlüssel erstellen und kopieren**

Klicken Sie auf **Schlüssel erstellen**. Der Schlüssel wird nun einmal angezeigt.

{% hint style="warning" %}
Kopieren Sie den Schlüssel sofort und bewahren Sie ihn sicher auf. Er wird **nicht erneut angezeigt**. Wenn Sie ihn verlieren, erstellen Sie einen neuen.
{% endhint %}
{% endstep %}
{% endstepper %}

### Bestehende Schlüssel ansehen

Alle Ihre Schlüssel stehen in einer Tabelle. Sie sehen dort:

* **Name**: der Name, den Sie vergeben haben
* **Läuft ab**: wann der Schlüssel ungültig wird (oder „Nie")
* **Zuletzt verwendet**: wann der Schlüssel das letzte Mal genutzt wurde

### Einen Schlüssel widerrufen

Brauchen Sie einen Schlüssel nicht mehr? Oder ist er in falsche Hände geraten? Dann widerrufen Sie ihn.

1. **Suchen** Sie den Schlüssel in der Tabelle.
2. **Klicken** Sie rechts auf das Papierkorb-Symbol.
3. **Bestätigen** Sie im Fenster mit **Schlüssel widerrufen**.

{% hint style="danger" %}
Ein widerrufener Schlüssel funktioniert sofort nicht mehr. Alle damit gestarteten Sitzungen werden beendet. Dieser Schritt lässt sich nicht rückgängig machen.
{% endhint %}

### Tipps

* Behandeln Sie einen Schlüssel wie ein Passwort. Geben Sie ihn nicht weiter.
* Sie können mehrere Schlüssel gleichzeitig haben. Vergeben Sie klare Namen.
* Nutzen Sie lieber ein Ablaufdatum. So bleibt kein alter Schlüssel unbemerkt gültig.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.polyteia.com/web/konto/zugriffsschlussel-pak.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.