> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/cloud-telefonanlage/anbindungen-und-integrationen/api/was-ist-die-authentifizierung-mittels-eines-personal-access-tokens.md).

# Was ist die Authentifizierung mittels eines Personal Access Tokens?

Erfahren Sie, wie Sie Personal Access Tokens für die sichere Authentifizierung bei der sipgate REST API erstellen und verwalten.

Sie können Personal-Access-Token zur Authentisierung bei der sipgate [REST API](https://www.sipgate.io/rest-api) verwenden. Dieses Verfahren soll das bisherige basic auth-Verfahren ersetzen.

Anstelle von Benutzernamen und Passwort wird für die Authentisierung bei der sipgate REST API eine individuelle Kombination aus Token-ID und Token genutzt.

**Personal-Access-Token** bieten im Gegensatz zur Authentisierung über Benutzernamen und Passwort mehr Sicherheit:

* Mehr **Kontrollmöglichkeiten** durch Verwaltung der Berechtigungen (Scopes)
* Einsatzbereiche der Token können über die Scopes spezifiziert werden, sodass nur Zugriff auf einen eingeschränkten Bereich des Accounts besteht
* Sollte ein Token kompromittiert worden sein, kann dieser gelöscht werden
* Username und Passwort müssen nicht über das Netzwerk verschickt werden
* Die Erstellung eines Token ist über die **2-Faktor-Authentifizierung** mit abgesichert, wenn diese aktiviert ist

{% hint style="info" %}
**Hinweis:** Ihre Personal-Access-Token können Sie in Ihrem [Account](https://app.sipgate.com/personal-access-token) erstellen, verwalten und löschen. Beachten Sie bei der Vergabe der Berechtigungen (Scopes), dass Sie nur die Berechtigungen vergeben, die für Ihre Anwendung benötigt werden. Unnötig vergebene Berechtigungen stellen ein Sicherheitsrisiko dar.
{% endhint %}

Beispiele dafür, wie Sie einen Personal-Access-Token zur Authentisierung bei der API verwenden können, finden Sie in unserer [Dokumentation](https://www.sipgate.io/rest-api/authentication/#personalAccessToken).


---

# 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://help.sipgate.de/cloud-telefonanlage/anbindungen-und-integrationen/api/was-ist-die-authentifizierung-mittels-eines-personal-access-tokens.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.