> 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
