Conexión y Autenticación

Agregue uno o más servidores Odoo, elija cómo autenticarse y, si desea, proteger el acceso con la biometría de su dispositivo Android. Las credenciales nunca se guardan en texto claro: siempre permanecen cifradas en el hardware del teléfono o la tableta.

Descripción General

Antes de utilizar cualquier función de SiltaFlow debe conectar la aplicación a su servidor Odoo. La configuración se llama "perfil de conexión" y contiene todo lo que necesita: la dirección del servidor, el nombre de la base de datos, su usuario y sus credenciales de inicio de sesión.

Puedes crear tantos perfiles como quieras: uno para producción, uno para el entorno de prueba, uno para cada cliente o sucursal. Cambiar entre perfiles requiere solo un toque y la aplicación siempre recuerda cuál está activo para que nunca trabajes en el servidor equivocado por error.

Cuando lo inicia por primera vez, SiltaFlow lo lleva directamente a la pantalla para agregar su primer perfil. Después de guardarla, la aplicación está lista para usar.

Crear un perfil de conexión

Vaya a Configuración > Conexiones y toque el botón "+" en la parte superior derecha. El formulario de configuración se abre con los siguientes campos:

campo Descripción Ejemplo
Nombre del perfil Una etiqueta descriptiva para reconocer el perfil en la lista. Produzione – Acme S.p.A.
URL del servidor Dirección completa de la instancia Odoo, con protocolo y puerto si es diferente a 443/80 https://mioserver.com:8069
Bases de datos Nombre de la base de datos Odoo (visible en la página de inicio de sesión web de Odoo) mydb_prod
Nombre de usuario/correo electrónico La dirección de correo electrónico que utiliza normalmente para acceder a Odoo mario@azienda.it
Autenticación. modo Nombre de usuario+Contraseña o clave API (consulte la siguiente sección) Nombre de usuario + Contraseña
Contraseña/Clave API La contraseña Odoo o la clave API generada por el panel de usuario Cifrado: no visible después de guardar

Después de completar todos los campos, toque Guardar. SiltaFlow ejecuta automáticamente una prueba de conexión para verificar que la dirección, base de datos y credenciales sean correctas. Si la prueba tiene éxito, el perfil se guarda y se establece como activo; en caso de error, se muestra un mensaje indicando el problema específico.

Elija nombres de perfil claros y únicos, como "Producción – Sede de Milán" o "Puesta en escena – Sprint 42". Durante operaciones urgentes, el nombre del perfil activo es su única defensa contra trabajar accidentalmente en la base de datos incorrecta.

Modo de autenticación

SiltaFlow admite dos formas diferentes de autenticarse en Odoo. La elección no afecta a las funciones disponibles: ambas dan acceso completo a todas las funciones de la aplicación.

Nombre de usuario + Contraseña

El modo clásico: ingresa el mismo correo electrónico y contraseña que utilizas en tu navegador para acceder a Odoo. Compatible con todas las versiones Odoo a partir de la 12. La contraseña se cifra inmediatamente y nunca se guarda en texto claro en el dispositivo.

API Key

Una alternativa más segura a la contraseña: en lugar de sus credenciales de inicio de sesión, utiliza una clave especial generada por el panel de usuario Odoo. Esta clave se puede revocar en cualquier momento sin cambiar la contraseña de su cuenta.

Si el dispositivo es utilizado por varias personas o se deja desatendido, utilice el modo de clave API. Si pierde su teléfono, puede bloquear el acceso a Odoo simplemente revocando la clave desde el navegador, sin cambiar su contraseña.

Cómo generar una clave API en Odoo

  1. Inicie sesión en Odoo con su cuenta desde su navegador
  2. Abra el menú Configuración
  3. En el menú lateral, vaya a Claves API técnicas › (es posible que necesite habilitar el modo desarrollador o buscarlo en el menú de usuario en la parte superior derecha desde Odoo v16)
  4. Haga clic en Nuevo, asigne un nombre descriptivo, por ejemplo "SiltaFlow – Tableta de almacén", y establezca una fecha de vencimiento si su póliza así lo requiere.
  5. Confirmar: la clave <strong> se muestra una sola vez </strong>. Cópialo ahora.
  6. Pegue la clave en el campo Clave API del perfil SiltaFlow y seleccione el modo Clave API

