> 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. Viele der nativen Integrationen von AirOps (Asana, HubSpot, Webflow, Shopify und andere) erfordern, dass Sie sich authentifizieren, bevor Sie sie in Workflow-Schritten verwenden können. Sobald Sie authentifiziert sind, können Sie auswählen, **anzeigen** diese Anmeldedaten offenzulegen, damit sie direkt aus Liquid-Vorlagen und Code-Schritten referenziert werden können. Dies ist nützlich, wenn Sie eine API aufrufen möchten, die der native Schritt nicht abdeckt, oder ein Token in eine Anfrage einfügen möchten. ## Eine Authentifizierung benennen Wenn Sie eine Authentifizierung in **Einstellungen → Integrationen**, können Sie einen benutzerdefinierten Namen eingeben, um Konten oder Umgebungen zu unterscheiden. Lassen Sie das Namensfeld leer, um den generierten Namen zu verwenden. Diese Option gilt auch für OAuth-Verbindungen. ## Eine Verbindung testen Verwenden **Verbindung testen** im **Einstellungen → Integrationen** um unterstützte Integrationen zu prüfen, bevor Sie sie in Workflows verwenden. Sie können während der Einrichtung neue Anmeldedaten testen oder über das Menü der gespeicherten Authentifizierung eine vorhandene Verbindung testen. Wenn bereits ein Ergebnis vorhanden ist, wählen Sie **Testergebnisse anzeigen** und verwenden Sie **Erneut testen** um erneut zu prüfen. Überprüfen Sie den **Verbindungsstatus** und die einzelnen Prüfungen: | Status | Bedeutung | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------- | | **Connected** | Die Verbindungsprüfungen waren erfolgreich. | | **Teilweise verifiziert** | Einige Prüfungen waren erfolgreich, andere konnten nicht verifiziert werden. | | **Nicht verifiziert** | Die Prüfungen konnten nicht feststellen, ob die Verbindung funktioniert. | | **Eingeschränkter Zugriff** | Überprüfen Sie die fehlgeschlagenen Zugriffsprüfungen und die für die Integration erforderlichen Berechtigungen. | | **Verbindung fehlgeschlagen** | Überprüfen Sie den Fehler, korrigieren Sie die Anmeldedaten oder die Konfiguration und testen Sie erneut. | | **Status nicht verfügbar** | AirOps kann kein zuverlässiges Verifizierungsergebnis anzeigen. Testen Sie die Verbindung erneut. | Ein einzelnes **Nicht verifiziert** Ergebnis bedeutet nicht unbedingt, dass die Anmeldedaten falsch sind. Einige Aktionen können nicht getestet werden, ohne Inhalte zu erstellen, zu bearbeiten oder zu löschen. Überprüfen Sie diese Aktionen, bevor Sie sich in einem Workflow darauf verlassen. Für eine neue Verbindung wählen Sie **Integration speichern** nachdem Sie die Ergebnisse überprüft haben. **Trotzdem speichern** ermöglicht es Ihnen, Anmeldedaten mit einem blockierenden Ergebnis zu speichern; dadurch werden die fehlgeschlagenen Prüfungen nicht behoben. Contentful-Verbindungstests sind für Authentifizierungen mit vollem Zugriff verfügbar und enthalten die konfigurierte Space-ID. ## Ablauf von Anmeldedaten verfolgen Für unterstützte Token- oder Basic-Auth-Verbindungen setzen Sie optional ein **Ablaufdatum** beim Erstellen oder Bearbeiten von Anmeldedaten. Admins können das Datum setzen, aktualisieren oder löschen, und die Authentifizierungsliste zeigt den konfigurierten Wert an. OAuth- und von Pipedream verwaltete Verbindungen stellen dieses Feld nicht bereit. Verwenden Sie das Datum, um festzuhalten, wann die vom Anbieter ausgestellten Anmeldedaten erneuert werden müssen. Das Festlegen des Datums erneuert oder verlängert die Anmeldedaten nicht. AirOps sendet **Posteingang** Warnungen 30 Tage vor Ablauf, 14 Tage vor Ablauf und wenn die Anmeldedaten ablaufen. Diese Benachrichtigungen verweisen zurück auf **Integrationen**, wo Sie die Anmeldedaten 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. Umschalten **Anmeldedaten freigeben** für diese Zeile ein. Der Schalter ist standardmäßig deaktiviert. Anmeldedaten sind für Workflows nur verfügbar, wenn Sie sie ausdrücklich freigeben. ## Verwendung in Workflows Sobald sie freigegeben sind, sind die Anmeldedaten über die `authentications` Variable zugänglich, gruppiert nach Anbieternamen und dann nach dem Anzeigenamen der Authentifizierung. ### 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"] ``` Der Variablen-Selektor im Workflow-Builder listet freigegebene Authentifizierungen unter der Kategorie „Integrations-Authentifizierungen“ auf. Ein Klick auf einen Eintrag fügt den korrekten Pfad für den jeweiligen Editor-Modus ein. ## Was verfügbar ist Die genauen Felder hängen vom Authentifizierungstyp ab. Für OAuth-Integrationen haben Sie in der Regel `token`, `refresh_token`und `expires_at`. Bei API-Schlüssel-Integrationen haben Sie das jeweilige Feld, das die Integration verwendet (häufig `api_key`). ## Freigabe deaktivieren Schalten Sie den Schalter aus. Workflows, die auf die nun nicht mehr freigegebenen Anmeldedaten verweisen, werden zu leeren Werten aufgelöst; wenn ein Workflow auf diese Anmeldedaten angewiesen war, können nachgelagerte Aufrufe fehlschlagen. Aktivieren Sie sie erneut, um sie wiederherzustellen. ## Sicherheit Anmeldedaten werden in `*****` in Protokollen und Fehlermeldungen von Schritten automatisch geschwärzt, sodass beim Debuggen von Fehlern, die ein Token erwähnen, der Wert nicht in die Ausführungshistorie gelangt. Schrittergebnisse werden nicht geschwärzt. Wenn ein Code-Schritt einen Anmeldedatenwert direkt zurückgibt (zum Beispiel, `return token`), wird der Wert im Ausführungsprotokoll angezeigt. Achten Sie darauf, keine Anmeldedaten in Schrittergebnissen 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=&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.