Kategorie: Datenbank-Gateway#

Die Kategorie Datenbank-Gateway dokumentiert Gateway- und Proxy-Konfigurationen, über die ein Datenbankschema auf entfernte Datenbanken zugreift. Sie ist eine Multi-Value-Kategorie -- pro Schema lassen sich beliebig viele Gateway-Verbindungen anlegen.

Verwendung#

Typische Anwendungsfälle:

• Datenbankzugriff über Proxy abbilden: Wenn Applikationen nicht direkt auf eine Datenbank zugreifen, sondern über einen Gateway (z.B. Oracle Connection Manager, MySQL Proxy oder PgBouncer), lässt sich diese Zwischenschicht hier dokumentieren.
• Zielschema verknüpfen: Über das Feld Target schema wird das entfernte Datenbankschema als i-doit-Objekt referenziert. Damit entsteht eine navigierbare Verbindung zwischen dem lokalen Schema und dem Ziel hinter dem Gateway.
• Impact-Analyse: Fällt ein Gateway aus, zeigt die Verknüpfung sofort, welche Schemata betroffen sind -- unverzichtbar für Change-Management und Incident-Analyse.
• Sicherheitsdokumentation: Benutzer, Host und Port des Gateways dokumentieren, wer über welchen Weg auf welche Daten zugreift. Hilfreich für Audits und Firewall-Reviews.

Felder#

Gateway-Typ#

Der Typ des Gateways, z.B. Oracle Connection Manager, PgBouncer, MySQL Proxy oder HAProxy. Beschreibt die eingesetzte Technologie oder Software, die als Vermittler zwischen Client und Zieldatenbank fungiert.

Host#

Der Hostname oder die IP-Adresse, unter der das Gateway erreichbar ist, z.B. dbgw01.example.com oder 10.0.5.20. Wird zusammen mit dem Port für die vollständige Verbindungsinformation benötigt.

Port#

Der Netzwerk-Port, auf dem das Gateway lauscht, z.B. 1521 (Oracle) oder 6432 (PgBouncer). Wichtig für Firewall-Dokumentation und Netzwerk-Diagramme.

User#

Der Benutzername, mit dem sich Clients am Gateway authentifizieren. In Kombination mit Host und Port ergibt sich die vollständige Zugangsinformation.

Target schema#

Verknüpfung zum entfernten Datenbankschema (i-doit-Objekt vom Typ Datenbankschema), auf das der Gateway Zugriff gewährt. Über den Objekt-Browser wählbar.

Beschreibung#

Freitext für ergänzende Angaben: Verbindungsoptionen, TLS-Konfiguration, Failover-Verhalten, zugehörige Firewall-Regeln oder Hinweise zum Betrieb.

Technische Referenz#

Felder (API-Referenz)#

API-Beispiele#

Eintrag erstellen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATS__DATABASE_GATEWAY",
        "data": {
            "type": "PgBouncer",
            "host": "dbgw01.example.com",
            "port": "6432",
            "user": "app_readonly",
            "target_schema": 456,
            "description": "PgBouncer-Gateway zur Reporting-Datenbank, TLS erzwungen"
        }
    },
    "id": 1
}

Einträge lesen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.read",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATS__DATABASE_GATEWAY"
    },
    "id": 2
}

Eintrag aktualisieren#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATS__DATABASE_GATEWAY",
        "entry": 1,
        "data": {
            "port": "6433",
            "description": "Port-Wechsel nach Netzwerk-Migration, ab 2026-03 aktiv"
        }
    },
    "id": 3
}