Adatszerkezet
A Hexbon nem csak titkosítja az adatait - strukturálja is őket. Ismerje meg a szükséges JSON formátumot, és ellenőrizze adatait a teljes interaktív élmény feloldásához.
Fejezetek
Miért fontos az adatszerkezet?
A Hexbon több, mint egy titkosító eszköz; ez egy strukturált adattároló rendszer. Az adatai hierarchikus formátumban vannak rendszerezve, ami olyan hatékony funkciókat tesz lehetővé, mint a drag-and-drop átrendezés, az interaktív kártyák, a kibontható rekordok és a rendszerezett szekciók.
Szerkezet vs. Titkosítás
Az adatait bármikor fel tudjuk törni, ha megadja a helyes titkosítási kulcsot. Ha azonban az adatai nem követik a szerkezeti irányelveinket, akkor nyers (raw) módban jelenítjük meg őket - látni fogja az adatokat, de az interaktív UI funkciók, mint a kártyák, rekordok, szekciók, drag-and-drop stb. nélkül.
Ez a dokumentáció elmagyarázza a Hexbon által elvárt pontos JSON szerkezetet. Ennek a szerkezetnek a követése biztosítja, hogy adatai teljes mértékben kompatibilisek legyenek az irányítópultunk interaktív funkcióival.
Szerkezeti áttekintés
A Hexbon adatai szigorú hierarchiát követnek. Ennek a hierarchiának a megértése a kulcs az adatok helyes rendszerezéséhez.
Adathierarchia
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Tulajdonság | Kötelező | Érvényes |
|---|---|---|
| cards | Igen | Gyökérobjektum |
| title | Igen | Kártya, Rekord |
| records | Igen | Kártya |
| data | Igen | Rekord (szekciók tömbje) |
| name | Igen | Szekció |
| values | Igen | Szekció |
| value | Igen | Érték |
| type | Igen | Érték (secret, note, totp, link, email) |
| id | Nem | Érték (rendezéshez) |
| updated_at | Nem | Kártya (időbélyeg) |
Kártyák
A kártyák a legfelső szintű konténerek az irányítópulton. Minden kártya kattintható csempeként jelenik meg, amely kibontható a rekordok megjelenítéséhez. A kártyák drag-and-drop módszerrel átrendezhetők.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Tulajdonság | Típus | Kötelező | Leírás |
|---|---|---|---|
| title | string | Igen | A kártyacsempén megjelenő név |
| records | array | Igen | Rekord objektumok tömbje (lehet üres) |
| updated_at | integer | Nem | Unix időbélyeg az "utolsó frissítés" megjelenítéséhez |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Rekordok
A rekordok a kártyán belüli bejegyzések. A kártya megnyitásakor a bal oldali sávban jelennek meg, és kiválaszthatók a szekcióik megtekintéséhez. Gondoljon a rekordokra egyedi tételekként vagy bejegyzésekként (pl. "Gmail fiók", "Céges VPN", "Adatbázis hitelesítő adatok").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Tulajdonság | Típus | Kötelező | Leírás |
|---|---|---|---|
| title | string | Igen | A rekordlistában megjelenő név |
| data | array | Igen | Szekció objektumok tömbje (lehet üres) |
Megjegyzés:
A data tulajdonság "szekciókat" tartalmaz, nem nyers adatokat. Ez az elnevezés történelmi okokból maradt meg. A data tömb minden eleme egy Szekció objektum.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Szekciók
A szekciók a kapcsolódó értékeket csoportosítják egy rekordon belül. Olyan szervezeti szintet biztosítanak, amely segít a különböző típusú információk kategorizálásában (pl. "Bejelentkezési adatok", "Helyreállítási opciók", "API kulcsok"). Minden szekciónak van neve, és több értéket tartalmaz.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Tulajdonság | Típus | Kötelező | Leírás |
|---|---|---|---|
| name | string | Igen | Az értékek felett megjelenő szekciófejléc |
| values | array | Igen | Az adatait tartalmazó Érték objektumok tömbje |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Értékek
Az értékek a tényleges adatbejegyzések - a titkok, jegyzetek és TOTP kódok, amelyeket tárol. Minden értéknek van egy típusa, amely meghatározza, hogyan jelenik meg, és hogyan lép vele interakcióba a felhasználói felületen.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Tulajdonság | Típus | Kötelező | Leírás |
|---|---|---|---|
| value | string | Igen | A tényleges tartalom (jelszó, jegyzet szövege, TOTP titok) |
| type | string | Igen | Az alábbiak egyike: "secret", "note", "totp", "link", "email" vagy "username" |
| id | string | Nem | Egyedi azonosító a rendezéshez és hivatkozáshoz |
Értéktípusok
| Típus | Megjelenítés | Felhasználási eset |
|---|---|---|
| "secret" | Alapértelmezés szerint rejtett (•••••), kattintson a felfedéshez | Jelszavak, API kulcsok, érzékeny adatok |
| "note" | Mindig látható sima szöveg | Felhasználónevek, e-mailek, URL-ek, nem érzékeny információk |
| "totp" | Valós idejű 6 jegyű kódokat generál | 2FA titkok (Base32 kódolással) |
| "link" | Kattintható hivatkozás | URL-ek, weboldal címek |
| "email" | E-mail cím mailto hivatkozással | E-mail címek |
| "username" | Mindig látható sima szöveg felhasználói ikonnal | Felhasználónevek, fiókazonosítók |
// 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"
}Teljes példa
Íme egy teljes, érvényes adatszerkezet, amely bemutatja a teljes hierarchiát több kártyával, rekorddal, szekcióval és különböző értéktípusokkal.
{
"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
}
]
}Nyers (Raw) mód
Ha a feltört adatai nem követik az elvárt szerkezetet, a Hexbon továbbra is megjeleníti őket, de nyers módban. Ez azt jelenti, hogy az adatait egyszerű JSON-ként fogja látni a strukturált adatok által biztosított interaktív funkciók nélkül.
| Funkció | Strukturált mód | Nyers mód |
|---|---|---|
| Interaktív kártyacsempék | ||
| Drag-and-drop átrendezés | ||
| Titkok maszkolása felfedés kapcsolóval | ||
| Valós idejű TOTP kódgenerálás | ||
| Helyben történő szerkesztés és automatikus mentés | ||
| Másolás a vágólapra gombok |
Az adatai mindig biztonságban vannak
A nyers mód csak a megjelenítést befolyásolja, a biztonságot nem. Az adatait mindig AES-256-GCM titkosítással titkosítjuk, függetlenül a szerkezettől. Egyszerűen nem kapja meg az interaktív UI funkciókat, ha a szerkezet nem egyezik.
Ellenőrizze adatszerkezetét
Használja interaktív ellenőrző eszközünket az adatszerkezet valós idejű ellenőrzéséhez.
Próbálja ki az ellenőrző eszközt