Wiki

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.
====== Instalación y Configuración de Antare Pocket Services ======

El ecosistema Antare, además de su aplicación principal de escritorio, consiste también en una aplicación que se ejecuta en dispositivos móviles Android llamada [[https://play.google.com/store/apps/details?id=net.antare.maui.antarepocket&hl=es_VE|Antare Pocket]], y otra, en desarrollo, que es albergada en navegadores web como Chrome. Asi como una interfaz API REST, la cual se prevee para futuros desarrollos y conexión con aplicaciones de terceros, tales como sitios de e-Commerce etc.

El objetivo de estas aplicaciones es extender las capacidades de Antare mas allá del entorno Windows a escenarios donde se requiere movilidad y acceso desde fuera de la red. Tales como tomas de pedido en el sitio, arqueos de inventario, fotografías de productos, etc.

Este artículo tiene como objetivo el adiestramiento al personal técnico o integrador en la instalación y configuración de estas aplicaciones en un servidor que ya tiene la aplicación de escritorio **Antare** previamente instalada y operativa.

===== Componentes de Antare Pocket Services =====

El siguiente diagrama proporciona una visualización de los componentes de **Antare Pocket Services** y su interacción con otros elementos:

{{:aspectos-tecnicos:webapi:diagramaantarepocketserver.png|}}

===== Componentes del Lado Cliente =====

==== Antare Pocket ====

**Antare Pocket** es una aplicación actualmente desarrollada en Android destinada a escenarios que requieran movilidad, tales como el de un un mesero tomando una orden a los comensales, un almacenista que realiza tomas físicas de inventario, un vendedor itinerante que tome pedidos a sus clientes, un operador de delivery que tome órdenes, etc.

Se descarga desde [[https://play.google.com/store/apps/details?id=net.antare.maui.antarepocket&hl=es_VE|Google Play Store]] y se actualiza automáticamente mediante esta misma plataforma.

**Antare Pocket** 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.


{{:aspectos-tecnicos:webapi:antarepocket01.jpeg?256|}}

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 Web ====

**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. 

{{:aspectos-tecnicos:webapi:antareennavegador.png?600|}}

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 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.

De todos las cuentas de usuario que se registren bajo esta aplicación, solo se reconocen como usuarios de **Antare** a aquellos cuya dirección email figura en la ficha Seguridad / Cuentas de Usuarios que se accede desde la aplicación **Antare** de escritorio. Las demás cuentas de usuarios podrían ser entonces de visitantes de sitios Web, o bien clientes o proveedores.

{{:aspectos-tecnicos:webapi:antareidentityusuarios.png?600|}}

===== Componentes del Lado del Servidor =====

==== 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**, 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: 

1. Se fija la IP del mismo, preferiblemente a una que esté fuera del Pool DHCP del router.

2. Se asegura de que el Firewall de Windows en el equipo tenga el perfil de Red Privada

3. 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