Resumen del componente

Mas Consents es un frontend alojado que permite a un cliente revisar y guardar declaraciones de consentimiento. Las aplicaciones consumidoras lo embeben y le pasan el contexto del cliente mediante parámetros de URL, con un mensaje JSON de configuración opcional cuando necesitan personalizar la experiencia.

El componente:

  • carga configuración de plataforma desde /config.json
  • lee cliente, marca, locale y flujo desde la URL
  • obtiene consentimientos del backend de consents
  • renderiza el camino actual de UI Custom
  • envía la selección del cliente
  • notifica al host con mensajes de ciclo de vida

Contrato de runtime

El runtime tiene un único camino de renderizado: AppCustomTheme montando ConsentsCoreCustom. El componente Legacy anterior ya no forma parte del flujo de la aplicación.

Flag de URLComportamiento de renderizadoRequisito para el host
enableCustomConfig ausente o falseRenderiza inmediatamente con tema y opciones de UI por defectoNinguno
enableCustomConfig=trueEnvía CONSENTS_CONFIG_REQUIRED y espera a que el host envíe JSON con SET_CONFIGObligatorio

enableCustomConfig solo controla si el componente debe esperar configuración enviada por el host antes de renderizar. No selecciona otra implementación del componente.

Modelo de integración

text

Aplicación host
  -> construye la URL del iframe / WebView
  -> opcionalmente escucha CONSENTS_CONFIG_REQUIRED
  -> opcionalmente envía SET_CONFIG
  -> escucha eventos loaded, completed y error

mas-consents
  -> lee parámetros de URL
  -> carga /config.json
  -> inicializa el bridge
  -> renderiza la UI Custom
  -> llama al backend
  -> informa al host con eventos de ciclo de vida

Responsabilidades del host

La aplicación host debe:

  • proporcionar los parámetros de URL necesarios para el flujo objetivo
  • aportar un token válido para llamadas reales al backend
  • escuchar eventos de finalización y error
  • decidir qué hacer tras el submit del cliente o cuando el componente reporta un error
  • enviar SET_CONFIG solo cuando enableCustomConfig=true está presente en la URL

La aplicación host no necesita conocer el árbol interno de declaraciones, la implementación de validación de tokens ni la configuración de desarrollo local para integrar el componente. Esos detalles están cubiertos en la referencia técnica del IDP.