Estructura de Datos

Hexbon no solo cifra sus datos, sino que los estructura. Conozca el formato JSON requerido y valide sus datos para desbloquear la experiencia interactiva completa.

Por qué es importante la estructura de datos

Hexbon es más que una herramienta de cifrado: es un sistema de almacenamiento de datos estructurados. Sus datos se organizan en un formato jerárquico que permite funciones potentes como el reordenamiento mediante arrastrar y soltar, tarjetas interactivas, registros expandibles y secciones organizadas.

Estructura frente a Cifrado

Siempre podemos descifrar sus datos si proporciona la clave de cifrado correcta. Sin embargo, si sus datos no siguen nuestras pautas de estructura, los mostraremos en modo raw: verá los datos, pero sin las funciones interactivas de la interfaz de usuario como tarjetas, registros, secciones, arrastrar y soltar, etc.

Esta documentación explica la estructura JSON exacta que espera Hexbon. Seguir esta estructura garantiza que sus datos sean totalmente compatibles con las funciones interactivas de nuestro panel.

Resumen de la Estructura

Los datos de Hexbon siguen una estructura jerárquica estricta. Comprender esta jerarquía es clave para organizar correctamente sus datos.

Jerarquía de Datos

{ "cards": [...] }
{
  "title": "Personal",
  "records": [...],
  "updated_at": 1763938832
}
{
  "title": "Gmail",
  "data": [...]
}
{
  "name": "Login",
  "values": [...]
}
{
  "value": "secret123",
  "type": "secret"
}
Propiedad Requerido Se aplica a
cards Sí Objeto raíz
title Sí Tarjeta, Registro
records Sí Tarjeta
data Sí Registro (matriz de secciones)
name Sí Sección
values Sí Sección
value Sí Valor
type Sí Valor (secret, note, totp, link, email)
id No Valor (para ordenar)
updated_at No Tarjeta (marca de tiempo)

Tarjetas

Las tarjetas son los contenedores de nivel superior en su panel. Cada tarjeta aparece como un mosaico en el que se puede hacer clic y que se puede expandir para revelar sus registros. Las tarjetas se pueden reordenar mediante arrastrar y soltar.

Esquema de Tarjeta 
{
  "title": "string",           // Required: Card name displayed on tile
  "records": [],              // Required: Array of Record objects
  "updated_at": 1763938832    // Optional: Unix timestamp of last update
}
Propiedad Tipo Requerido Descripción
title string Sí El nombre que se muestra en el mosaico de la tarjeta
records array Sí Matriz de objetos de Registro (puede estar vacía)
updated_at integer No Marca de tiempo Unix para la visualización de "última actualización"
Ejemplo de Tarjeta 
{
  "title": "Work Credentials",
  "records": [
    // Record objects go here...
  ],
  "updated_at": 1763938832
}

Registros

Los registros son entradas dentro de una tarjeta. Aparecen en la barra lateral izquierda cuando se abre una tarjeta y se pueden seleccionar para ver sus secciones. Piense en los registros como elementos o entradas individuales (por ejemplo, "Cuenta de Gmail", "VPN del trabajo", "Credenciales de la base de datos").

Esquema de Registro 
{
  "title": "string",     // Required: Record name displayed in sidebar
  "data": []               // Required: Array of Section objects
}
Propiedad Tipo Requerido Descripción
title string Sí El nombre que se muestra en la lista de registros
data array Sí Matriz de objetos de Sección (puede estar vacía)

Nota: La propiedad data contiene "secciones", no datos sin procesar. Este nombre se debe a razones históricas. Cada elemento de la matriz data es un objeto de Sección.

Ejemplo de Registro 
{
  "title": "Gmail Account",
  "data": [
    {
      "name": "Login Details",
      "values": [
        // Value objects go here...
      ]
    }
  ]
}

Secciones

Las secciones agrupan valores relacionados dentro de un registro. Proporcionan una capa organizativa que ayuda a categorizar diferentes tipos de información (por ejemplo, "Detalles de inicio de sesión", "Opciones de recuperación", "Claves API"). Cada sección tiene un nombre y contiene varios valores.

Esquema de Sección 
{
  "name": "string",     // Required: Section heading/label
  "values": []             // Required: Array of Value objects
}
Propiedad Tipo Requerido Descripción
name string Sí El encabezado de la sección que se muestra sobre los valores
values array Sí Matriz de objetos de Valor que contienen sus datos
Ejemplo de Sección 
{
  "name": "Login Details",
  "values": [
    {
      "value": "user@example.com",
      "type": "note",
      "id": "value_1763938238781_3jh5i3r20"
    },
    {
      "value": "supersecretpassword123",
      "type": "secret",
      "id": "value_1763938251026_fvjeq1vg9"
    }
  ]
}

Valores

