Skip to main content

Blockchain como Servicio (BaaS)

Este documento detalla el funcionamiento del componente BaaS, el cual es el encargado de gestionar las API Keys que se utilizan dentro de la aplicación. El sistema permite dos niveles de gestión: el nivel de Usuario/Desarrollador (gestión de claves propias) y el nivel de Administrador (gestión de claves de administración y de otras empresas).

1. Gestión de Claves de API de Usuario​

Esta sección describe cómo un usuario estándar interactúa con la interfaz para gestionar sus credenciales de acceso.

1.1. Visualización Inicial​

Al acceder al módulo, el usuario visualiza la tabla de "Claves API de usuario". Inicialmente, si no existen registros, la tabla se mostrará vacía, ofreciendo la opción principal de crear una nueva credencial.

Interfaz de Claves API de usuario vacía

1.2. Creación de una Nueva API Key​

Para generar una nueva credencial, el usuario debe presionar el botón “NUEVA API KEY”. Al hacerlo, se despliega un formulario modal.

Formulario Crear nueva clave API de usuario

El usuario debe completar los siguientes pasos:

  1. Rellenar los datos: Asignar un nombre identificativo a la clave (ej. "API-Enterprise-1").

  2. Elegir el tiempo de validez: Se debe seleccionar la duración de la clave en el menú desplegable. Las opciones disponibles incluyen:

    • Día
    • Semana
    • Mes
    • Año
    • Ilimitado
    Menú desplegable Tiempo de validez

Una vez completados los datos del formulario y confirmada la acción, el sistema crea la API Key con la validez estimada.

1.3. Listado y Detalles de la Clave​

Tras la creación, el nuevo registro aparecerá inmediatamente en la tabla del BaaS. El usuario podrá ver la información resumida (Nombre, fragmento de la API Key, fechas de creación y expiración).

Al desplegar los detalles de un registro específico, el sistema proporciona información técnica vital para la integración:

  • URL de la red: Endpoint para realizar las peticiones.
  • API KEY: La cadena completa de la clave.
  • Snippets de código: Ejemplos de uso en lenguajes como CLI (curl), TypeScript (ethers) y Python (web3.py).
Detalles de la clave API

1.4. Eliminación de Claves​

El sistema permite al usuario revocar el acceso eliminando una clave existente.

Modal de confirmación Eliminar clave API

Tras confirmar la eliminación, el registro desaparece de la lista, actualizando la tabla a su estado anterior o mostrando los registros restantes.

Tabla de Claves API de usuario tras eliminación