> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/dein-workspace/settings/authentications.md).

# Authentifizierungen für Integrationen

Teste Integrationsverbindungen, verfolge das Ablaufdatum von Zugangsdaten und verwende Zugangsdaten in Workflows.

Für viele native Integrationen von AirOps (Asana, HubSpot, Webflow, Shopify und weitere) musst du dich authentifizieren, bevor du sie in Workflow-Schritten verwenden kannst. Nach der Authentifizierung kannst du festlegen, ob diese Anmeldedaten **offengelegt werden** sollen, damit direkt in Liquid-Vorlagen und Code-Schritten auf sie verwiesen werden kann. Das ist nützlich, wenn du eine API aufrufen möchtest, die der native Schritt nicht abdeckt, oder ein Token in eine Anfrage einfügen willst.

## Authentifizierung benennen

Wenn du unter **Einstellungen → Integrationen**eine Authentifizierung hinzufügst, kannst du einen benutzerdefinierten Namen eingeben, um Konten oder Umgebungen voneinander zu unterscheiden. Lass das Namensfeld leer, um den automatisch generierten Namen zu verwenden. Diese Option gilt auch für OAuth-Verbindungen.

## Verbindung testen

Verwende **Verbindung testen** unter **Einstellungen → Integrationen** , um unterstützte Integrationen zu prüfen, bevor du sie in Workflows verwendest. Du kannst während der Einrichtung neue Anmeldedaten testen oder über das Menü der gespeicherten Authentifizierung eine bestehende Verbindung testen. Wenn bereits ein Ergebnis vorliegt, wähle **Testergebnisse anzeigen** und dann **Erneut testen** , um die Verbindung noch einmal zu prüfen.

Die Spalte **Letzte Verbindungsprüfung** beschreibt den letzten Test. **Testen nicht verfügbar** bedeutet, dass AirOps für diese Integration keinen Test anbietet; **Nicht getestet** bedeutet, dass kein Test durchgeführt wurde. Keine der beiden Kennzeichnungen bedeutet, dass die Authentifizierung getrennt ist.

Gespeicherte Ergebnisse und einzelne Prüfungen im Überblick:

| Status                        | Bedeutung                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Verbunden**                 | Die Verbindungsprüfungen waren erfolgreich.                                                                   |
| **Teilweise verifiziert**     | Einige Prüfungen waren erfolgreich, andere konnten jedoch nicht verifiziert werden.                           |
| **Nicht verifiziert**         | Anhand der Prüfungen ließ sich nicht feststellen, ob die Verbindung funktioniert.                             |
| **Eingeschränkter Zugriff**   | Sieh dir die fehlgeschlagenen Zugriffsprüfungen und die für die Integration erforderlichen Berechtigungen an. |
| **Verbindung fehlgeschlagen** | Prüfe den Fehler, korrigiere die Anmeldedaten oder Konfiguration und teste die Verbindung erneut.             |
| **Status nicht verfügbar**    | AirOps kann kein zuverlässiges Verifizierungsergebnis anzeigen. Teste die Verbindung erneut.                  |

Ein einzelnes Ergebnis **Nicht verifiziert** bedeutet nicht unbedingt, dass die Anmeldedaten falsch sind. Manche Aktionen lassen sich nicht testen, ohne Inhalte zu erstellen, zu bearbeiten oder zu löschen. Prüfe diese Aktionen, bevor du dich in einem Workflow auf sie verlässt.

Wähle bei einer neuen Verbindung nach Prüfung der Ergebnisse **Integration speichern** . **Trotzdem speichern** ermöglicht es dir, Anmeldedaten trotz eines blockierenden Ergebnisses zu speichern; die fehlgeschlagenen Prüfungen werden dadurch nicht behoben.

Verbindungstests für Contentful sind für Authentifizierungen mit Vollzugriff verfügbar und berücksichtigen die konfigurierte Space-ID.

