Documentación de Oracle Cloud Infrastructure

Conexión de aplicaciones de Python sin una cartera (TLS)

Puede conectar aplicaciones Python a su instancia de Autonomous Database sin una cartera. La conexión de una aplicación Python sin una cartera (TLS) proporciona seguridad para la autenticación y el cifrado, y la seguridad se aplica mediante credenciales de cliente (al proporcionar un nombre de usuario y una contraseña).

El "modo fino" predeterminado del controlador python-oracledb se conecta directamente a Oracle Database. Opcionalmente, puede utilizar las bibliotecas del cliente de Oracle, "Thick mode", para algunas funciones adicionales. Las bibliotecas de Oracle Client pueden ser de Oracle Instant Client, el cliente de Oracle completo o una instalación de Oracle Database.

Siga estos pasos para conectar la aplicación Python a una instancia de Autonomous Database sin cartera (TLS):

  1. Instalación de Python y el controlador python-oracledb

  2. Activación de TLS en Autonomous Database y obtención de cadena de conexión

  3. Ejecución de la aplicación Python sin cartera

Consulte Enabling python-oracledb Thick mode para obtener información sobre el modo Thick.

Temas

Tema principal: Conexión de aplicaciones Python a Autonomous Database

Activación de TLS en Autonomous Database y obtención de cadena de conexión

Para ejecutar una aplicación de Python sin cartera, active la instancia de Autonomous Database para las conexiones TLS y obtenga una cadena de conexión para ponerse en contacto con la base de datos desde la aplicación de Python.
  1. Determine si la instancia de Autonomous Database está activada para conexiones TLS.

    Si la instancia está activada para conexiones TLS, en el área Red de la consola de Oracle Cloud Infrastructure, el campo Autenticación TLS mutua (mTLS) muestra: No necesaria:

    Descripción de adb_mutual_tls_not_required.png a continuación
    Descripción de la ilustración adb_mutual_tls_not_required.png

    Si la instancia necesita autenticación TLS mutua, permita conexiones TLS en la instancia de Autonomous Database. Consulte la sección sobre actualización de las instancias de Autonomous Database para permitir tanto autenticación TLS y mTLS para obtener más información.

  2. Obtenga una cadena de conexión al servicio Autonomous Database para acceder a la base de datos de la siguiente manera:
    1. En la consola de Oracle Cloud Infrastructure, haga clic en Conexión de base de datos.
    2. Seleccione TLS en el cuadro de diálogo Conexión a base de datos, en Cadenas de conexión, en la lista desplegable Autenticación TLS.
      Nota

      Debe seleccionar TLS en la lista desplegable Autenticación TLS para obtener las cadenas de conexión TLS antes de copiar una cadena de conexión (cuando el valor es TLS mutua, las cadenas de conexión tienen valores diferentes y no funcionan con conexiones TLS).
    3. Copie la cadena de conexión para el servicio de base de datos que desea utilizar con la aplicación.

Ejecución de la aplicación Python sin cartera

Una aplicación Python se puede conectar a la instancia de Autonomous Database sin una cartera (TLS) mediante las credenciales de base de datos y un descriptor de conexión.

  1. Obtenga la cadena de conexión, como se describe en Activación de TLS en Autonomous Database y obtención de cadena de conexión.
  2. En la aplicación Python, defina los siguientes parámetros de conexión para conectarse a una instancia de Autonomous Database:
    • dsn: utilice la cadena de conexión para especificar el nombre de servicio de base de datos deseado.
    • password: especifica la contraseña de usuario de la base de datos.
    • user: especifica el usuario de la base de datos.

    Por ejemplo:

    cs='''(description = (retry_count=20)(retry_delay=3)(address=(protocol=tcps)
     (port=1521)(host=xxx.oraclecloud.com))
     (connect_data=(service_name=xxx.adb.oraclecloud.com))
     (security=(ssl_server_dn_match=yes)))'''

connection=oracledb.connect(
     user="admin",
     password=password,
     dsn=cs)
  3. Si desea conectarse en modo grueso, incluya oracledb.init_oracle_client() en la aplicación Python.

    Por ejemplo:

    cs='''(description = (retry_count=20)(retry_delay=3)(address=(protocol=tcps)
     (port=1521)(host=xxx.oraclecloud.com))
     (connect_data=(service_name=xxx.adb.oraclecloud.com))
     (security=(ssl_server_dn_match=yes)))'''

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