Conexión a Node.js y otros idiomas de creación de scripts (mTLS)

Puede utilizar programas en diferentes lenguajes, incluidos Python, Node.js, PHP, Ruby, R, Go y Perl para conectarse a una instancia de Autonomous Database mediante mTLS (con carteras) La seguridad se aplica mediante credenciales de cliente.

Estos idiomas de creación de scripts tienen controladores o API de acceso a base de datos que utilizan las bibliotecas de Oracle Call Interface.

Nota

Los clientes de Oracle Call Interface (OCI) soportan la autenticación mTLS con una cartera si se conecta mediante las siguientes versiones de cliente:
  • Oracle Instant Client/Oracle Database Client: 18.19 (o posterior), 19.2 (o posterior) o 21 (versión base o posterior).

Para obtener información sobre la conexión de Node.js u otros idiomas de script sin una cartera, consulte Conexión de Node.js y otros idiomas de script sin una cartera.

Para obtener más información, consulte el siguiente vídeo:

Instalación del controlador de lenguaje y las bibliotecas de cliente

Para conectarse a Autonomous Database desde el lenguaje de creación de scripts, primero instale el controlador de lenguaje y las bibliotecas de cliente de la siguiente manera:

  1. Instale Oracle Instant Client/Oracle Database Client: 18.19 (o posterior), 19.2 (o posterior) o 21 (versión base o posterior).

    Instant Client funciona correctamente para la mayoría de las aplicaciones. Para instalar Instant Client, haga lo siguiente:

    1. Seleccione la arquitectura que desee en la página Instant Client Downloads y descargue un paquete básico (disponible en la página de descarga): Descargas de Oracle Instant Client.

      Como alternativa, descargue el paquete Basic Light de la página de descarga para la arquitectura deseada si las limitaciones de globalización de Basic Light se adecuan a su uso.

    2. Si va a crear una API o un controlador de lenguaje a partir del código fuente, puede que también necesite descargar el SDK de Instant Client: Oracle Instant Client

    3. Descomprima el paquete base que ha seleccionado. Por ejemplo, descomprímalo en C:\instantclient_12_2 o /home/myuser/instantclient_18_5. Si también descarga el SDK, descomprímalo en el mismo directorio.

    4. En Windows, agregue la ruta a la variable PATH en la sección "Variables del sistema" del panel Variables de entorno (por ejemplo, agregue C:\instantclient_12_2). En Windows 8, acceda al área de configuración de la variable PATH desplazándose hasta Panel de control>Sistema>Configuración avanzada del sistema>Variables de entorno. Si tiene instaladas varias versiones de bibliotecas de Oracle, asegúrese de que el nuevo directorio aparezca en primer lugar en la ruta.

    5. En plataformas que no sean Windows, cree un enlace simbólico si no existe. Por ejemplo:

      cd /home/myuser/instantclient_18_5
      ln -s libclntsh.so.18.1 libclntsh.so

      Si no hay ningún otro software de Oracle en el sistema que se vea afectado, agregue Instant Client a la ruta del enlace de tiempo de ejecución. Por ejemplo:

      sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
      sudo ldconfig
      

      También puede definir la ruta de la biblioteca en cada shell que ejecute la aplicación. Por ejemplo:

      export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH
      Nota

      Los archivos de descarga de Linux Instant Client están disponibles como archivos .zip o archivos .rpm. Puede utilizar cualquiera de las versiones.
  2. Instale el controlador de lenguaje correspondiente para Oracle Database:

Activación de la conectividad de la red de Oracle y obtención de las credenciales de seguridad (Oracle Wallet)

  1. Obtenga credenciales de seguridad de cliente para conectarse a Autonomous Database. Debe obtener un archivo zip que contiene las credenciales de seguridad del cliente y los valores de configuración de red necesarios para acceder a su base de datos . Debe proteger este archivo y su contenido para evitar el acceso no autorizado a la base de datos. Obtenga el archivo de credenciales de seguridad del cliente de la siguiente manera:

    • Usuario ADMIN: haga clic en Conexión de base de datos. Consulte Download Client Credentials (Wallets).

    • Otro usuario (no administrador): obtenga Oracle Wallet del administrador para su instancia de Autonomous Database.

  2. Extraiga los archivos de credenciales de cliente (cartera):

    1. Descomprima el archivo zip de credenciales de cliente.

    2. Si va a utilizar Instant Client, cree la jerarquía de subdirectorio network/admin en el directorio Instant Client si es necesario. A continuación, mueva los archivos a este subdirectorio. Por ejemplo, en función de la arquitectura o el sistema cliente y de dónde haya instalado Instant Client, los archivos deben estar en el directorio:

      C:\instantclient_12_2\network\admin

      o

      /home/myuser/instantclient_18_5/network/admin

      o

      /usr/lib/oracle/18.5/client64/lib/network/admin
      • Si va a utilizar Oracle Client completo, mueva el archivo a $ORACLE_HOME/network/admin.

    3. También puede colocar los archivos de cartera descomprimidos en un directorio seguro y definir la variable de entorno TNS_ADMIN en ese nombre de directorio.

    Nota

    En el archivo zip, solo se necesitan estos archivos: tnsnames.ora, sqlnet.ora, cwallet.sso y ewallet.p12.
  3. Si está protegido por un proxy, siga los pasos de "Conexiones con un proxy HTTP", en Preparación para conexiones de Oracle Call Interface, ODBC y JDBC OCI con carteras (mTLS).

Run Your Application

  1. Actualice la aplicación para conectarse mediante el nombre de usuario de la base de datos, la contraseña y el nombre de conexión de red de Oracle proporcionado en el archivo tnsnames.ora descomprimido. Por ejemplo, usuario, adb_user, contraseña y db2022adb_low como cadena de conexión.

  2. También puede cambiar la cadena de conexión en tnsnames.ora para que coincida con la cadena que utiliza la aplicación.

  3. Run your application.