Integration
Zugangsdaten
Verwalten Sie Zugangsdaten für externe Dienste
Mit Zugangsdaten bündeln Sie vertrauliche Kennwörter, API-Keys oder SFTP-Parameter, die zBsp. für Folgeaktionen oder externe Email-Server benötigt werden. Durch die zentrale Verwaltung behalten Sie den Überblick darüber, welche Integrationen wie eingerichtet sind. Einen praxisnahen Überblick zur Nutzung der Platzhalter finden Sie unter Zugangsdaten-Verwaltung und Verwendung.
Alle Einträge können mit Benutzerdefinierten Zugangsdaten innerhalb von E-Mail-Vorlagen, Webhooks oder Renderings verknüpft werden. Dabei sorgt die Verschlüsselungsschicht des Backends dafür, dass sensible Inhalte ausschließlich serverseitig entschlüsselt werden.
Speichern Sie niemals Produktiv-Geheimnisse in Klartext-Notizen oder externen Tools. Die Zugangsdaten-Tabelle erzwingt eine Maskierung der Werte und kennzeichnet sichtbar, ob ein Wert verschlüsselt abgelegt ist.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
Zugangsdaten-Liste
Die Listenansicht zeigt alle Credential-Einträge inklusive Aktivierungsstatus, Verschlüsselungskennzeichen und Mandanten-Bezug. So erkennen EVU-Teams unmittelbar, ob beispielsweise SFTP-Zugänge für Marktpartner bereits produktiv sind.
ID, Identifier, Aktiv ab, Aktiv, Wert
| ID | Identifier | Gruppen-Identifier | Aktiv ab | Aktiv | Wert |
|---|---|---|---|---|---|
| identifier_name | Null | Aktiv |
ID
Eindeutige Nummer zur internen Identifikation des Zugangsdatens.
Identifier
Eindeutiger Name des Zugangsdatens für Rendering und API-Aufrufe.
Eindeutiger Name für eine optionale Gruppierung von verwandten Zugangsdatenn. Elemente einer Gruppe werden gemeinsam verarbeitet und optionale Validatoren können dabei einzelne Elemente aktivieren oder ignorieren.
Aktiv ab
Startdatum eines Zugangsdatens. Zugangsdatens werden erst ab diesem Datum beim Rendern beachtet.
Aktiv
Schnellübersicht, ob das Zugangsdaten derzeit freigegeben ist. Deaktivierte Elemente behalten ihre Historie, werden aber nicht mehr automatisch verwendet.
Wert
Der Dateneintrag des Zugangsdatens. Kann Text, Zahlen, Bedingungen oder andere Daten enthalten, die in Vorlagen verwendet werden.
Maskierte Werte bleiben auch bei ausgeschaltetem Verschlüsselungs-Flag verborgen. Die tatsächliche Zeichenfolge wird ausschließlich in der Detailansicht angezeigt und lässt sich dort kopieren.
Verschlüsselt
Setzen Sie das Verschlüsselungs-Flag für Passwörter, API-Keys oder Tokens, die nicht über Hardware-Sicherheitsmodule verwaltet werden. Nur unkritische IDs (z.B. sftp_user) sollten unverschlüsselt bleiben.
Mandant, Standard für Umgebungs-Mandanten
| Umgebungs-Mandant | Standard für Umgebungs-Mandanten | Benutzerdefinierte ID | Farbe |
|---|---|---|---|
| (1880) Submarke 1 | NO | Null | |
| Null | YES | <<payload.value>> |
Zugeordneter Mandant des/der Zugangsdaten. Ermöglicht Mandanten-spezifische Konfiguration.
Kennzeichnet Zugangsdaten als Standard und vererbt (verfügbar) für alle Umgebungs-Mandanten.
Optionale benutzerdefinierte Kennung nach dem Rendering für externe Systeme. Wird als Referenzen des/der Zugangsdaten bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.
Visuelle Kennzeichnung für schnelle Identifikation des/der Zugangsdaten. Vor allem nützlich für Dashboard-Statistiken und Charts.
Verknüpfen Sie Zugangsdaten mit einzelnen Umgebungs-Mandanten, um SFTP- oder REST-Credentials für Tochtergesellschaften getrennt zu halten. Das Feld Standard für Umgebungs-Mandanten vererbt denselben Eintrag an alle Untergesellschaften.
Erstellt am, Aktualisiert am
| Validatoren | Pausiert | Aktiv | Erstellt am | Aktualisiert am |
|---|---|---|---|---|
| Null | NO | Ja | ||
| missing_street | YES | Nein |
Zugewiesene Validierungsregeln für das Zugangsdaten. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.
Temporäre Deaktivierung des Zugangsdatens. Pausierte Elemente werden nicht verarbeitet.
Aktivierungsstatus des Zugangsdatens. Nur aktive Elemente werden beim Rendern berücksichtigt.
Erstellt am
Zeitstempel der Zugangsdaten-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann Zugangsdaten-Konfiguration zuletzt bearbeitet wurde.
Kontext-Aktionen
Aktions-Dropdown
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen Zugangsdaten.
Testen
Öffnet eine Zugangsdaten-Testumgebung zum lokalen Rendern mit bearbeitbaren Validatoren und JSON-Testdaten.
Zugangsdaten herunterladen
Lädt die Quell-Datei des Zugangsdaten auf Ihren Computer herunter.
Anzeigen
Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen des Zugangsdaten.
Ändern
Öffnet das Bearbeitungsformular für alle Einstellungen und den Upload einer neuen Zugangsdaten-Version.
Löschen
Entfernt das Zugangsdaten dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.
Die Dropdown-Aktion Löschen öffnet immer ein Sicherheitsmodal. Dadurch lassen sich produktive Verbindungen nicht versehentlich entfernen, während parallele Prozesse laufen.
Filter
- Filtern öffnet das Modal, in dem sich Identifier, Aktiv-Status, Mandant und Zeiträume für „Aktiv ab“ kombinieren lassen.
- Zurücksetzen entfernt alle Kriterien und zeigt wieder sämtliche Credentials.
- Anwenden übernimmt die Filter und aktualisiert die Tabelle ohne Seitenwechsel.
Batch-Aktionen
Mehrfachauswahl aktiviert die Schaltfläche Löschen im Batch-Menü. Nach Bestätigung blendet das Modal die Anzahl der betroffenen Elemente ein und führt die Aktion erst nach einer expliziten Freigabe aus. So bleiben serielle Anpassungen (z.B. Austausch aller SFTP-Passwörter) nachvollziehbar.
Zugangsdaten erstellen
Aktions-Buttons zum Speichern und Verwalten der Zugangsdaten-Konfiguration.
Verwenden Sie "Erstellen und weiteres Element hinzufügen" für effizientes Batch-Erstellen mehrerer Elemente.
Beim Speichern legt das Backend automatisch Audit-Informationen (Erstellt/Aktualisiert) an und kennzeichnet verschlüsselte Felder serverseitig, ohne dass Nutzer:innen Schlüsselmaterial sehen.
Formularfelder
Identifier
Eindeutige Kennung für dieses/r Zugangsdaten zur programmatischen Verwendung, Einbindung in Vorlagen, Lookups und API-Zugriff.
Identifiers sollten 'snake_case' sein, also klein geschrieben und Unterstriche verwenden, z.B. 'kunde_name' oder 'rechnung_nummer'.
Verwenden Sie sprechende Namen wie sftp_host oder billing_api_key, um Automationen eindeutig zuzuordnen. Diese Identifier tauchen auch in Logs und Webhooks auf.
Aktiv ab und Aktiv
Startdatum des Zugangsdatens. Zugangsdatene werden erst ab diesem Datum beim Rendern beachtet.
Die Aktiv-Checkbox ermöglicht eine sofortige De-/Aktivierung unabhängig vom Datum.
Vor-Terminierung: Mit diesem Feld können Zugangsdatene vor-terminiert werden. Setzen Sie ein zukünftiges Datum, um das Element automatisch ab diesem Zeitpunkt zu aktivieren.
Mehrere Elemente mit gleichem Identifier: unterschiedliches 'Aktiv ab' staffelt die Version; bei einer Anfrage gilt das aktive Element mit dem spätesten Aktiv ab (nicht Erstell- oder Änderungsdatum).
Wert & Verschlüsselung
Der Verschlüsselungsstatus lässt sich jederzeit ändern. Bereits gespeicherte Werte werden beim Umschalten neu verschlüsselt oder als Klartext abgelegt.
Mandant & Standard für Umgebungs-Mandanten
Zuordnung zu einem spezifischen Umgebungs-Mandanten oder Standard-Verwendung für alle Mandanten.
Markiert Element als Standard-Element, das automatisch an alle Umgebungs-Mandanten vererbt wird.
Fehlermeldung: Die Kombination "Standard für Umgebungs-Mandanten" + ausgewählter "Umgebungs-Mandant" erzeugt die Fehlermeldung: Tenant defaults can not be set on tenant assigned entities. Ein Element kann entweder für einen spezifischen Mandant ODER als Standard für alle Umgebungs-Mandanten konfiguriert werden.
Nutzen Sie diese Felder, um identische Credentials an mehrere Submarken zu vererben oder bewusst nur in einzelnen Regionen verfügbar zu machen.
Verwandte Backend-Bereiche
- API-Token: Kombinieren Sie Zugangsdaten mit Token-basierten Schnittstellen, um Authentifizierungs- und Autorisierungsinformationen sauber zu trennen.
- E-Mail-Server: SMTP-Accounts greifen häufig auf dieselben Zugangsdaten zurück.
- Webhooks: Verwenden Sie Credentials für Signaturen oder Basic-Auth, wenn Output.Rocks Benachrichtigungen versendet.
Relevante Use Cases
- Benutzerdefinierte Zugangsdaten – zeigt, wie Credentials innerhalb von E-Mail-Vorlagen genutzt werden.
- Mandanten-Management – erklärt, wie Vererbungen zwischen Haupt- und Untermandanten funktionieren.