Struttura dei Dati
Hexbon non si limita a crittografare i tuoi dati, ma li struttura. Scopri il formato JSON richiesto e valida i tuoi dati per sbloccare l'esperienza interattiva completa.
Capitoli
Perché la struttura dei dati è importante
Hexbon è più di uno strumento di crittografia: è un sistema di archiviazione dati strutturato. I tuoi dati sono organizzati in un formato gerarchico che abilita potenti funzionalità come il riordinamento drag-and-drop, schede interattive, record espandibili e sezioni organizzate.
Struttura vs Crittografia
Possiamo sempre decrittografare i tuoi dati se fornisci la chiave di crittografia corretta. Tuttavia, se i tuoi dati non seguono le nostre linee guida sulla struttura, li visualizzeremo in modalità raw: vedrai i dati, ma senza le funzionalità interattive dell'interfaccia utente come schede, record, sezioni, drag-and-drop, ecc.
Questa documentazione spiega l'esatta struttura JSON prevista da Hexbon. Seguire questa struttura garantisce che i tuoi dati siano pienamente compatibili con le funzionalità interattive della nostra dashboard.
Panoramica della Struttura
I dati Hexbon seguono una rigorosa struttura gerarchica. Comprendere questa gerarchia è fondamentale per organizzare correttamente i propri dati.
Gerarchia dei Dati
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Proprietà | Obbligatorio | Si applica a |
|---|---|---|
| cards | Sì | Oggetto radice |
| title | Sì | Scheda, Record |
| records | Sì | Scheda |
| data | Sì | Record (array di sezioni) |
| name | Sì | Sezione |
| values | Sì | Sezione |
| value | Sì | Valore |
| type | Sì | Valore (secret, note, totp, link, email) |
| id | No | Valore (per l'ordinamento) |
| updated_at | No | Scheda (timestamp) |
Schede
Le schede sono i contenitori di primo livello nella tua dashboard. Ogni scheda appare come un riquadro cliccabile che può essere espanso per rivelare i suoi record. Le schede possono essere riordinate tramite drag-and-drop.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Proprietà | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| title | string | Sì | Il nome visualizzato sul riquadro della scheda |
| records | array | Sì | Array di oggetti Record (può essere vuoto) |
| updated_at | integer | No | Timestamp Unix per la visualizzazione "ultimo aggiornamento" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Record
I record sono voci all'interno di una scheda. Appaiono nella barra laterale sinistra quando viene aperta una scheda e possono essere selezionati per visualizzarne le sezioni. Pensa ai record come a singoli elementi o voci (ad esempio, "Account Gmail", "VPN aziendale", "Credenziali database").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Proprietà | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| title | string | Sì | Il nome visualizzato nell'elenco dei record |
| data | array | Sì | Array di oggetti Sezione (può essere vuoto) |
Nota:
La proprietà data contiene "sezioni", non dati grezzi. Questa denominazione è per motivi storici. Ogni elemento nell'array data è un oggetto Sezione.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Sezioni
Le sezioni raggruppano valori correlati all'interno di un record. Forniscono un livello organizzativo che aiuta a categorizzare diversi tipi di informazioni (ad esempio, "Dettagli di accesso", "Opzioni di ripristino", "Chiavi API"). Ogni sezione ha un nome e contiene più valori.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Proprietà | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| name | string | Sì | L'intestazione della sezione visualizzata sopra i valori |
| values | array | Sì | Array di oggetti Valore contenenti i tuoi dati |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Valori
I valori sono le voci di dati effettive: i segreti, le note e i codici TOTP che memorizzi. Ogni valore ha un tipo che determina come viene visualizzato e come si interagisce con esso nell'interfaccia utente.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Proprietà | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| value | string | Sì | Il contenuto effettivo (password, testo della nota, segreto TOTP) |
| type | string | Sì | Uno tra: "secret", "note", "totp", "link", "email" o "username" |
| id | string | No | Identificatore univoco utilizzato per lordinamento e il riferimento |
Tipi di Valore
| Tipo | Visualizzazione | Caso d'uso |
|---|---|---|
| "secret" | Nascosto per impostazione predefinita (•••••), clicca per rivelare | Password, chiavi API, dati sensibili |
| "note" | Testo normale sempre visibile | Nomi utente, e-mail, URL, informazioni non sensibili |
| "totp" | Genera codici a 6 cifre in tempo reale | Segreti 2FA (codificati in Base32) |
| "link" | Collegamento ipertestuale cliccabile | URL, indirizzi di siti web |
| "email" | Indirizzo e-mail con collegamento mailto | Indirizzi e-mail |
| "username" | Testo normale sempre visibile con icona utente | Nomi utente, identificatori di account |
// 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"
}Esempio Completo
Ecco una struttura dati completa e valida che mostra lintera gerarchia con più schede, record, sezioni e diversi tipi di valore.
{
"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
}
]
}Modalità Raw
Se i tuoi dati decrittografati non seguono la struttura prevista, Hexbon li visualizzerà comunque, ma in modalità raw. Ciò significa che vedrai i tuoi dati come JSON semplice senza le funzionalità interattive fornite dai dati strutturati.
| Funzionalità | Modalità Strutturata | Modalità Raw |
|---|---|---|
| Riquadri delle schede interattivi | ||
| Riordinamento drag-and-drop | ||
| Mascheramento dei segreti con interruttore di rivelazione | ||
| Generazione di codici TOTP in tempo reale | ||
| Modifica in loco e salvataggio automatico | ||
| Pulsanti di copia negli appunti |
I tuoi dati sono sempre al sicuro
La modalità raw influisce solo sulla visualizzazione, non sulla sicurezza. I tuoi dati sono sempre crittografati con crittografia AES-256-GCM indipendentemente dalla struttura. Semplicemente non otterrai le funzionalità interattive dellinterfaccia utente se la struttura non corrisponde.
Valida la tua Struttura Dati
Usa il nostro strumento di validazione interattivo per controllare la tua struttura dati in tempo reale.
Prova lo Strumento di Validazione