Crea o edita una app
Crea una app
Para crear una app, dirígete a la página Applications y haz clic en + Create. Se abre la página Create application. También puedes copiar una app existente y editar la copia creada. Una vez que hayas configurado todas las secciones, haz clic en Add para confirmar el proceso de creación. Se te redirigirá a la página Applications y aparecerá un mensaje que confirma que la app se ha creado correctamente.
Cada vez que guardas cambios en tu app, se abre el modal Record Description para detallar los cambios realizados. Luego, puedes acceder al historial de los cambios realizados en la app en la página Records.
En las secciones siguientes, encontrarás instrucciones detalladas sobre cómo crear tu app:
Escribe un nombre para identificar la app. Por ejemplo, Goldbank wallet prod.
En el campo Description, escribe un texto breve con información detallada sobre el propósito de la app.
En el campo Static resources id, escribe la ruta al repositorio de recursos estáticos generado para la app en tu proyecto de Gitlab. Para este ejemplo, escribe: git-group-example/git-sub-group-example/git-project-example.
En el campo Client, selecciona un cliente del menú desplegable. Esta opción solo está disponible para usuarios con permisos sobre más de un cliente.
En el campo Product, selecciona un producto del menú desplegable, donde puedes ver la descripción de cada producto y su nombre entre paréntesis. Puedes administrar tus productos y crear otros nuevos desde la página Products.
Nota
Solo se muestran los productos del cliente previamente seleccionado.
En el campo Environment, selecciona un ambiente del menú desplegable, donde puedes ver el nombre de cada entorno y su variante entre paréntesis. Puedes administrar tus ambientes y crear otros nuevos desde la página Environments.
Nota
Solo se muestran los ambientes del cliente previamente seleccionado.
Posa el cursor sobre cada chip para ver las configuraciones de la app y el producto. Estos parámetros son comunes a todas las plataformas y están relacionados con la comunicación con VT-NET. Por ejemplo, la configuración de los parámetros de cifrado. Los parámetros se establecen con valores predeterminados, pero puedes editar la configuración de la app o del producto desde esta sección de acuerdo con los requisitos de tu proyecto.
Edita la configuración de la app
Para editar la configuración de la app, haz clic en el icono del lápiz en el chip de la app. Se abrirá un panel en el que puedes editar la siguiente información:
Device type
Selecciona uno de los tipos de dispositivo en el menú desplegable: teléfono, tableta o ambos.
Screen orientation
Selecciona una de las orientaciones de la pantalla en el menú desplegable: vertical, horizontal o ambas.
Test automation enabled
Acciona el interruptor para habilitar el uso de herramientas de prueba automatizadas para probar los binarios de la app. Esta funcionalidad no se puede usar en binarios productivos ni en apps con configuraciones de accesibilidad en Studio.
Aviso
Las opciones "Test automation enabled" y "Low Code Test enabled" no deben activarse simultáneamente, ya que esto genera conflictos.
Low Code Test enabled
Acciona el interruptor para habilitar la funcionalidad Low-Code Test en la app y poder probarla en Studio. Esta funcionalidad no se puede usar en binarios productivos ni en apps con configuraciones de accesibilidad en Studio.
Aviso
Las opciones "Low Code Test enabled" y "Test automation enabled" no deben activarse simultáneamente, ya que esto genera conflictos.
Webview debug enabled
Acciona el interruptor para habilitar la opción de depuración para los componentes webview Esta opción no se puede utilizar en binarios productivos.
WebView Certificate pinning
Haz clic en el campo e introduce el dominio y el hash (o hashes) necesarios para restringir qué certificados se consideran válidos para tu app. Luego, haz clic en + Add certificate para finalizar el proceso. Una vez que se agrega cada certificado, haz clic en el icono de lápiz para editarlo o en el icono de papelera para eliminarlo.
CA Certificates
Haz clic en el campo e introduce los certificados digitales utilizados para verificar los certificados SSL firmados por cada autoridad de certificación (CA). Luego, haz clic en + Add CA certificate para finalizar el proceso. Una vez que se agrega cada certificado, haz clic en el icono de lápiz para editarlo o en el icono de papelera para eliminarlo.
XpressPlug entry point
Acciona el interruptor para habilitar la integración de XpressPlug. Esta opción te permite: generar un binario de iOS integrado con XpressPlug.
Importante
Esta opción solo está disponible para iOS. Asegúrate de tener la plataforma iOS configurada en la sección deconfiguración de las plataformas de tu app.
Cuando se habilita, la opción de cargar el archivo JSON necesario para la integración pasa a estar disponible. Haz clic en Upload file para seleccionar el archivo desde tu escritorio.
Una vez que hayas editado los campos necesarios, haz clic en Save para implementar los cambios y cerrar el panel.
Edita la configuración del producto
Lee las instrucciones a continuación para aprender a editar la configuración del producto.
Importante
Si necesitas completar alguno de estos campos pero no tienes la información necesaria, comunícate con el equipo de IT.
Haz clic en el icono de lápiz en el chip del producto. Se abrirá un panel en el que puedes editar la siguiente información:
Crc header type
El tipo de encabezado CRC (Cyclic Redundancy Check) indica qué algoritmo se debe utilizar para calcular el hash generado por VT-NET y el binario móvil, con el fin de garantizar que ambos hashes coincidan y que la comunicación no se haya visto comprometida. Escribe "0" para usar MD5, "1" para usar SHA1 o "2" para usar SHA3-256. Puedes usar las flechas a la derecha para seleccionar el número.
Delta version
Introduce la versión de configuración delta deseada: "0" activa la versión fat, "1" activa la versión split, "2" activa la versión delta completa. También puedes usar las flechas a la derecha para seleccionar el número. De forma predeterminada, la versión delta se establece en 2 y no se puede modificar.
Mstm version
Introduce la versión deseada del protocolo de mensajería interna MSTM. La opción sugerida es "2", ya que debe coincidir con la versión delta. También puedes usar las flechas a la derecha para seleccionar el número.
Working key type
Introduce el tipo de cifrado de extremo a extremo (E2EE) deseado. "0" para usar el cifrado de extremo a extremo Diffie Hellman o "1" para usar el cifrado de extremo a extremo PKI (Public Key Infraestracture). El tipo de encabezado CRC debe estar activado para utilizar una de estas opciones. También puedes usar las flechas a la derecha para seleccionar el número.
Aviso
El cifrado de extremo a extremo Diffie Hellman se ha deprecado y no debe seleccionarse.
Veritran secret code
Haz clic en el campo e introduce el código secreto definido para la app. El código secreto se usa para acceder a la información de configuración de la app desde un dispositivo mientras se inicializa la app.
Device handler certificate
Introduce el certificado de controlador de dispositivos que se usa para proteger la comunicación con cifrado de extremo a extremo. Este certificado debe ser el mismo que el creado en el middleware de la plataforma para el producto seleccionado.
VTNetworking
Acciona el interruptor para habilitar la librería. Al transaccionar contra VT-NET, esta librería verifica la información y la registra en Crashlytics. Todas las aplicaciones nuevas deben tener esta opción habilitada.
Importante
Esta funcionalidad aún se está probando y solo está disponible para usuarios beta. Ponte en contacto con el equipo de Mobile Builder antes de habilitarlo.
Working key persisted
Acciona el interruptor para desactivar esta opción. Esta opción debe estar activada cuando se utiliza el cifrado de extremo a extremo Diffie Hellman y desactivada cuando se utiliza el cifrado de extremo a extremo PKI. De forma predeterminada, el interruptor está activado.
Aviso
El cifrado de extremo a extremo Diffie Hellman se ha deprecado y no debe seleccionarse.
Certificate pinning
Haz clic en el campo e introduce el hash (o hashes) obtenido de VT-Gateway necesario para restringir qué certificados se consideran válidos para su producto. Luego haz clic en + Add certificate hash para finalizar el proceso. Una vez agregado, tienes la opción de eliminar (icono de papelera a la derecha) cada hash.
Una vez que hayas editado los campos necesarios, haz clic en Save para implementar los cambios y cerrar el panel.
En las instrucciones siguientes se explica cómo configurar las plataformas (iOS, Android y Harmony) para las que desees generar un binario de la app.
En la sección Platforms, haz clic en + Add platform. Se abre un panel en el lado derecho de la pantalla.
Selecciona una plataforma en el menú desplegable (iOS, Android o Harmony).
A continuación, configura los siguientes parámetros:
Version
Selecciona una versión de rama mobile o tag del menú desplegable. Consulta la página Versions para ver una lista de las versiones existentes con sus estados actuales. Este campo es obligatorio.
Name
Escribe un nombre único para identificar la app. Este nombre se muestra debajo del icono de la app en los dispositivos.
Identifier
Introduce un ID para el paquete utilizado para instalar la app en un dispositivo. Esta información es necesaria para agregar la app a cualquier tienda. Un ejemplo de la estructura de un ID es: net.veritran.glbk.s.dev. Puedes introducir un ID diferente para cada plataforma y sobrescribir el introducido en la sección de información básica de la app al crearla. Este campo es obligatorio.
Aviso
Los identificadores son únicos y no se pueden reutilizar para otras apps.
Store URL
URL de la tienda donde se publicará la app (App Store para iOS, Google Play Store para Android y AppGallery para Huawei). Este campo es obligatorio.
Repo encryption version
La app almacena su información en repositorios que se persisten en el espacio de almacenamiento del dispositivo con un mecanismo de cifrado específico que depende de la plataforma. Introduce la versión con la que se realiza el cifrado: "0" para el cifrado basado en software, "1" para el cifrado basado en hardware (solo disponible para iOS) o "2" para el almacenamiento seguro (solo disponible para Android).
Importante
Las opciones "1" y "2" implican niveles de seguridad más altos y deben usarse para todas las apps nuevas.
Revision to force full configuration download
Este valor permite que el binario identifique si la configuración de la app cambió de la que ya estaba disponible en el servidor y debe descargarse o no. Si el valor se establece en 0, el binario no descargará la configuración. Si el valor se establece en 99999, la aplicación siempre volverá a descargar la configuración. Si el campo se deja incompleto, la aplicación siempre volverá a descargar la configuración.
Min. SDK version (solo disponible para Android y Harmony)
Introduzca la versión mínima de Android o Harmony compatible con la app.
Min. iOS version (solo disponible para iOS)
Introduce la versión mínima de iOS compatible con la app.
Split APK (solo disponible para Android y Harmony)
Habilita esta opción para generar un archivo .apk diferente para cada arquitectura de dispositivo, en lugar de generar un solo archivo para todos los dispositivos. Esto permite generar archivos más pequeños que ocuparán menos espacio en los dispositivos.
Nota
Esta opción solo está disponible para los archivos .apk de las apps existentes. Las apps de Android y Harmony publicadas en las tiendas por primera vez utilizan archivos .aab y no tienen esta opción disponible.
Http traffic Whitelist (solo disponible para Android y Harmony)
Introduce una URL para permitir el tráfico sin seguridad desde el dominio especificado. Se utiliza para widgets y webviews. Una vez añadido, tienes la opción de editar (icono de lápiz a la derecha) o eliminar (icono de papelera a la derecha) cada dominio.
Mobile security
Acciona el interruptor para habilitar la funcionalidad Tamper Plus.
Importante
Esta opción solo está disponible para los proyectos que han adquirido la funcionalidad Tamper Plus. Para obtener más información sobre la funcionalidad y los modos disponibles, ponte en contacto con el equipo de Mobile Builder.
Cuando se habilita, aparecen dos configuraciones:
Selecciona el nivel de seguridad
Elige entre los modos de seguridad disponibles:
Hard: Interrumpe el uso de la app si se detecta una amenaza y se genera un informe de errores no fatales en Crashlytics.
Soft: La app sigue funcionando después de que se detecta la amenaza y se genera un informe de errores no fatales en Crashlytics.
Crash: Cierra inmediatamente la app si se detecta una amenaza.
Securely closed
Accina el interruptor para habilitar la opción. El resultado varía en función de la configuración anterior:
Si el nivel de seguridad se establece en hard y esta opción está habilitada, se muestra un mensaje con el código de error ua599, que notifica de una amenaza e impide que continúe el flujo normal de la app.
Si el nivel de seguridad se establece en hard y esta opción no está habilitada, la app se cerrará inesperadamente.
Si el nivel de seguridad se establece en soft, la app sigue funcionando independientemente de si esta opción está habilitada o no.
Public keys
Ingresa la clave pública del keystore que utilizaste para firmar los APKs. Esto mejora la seguridad de los binarios generados, asegurando que solo aquellos firmados con claves autorizadas sean válidos.
Nota
Esta opción solo está disponible para Android y Harmony.
Universal Domains
Completa los campos de esta sección para definir las URL que abrirán la app cuando se descargue en el dispositivo.
Domain
Introduce el dominio. Por ejemplo: https://example.net.
Path type
Elige un tipo de ruta. Las opciones disponibles son:
Path
Interpreta el texto especificado en el campo Path como una ruta de acceso y solo abre la URL con esa ruta de acceso concreta. Por ejemplo, si completas el campo con /test, se abrirá la URL https://example.net/test.
Path prefix
Interpreta el texto especificado en el campo Path como un prefijo y abre todas las direcciones URL que incluyen ese prefijo. Por ejemplo, si completas el campo con /test, se abrirán URLs tales como https://example.net/test, https://example.net/tester y https://example.net/testing.
Path pattern
Interpreta el texto especificado en el campo Path como un patrón de ruta de acceso y abre todas las URLs que incluyen ese patrón en cualquier segmento. Por ejemplo, si completas el campo con /test/.* , se abrirán todas las URL que incluyan «test» como segmento de ruta, tales como https://example.net/test/resource y https://example.net/test/media.
Path
Introduce la ruta que deseas abrir. Por ejemplo: /test.
Luego haz clic en + Add Universal domain para finalizar el proceso. Una vez que se agrega cada dominio, haz clic en el icono de lápiz para editarlo o en el icono de papelera para eliminarlo.
Haz clic en Add para finalizar el proceso. Repite estos pasos con cada plataforma que desees agregar.
Posa el cursor sobre cada chip para ver los detalles de las plataformas añadidas. Haz clic en el icono de eliminación (x) en cualquier chip de plataforma para eliminarlao. Para editar una plataforma, haz clic en el icono de lápiz en el chip de esa plataforma. Puedes editar todos los campos excepto el nombre de la plataforma. Haz clic en Save en la parte inferior del panel para implementar los cambios.
Para integrar un nuevo SDK a tu app, haz clic en + Add SDK en la sección SDKs. Se abre un panel.
Selecciona un SDK del menú desplegable y revisa las plataformas seleccionadas (Android, iOS o Harmony). De forma predeterminada, se seleccionan todas las plataformas configuradas para su app al momento de agregar el SDK. Puedes deseleccionar aquellas en las que no desees incluir el SDK. Asegúrate de que las plataformas seleccionadas estén agregadas en la sección de configuración de las plataformas para evitar problemas a la hora de generar la app.
Completa los parámetros necesarios para habilitar ese SDK. Posa el cursor sobre el icono de signo de interrogación a la derecha de cada campo para obtener información adicional sobre la configuración del SDK.
Importante
Cada SDK requiere que completes diferentes parámetros para su configuración. Si tienes preguntas sobre cómo completar estos parámetros, consulta la documentación o ponte en contacto con el equipo de Mobile Producto.
Haz clic en Add para finalizar el proceso. Repite estos pasos con cada SDK que desees agregar.
Posa el cursor sobre cada chip de SDK para ver en qué plataformas está incluido. Los chips con un icono rojo indican que el SDK se desactivó y no funcionará en la app a menos que el equipo Mobile lo vuelva a habilitar. Los chips con un icono de advertencia amarillo indican que el SDK tiene dependencias pendientes de configuración, esto significa que requiere de la configuración de otro SDK o SDKs para funcionar.
Haz clic en el icono de eliminación (x) de cualquier chip de SDK para eliminarlo de la app. Para editar un SDK, haz clic en el icono de lápiz en el chip de ese SDK. Solo se pueden editar los SDKs con parámetros configurables. Puedes editar todos los campos, excepto el nombre del SDK. Una vez que hayas editado los campos necesarios, haz clic en Save para implementar los cambios y cerrar el panel.
Para activar los detectores de manipulación en tu app, es decir, medidas preventivas para evitar cualquier intento de manipular tu app sin consentimiento, busca el detector en la lista y haz clic en la casilla de verificación a la izquierda. De forma predeterminada, todos los detectores están habilitados excepto el detector de integridad. Para activar todos los detectores de manipulación a la vez, haz clic en la casilla de verificación en la parte superior de la lista. Consulta la tabla a continuación para obtener más información sobre cada detector de manipulación:
Debugger
Impide la eliminación de bugs de la app. El modo sugerido para este detector es «soft».
Hooking
Comprueba las llamadas a funciones del sistema. El modo sugerido para este detector es «hard».
Root
Evita el uso de la app en un dispositivo rooteado. El modo sugerido para este detector es «hard».
Emulator
Impide el uso de la app en un emulador. El modo sugerido para este detector es «hard».
Integrity
Comprueba la integridad de la app validando sus certificados.
Luego, edita cualquier detector de manipulaciones como desees. Para hacerlo, búscalo en la lista y haz clic en el icono de lápiz. Se abre un panel en el que puede editar las siguientes configuraciones:
Mode
Modo en el que se ejecutará el detector. Selecciona una opción del menú desplegable. Haz clic en soft si solo deseas que el detector te advierta sobre cualquier intento de manipulación de tu app. Haz clic en hard si deseas que el detector bloquee cualquier otra acción si se detecta algún intento de manipulación de la app.
Interval
Intervalo en el que se ejecutará el detector. Haz clic en el campo e introduce el intervalo en números.
Services
Introduce el número de transacciones a las que deseas aplicar la detección de manipulación.
Checks
Controles realizados por el detector. Por defecto, cada detector incluye diferentes controles. Haz clic en el icono de eliminación (x) de cualquier control si no deseas incluirlo en el proceso de detección. Para agregar más controles, haz clic en la flecha y seleccionalos en el menú desplegable o haz clic en el interruptor Include all checks para incluir todos los controles.
Packages
Información utilizada para comprobar que el emulador se ha detenido. Selecciona el paquete o paquetes en el menú desplegable. Este campo sólo aparece en la configuración del emulador.
Haz clic en Save para implementar los cambios realizados en los detectores de manipulaciones y cerrar el panel.
Puedes cambiar el orden en el que se ejecutarán los detectores. Para hacerlo, haz clic en las flechas hacia arriba y hacia abajo ubicadas a la derecha de cada detector.
Edita una app
Para editar una app existente, busca la app en el listado y haz clic en el icono de lápiz a la derecha. Se abre la página Edit application, donde puede editar los parámetros configurados durante el proceso de creación o agregar nuevos. Una vez que hayas editado todas las secciones necesarias, haz clic en Save para aplicar los cambios.
Cada vez que guardas cambios en tu app, se abre el modal Record Description para detallar los cambios realizados. Luego, puedes acceder al historial de los cambios realizados en la app en la página Records.