Saltar al contenido

Configura un destino de base de datos Microsoft SQL en Jitterbit Design Studio

Esta página describe cómo configurar Microsoft SQL Server como origen o destino dentro de Jitterbit Studio usando autenticación de Windows o SQL Server. Consulta Base de datos para obtener información sobre los tipos de autenticación compatibles con varios sistemas.

Nota

Para la configuración de autenticación Kerberos, consulta Autenticación de SQL Server con Kerberos.

Autenticación de Windows

La autenticación de Windows se admite usando ODBC y JDBC solo en agentes privados y se puede usar con una única cuenta de dominio. Para usar autenticación de Windows, configura estas propiedades en Windows:

  1. Abre la herramienta Servicios Administrativos (Inicio > Herramientas administrativas > Servicios).
  2. Si usas ODBC, haz clic derecho en el servicio Jitterbit Apache Server y selecciona Propiedades. Si usas JDBC, haz clic derecho en el servicio Jitterbit Tomcat Server y selecciona Propiedades.
  3. Ve a la pestaña Sesión. Selecciona Esta cuenta e ingresa el nombre y las credenciales de la cuenta que deseas usar para la autenticación. Luego haz clic en Aplicar.
  4. Repite el proceso para el servicio Jitterbit Process Engine.
  5. Configura TempDir en el archivo de configuración del agente (jitterbit.conf) en C:\Windows\Temp\jitterbit.
  6. Reinicia los servicios de Jitterbit.

Precaución

Asegúrate de haber otorgado al usuario de dominio el privilegio de Iniciar sesión como servicio y Actuar como parte del sistema operativo. También asegúrate de que el usuario de dominio tenga derechos de lectura y escritura en el directorio de instalación de Jitterbit.

Nota

Una alternativa a los pasos anteriores 1 a 4 es otorgar a la cuenta que se usa en la máquina del agente privado permisos al SQL Server. El administrador de SQL Server puede hacerlo configurando la cuenta de la máquina del agente privado en Windows Active Directory (por ejemplo, <domainName>\<machineName>$).

Una vez completados los pasos anteriores, ve a Jitterbit Studio y configura tu origen o destino de forma normal. En la pantalla de definición del origen/destino de la base de datos en Parámetros de conexión, especifica lo siguiente:

  • Tipo de controlador: Selecciona ODBC o JDBC según corresponda.

    Importante

    La autenticación de Windows se admite con los siguientes controladores JDBC:

    Para usar autenticación de Windows con un controlador JDBC, copia un archivo DLL al agente, según el controlador que selecciones:

    • SQL Server jTDS: Copia el archivo ntlmauth.dll de la carpeta x64/SSO del paquete de descargas del proyecto jTDS a la carpeta C:\Program Files\Jitterbit Agent\jre\bin en el agente.

    • SQL Server MS JDBC o una versión más reciente del Microsoft JDBC Driver para SQL Server: Copia el archivo mssql-jdbc_auth-x.x.x.x64.dll incluido en el paquete de descargas del controlador a las carpetas C:\Program Files\Jitterbit Agent\jre\bin y C:\Program Files\Jitterbit Agent\jre\lib en el agente. La versión del DLL debe coincidir con la versión del archivo JDBC JAR incluido en el agente. Haz una copia de seguridad del archivo, ya que puede eliminarse durante actualizaciones importantes del agente.

  • Nombre del servidor: Ingresa el nombre o la dirección IP del servidor que ejecuta SQL Server al que Jitterbit necesita conectarse. Puede ser necesario especificar el nombre de instancia de SQL Server (NombreDelHost\NombreDeLaInstancia).

  • Nombre de la base de datos: Ingresa el nombre de la base de datos en el servidor con la que Jitterbit necesita integrarse.
  • Inicio de sesión: Deja este campo en blanco.
  • Contraseña: Deja este campo en blanco.

  • Opciones: Haz clic para expandir configuraciones adicionales. En el campo Parámetros adicionales de cadena de conexión, ingresa lo siguiente según tu controlador:

  • SQL Server [ODBC]: Si usas el driver "SQL Server [ODBC]", ingresa integratedSecurity=true. Si esto no funciona, ingresa Trusted_Connection=yes.

    • ODBC Driver 11 for SQL Server [ODBC], SQL Server Native Client 10.0 [ODBC], SQL Server Native Client 11.0 [ODBC]: Si usas otro driver de SQL Server, ingresa Trusted_Connection=yes.
    • SQL Server jTDS [JDBC]: Ingresa integratedSecurity=true.
    • SQL Server MS JDBC [JDBC]: Ingresa integratedSecurity=true;trustServerCertificate=true.