Bei Semrush OAuth **prüft „Verbindung testen“** die Token-Authentifizierung und den Serverzugriff, ohne API-Einheiten für Berichte zu verbrauchen. Eine erfolgreiche Authentifizierungsprüfung bestätigt weder die Berechtigungen für Berichte noch die verfügbaren Berichtsguthaben. Lies den separaten Hinweis zum Berichtszugriff, bevor du einen Workflow ausführst.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-781014a050068c906c2e9666c769859440c30986%2Fauthentications-01-integrations-list.png?alt=media" alt="Settings Integrations list with named authentications, a connection test result, an expiration badge, and Expose credentials"><figcaption><p>Teste Verbindungen, behalte den Ablauf im Blick und lege unter „Integrationen“ Anmeldedaten offen.</p></figcaption></figure>

## Ablauf von Zugangsdaten nachverfolgen

Legen Sie für unterstützte Token- oder Basic-Auth-Verbindungen beim Erstellen oder Bearbeiten von Zugangsdaten optional ein **Ablaufdatum** fest. Admins können das Datum festlegen, aktualisieren oder löschen. In der Authentifizierungsliste wird der konfigurierte Wert angezeigt. Bei OAuth- und von Pipedream verwalteten Verbindungen ist dieses Feld nicht verfügbar.

Verwenden Sie das Datum, um festzuhalten, wann die vom Anbieter ausgestellten Zugangsdaten erneuert werden müssen. Durch das Festlegen des Datums werden die Zugangsdaten weder erneuert noch verlängert. AirOps sendet **Posteingang** Warnungen 30 Tage und 14 Tage vor dem Ablauf sowie zum Ablaufzeitpunkt der Zugangsdaten. Diese Benachrichtigungen führen zurück zu **Integrationen**, wo Sie die Zugangsdaten und das Datum aktualisieren können.

## Freigabe aktivieren

1. Navigieren Sie zu **Einstellungen > Integrationen**.
2. Suchen Sie die Authentifizierung, die Sie freigeben möchten.
3. Aktivieren Sie für diese Zeile den Schalter **Zugangsdaten freigeben** .

Der Schalter ist standardmäßig deaktiviert. Zugangsdaten sind für Workflows nur verfügbar, wenn Sie sie ausdrücklich freigeben.

## In Workflows referenzieren

Nach der Freigabe sind Zugangsdaten über die Variable `authentications` zugänglich. Sie ist nach Anbieternamen und anschließend nach dem Anzeigenamen der Authentifizierung verschachtelt.

### Liquid-Vorlage

```
{{ authentications['asana']['Prod'].token }}
```

### JavaScript-Code-Schritt

```javascript
const auth = authentications.asana["Prod"];
const token = auth.token;
```

### Python-Code-Schritt

```python
auth = authentications["asana"]["Prod"]
token = auth["token"]
```

Die Variablenauswahl im Workflow-Builder listet freigegebene Authentifizierungen in der Kategorie "Integration Authentications" auf. Wenn Sie auf einen Eintrag klicken, wird der passende Pfad für den verwendeten Editormodus eingefügt.

## Verfügbare Daten

Die genauen Felder hängen vom Authentifizierungstyp ab. Bei OAuth-Integrationen stehen Ihnen in der Regel `token`, `refresh_token`und `expires_at`zur Verfügung. Bei API-Key-Integrationen erhalten Sie das von der Integration verwendete Feld (häufig `api_key`).

## Freigabe deaktivieren

Deaktivieren Sie den Schalter. Workflows, die auf die nun nicht mehr freigegebenen Zugangsdaten verweisen, erhalten leere Werte. Wenn ein Workflow auf diese Zugangsdaten angewiesen war, können nachfolgende Aufrufe fehlschlagen. Aktivieren Sie den Schalter erneut, um die Freigabe wiederherzustellen.

## Sicherheit

Zugangsdaten werden in Trace-Protokollen und Fehlermeldungen von Schritten automatisch als `*****` geschwärzt, damit bei der Fehlersuche der Wert nicht in den Ausführungsverlauf gelangt, wenn in einer Fehlermeldung ein Token erwähnt wird.

Schrittausgaben werden nicht geschwärzt. Wenn ein Code-Schritt direkt einen Wert für Zugangsdaten zurückgibt (zum Beispiel `return token`), erscheint der Wert im Ausführungs-Trace. Achten Sie darauf, keine Zugangsdaten in Schrittausgaben auszugeben.


---

# 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.airops.com/docs/de/dein-workspace/settings/authentications.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.
