Datenstruktur
Hexbon verschlüsselt Ihre Daten nicht nur - es strukturiert sie auch. Lernen Sie das erforderliche JSON-Format kennen und validieren Sie Ihre Daten, um das volle interaktive Erlebnis freizuschalten.
Kapitel
Warum die Datenstruktur wichtig ist
Hexbon ist mehr als nur ein Verschlüsselungstool - es ist ein Speichersystem für strukturierte Daten. Ihre Daten werden in einem hierarchischen Format organisiert, das leistungsstarke Funktionen wie Drag-and-Drop-Neuordnung, interaktive Karten, erweiterbare Datensätze und organisierte Abschnitte ermöglicht.
Struktur vs. Verschlüsselung
Wir können Ihre Daten jederzeit entschlüsseln, wenn Sie den richtigen Verschlüsselungsschlüssel angeben. Wenn Ihre Daten jedoch nicht unseren Strukturrichtlinien entsprechen, zeigen wir sie im Raw-Modus an - Sie sehen die Daten, aber ohne die interaktiven UI-Funktionen wie Karten, Datensätze, Abschnitte, Drag-and-Drop usw.
Diese Dokumentation erklärt die genaue JSON-Struktur, die Hexbon erwartet. Die Einhaltung dieser Struktur stellt sicher, dass Ihre Daten vollständig mit unseren interaktiven Dashboard-Funktionen kompatibel sind.
Strukturübersicht
Hexbon-Daten folgen einer strengen hierarchischen Struktur. Das Verständnis dieser Hierarchie ist der Schlüssel zur ordnungsgemäßen Organisation Ihrer Daten.
Datenhierarchie
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Eigenschaft | Erforderlich | Gilt für |
|---|---|---|
| cards | Ja | Wurzelobjekt |
| title | Ja | Karte, Datensatz |
| records | Ja | Karte |
| data | Ja | Datensatz (Abschnitts-Array) |
| name | Ja | Abschnitt |
| values | Ja | Abschnitt |
| value | Ja | Wert |
| type | Ja | Wert (secret, note, totp, link, email) |
| id | Nein | Wert (für Sortierung) |
| updated_at | Nein | Karte (Zeitstempel) |
Karten
Karten sind die obersten Container in Ihrem Dashboard. Jede Karte erscheint als anklickbare Kachel, die erweitert werden kann, um ihre Datensätze anzuzeigen. Karten können per Drag-and-Drop neu angeordnet werden.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| title | string | Ja | Der auf der Kartenkachel angezeigte Anzeigename |
| records | array | Ja | Array von Datensatzobjekten (kann leer sein) |
| updated_at | integer | Nein | Unix-Zeitstempel für die Anzeige "Zuletzt aktualisiert" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Datensätze
Datensätze sind Einträge innerhalb einer Karte. Sie erscheinen in der linken Seitenleiste, wenn eine Karte geöffnet wird, und können ausgewählt werden, um ihre Abschnitte anzuzeigen. Betrachten Sie Datensätze als einzelne Elemente oder Einträge (z. B. "Gmail-Konto", "Arbeits-VPN", "Datenbank-Anmeldeinformationen").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| title | string | Ja | Der in der Datensatzliste angezeigte Anzeigename |
| data | array | Ja | Array von Abschnittsobjekten (kann leer sein) |
Hinweis:
Die Eigenschaft data enthält "Abschnitte", keine Rohdaten. Diese Benennung hat historische Gründe. Jedes Element im data-Array ist ein Abschnittsobjekt.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Abschnitte
Abschnitte gruppieren verwandte Werte innerhalb eines Datensatzes. Sie bieten eine organisatorische Ebene, die hilft, verschiedene Arten von Informationen zu kategorisieren (z. B. "Anmeldedetails", "Wiederherstellungsoptionen", "API-Schlüssel"). Jeder Abschnitt hat einen Namen und enthält mehrere Werte.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| name | string | Ja | Die über den Werten angezeigte Abschnittsüberschrift |
| values | array | Ja | Array von Wertobjekten, die Ihre Daten enthalten |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Werte
Werte sind die eigentlichen Dateneinträge - die Geheimnisse, Notizen und TOTP-Codes, die Sie speichern. Jeder Wert hat einen Typ, der bestimmt, wie er in der Benutzeroberfläche angezeigt wird und wie mit ihm interagiert wird.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| value | string | Ja | Der eigentliche Inhalt (Passwort, Notiztext, TOTP-Geheimnis) |
| type | string | Ja | Einer von: "secret", "note", "totp", "link", "email" oder "username" |
| id | string | Nein | Eindeutige Kennung, die für Sortierung und Referenzierung verwendet wird |
Werttypen
| Typ | Anzeige | Anwendungsfall |
|---|---|---|
| "secret" | Standardmäßig ausgeblendet (•••••), zum Anzeigen klicken | Passwörter, API-Schlüssel, sensible Daten |
| "note" | Immer sichtbarer Klartext | Benutzernamen, E-Mails, URLs, unempfindliche Informationen |
| "totp" | Generiert Live-6-stellige Codes | 2FA-Geheimnisse (Base32-kodiert) |
| "link" | Anklickbarer Hyperlink | URLs, Website-Adressen |
| "email" | E-Mail-Adresse mit mailto-Link | E-Mail-Adressen |
| "username" | Immer sichtbarer Klartext mit Benutzersymbol | Benutzernamen, Kontokennungen |
// 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"
}Vollständiges Beispiel
Hier ist eine vollständige, gültige Datenstruktur, die die gesamte Hierarchie mit mehreren Karten, Datensätzen, Abschnitten und verschiedenen Werttypen zeigt.
{
"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
}
]
}Raw-Modus
Wenn Ihre entschlüsselten Daten nicht der erwarteten Struktur folgen, zeigt Hexbon sie trotzdem an - aber im Raw-Modus. Das bedeutet, dass Sie Ihre Daten als einfaches JSON ohne die interaktiven Funktionen sehen, die strukturierte Daten bieten.
| Funktion | Strukturierter Modus | Raw-Modus |
|---|---|---|
| Interaktive Kartenkacheln | ||
| Drag-and-Drop-Neuordnung | ||
| Geheimnismaskierung mit Anzeige-Umschalter | ||
| Live-TOTP-Codegenerierung | ||
| In-Place-Bearbeitung & automatisches Speichern | ||
| In-die-Zwischenablage-kopieren-Schaltflächen |
Ihre Daten sind immer sicher
Der Raw-Modus wirkt sich nur auf die Anzeige aus, nicht auf die Sicherheit. Ihre Daten werden unabhängig von der Struktur immer mit AES-256-GCM-Verschlüsselung verschlüsselt. Sie erhalten lediglich nicht die interaktiven UI-Funktionen, wenn die Struktur nicht übereinstimmt.
Validieren Sie Ihre Datenstruktur
Verwenden Sie unser interaktives Validierungstool, um Ihre Datenstruktur in Echtzeit zu überprüfen.
Validierungstool ausprobieren