Python-Anwendungen mit einem Wallet (mTLS) verbinden

Rufen Sie die Clientsicherheitszugangsdaten ab, um eine Verbindung zu einer Autonomous Database-Instanz herzustellen.

1. Laden Sie eine Wallet-Datei aus der Autonomous Database-Instanz herunter, um eine ZIP-Datei mit den Clientsicherheitszugangsdaten und den Netzwerkkonfigurationseinstellungen abzurufen, die für den Zugriff auf eine Autonomous Database-Instanz erforderlich sind.

   Rufen Sie die Clientsicherheitszugangsdaten (Datei wallet.zip) ab:

   • ADMIN-Benutzer: Klicken Sie in der Oracle Cloud Infrastructure-Konsole auf Datenbankverbindung. Siehe Clientzugangsdaten (Wallets) herunterladen.

   • Anderer Benutzer (ohne Administrator): Rufen Sie das Oracle Wallet vom Administrator für Ihre Autonomous Database-Instanz ab.

   Hinweis
   
   Schützen Sie die Datei wallet.zip und ihren Inhalt, um einen nicht autorisierten Datenbankzugriff zu verhindern.
2. Dekomprimieren Sie die Clientzugangsdaten-Datei (wallet.zip).

Standardmäßig verwendet python-oracledb den Thin-Modus, um eine direkte Verbindung zur Autonomous Database-Instanz herzustellen.

1. Verschieben Sie die Dateien tnsnames.ora und ewallet.pem in einen Speicherort auf dem System.
   • Linux
   • Fenster

   • Beispiel unter Linux:

     /opt/OracleCloud/MYDB

   • Beispiel für Windows:

     C:\opt\OracleCloud\MYDB

2. Legen Sie in Ihrer Python-Anwendung die folgenden Verbindungsparameter fest, um eine Verbindung zu einer Autonomous Database-Instanz herzustellen:
   • config_dir: Gibt das Verzeichnis an, das tnsnames.ora enthält.
   • dsn: Hiermit geben Sie den gewünschten Netzwerkalias aus der Datei tnsnames.ora an.
   • password: Gibt das Kennwort des Datenbankbenutzers an.
   • user: Gibt den Datenbankbenutzer an.
   • wallet_location: Gibt das Verzeichnis an, das die PEM-Datei (ewallet.pem) enthält.
   • wallet_password: Gibt das Kennwort für die PEM-Datei an (ewallet.pem). Sie legen dieses Kennwort fest, wenn Sie die Datei wallet.zip herunterladen.
   • Linux
   • Fenster

   • Beispiel: Melden Sie sich unter Linux mit oracledb.connect und dem Netzwerkservicenamen db2024_low als ADMIN-Benutzer an (der Servicename befindet sich in tnsnames.ora):

     connection=oracledb.connect(
          config_dir="/opt/OracleCloud/MYDB",
          user="admin",
          password=password,
          dsn="db2024_low",
          wallet_location="/opt/OracleCloud/MYDB",
          wallet_password=wallet_pw)

   • Beispiel: Wenn Sie unter Windows eine Verbindung als ADMIN-Benutzer mit oracledb.connect und dem Netzwerkservicenamen db2024_low herstellen möchten (der Servicename befindet sich in tnsnames.ora):

     connection=oracledb.connect(
          config_dir=r"C:\opt\OracleCloud\MYDB",
          user="admin",
          password=password,
          dsn="db2024_low",
          wallet_location=r"C:\opt\OracleCloud\MYDB",
          wallet_password=wallet_pw)

     Die Verwendung einer "raw"-Zeichenfolge r"..." bedeutet, dass umgekehrte Schrägstriche als Verzeichnistrennzeichen behandelt werden.

   Wie in diesem Beispiel gezeigt, werden wallet_location und config_dir auf dasselbe Verzeichnis gesetzt (und das Verzeichnis enthält tnsnames.ora und ewallet.pem). Es ist nicht erforderlich, dasselbe Verzeichnis für diese Dateien anzugeben.

connection=oracledb.connect(
     config_dir="/opt/OracleCloud/MYDB",
     user="admin",
     password=password,
     dsn="db2024_low",
     wallet_location="/opt/OracleCloud/MYDB",
     wallet_password=wallet_pw,
     https_proxy='myproxy.example.com',
     https_proxy_port=80)

connection=oracledb.connect(
     config_dir=r"C:\opt\OracleCloud\MYDB",
     user="admin",
     password=password,
     dsn="db2024_low",
     wallet_location=r"C:\opt\OracleCloud\MYDB",
     wallet_password=wallet_pw,
     https_proxy='myproxy.example.com',
     https_proxy_port=80)

