1. Fidi X
Fidi X Developer Preview
  • Fidi X
    • Diccionario de Datos - Enumeraciones
    • Autenticación
      • Obtener Token de Acceso
    • Cuentas
      • Crear Cuenta
      • Obtener Cuenta por ID
      • Listar Cuentas por Ledger
      • Actualizar Cuenta
      • Eliminar Cuenta
      • Suspender Cuenta
      • Activar Cuenta
      • Obtener Balance de Cuenta
      • Obtener Cuentas linkeadas
      • Linkear Cuenta Bancaria
    • Personas
      • Crear Persona
      • Listar Personas
      • Obtener Persona por ID
      • Obtener jerarquía de persona
      • Bloquear persona y descendientes
      • Desbloquear persona y descendientes
      • Actualizar datos de persona
      • Eliminar persona (soft delete)
    • Transacciones
      • Crear Transacción
      • Create Notification
    • Operaciones
      • Listar Operaciones
    • Webhooks
      • Crear Suscripción Webhook
      • Listar Suscripciones
      • Obtener Suscripción
      • Actualizar Suscripción
      • Eliminar Suscripción
  • Schemas
    • CreateSubscriptionRequest
    • Person
    • LinkBankAccountRequest
    • PersonHierarchyResponse
    • UpdateAccountRequest
    • UpdateSubscriptionRequest
    • LinkBankAccountResponse
    • BlockPersonDataResponse
    • HTTPValidationError
    • CreateAccountRequest
    • DeliveryInfo
    • TransactionDataResponse
    • AssetResponse
    • AuthResponse
    • WebhookEventType
    • CreateTransactionRequest
    • ErrorResponse
    • AccountResponse
    • BalanceResponse
    • CreatePersonRequest
    • PersonResponse
    • TransactionOperation
    • CreateWebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • UpdateWebhookSubscriptionRequest
    • SubscriptionResponse
    • LinkBankAccountDataResponse
    • CreateAssetRequest
    • SubscriptionListResponse
    • AssetListResponse
    • WebhookSubscriptionListResponse
    • AccountDetailResponse
    • TransactionCreateResponse
    • WebhookEventTypesResponse
    • LedgerResponse
    • WebhookEventsListResponse
    • WebhookEventRecord
    • PersonDataResponse
    • SimulateExternalTransferRequest
    • PersonListResponse
    • SimulateExternalTransferResponse
    • TransactionResponse
  1. Fidi X

# 🔐 Autenticación – FIDI X (v1)

Introducción#

Para garantizar una integración segura y confiable, FIDI X protege todas sus APIs mediante un mecanismo de autenticación estándar, basado en tecnologías ampliamente adoptadas en la industria financiera.
El objetivo de esta primera versión es verificar la identidad de quien consume las APIs, asegurando que cada solicitud provenga de un cliente, sistema o aplicación previamente autenticada.

🧩 ¿Cómo funciona la autenticación en FIDI X?#

FIDI X utiliza un modelo de autenticación centralizado, apoyado en un proveedor de identidad externo y tokens de acceso seguros.
El proceso general es el siguiente:
1.
El cliente se autentica contra el proveedor de identidad.
2.
Se obtiene un Access Token.
3.
El token se envía en cada llamada a las APIs de FIDI X.
4.
FIDI X valida el token antes de procesar la solicitud.

🔑 Tecnologías Utilizadas#

La autenticación en FIDI X se basa en los siguientes estándares:
OAuth 2.0: protocolo para la obtención de tokens de acceso.
OpenID Connect (OIDC): extensión de OAuth 2.0 para identidad.
JWT (JSON Web Token): formato seguro del token.
Estos estándares permiten una integración sencilla, segura y compatible con múltiples lenguajes y plataformas.

🔐 Proveedor de Identidad#

El proveedor de identidad es responsable de:
Autenticar aplicaciones, servicios o usuarios.
Emitir tokens de acceso firmados (JWT).
Gestionar clientes OAuth 2.0.
Publicar claves públicas para validación de tokens.

🔁 Flujos de Autenticación Soportados#

1️⃣ Client Credentials (Recomendado)#

Este es el flujo principal para integraciones con FIDI X.
Está diseñado para:
Integraciones backend a backend.
Partners que consumen las APIs desde sus sistemas.
Procesos automáticos o servicios.
Cómo funciona:
1.
El cliente solicita un token al proveedor de identidad usando su client_id y client_secret.
2.
El proveedor valida las credenciales.
3.
Se emite un Access Token.
4.
El cliente utiliza el token para consumir las APIs de FIDI X.
Este flujo no involucra usuarios finales.

2️⃣ Authorization Code + PKCE (Opcional)#

Este flujo se utiliza únicamente cuando existe interacción directa con usuarios (por ejemplo, portales o backoffice).
Características:
Autenticación interactiva.
Redirección al proveedor de identidad.
Emisión de token tras login exitoso.
📌 Este flujo es opcional y solo se habilita para clientes que lo requieran.

📥 Uso del Token en las APIs#

Todas las llamadas autenticadas a FIDI X deben incluir el token en el siguiente header HTTP:
Sin este header, la solicitud será rechazada.

🔍 Validación del Token#

Antes de procesar una solicitud, FIDI X valida el token recibido.
En esta versión se verifica:
Firma del token.
Fecha de expiración.
Emisor del token.
Audiencia esperada.
📌 La validación es local y automática, sin llamadas adicionales al proveedor de identidad.

⏱️ Vigencia de los Tokens#

Tipo de TokenDescripción
Access TokenToken JWT utilizado para consumir las APIs
DuraciónCorta (entre 5 y 15 minutos)
RenovaciónMediante nueva autenticación
RevocaciónPor expiración del token

🛡️ Recomendaciones de Seguridad para Clientes#

Para una integración segura, se recomienda:
Utilizar siempre HTTPS.
Proteger el client_secret y no exponerlo públicamente.
No almacenar tokens en logs o repositorios.
Renovar los tokens cuando expiren.
Rotar credenciales periódicamente.

✅ Beneficios para el Cliente#

Integración simple y estandarizada.
Seguridad alineada a buenas prácticas fintech.
Bajo acoplamiento técnico.
Preparación para futuras capas de seguridad.
Modificado en 2026-02-02 20:24:22
Anterior
Diccionario de Datos - Enumeraciones
Siguiente
Obtener Token de Acceso
Built with