Guía de producto v1

Centro de ayuda de TrustLayer

Recorrido verificable desde el registro y el espacio de trabajo hasta Proyectos, Activos verificados, la Bóveda de evidencias, Informes de confianza, API, webhooks y soporte.

Actualizado 29 de julio de 2026
Cobertura producto, API y operación
Pensado para equipos, desarrolladores y operadores
Cómo usar la guía

Del registro al Informe publicado

Sigue Organización, Proyecto, Activo verificado, Bóveda de evidencias, Informe de confianza y distribución.

Qué cubre

Contratos y rutas reales

Los ejemplos se validan contra OpenAPI y los enlaces de producto del repositorio.

Cobertura operativa

Producto, desarrollo y operaciones

Incluye incorporación, Evidencia, Informes, API, webhooks, GitHub, facturación, privacidad y soporte.

Cobertura 16

Secciones de producto, API, seguridad, soporte y compatibilidad.

Canales /app | /r | /v1 | /platform

La guía separa espacio de trabajo organización, Informes distribuidos, API y operaciones globales.

Fuentes OpenAPI + procedimientos operativos

La documentación activa tiene versión, validador de enlaces y ejemplos ejecutables.

Entrada rápida

Soy nuevo

Crea una cuenta, un Proyecto, un activo, Evidencia y el primer informe.

Entrada rápida

Quiero organizar Evidencia

Proyectos, Activos verificados, Bóveda de evidencias e Informes de confianza.

Entrada rápida

Quiero invitar al equipo

Roles, membresías y cambio de espacio de trabajo.

Entrada rápida

Quiero usar la API

Permisos, idempotencia, ejemplos y OpenAPI.

Entrada rápida

Quiero automatizar Evidencia

Webhooks firmados y Evidencia procedente de GitHub.

Entrada rápida

Quiero distribuir un reporte

Distintivos y versiones públicas revisadas.

Entrada rápida

Necesito soporte

Solicitud de soporte depurada, severidad y escalado.

Entrada rápida

Opero el servicio

Despliegue, restauración, observabilidad e incidentes.

Por rol

Miembro del espacio de trabajo

Consulta Proyectos, activos, Evidencia e informes autorizados.

Abrir Proyectos
Por rol

Propietario o administrador

Gestiona equipo, publicación, claves API, webhooks, integraciones y facturación.

Gestionar equipo
Por rol

Integrador API

Usa claves con permisos limitados, OpenAPI, idempotencia y eventos firmados.

Abrir API keys
Por rol

Operador de plataforma

Opera soporte, moderación, auditoría y ciclo de vida global con un rol separado.

Abrir consola
Navegar ayuda
Producto

Qué es TrustLayer

v1-saas

TrustLayer ayuda a equipos de software a organizar Evidencia técnica en torno a Aplicaciones, Agentes, Flujos de trabajo, API y Productos. La Evidencia aprobada se convierte en un Informe de confianza versionado que puede compartirse de forma privada, publicarse, integrarse como distintivo o consultarse por API.

Qué significa «verificado»: quedan registrados fuente, método, resultado y estado actual. No es una certificación, garantía ni afirmación de seguridad permanente.
Modelo

Visión general del producto

Frontera de la Organización

Organización y Proyecto

La Organización es la frontera de autorización y datos. Los Proyectos agrupan Activos verificados relacionados sin cambiar esa frontera.

Activo verificado

Una Aplicación, Agente, Flujo de trabajo, API o Producto cuya Evidencia e Informes gestiona el espacio de trabajo.

Bóveda de evidencias

Registros y archivos escaneados con procedencia, fechas, sensibilidad, integridad y estado.

Informe de confianza

Instantánea revisada con secciones fijas, Evidencia seleccionada y visibilidad explícita.

Primer recorrido

Del registro al primer Informe

Objetivo 20 minutos
  1. Crea una cuenta en /signup, verifica el correo electrónico e inicia sesión.
  2. Confirma el espacio de trabajo activo en /app/onboarding.
  3. Crea un Proyecto y añade un Activo verificado con su tipo correspondiente.
  4. Crea Evidencia privada. Sube un archivo no sensible solo si el almacenamiento y el escaneo están listos.
  5. Crea un borrador de Informe de confianza, añade secciones, adjunta Evidencia elegible y revisa la instantánea.
  6. Envíalo a revisión. Publica o crea un enlace compartido con caducidad solo tras comprobar la redacción y la visibilidad.
  7. Usa un distintivo, una Clave API con permisos limitados, un webhook o GitHub únicamente si necesitas distribución o automatización.
Regla de usuario nuevo: ningún paso requiere SQL, operador ni credencial oculta. Si falta un proveedor requerido, el paso afectado queda bloqueado; no se evita el control.
Espacio de trabajo

Proyectos, activos, Evidencia y Informes

Acotado a la Organización

Usa /app/projects como entrada al espacio de trabajo comercial. Cada Proyecto, activo, Evidencia y Informe se resuelve dentro de la Organización activa en servicios y datos.

  • Archiva Proyectos o activos en vez de borrarlos desde la interfaz normal.
  • La Evidencia empieza como no pública y los archivos necesitan un resultado de escaneo limpio.
  • Los Informes publicados son instantáneas; crea una versión nueva para modificarlos.
  • Privado, no listado y público son modos distintos; un enlace no listado no es adecuado para secretos.
