# Sentry: Zugangsdaten

Du verbindest dein Sentry-Konto entweder per OAuth mit Sentry Cloud oder per API-Token, der auch für eine selbst gehostete Instanz funktioniert.

> Source: https://www.application-platform.com/de/docs/sentry-credentials/

Unter **Anbindungen** verbindest du das Sentry-Konto, in dem die Plattform die Sentry-Projekte deiner Komponenten anlegt. **Mit Sentry verbinden** nutzt eine Public Integration und funktioniert nur mit Sentry Cloud unter [sentry.io](https://sentry.io). **API-Token hinzufügen** funktioniert auch mit einer selbst gehosteten Instanz; du gibst Host, Organisations-Slug und einen Auth-Token an.

## Auth-Token in Sentry anlegen

1. Melde dich bei [sentry.io](https://sentry.io) oder bei deiner eigenen Instanz an und öffne deine Organisation.
2. Gehe zu **Settings → Account → API → Auth Tokens**. Organisations-Tokens findest du unter **Settings → Developer Settings / Auth Tokens**; die Bezeichnungen können je nach Sentry-Version abweichen.
3. Erstelle einen Token mit diesen Scopes:
   - `org:read` zum Lesen der Organisation
   - `project:read` und `project:write` für Projekte und Client-Keys
   - `team:read` und `team:write`, weil die Plattform bei Bedarf ein Team anlegt
4. Kopiere den Token. Sentry zeigt ihn nur einmal an.

Bei einer eigenen Instanz wie `https://sentry.example.com` ist der Ablauf gleich. Vergib nur die genannten Scopes statt eines breiten Admin-Tokens und aktualisiere nach einer Neuerzeugung in Sentry den Eintrag unter **Anbindungen**.

## Token in der Plattform eintragen

Öffne **Anbindungen → Sentry → API-Token hinzufügen** und fülle die Felder aus.

| Feld | Inhalt |
|---|---|
| **Name** und **Slug** | Anzeigename und unveränderlicher Slug für die Projekte |
| **Instanz** | **Sentry Cloud (sentry.io)** oder **Self-hosted** |
| **Sentry-URL** | Nur bei Self-hosted: die Basis-URL deiner Instanz ohne `/api/0` |
| **Organisation (Slug)** | Der Organisations-Slug aus der Sentry-URL, zum Beispiel `meine-firma` |
| **Auth-Token** | Der eben erzeugte Token |

Nach dem Speichern steht der Zugang in den Projekten deiner Organisation zur Auswahl. Wie du Sentry für eine Komponente aktivierst, beschreibt [Error-Tracking]({{< relref "error-tracking" >}}).

## OAuth für Sentry Cloud

Wähle unter **Anbindungen → Sentry** die Option **Mit Sentry verbinden** und melde dich an. Für selbst gehostete Instanzen steht dieser Weg nicht zur Verfügung.