Los valores son las entradas de datos reales: los secretos, las notas y los códigos TOTP que almacena. Cada valor tiene un tipo que determina cómo se muestra y cómo se interactúa con él en la interfaz de usuario.

Esquema de Valor 
{
  "value": "string",   // Required: The actual content
  "type": "secret" | "note" | "totp" | "link" | "email" | "username",  // Required
  "id": "string"      // Optional: Unique identifier for sorting
}
Propiedad Tipo Requerido Descripción
value string Sí El contenido real (contraseña, texto de la nota, secreto TOTP)
type string Sí Uno de: "secret", "note", "totp", "link", "email" o "username"
id string No Identificador único utilizado para ordenar y hacer referencias

Tipos de Valores

Tipo Visualización Caso de uso
"secret" Oculto por defecto (•••••), haga clic para revelar Contraseñas, claves API, datos sensibles
"note" Texto sin formato siempre visible Nombres de usuario, correos electrónicos, URL, información no sensible
"totp" Genera códigos de 6 dígitos en vivo Secretos 2FA (codificados en Base32)
"link" Hipervínculo en el que se puede hacer clic URL, direcciones de sitios web
"email" Dirección de correo electrónico con enlace mailto Direcciones de correo electrónico
"username" Texto sin formato siempre visible con icono de usuario Nombres de usuario, identificadores de cuenta
Ejemplo de Valores 
// Secret value (hidden by default)
{
  "value": "MySecurePassword123!",
  "type": "secret",
  "id": "value_1763938251026_fvjeq1vg9"
}

// Note value (always visible)
{
  "value": "user@example.com",
  "type": "note",
  "id": "value_1763938238781_3jh5i3r20"
}

// TOTP value (generates 2FA codes)
{
  "value": "JBSWY3DPEHPK3PXP",
  "type": "totp",
  "id": "value_1763938267595_kaecs9y31"
}

// Username value (visible text with user icon)
{
  "value": "john_doe_123",
  "type": "username",
  "id": "value_1763938289412_xm2kp7v91"
}

Ejemplo Completo

Aquí hay una estructura de datos completa y válida que muestra la jerarquía completa con varias tarjetas, registros, secciones y diferentes tipos de valores.

Estructura Válida Completa 
{
  "cards": [
    {
      "title": "Personal Accounts",
      "records": [
        {
          "title": "Gmail",
          "data": [
            {
              "name": "Login Details",
              "values": [
                {
                  "value": "myemail@gmail.com",
                  "type": "note"
                },
                {
                  "value": "SuperSecretPassword123",
                  "type": "secret"
                }
              ]
            },
            {
              "name": "2FA",
              "values": [
                {
                  "value": "JBSWY3DPEHPK3PXP",
                  "type": "totp"
                }
              ]
            }
          ]
        },
        {
          "title": "GitHub",
          "data": [
            {
              "name": "Account",
              "values": [
                {
                  "value": "myusername",
                  "type": "note"
                },
                {
                  "value": "gh_token_abc123xyz",
                  "type": "secret"
                }
              ]
            }
          ]
        }
      ],
      "updated_at": 1763938832
    },
    {
      "title": "Work",
      "records": [
        {
          "title": "VPN Access",
          "data": [
            {
              "name": "Credentials",
              "values": [
                {
                  "value": "vpn.company.com",
                  "type": "note"
                },
                {
                  "value": "john.doe",
                  "type": "note"
                },
                {
                  "value": "VpnP@ssw0rd!",
                  "type": "secret"
                }
              ]
            }
          ]
        }
      ],
      "updated_at": 1763856530
    }
  ]
}

Modo Raw

Si sus datos descifrados no siguen la estructura esperada, Hexbon los mostrará de todos modos, pero en modo raw. Esto significa que verá sus datos como JSON simple sin las funciones interactivas que proporcionan los datos estructurados.

Función Modo Estructurado Modo Raw
Mosaicos de tarjetas interactivas
Reordenamiento mediante arrastrar y soltar
Enmascaramiento de secretos con interruptor de revelación
Generación de códigos TOTP en vivo
Edición in situ y guardado automático
Botones de copiar al portapapeles

Sus datos siempre están seguros

El modo raw solo afecta a la visualización, no a la seguridad. Sus datos siempre están cifrados con cifrado AES-256-GCM independientemente de la estructura. Simplemente no obtendrá las funciones interactivas de la interfaz de usuario si la estructura no coincide.

Valide su Estructura de Datos

Utilice nuestra herramienta de validación interactiva para comprobar su estructura de datos en tiempo real.

Probar Herramienta de Validación

Apenas usamos cookies

Solo usamos cookies estrictamente necesarias, que mejoran la seguridad del sitio web y la experiencia del usuario. No rastreamos tus acciones ni actividad.

Más información sobre nuestra política de cookies