Acceso

Equipos y membresías

Mínimo privilegio

Propietarios y administradores autorizados gestionan invitaciones y roles en /app/settings/members. Permisos de lectura, edición, facturación y administración permanecen separados. Cambiar espacio de trabajo cambia la organización activa; nunca transfiere un recurso.

Desarrollo

Inicio rápido de API

OpenAPI 3.0.3

Crea una clave restringida al Proyecto y con los permisos mínimos, y sigue los ejemplos ejecutables de examples/api. El contrato canónico es docs/openapi.yaml.

TRUSTLAYER_QUICKSTART_DRY_RUN=1 node examples/api/onboarding.mjs

Las mutaciones comerciales requieren idempotencia. La API no publica Informes: una persona responsable publica la instantánea revisada.

Acceso de máquina

Seguridad de API

Claves con permisos limitados
  • El valor de la Clave API se muestra una vez. Guárdalo fuera del repositorio.
  • 401 indica autenticación ausente o inválida; 403 indica permisos insuficientes; 404 no revela la propiedad de una Organización.
  • Usa una clave distinta por integración, Proyecto y entorno.
  • Rota o revoca inmediatamente si sospechas exposición.
  • No envíes credenciales, enlaces compartidos privados ni evidencia de clientes al equipo de soporte.
Automatización

Webhooks y GitHub

Firmados e idempotentes

Los webhooks comerciales usan un contrato fechado, firma HMAC, marca de tiempo e identificador UUID de entrega. El receptor verifica antes de procesar y elimina entregas duplicadas. La Evidencia de GitHub requiere vincular un repositorio verificado y una clave dedicada write:evidence.

Desconectar una integración detiene nueva ingesta y conserva Evidencia histórica. No republica ni borra Informes silenciosamente.

Distribución

Distintivos y Informes públicos

Versiones publicadas

Genera distintivos desde /widget-builder/v2. El distintivo enlaza una versión publicada y refleja su ciclo de vida. Revisa la salida pública antes de embeberla y no uses un borrador o Informe privado como Evidencia pública.

Comercial

Planes, facturación y límites

Bloqueo seguro ante fallos

/app/billing muestra derecho de uso y acciones alojadas cuando están configuradas. Los límites pueden impedir nuevos recursos sin borrar datos existentes. Un entorno sin proveedor debe mostrar indisponibilidad, no una compra correcta.

Datos

Seguridad, privacidad y legal

Visibilidad explícita

Consulta el canal de divulgación de seguridad y el índice legal. Exportación, borrado, retención, bloqueo legal y moderación son flujos de trabajo auditados. La Evidencia y los Informes públicos deben depurarse antes de publicar.

Soporte

Soporte e incidentes

Solicitud depurada

Proporciona hora UTC, versión, Organización, ruta afectada, identificador de solicitud, resultado esperado, resultado observado e impacto. No proporciones contraseñas, cookies, Claves API, enlaces privados ni archivos de clientes. Las vulnerabilidades se comunican por el canal de divulgación.

Operadores

Procedimientos operativos

Documentación del repositorio

Los índices activos son docs/ops/README.md y docs/support/README.md. Cubren preproducción, reversión, restauración, almacenamiento, observabilidad, incidentes, datos y traspaso a soporte.

Resolución de problemas

Bloqueos comunes

No evitar controles
  • Correo electrónico ausente: revisa la bandeja de salida o el proveedor y usa el reenvío.
  • Carga bloqueada: confirma la disponibilidad del almacenamiento y del escáner.
  • No se puede publicar: revisa estado, Evidencia elegible, visibilidad y moderación.
  • Webhook en reintento: corrige el destino o la firma y reproduce la misma entrega.
  • Cuota alcanzada: revisa uso y plan; no borres recursos automáticamente.
Lenguaje

Glosario corto

v1 comercial
Activo verificado
Entidad de software gestionada dentro de un Proyecto.
Evidencia
Registro con fuente, fechas, integridad, sensibilidad y ciclo de vida.
Informe de confianza
Instantánea versionada, seleccionada y revisada para su distribución.
Organización
Frontera de datos y autorización del espacio de trabajo.
Compatibilidad

Superficies heredadas

Fuera del recorrido principal v1

Algunos perfiles heredados conservan catálogo, validaciones, reputación y operaciones de la Organización. No forman parte de la incorporación comercial ni prueban que una función v1 esté terminada.

Catálogo descubrimiento

Compatibilidad pública. La entrada comercial son Proyectos y Activos verificados.

Operación descubrimiento

Moderación de compatibilidad separada de los recursos organización.

Reclamaciones de perfil

La reclamación heredada no publica un Informe de confianza comercial.

Vinculación de perfil

No sustituye propiedad de repositorio ni autorización de la organización.

Incorporación de catálogo

Ruta de compatibilidad; clientes nuevos usan /app/onboarding.

Contacto

Flujo de trabajo de plataforma para compatibilidad, sin afirmaciones inventadas sobre clientes.

Clasificaciones

No son una puntuación de confianza comercial ni una certificación.

Validaciones y reputación

Modelo heredado; v1 usa Evidencia explícita e Informes revisados.

Operación de alertas

Los operadores clasifican sin cambiar datos fuera de flujos de trabajo autorizados.

Consola de plataforma

Roles globales de soporte y seguridad separados de los roles de la Organización.