1. Speichern Sie die Dateien tnsnames.ora, sqlnet.ora und cwallet.sso auf dem System.

   Verwenden Sie eine von zwei Optionen, um diese Dateien auf Ihrem System zu speichern:

   • Wenn Sie Instant Client verwenden, verschieben Sie die Dateien in eine Unterverzeichnishierarchie network/admin unter dem Instant Client-Verzeichnis. Abhängig von der Architektur oder Ihrem Clientsystem und dem Ort, an dem Sie Instant Client installiert haben, sollten die Dateien sich in einem Verzeichnis befinden, z. B.:

     /home/myuser/instantclient_19_21/network/admin

     oder

     /usr/lib/oracle/19.21/client64/lib/network/admin

     Beispiel: Wenn Sie unter Linux den vollständigen Oracle-Client verwenden, verschieben Sie die Dateien in $ORACLE_HOME/network/admin.

   • Alternativ können Sie die Dateien in ein beliebiges zugängliches Verzeichnis verschieben.

     Beispiel: Verschieben Sie die Dateien unter Linux in das Verzeichnis /opt/OracleCloud/MYDB, und bearbeiten Sie sqlnet.ora, um das Wallet-Speicherortverzeichnis in das Verzeichnis zu ändern, das die Datei cwallet.sso enthält.

     Beispiel: Bearbeiten Sie unter Linux sqlnet.ora wie folgt:

     WALLET_LOCATION = (SOURCE = (METHOD=file) (METHOD_DATA = (DIRECTORY="/opt/OracleCloud/MYDB")))
     SSL_SERVER_DN_MATCH=yes

     Wenn sich die Konfigurationsdateien nicht im Standardspeicherort befinden, muss Ihre Anwendung angeben, wo sie sich befinden, entweder mit dem Parameter config_dir im Aufruf oracledb.init_oracle_client() oder durch Festlegen der Umgebungsvariablen TNS_ADMIN.

     Hinweis
     
     Keine dieser Einstellungen ist erforderlich. Sie müssen sqlnet.ora nicht bearbeiten, wenn Sie alle Konfigurationsdateien im Verzeichnis network/admin ablegen.
2. Legen Sie in Ihrer Python-Anwendung die folgenden Initialisierungs- und Verbindungsparameter fest, um eine Verbindung zur Autonomous Database-Instanz herzustellen:
   • config_dir: Gibt das Konfigurationsverzeichnis an, wenn Sie die Konfigurationsdateien speichern. Dies ist nur erforderlich, wenn die Konfigurationsdateien in einem Verzeichnis außerhalb des Instant Client Configuration Directory network/admin abgelegt werden.
   • dsn: Gibt den gewünschten Netzwerkalias aus der Datei tnsnames.ora an.
   • password: Gibt das Kennwort des Datenbankbenutzers an.
   • user: Gibt den Datenbankbenutzer an.

   Stellen Sie im ersten Fall für die Platzierung der Konfigurationsdateien mit Ihren Datenbankzugangsdaten eine Verbindung zur Autonomous Database-Instanz her, indem Sie den Parameter dsn von tnsnames.ora auf den gewünschten Netzwerkalias setzen.

   Beispiel: So stellen Sie eine Verbindung als ADMIN-Benutzer mit oracledb.init_oracle_client her und stellen eine Verbindung zum Netzwerkservicenamen db2024_low her (wo der Servicename in tnsnames.ora enthalten ist):

   oracledb.init_oracle_client()
      connection=oracledb.connect(
          user="admin",
          password=password,
          dsn="db2024_low")

   Wenn sich Konfigurationsdateien in einem Verzeichnis außerhalb des Instant Client-Konfigurationsverzeichnisses befinden, legen Sie den Parameter config_dir fest, wenn Sie oracledb.init_oracle_client aufrufen.

   • Linux
   • Fenster

   • Beispiel: Melden Sie sich unter Linux als ADMIN-Benutzer mit dem Netzwerkservicenamen db2024_low an:

     oracledb.init_oracle_client(config_dir="/opt/OracleCloud/MYDB")
        connection=oracledb.connect(
           user="admin",
           password=password,
           dsn="db2024_low")

   • Beispiel: Stellen Sie unter Windows eine Verbindung als ADMIN-Benutzer mit dem Netzwerkservicenamen db2024_low her:

     oracledb.init_oracle_client(config_dir=r"C:\opt\OracleCloud\MYDB")
        connection=oracledb.connect(
           user="admin",
           password=password,
           dsn="db2024_low")

     Die Verwendung einer "raw"-Zeichenfolge r"..." bedeutet, dass umgekehrte Schrägstriche als Verzeichnistrennzeichen behandelt werden.

SQLNET.USE_HTTPS_PROXY=on

mydb_high=(description=
(address=(https_proxy=myproxy.example.com)
(https_proxy_port=80)
(protocol=tcps)(port=1522)(host=...)