Personalizar el archivo de configuración
Configuración de la aplicación dab Nexus
Esta es la configuración para guardar los datos de la aplicación. No se trata de la configuración de los datos SAP ni de los resultados.
- Vaya al directorio DAB_NEXUS_HOME: la ruta predeterminada es C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\dabGmbH\Nexus
- Abra el archivo Configuration.json con un editor de texto (por ejemplo, Notepad)
- Defina la Connection String para el servidor SQL utilizado por dab Nexus para almacenar datos de la aplicación e información meta. Puede ser el mismo servidor SQL que más adelante se utilice para guardar los datos SAP y los resultados. Dependiendo del tipo de autenticación, utilice una de las siguientes plantillas para la Connection String.
Autenticación de Windows
"ConnectionStrings": {
"ApplicationDatabase": "Server=YourSQLServer;Database=YourDatabase;Trusted_Connection=True;MultipleActiveResultSets=true"
}
Autenticación de SQL-server
"ConnectionStrings": {
"ApplicationDatabase": "Server=YourSQLServer;Database=YourDatabase;UserId=myUsername;Password=myPassword;MultipleActiveResultSets=true"
}
Cargar certificados
Un certificado se puede cargar desde un archivo o desde un almacén de certificados de Windows. Según la variante que elija, los parámetros en el Configuration.json deben ajustarse de manera correspondiente.
- Archivo: en este caso, debe ingresar el valor File en el parámetro CertificateStore
- Almacén de certificados de Windows: aquí se debe especificar la huella digital (fingerprint/thumbprint) del certificado en las propiedades
Cargar certificado desde archivo
"CertificateStore": "File",
"CertificatePassword": "<Configure>",
Cargar certificado desde el almacén de certificados de Windows
"CertificateStore": "LocalMachine",
"CertificateFingerprint": "<Configure>",
Después de realizar las modificaciones en el Configuration.json, haga clic en Guardar y reinicie el servicio dab Nexus.
Cambiar el certificado del almacén de certificados de Windows
Si se debe cambiar el Certificado (por ejemplo, con un nuevo periodo de validez), se debe cambiar manualmente el CertificateFingerprint en el Configuration.json.
Realice los siguientes pasos cuando cambie el Certificado:
- Detenga el servicio de Windows para dab Nexus (puede encontrar más información en este artículo. Seleccione el servicio de Windows y haga clic en Detener en el lado izquierdo)
- Abra el Configuration.json
- El valor del campo CertificateFingerprint debe cambiarse a la nueva huella digital (fingerprint/thumbprint)
- Guarde el Configuration.json
- Reinicie el servicio de Windows para dab Nexus (puede encontrar más información en este artículo)
Más opciones posibles de configuración
| Opción | Descripción | Valores posibles (por defecto en negrita) | Ejemplo |
|---|---|---|---|
| ConnectionStrings / PrimaryDatabase ConnectionStrings / ApplicationDatabase (desde 1.12) | Conexión a la base de datos de la aplicación Nota Para conectar a una instancia nombrada, debe insertar dos barras invertidas entre el nombre del servidor y la instancia: por ejemplo, SERVER\yourINSTANCE | "ConnectionStrings": { "PrimaryDatabase": "Server=..." } | |
| ApplicationURL | URL donde se puede acceder a dab Nexus | "ApplicationUrl": "https://localhost/" | |
| RedirectHttp | Solo surte efecto si el protocolo del ApplicationUrl es HTTPS. Si está habilitado, las solicitudes HTTP serán redirigidas a HTTPS. El puerto predeterminado utilizado para la redirección es 80. | true false | "RedirectHttp": true |
| RedirectHttpPort | Solo surte efecto si RedirectHttp está habilitado. | "RedirectHttpPort": 80 | |
| EnableHsts | Si está habilitado, dab Nexus enviará la cabecera Strict-Transport-Security, que indica a los navegadores utilizar automáticamente HTTPS para futuras conexiones después de haber establecido una conexión HTTPS exitosa por primera vez. Los navegadores recordarán esta configuración durante 8 horas. | true false | "EnableHsts": true |
| CertificateStore | Ubicación donde se almacena el certificado SSL/TLS | File CurrentUser LocalMachine | "CertificateStore": "LocalMachine" |
| CertificatePassword | Solo surte efecto si CertificateStore es File La contraseña para el archivo Certificate.pfx. | "CertificateStore": "MySecurePassword" | |
| CertificateFinterprint | Solo surte efecto si CertificateStore es CurrentUser o LocalMachine | "CertificateFingerprint": "673ad021431f66c71d901ffc791959a2b5c9ce79" | |
| LicenseServerUrl | El servidor que dab Nexus utilizará para las comprobaciones de licencia. | "LicenseServerUrl": "https://aresbackendapi.azurewebsites.net/nexus/activation" | |
| AuthMode | Cómo los usuarios iniciarán sesión en dab Nexus. Con BuiltIn, cada usuario utiliza una dirección de correo electrónico y contraseña para iniciar sesión. Con SAML, la autenticación la gestiona un Proveedor de Identidad, por ejemplo, Azure Active Directory. Con SAML, se deben completar SAML / Issuer y SAML / IdentityProviderMetadataUrl o SAML / IdentityProviderMetadataFile. | SAML BuiltIn | "AuthMode": "SAML" |
| SAML / Issuer | Requerido si AuthMode es SAML Nombre de la aplicación tal como está configurado en el Proveedor de Identidad. | "SAML": {"Issuer": "dab Nexus"} | |
| SAML / IdentityProviderMetadataUrl | Solo surte efecto si AuthMode es SAML URL donde se puede encontrar la Metadata del Proveedor de Identidad. Esta URL debe ser accesible para dab Nexus. | "SAML": {"IdentityProviderMetadataUrl": "https://login.microsoftonline.com/..."} | |
| SAML / IdentityProviderMetadataFile | Solo surte efecto si AuthMode es SAML Nombre de un archivo XML que contiene la Metadata del Proveedor de Identidad. Este archivo debe colocarse en el directorio DAB_NEXUS_HOME. | "SAML": {"IdentityProviderMetadataFile": "IdPMetadata.xml"} | |
| TransitionToBuiltInAuth | Solo surte efecto si AuthMode es SAML Si está habilitado, los usuarios podrán cambiar sus contraseñas incluso si se utiliza Single Sign-On. Esta opción está destinada a ser utilizada cuando se desea cambiar de autenticación SAML a BuiltIn. | true false | "TransitionToBuiltInAuth": false |
Problemas de inicio debido a la personalización insuficiente del archivo de configuración
Error con el certificado SSL al intentar iniciar el servicio de Windows de Nexus
Si después de personalizar el archivo de configuración reinicia el servicio de Windows de dab Nexus y este reinicio falla, la causa puede ser la siguiente:
Mensaje: Se estableció correctamente una conexión con el servidor, pero luego se produjo un error durante el proceso de inicio de sesión. (proveedor: SSL Provider, error: 0 - El nombre principal de destino es incorrecto).
Solución: Agregue el código ;Encrypt=True;Trust Server Certificate=True en la sección Connection Strings > ApplicationDatabase entre MultipleActiveResultSets=true y ", de modo que quede como el siguiente código:
Nota: Este es el usuario que ejecuta el servicio dab Nexus.
"ConnectionStrings": {
"ApplicationDatabase": "Server=YourSQLServer;Database=YourDatabase;Trusted_Connection=True;MultipleActiveResultSets=true;Encrypt=True;Trust Server Certificate=True"
}
Guarde el archivo de configuración y luego reinicie el servicio de Windows de dab Nexus.