Odoo muestra la clave API completa solo una vez, al momento de su creación. Si lo pierde antes de guardarlo en su perfil, deberá revocarlo y crear uno nuevo. SiltaFlow lo cifra y lo almacena de forma segura en el hardware de su dispositivo tan pronto como lo inserta.

Comparación entre modalidades

Característica Nombre de usuario + Contraseña API Key
Versión Odoo mínima v12+ v14+
Se requiere configuración del servidor Ninguno Generar la clave desde el panel de usuario
Contraseña maestra expuesta Guardado cifrado en su dispositivo No, la contraseña nunca se utiliza
Revocar el acceso selectivo Requiere cambio de contraseña Revocar clave única desde Odoo
Adecuado para dispositivos compartidos Con precauciones Recomendado
Funciones SiltaFlow disponibles todos ellos todos ellos

Gestión de perfiles

Todos los perfiles configurados son visibles en Configuración › Conexiones. El perfil activo se resalta con un borde de color y un punto verde animado. Los perfiles inactivos se enumeran a continuación con un punto gris.

Cambiar perfil activo

Toque el botón Activar junto a cualquier perfil inactivo para cambiar a él. El cambio se produce en un instante: la aplicación actualiza la conexión activa localmente y muestra una notificación de confirmación. Los errores de red (servidor inaccesible, credenciales caducadas) solo se informarán en la primera operación real en el nuevo perfil.

Antes de confirmar transferencias, recepciones o cualquier operación irreversible, consulta siempre en Ajustes › Conexiones qué perfil está activo. Un segundo de atención puede evitar horas de correcciones en la base de datos equivocada.

Desconectar (Cerrar sesión)

Toque Cerrar sesión en el perfil activo para cerrar sesión. La aplicación siempre muestra un diálogo de confirmación para evitar desconexiones accidentales. Al cerrar sesión se desactiva tu perfil pero no se eliminan tus credenciales: puedes volver a conectarte en cualquier momento tocando Activar.

Editar o eliminar un perfil

Toque Editar para actualizar la información de un perfil (por ejemplo, para cambiar su contraseña o actualizar una clave API vencida). Toque Eliminar para eliminar permanentemente un perfil: esto también elimina las credenciales del hardware del dispositivo y no es reversible.

Elimine los perfiles que ya no utilice (clientes cancelados, servidores fuera de servicio). Además de mantener tu lista ordenada, eliminarla borra de forma segura tus credenciales, lo que reduce el riesgo si pierdes tu dispositivo.

Cómo se protegen las credenciales

La contraseña y la clave API nunca se escriben en texto plano en el dispositivo. Tan pronto como los ingresas en el módulo de configuración, SiltaFlow los cifra con AES-256 usando una clave almacenada en el hardware del teléfono (Android Keystore). Esta clave está vinculada al dispositivo específico: incluso si alguien extrajera la base de datos de la aplicación, las credenciales cifradas no se podrían utilizar en ningún otro dispositivo.

Durante el uso de la aplicación, las credenciales son descifradas en memoria sólo por el tiempo necesario para realizar la llamada a Odoo, luego son descartadas. Nunca terminan en archivos de registro o archivos temporales.

Las credenciales cifradas están vinculadas al hardware del dispositivo. Si reinicia su teléfono o cambia a un nuevo dispositivo, deberá volver a ingresar contraseñas o claves API para todos los perfiles. Sin embargo, los datos del perfil (nombre, URL, base de datos, usuario) se conservan.

Autenticación biométrica

