Wie dokumentiere ich VPN-Verbindungen?

Ab Tarif Basic

Kurzantwort

Im Modul Netzwerk wechselst du in den Reiter VPN und legst einen VPN-Tunnel an. Pflicht ist nur der Name. Optional dokumentierst du den Typ (z. B. IPSec, WireGuard, OpenVPN), die Peer-Adresse (Gegenstelle), eine Tunnelgruppe und eine Beschreibung.

Voraussetzungen

Enthalten in allen Tarifen ab Basic.

Reiter „VPN” öffnen. Wähle Netzwerk und dann den Reiter VPN. Klicke auf Hinzufügen.

Screenshot ausstehend netzwerk-vpn-01 Reiter 'VPN' im Modul Netzwerk mit dem Formular für einen neuen VPN-Tunnel

Der Reiter 'VPN': Tunnel und Tunnelgruppen dokumentieren.
Tunnel ausfüllen.
- Name: z. B. „Standort-Kopplung Berlin ↔ München”
- Typ (optional): frei wählbar, z. B. IPSec, WireGuard, OpenVPN
- Peer-Adresse (optional): Gegenstelle, z. B. 203.0.113.7
- Tunnelgruppe (optional): Auswahl einer vorhandenen Gruppe
- Beschreibung (optional)
Zum Bündeln legst du zuvor über Hinzufügen eine Tunnelgruppe an (nur ein Name nötig).
Speichern. Der Tunnel erscheint in der Liste, sortiert nach Name.

Per REST-API: ein POST auf /api/v1/network/vpn. Pflicht ist nur name.

curl -X POST https://demo.notory.io/api/v1/network/vpn \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Standort-Kopplung Berlin-Muenchen",
    "vpn_type": "IPSec",
    "peer_address": "203.0.113.7",
    "description": "Site-to-Site zwischen den Standorten"
  }'

{
  "id": "0190f3a2-a055-7fcd-d4e6-5a8b9c0d1e24",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "name": "Standort-Kopplung Berlin-Muenchen",
  "vpn_type": "IPSec",
  "peer_address": "203.0.113.7",
  "group_id": null,
  "description": "Site-to-Site zwischen den Standorten",
  "created_at": "2026-07-08T09:40:00Z",
  "updated_at": "2026-07-08T09:40:00Z"
}

Eine Tunnelgruppe legst du separat an (POST /api/v1/network/vpn-groups, name Pflicht) und referenzierst ihre id über group_id.

Mögliche Fehler: 401, 403 (Rechte/Rolle), 422 (leerer name).

Was passiert dabei?

Mandanten-Zuordnung: Tunnel und Tunnelgruppe gehören deinem aktuellen Mandanten.
Typ ist Freitext: Das Feld Typ ist nicht auf feste Werte beschränkt. Trage die in deiner Umgebung übliche Bezeichnung ein.
Gruppen-Bezug: Wird die verknüpfte Tunnelgruppe gelöscht, setzt Notory group_id auf null (SET NULL); der Tunnel bleibt bestehen.
Reine Dokumentation: Es werden keine VPN-Verbindungen aufgebaut oder überwacht. Die Einträge dienen der Nachvollziehbarkeit deiner VPN-Landschaft.