Datastruktur
Hexbon krypterer ikke bare dataene dine - den strukturerer dem også. Lær om det nødvendige JSON-formatet og valider dataene dine for å låse opp den fulle interaktive opplevelsen.
Kapitler
Hvorfor datastruktur er viktig
Hexbon er mer enn bare et krypteringsverktøy; det er et strukturert datalagringssystem. Dataene dine er organisert i et hierarkisk format som muliggjør kraftige funksjoner som dra-og-slipp-sortering, interaktive kort, utvidbare poster og organiserte seksjoner.
Struktur vs. kryptering
Vi kan alltid dekryptere dataene dine hvis du oppgir riktig krypteringsnøkkel. Men hvis dataene dine ikke følger våre strukturretningslinjer, vil vi vise dem i råmodus (raw mode) - du vil se dataene, men uten de interaktive UI-funksjonene som kort, poster, seksjoner, dra-og-slipp osv.
Denne dokumentasjonen skisserer den nøyaktige JSON-strukturen Hexbon forventer. Ved å følge denne strukturen sikrer du at dataene dine er fullt kompatible med de interaktive funksjonene i kontrollpanelet vårt.
Strukturoversikt
Hexbon-data følger et strengt hierarki. Å forstå dette hierarkiet er nøkkelen til å organisere dataene dine riktig.
Datahierarki
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Egenskap | Påkrevd | Gjelder for |
|---|---|---|
| cards | Ja | Rotobjekt |
| title | Ja | Kort, Post |
| records | Ja | Kort |
| data | Ja | Post (array av seksjoner) |
| name | Ja | Seksjon |
| values | Ja | Seksjon |
| value | Ja | Verdi |
| type | Ja | Verdi (secret, note, totp, link, email) |
| id | Nei | Verdi (for sortering) |
| updated_at | Nei | Kort (tidsstempel) |
Kort
Kort er toppnivå-beholderne i kontrollpanelet ditt. Hvert kort vises som en klikkbar boks som kan utvides for å vise postene sine. Kort kan sorteres på nytt via dra-og-slipp.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Egenskap | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| title | string | Ja | Navnet som vises på kortboksen |
| records | array | Ja | Array av post-objekter (kan være tom) |
| updated_at | integer | Nei | Unix-tidsstempel for å vise "sist oppdatert" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Poster
Poster er oppføringer inne i et kort. De vises i venstre sidefelt når et kort åpnes, og kan velges for å se seksjonene sine. Tenk på poster som individuelle elementer eller oppføringer (f.eks. "Gmail-konto", "Bedrifts-VPN", "Database-legitimasjon").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Egenskap | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| title | string | Ja | Navnet som vises i postlisten |
| data | array | Ja | Array av seksjonsobjekter (kan være tom) |
Merk:
Egenskapen data inneholder "seksjoner", ikke rådata. Denne navngivingen er av historiske årsaker. Hvert element i data-arrayen er et seksjonsobjekt.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Seksjoner
Seksjoner grupperer relaterte verdier inne i en post. De gir et organisatorisk nivå som hjelper til med å kategorisere ulike typer informasjon (f.eks. "Innloggingsdetaljer", "Gjenopprettingsalternativer", "API-nøkler"). Hver seksjon har et navn og inneholder flere verdier.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Egenskap | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| name | string | Ja | Seksjonstittelen som vises over verdiene |
| values | array | Ja | Array av verdiobjekter som inneholder dataene dine |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Verdier
Verdier er de faktiske dataoppføringene - passord, notater og TOTP-koder du lagrer. Hver verdi har en type som bestemmer hvordan den vises og hvordan den samhandles med i brukergrensesnittet.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Egenskap | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| value | string | Ja | Det faktiske innholdet (passord, notat-tekst, TOTP-hemmelighet) |
| type | string | Ja | En av: "secret", "note", "totp", "link", "email", eller "username" |
| id | string | Nei | En unik ID som brukes for sortering og referanse |
Verdityper
| Type | Visning | Brukstilfelle |
|---|---|---|
| "secret" | Skjult som standard (•••••), klikk for å vise | Passord, API-nøkler, sensitive data |
| "note" | Klartekst som alltid er synlig | Brukernavn, e-post, URL-er, ikke-sensitiv informasjon |
| "totp" | Genererer 6-sifrede koder i sanntid | 2FA-hemmeligheter (Base32-kodet) |
| "link" | Klikkbar hyperkobling | URL-er, nettstedsadresser |
| "email" | E-postadresse med mailto-lenke | E-postadresser |
| "username" | Klartekst som alltid er synlig med et brukerikon | Brukernavn, konto-ID-er |
// 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"
}Fullstendig eksempel
Her er en fullstendig, gyldig datastruktur som viser hele hierarkiet med flere kort, poster, seksjoner og ulike verdityper.
{
"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
}
]
}Råmodus (Raw Mode)
Hvis dine dekrypterte data ikke følger den forventede strukturen, vil Hexbon vise dem uansett, men i råmodus. Dette betyr at du vil se dataene dine som enkel JSON uten de interaktive funksjonene som strukturerte data gir.
| Funksjon | Strukturert modus | Råmodus |
|---|---|---|
| Interaktive kortbokser | ||
| Dra-og-slipp-sortering | ||
| Skjuling av hemmeligheter med visningsbryter | ||
| Sanntidsgenerering av TOTP-koder | ||
| Redigering på stedet og automatisk lagring | ||
| Knapper for kopiering til utklippstavle |
Dataene dine er alltid trygge
Råmodus påvirker bare presentasjonen, ikke sikkerheten. Dataene dine er alltid AES-256-GCM-kryptert uavhengig av struktur. Du får bare ikke de interaktive UI-funksjonene hvis strukturen ikke stemmer.
Valider din datastruktur
Bruk vårt interaktive valideringsverktøy for å sjekke datastrukturen din i sanntid.
Prøv valideringsverktøyet