El driver se autenticará como el usuario del dominio de Windows especificado arriba.

Autenticación de SQL Server

Ve a Jitterbit Studio y configura tu origen o destino como de costumbre. En la pantalla de definición de origen/destino bajo Connection Parameters, especifica lo siguiente:

  • Driver: El driver de SQL Server puede ser un driver ODBC o JDBC.

    Nota

    Al seleccionar un driver JDBC, recomendamos usar "SQL Server MS JDBC [JDBC]," el driver JDBC de Microsoft para SQL Server, que se incluye con los agentes de Jitterbit a partir de la versión 9.3.

  • Server Name: Ingresa el nombre o la dirección IP del servidor que ejecuta SQL Server al que Jitterbit necesita conectarse. Es posible que tengas que especificar el nombre de la instancia de SQL Server (HostName\InstanceName).

  • Database Name: Ingresa el nombre de la base de datos en el servidor con la que Jitterbit necesita integrarse.

  • Login: Ingresa el nombre de usuario para la autenticación de SQL Server.

  • Password: Ingresa la contraseña para la autenticación de SQL Server.

El driver se autenticará usando las credenciales de autenticación de SQL Server especificadas.

Encriptación de conexión y certificados del servidor

Las versiones actuales del driver SQL Server MS JDBC solicitan una conexión encriptada de forma predeterminada (encrypt=true) y validan el certificado que presenta el servidor de base de datos. Si el driver no puede validar el certificado del servidor con el almacén de claves Java del agente, la conexión falla con un error similar a este:

"encrypt" property is set to "true" and "trustServerCertificate" property is set to "false" but the driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption: Error: (certificate_unknown) PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.

Esto afecta cualquier SQL Server cuyo certificado no pueda rastrearse hasta una autoridad de certificación (CA) que el agente ya confíe, incluyendo un certificado autofirmado o emitido internamente. Amazon RDS for SQL Server es un ejemplo: una instancia de RDS presenta un certificado emitido por una CA de Amazon RDS que no está en el almacén de claves predeterminado del agente. Una base de datos puede tener encriptación habilitada y un certificado válido instalado y aún así fallar en esta validación, porque el fallo es de confianza y no de encriptación.

La versión 12.8 del agente actualizó el driver JDBC de Microsoft SQL Server incluido. Microsoft cambió el valor predeterminado de encrypt de false a true en la versión 10.2 del driver y documenta ese cambio como uno que rompe la compatibilidad, descrito bajo encrypt en Set the connection properties en la documentación de Microsoft. Un destino que funcionaba en un agente anterior a 12.8 puede comenzar a fallar después de la actualización.

Para resolver esto, expande Options e ingresa encrypt=false; en el campo Additional Connection String Parameters, o inclúyelo en la cadena de conexión si seleccionaste Construct connection string manually. Esto funciona en agentes en la nube y privados.

Advertencia

Con encrypt=false, los datos viajan entre el agente y la base de datos sin encriptar. Usa esta opción solo donde sea aceptable para los datos y la ruta de red involucrada.

Tu configuración de SQL Server también puede requerir otras propiedades de conexión. Para las propiedades que admite el driver, consulta Set the connection properties en la documentación de Microsoft.