Si su dispositivo Android tiene un sensor de huellas dactilares (o reconocimiento facial), puede habilitar el desbloqueo biométrico para proteger el acceso a las conexiones guardadas. Cada vez que seleccionas un perfil para conectarte, la aplicación solicita confirmación con el sensor antes de continuar.

La biometría no reemplaza las credenciales Odoo; las protege localmente. Evita que cualquier persona que levante su teléfono pueda conectarse a su Odoo incluso si la conexión ya está configurada en la aplicación.

Cómo activar la biometría

  1. Vaya a Configuración>Conexiones
  2. Habilite el interruptor de desbloqueo biométrico (visible solo si el dispositivo tiene al menos una huella digital registrada)
  3. El sistema muestra inmediatamente una solicitud de confirmación biométrica para verificar que usted es el propietario del dispositivo.
  4. A partir de ahora, cada acceso a una conexión guardada requerirá verificación con el sensor

La función biométrica requiere Android 10 o posterior (API 29+) y al menos una huella digital registrada en la configuración de Android. Si el dispositivo no cumple con estos requisitos, el interruptor no aparece.

Cómo funciona el desbloqueo

Cuando tocas un perfil para conectarte, aparece el cuadro de diálogo de desbloqueo del sistema operativo Android, el mismo que usas para desbloquear tu teléfono. Coloque su pulgar sobre el sensor: si el reconocimiento es exitoso, SiltaFlow lee las credenciales y completa el inicio de sesión en Odoo en unos momentos.

Si el sensor no te reconoce (por ejemplo porque tienes los dedos mojados o llevas guantes), después de tres intentos la aplicación ofrece automáticamente la alternativa Usar PIN, que utiliza el PIN de desbloqueo del dispositivo.

Registre al menos dos dedos en la configuración de Android (por ejemplo, el pulgar derecho y el índice izquierdo). En el almacén, con guantes de una sola mano o pequeños cortes, tener una alternativa evita que te quedes fuera de la aplicación mientras trabajas.

Limitaciones a tener en cuenta

Escenarios de uso comunes

Entorno de producción y prueba.

Configure dos perfiles: uno para el servidor de producción y otro para el ensayo. Antes de aplicar nuevos procedimientos en la base de datos real, cambie al perfil de prueba con un solo toque, realice verificaciones y luego regrese a producción. El punto verde en la lista siempre te recuerda en qué servidor estás trabajando.

Consultor con múltiples clientes.

Agregue un perfil para cada cliente utilizando una clave API dedicada. Cuando vas a la oficina de un cliente, activas su perfil en dos segundos. Si deja de seguir a un cliente, su acceso será revocado directamente desde Odoo sin tocar la aplicación.

Dispositivo compartido en almacén

En una tableta utilizada por varios operadores en turnos, cada persona puede tener su propio perfil de nombre. En el cambio de turno, quien termina cierra sesión (con un diálogo de confirmación para evitar toques accidentales) y quien comienza activa su perfil. Con la biometría habilitada, cada inicio de sesión requiere la verificación del operador correcto.

Problemas comunes y soluciones.

Si falla la prueba de conexión o el acceso a Odoo, verifique estos puntos en el orden indicado:

  1. Conexión de red — ¿Está el dispositivo conectado a la red correcta? ¿La VPN de la empresa está activa para los servidores locales?
  2. URL del servidor — Verifique que no haya una barra diagonal al final, que el puerto sea correcto y que el protocolo (http o https) coincida con la configuración del servidor.
  3. Nombre de la base de datos — El nombre distingue entre mayúsculas y minúsculas en algunos sistemas. Compruébelo en Odoo desde Configuración › Técnico › Base de datos.
  4. Credenciales caducadas — Si utiliza una clave API, verifique que no haya caducado ni haya sido revocada desde el panel Odoo.
  5. Servidor en mantenimiento — Abra la misma URL desde el navegador de su dispositivo para confirmar que se puede acceder a Odoo.
  6. Certificado SSL — En servidores con certificados autofirmados, es posible que deba agregar el certificado como confiable en la configuración de Android.

Requisitos