Diferencias

Muestra las diferencias entre dos versiones de la página.

--- aspectos-tecnicos:webapi:antarepocketserver [2026/09/14 17:03] – antarex
+++ aspectos-tecnicos:webapi:antarepocketserver [2026/09/15 03:28] (actual) – antarex
@@ Línea 28: / Línea 28: @@
 Al descargar la aplicación desde [[https://play.google.com/store/apps/details?id=net.antare.maui.antarepocket&hl=es_VE|Google Play Store]], se tiene la opción de utilizarla accediendo a la base de datos de demostración previamente configurada en la nube.
-==== Antare en el Navegador ====
+==== Antare Web ====
-**Antare en el Navegador** (nombre temporal), es una aplicación Web en desarrollo, que tiene como objetivo proporcionar al usuario al menos la mayoria de las funciones actualmente disponibles en la aplicación de escritorio **Antare** (Facturación, Inventario, Caja, etc).
+**Antare Web** (nombre temporal), es una aplicación Web en desarrollo, que tiene como objetivo proporcionar al usuario al menos la mayoria de las funciones actualmente disponibles en la aplicación de escritorio **Antare** (Facturación, Inventario, Caja, etc).
 Se accede abriendo la URL https://app.servidorantare.lan desde cualquier navegador moderno (Chrome, Edge, etc) y se adaptará a cualquier tamaño de pantalla.
@@ Línea 36: / Línea 36: @@
 {{:aspectos-tecnicos:webapi:antareennavegador.png?600|}}
-Al igual que con **Antare Pocket**, **Antare en el Navegador** conecta con **Antare Pocket Server** previa autenticación y autorización proporcionada por **Antare Identity Server**, para realizar transacciones hacia la Base de Datos SQL Server de **Antare** bajo las reglas y contratos establecidos en la API REST que **Antare Pocket Server** expone.
+Al igual que con **Antare Pocket**, **Antare Web** conecta con **Antare Pocket Server** previa autenticación y autorización proporcionada por **Antare Identity Server**, para realizar transacciones hacia la Base de Datos SQL Server de **Antare** bajo las reglas y contratos establecidos en la API REST que **Antare Pocket Server** expone.
 ==== Gestor de Usuarios Antare ====
-**Gestor de Usuarios Antare** es una aplicación Web que permite gestionar cuentas de usuario para vincular con ellas los dispositivos con **Antare Pocket** y el acceso hacia **Antare en el Navegador**
+**Gestor de Usuarios Antare** es una aplicación Web que permite gestionar cuentas de usuario para vincular con ellas los dispositivos con **Antare Pocket** y el acceso de usuarios a **Antare Web**
 Esta aplicación Web se accede mediante la URL https://usuarios.servidorantare.lan, Los usuarios que se registran mediante esta aplicación se identifican unicamente a través de su dirección email.
@@ Línea 52: / Línea 52: @@
 ==== Antare Identity Server ====
-**Antare Identity Server** es una implementación de [[https://docs.identityserver.com/openidentityserver/|Identity Server]] enfocada a los requerimientos de **Antare Pocket Services**. Es una aplicación Web normalmente hospedada en la característica de Windows **Microsoft Internet Information Services (IIS)** que se encarga por una parte de autenticar y proporcionar credenciales de acceso a las aplicaciones **Antare Pocket** y **Antare Web**
+**Antare Identity Server** es una implementación de [[https://docs.identityserver.com/openidentityserver/|Identity Server]] enfocada a los requerimientos de **Antare Pocket Services**. Es una aplicación Web normalmente hospedada en la característica de Windows **Microsoft Internet Information Services (IIS)** que se encarga por una parte de autenticar y proporcionar credenciales de acceso a las aplicaciones **Antare Pocket** y **Antare Web**, y por otra parte, mantener un registro de cuentas de usuarios que forman parte de este ecosistema, identificados por su dirección email, registro accesible desde https://usuarios.servidorantare.lan
+Al traer consigo todo lo que ofrece [[https://docs.identityserver.com/openidentityserver/|Identity Server]], es posible configurar **Antare Identity Server** para delegar la autenticación de usuarios a servicios externos como Google OpenId, o Cuentas de Microsoft cuando se hospeda en VPS con dominios FQDN registrados.
+Estando el usuario correctamente autenticado y con una dirección email que concide con su ficha en Antare, **Antare Pocket Server** tendrá siempre la información suficiente que le permita otorgarle acceso a los recursos que este usuario tiene derecho, según los permisos establecidos.
+En resumen, todo lo que tiene que ver con identificar correctamente a cada usuario de la plataforma, (Nombre y Grupo o rango al que pertenece) para posteriormente saber a qué funciones de **Antare** tiene no tiene acceso, queda a cargo de **Antare Identity Server**
+==== Antare Pocket Server ====
+**Antare Pocket Server** es una aplicación Web que también se hospeda en una instancia de **Microsoft Internet Information Services (IIS)** y contiene toda la lógica de negocios que se va migrando progresivamente desde la aplicación de escritorio clásico **Antare** encapsulada en un núcleo, hacia el cual se conectan las aplicaciones cliente como **Antare Pocket** o **Antare Web** únicamente a través de la API que este expone.
+**Antare Pocket Server** es el único componente de este ecosistema (aparte de la aplicación de escritorio Windows) con conexión directa a la Base de Datos SQL, dando a entender que toda transacción o modificación a ésta, normalmente se lleva a cabo a través de estos dos componentes, segun las reglas de negocio establecidas (Procesos de facturación, inventario, Caja, etc).
+**Antare Pocket Server** también sirve a los navegadores que conectan a https://app.servidorantare.lan los correspondientes binarios y código html que forman parte de la aplicación **Antare Web**.
+===== Proceso de Instalación =====
+Una vez que se tenga instalada y configurada la aplicación de escritorio **Antare** accediendo a la correspondiente Base de Datos SQL debidamente inicializada (es decir, con la Empresa ya definida en la misma) en el servidor:
+. Se fija la IP del mismo, preferiblemente a una que esté fuera del Pool DHCP del router.
+. Se asegura de que el Firewall de Windows en el equipo tenga el perfil de Red Privada
+. Se ejecutan uno tras otro y en el siguiente orden los siguientes instaladores:
+==== Aplicaciones antiguas instaladas manualmente ====
+Si previamente ha copiado en el equipo y configurado manualmente Certificados e IIS para albergar versiones antiguas de las aplicaciones siguiendo el viejo manual y desea migrar a los nuevo instaladores, es recomendable que:
+  - Elimine desde IIS los sitios App y Usuarios, asi como sus correspondientes Pool de Aplicaciones llamadas igual que los sitios.\\ \\
+  - Borre la carpeta AntarePocketServer\\ \\
+  - Despues de haber aplicado los nuevos instaladores (vease seccióm siguiente), entrar con calma a https://usuarios.servidorantare.lan y recree manualmente las cuentas de usuario.
+==== Instalar Antare Identity Server ====
+El instalador de Antare Identity Server está disponible en este [[https://www.antare.net/descargas/IAntareIdentityServer.exe|enlace permanente]]
+Al ejecutar el instalador, ocurren los siguientes pasos en forma de asistente:
+  - Chequea la presencia de Internet Information Services (IIS) en el equipo. En caso de no detectarlo se interrumpe la instalación para guiar al usuario a activarlo.\\ \\
+  - Detecta si la aplicación fue o no fué previamente instalada para ejecutar la instalación desde cero o actualizar los archivos existentes.\\ \\
+  - Si la aplicación se instala desde cero, definir los parámetros del Servidor SQL instalado en el equipo para preparar una nueva base de datos llamada AntareIdentitySQL (u otro nombre que defina el usuario). Estos parámetros son validados por el instalador antes de continuar.\\ \\
+  - Descarga e instala la versión más reciente de Microsoft Asp.Net Core Hosting Bundle\\ \\
+  - Detiene el servicio IIS (w3svc)\\ \\
+  - Copia los archivos de la aplicación hacia la ruta ''C:\AntarePocketServer\Usuarios'', creando las carpetas si es necesario.\\ \\
+  - Crea e inicializa una nueva Base de Datos AntareIdentitySQL, o actualiza la existente si es el caso.\\ \\
+  - Configura la cadena de certificados privados CA de Antare Systems y servidorantare.lan\\ \\
+  - Configura en IIS el sitio Web denominado **Usuarios** con su correspondiente Pool de Aplicaciones, llamado también **Usuarios** y vinculandolo al certificado SSL servidorantare.lan\\ \\
+  - Levanta nuevamente el servicio IIS (w3svc)\\ \\
+  - Agrega o actualiza una entrada al archivo ''hosts'' de Windows para vincular la App a la dirección https://usuarios.servidorantare.lan\\ \\
+  - Abre en el navegador predeterminado de Windows (Edge, Chrome) la página https://usuarios.servidorantare.lan
+Una vez abierta la página. entrar como def@amtare.net para constatar el funcionamiento del sitio.
+==== Instalar Antare Pocket Server ====
+El instalador de Antare Pocket Server está disponible en este [[https://www.antare.net/descargas/IAntarePocketServer.exe|enlace permanente]]
+Al ejecutar el instalador, ocurren los siguientes pasos en forma de asistente:
+  - Chequea la presencia de Internet Information Services (IIS) en el equipo. En caso de no detectarlo se interrumpe la instalación para guiar al usuario a activarlo.\\ \\
+  - Detecta si la aplicación fue o no fué previamente instalada para ejecutar la instalación desde cero o actualizar los archivos existentes.\\ \\
+  - Si la aplicación se instala desde cero, definir los parámetros del Servidor SQL instalado en el equipo para seleccionar la Base de Datos Antare activa. (Generalmente llamada AntareSystemsSQL) a la que la aplicación tendrá acceso. Estos parámetros son validados por el instalador antes de continuar.\\ \\
+  - Descarga e instala la versión más reciente de Microsoft Asp.Net Core Hosting Bundle\\ \\
+  - Detiene el servicio IIS (w3svc)\\ \\
+  - Copia los archivos de la aplicación hacia la ruta ''C:\AntarePocketServer\App'', creando las carpetas si es necesario.\\ \\
+  - Configura la cadena de certificados privados CA de Antare Systems y servidorantare.lan\\ \\
+  - Configura en IIS el sitio Web denominado **App** con su correspondiente Pool de Aplicaciones, llamado también **App** y vinculandolo al certificado SSL servidorantare.lan\\ \\
+  - Levanta nuevamente el servicio IIS (w3svc)\\ \\
+  - Agrega o actualiza una entrada al archivo ''hosts'' de Windows para vincular la App a la dirección https://app.servidorantare.lan\\ \\
+  - Abre en el navegador predeterminado de Windows (Edge, Chrome) la página https://app.servidorantare.lan
+===== Instalación de componentes de Apoyo =====
+Para el correcto funcionamiento de los Servicios de Antare Pocket en todos los equipos de la red del establecimiento, se precisa que en todos ellos se reconozca efectivamente los dominios locales https://app.servidorantare.lan o https://usuarios.servidorantare.lan y que estos traduzcan o apunten efectivamente a la dirección IP del servidor, donde **Antare Pocket/Identity Server** están esperando las conexiones entrantes.
+Este propósito