- Početna
- Struktura podataka
Struktura podataka
Hexbon ne samo da kriptira vaše podatke - on ih i strukturira. Saznajte više o potrebnom JSON formatu i potvrdite svoje podatke kako biste otključali potpuno interaktivno iskustvo.
Poglavlja
Zašto je struktura podataka važna
Hexbon je više od običnog alata za kriptiranje; to je strukturirani sustav za pohranu podataka. Vaši su podaci organizirani u hijerarhijskom formatu koji omogućuje moćne značajke kao što su povlačenje i ispuštanje za promjenu redoslijeda, interaktivne kartice, proširivi zapisi i organizirani odjeljci.
Struktura nasuprot kriptiranju
Uvijek možemo dekriptirati vaše podatke ako dostavite ispravan ključ za kriptiranje. Međutim, ako vaši podaci ne slijede naše smjernice za strukturu, prikazat ćemo ih u sirovom načinu (raw mode) - vidjet ćete podatke, ali bez interaktivnih značajki korisničkog sučelja kao što su kartice, zapisi, odjeljci, povlačenje i ispuštanje itd.
Ova dokumentacija opisuje točnu JSON strukturu koju Hexbon očekuje. Pridržavanje ove strukture osigurava da su vaši podaci u potpunosti kompatibilni s interaktivnim značajkama naše nadzorne ploče.
Pregled strukture
Hexbon podaci slijede strogu hijerarhiju. Razumijevanje ove hijerarhije ključno je za ispravno organiziranje vaših podataka.
Hijerarhija podataka
{ "cards": [...] }
{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}
{
"title": "Gmail",
"data": [...]
}
{
"name": "Login",
"values": [...]
}
{
"value": "secret123",
"type": "secret"
}
| Svojstvo | Obavezno | Odnosi se na |
|---|---|---|
| cards | Da | Korijenski objekt |
| title | Da | Kartica, Zapis |
| records | Da | Kartica |
| data | Da | Zapis (niz odjeljaka) |
| name | Da | Odjeljak |
| values | Da | Odjeljak |
| value | Da | Vrijednost |
| type | Da | Vrijednost (secret, note, totp, link, email) |
| id | Ne | Vrijednost (za sortiranje) |
| updated_at | Ne | Kartica (vremenska oznaka) |
Kartice
Kartice su spremnici najviše razine na vašoj nadzornoj ploči. Svaka se kartica pojavljuje kao okvir koji se može kliknuti i proširiti kako bi se prikazali njezini zapisi. Kartice se mogu presložiti povlačenjem i ispuštanjem.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}
| Svojstvo | Vrsta | Obavezno | Opis |
|---|---|---|---|
| title | string | Da | Naziv prikazan na okviru kartice |
| records | array | Da | Niz objekata zapisa (može biti prazan) |
| updated_at | integer | Ne | Unix vremenska oznaka za prikaz "zadnje ažurirano" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}
Zapisi
Zapisi su unosi unutar kartice. Pojavljuju se u lijevoj bočnoj traci kada se kartica otvori i mogu se odabrati za pregled odjeljaka. Razmišljajte o zapisima kao o pojedinačnim stavkama ili unosima (npr. "Gmail račun", "Poslovni VPN", "Podaci za prijavu u bazu podataka").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}
| Svojstvo | Vrsta | Obavezno | Opis |
|---|---|---|---|
| title | string | Da | Naziv prikazan na popisu zapisa |
| data | array | Da | Niz objekata odjeljaka (može biti prazan) |
Napomena:
Svojstvo data sadrži "odjeljke", a ne sirove podatke. Ovo imenovanje je iz povijesnih razloga. Svaka stavka u nizu data je objekt odjeljka.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}
Odjeljci
Odjeljci grupiraju povezane vrijednosti unutar zapisa. Oni pružaju organizacijsku razinu koja pomaže u kategorizaciji različitih vrsta informacija (npr. "Podaci za prijavu", "Opcije oporavka", "API ključevi"). Svaki odjeljak ima naziv i sadrži više vrijednosti.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}
| Svojstvo | Vrsta | Obavezno | Opis |
|---|---|---|---|
| name | string | Da | Naslov odjeljka prikazan iznad vrijednosti |
| values | array | Da | Niz objekata vrijednosti koji sadrže vaše podatke |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}
Vrijednosti
Vrijednosti su stvarni unosi podataka - lozinke, bilješke i TOTP kodovi koje pohranjujete. Svaka vrijednost ima vrstu koja određuje kako se prikazuje i kako se s njom komunicira u korisničkom sučelju.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}
| Svojstvo | Vrsta | Obavezno | Opis |
|---|---|---|---|
| value | string | Da | Stvarni sadržaj (lozinka, tekst bilješke, TOTP tajna) |
| type | string | Da | Jedno od sljedećeg: "secret", "note", "totp", "link", "email" ili "username" |
| id | string | Ne | Jedinstveni ID koji se koristi za sortiranje i referenciranje |
Vrste vrijednosti
| Vrsta | Prikaz | Slučaj upotrebe |
|---|---|---|
| "secret" | Skriveno prema zadanim postavkama (•••••), kliknite za otkrivanje | Lozinke, API ključevi, osjetljivi podaci |
| "note" | Uvijek vidljiv običan tekst | Korisnička imena, e-pošta, URL-ovi, neosjetljive informacije |
| "totp" | Generira 6-znamenkaste kodove u stvarnom vremenu | 2FA tajne (Base32 kodirano) |
| "link" | Hiperveza na koju se može kliknuti | URL-ovi, adrese web stranica |
| "email" | Adresa e-pošte s mailto vezom | Adrese e-pošte |
| "username" | Uvijek vidljiv običan tekst s ikonom korisnika | Korisnička imena, ID-ovi računa |
// 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"
}
Potpuni primjer
Ovdje je potpuna i valjana struktura podataka koja prikazuje cijelu hijerarhiju s više kartica, zapisa, odjeljaka i različitih vrsta vrijednosti.
{
"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
}
]
}
Sirovi način (Raw Mode)
Ako vaši dekriptirani podaci ne slijede očekivanu strukturu, Hexbon će ih ipak prikazati, ali u sirovom načinu. To znači da ćete svoje podatke vidjeti kao jednostavan JSON bez interaktivnih značajki koje pružaju strukturirani podaci.
| Značajka | Strukturirani način | Sirovi način |
|---|---|---|
| Interaktivni okviri kartica | ||
| Povlačenje i ispuštanje za promjenu redoslijeda | ||
| Maskiranje tajni s prekidačem za otkrivanje | ||
| Generiranje TOTP koda u stvarnom vremenu | ||
| Uređivanje na licu mjesta i automatsko spremanje | ||
| Gumbi za kopiranje u međuspremnik |
Vaši su podaci uvijek sigurni
Sirovi način utječe samo na prezentaciju, a ne na sigurnost. Vaši su podaci uvijek kriptirani AES-256-GCM algoritmom, bez obzira na strukturu. Samo nećete dobiti interaktivne značajke korisničkog sučelja ako se struktura ne podudara.
Potvrdite svoju strukturu podataka
Upotrijebite naš interaktivni alat za validaciju kako biste provjerili svoju strukturu podataka u stvarnom vremenu.
Isprobajte alat za validaciju