Tietorakenne
Hexbon ei ainoastaan salaa tietojasi - se myös rakentaa ne. Lue vaaditusta JSON-muodosta ja validoi tietosi avataksesi täyden interaktiivisen kokemuksen.
Luvut
Miksi tietorakenne on tärkeä
Hexbon on enemmän kuin pelkkä salaustyökalu; se on rakenteellinen tietovarasto. Tietosi on järjestetty hierarkkiseen muotoon, mikä mahdollistaa tehokkaat ominaisuudet, kuten vedä ja pudota -uudelleenjärjestelyn, interaktiiviset kortit, laajennettavat tietueet ja järjestetyt osiot.
Rakenne vs. salaus
Voimme aina purkaa tietosi, jos annat oikean salausavaimen. Jos tietosi eivät kuitenkaan noudata rakenneohjeitamme, näytämme ne raakatilassa (raw mode) - näet tiedot, mutta ilman interaktiivisia käyttöliittymäominaisuuksia, kuten kortteja, tietueita, osioita, vedä ja pudota -toimintoa jne.
Tämä dokumentaatio kuvaa tarkan JSON-rakenteen, jota Hexbon odottaa. Tämän rakenteen noudattaminen varmistaa, että tietosi ovat täysin yhteensopivia hallintapaneelimme interaktiivisten ominaisuuksien kanssa.
Rakenteen yleiskatsaus
Hexbonin tiedot noudattavat tiukkaa hierarkiaa. Tämän hierarkian ymmärtäminen on avain tietojesi oikeaan järjestämiseen.
Tietohierarkia
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Ominaisuus | Pakollinen | Koskee |
|---|---|---|
| cards | Kyllä | Juuriolio |
| title | Kyllä | Kortti, Tietue |
| records | Kyllä | Kortti |
| data | Kyllä | Tietue (osioiden taulukko) |
| name | Kyllä | Osio |
| values | Kyllä | Osio |
| value | Kyllä | Arvo |
| type | Kyllä | Arvo (secret, note, totp, link, email) |
| id | Ei | Arvo (lajittelua varten) |
| updated_at | Ei | Kortti (aikaleima) |
Kortit
Kortit ovat hallintapaneelisi ylimmän tason säiliöitä. Jokainen kortti näkyy klikattavana laatikkona, joka voidaan laajentaa sen tietueiden näyttämiseksi. Kortteja voidaan järjestää uudelleen vedä ja pudota -toiminnolla.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Ominaisuus | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| title | string | Kyllä | Korttilaatikossa näkyvä nimi |
| records | array | Kyllä | Tietueolioiden taulukko (voi olla tyhjä) |
| updated_at | integer | Ei | Unix-aikaleima "viimeksi päivitetty" -tiedon näyttämiseen |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Tietueet
Tietueet ovat merkintöjä kortin sisällä. Ne näkyvät vasemmassa sivupalkissa, kun kortti avataan, ja ne voidaan valita osioiden tarkastelemiseksi. Ajattele tietueita yksittäisinä kohteina tai merkintöinä (esim. "Gmail-tili", "Yrityksen VPN", "Tietokannan kirjautumistiedot").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Ominaisuus | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| title | string | Kyllä | Tietueluettelossa näkyvä nimi |
| data | array | Kyllä | Osio-olioiden taulukko (voi olla tyhjä) |
Huomautus:
Ominaisuus data sisältää "osioita", ei raakatietoja. Tämä nimeäminen johtuu historiallisista syistä. Jokainen kohde data-taulukossa on osio-olio.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Osiot
Osiot ryhmittelevät toisiinsa liittyvät arvot tietueen sisällä. Ne tarjoavat organisatorisen tason, joka auttaa luokittelemaan erilaisia tietoja (esim. "Kirjautumistiedot", "Palautusvaihtoehdot", "API-avaimet"). Jokaisella osiolla on nimi ja se sisältää useita arvoja.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Ominaisuus | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| name | string | Kyllä | Osion otsikko, joka näkyy arvojen yläpuolella |
| values | array | Kyllä | Arvo-olioiden taulukko, joka sisältää tietosi |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Arvot
Arvot ovat varsinaisia tietomerkintöjä - salasanoja, muistiinpanoja ja TOTP-koodeja, joita tallennat. Jokaisella arvolla on tyyppi, joka määrittää, miten se näytetään ja miten sen kanssa ollaan vuorovaikutuksessa käyttöliittymässä.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Ominaisuus | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| value | string | Kyllä | Varsinainen sisältö (salasana, muistiinpanon teksti, TOTP-salaisuus) |
| type | string | Kyllä | Yksi seuraavista: "secret", "note", "totp", "link", "email" tai "username" |
| id | string | Ei | Yksilöllinen tunnus, jota käytetään lajitteluun ja viittaamiseen |
Arvotyypit
| Tyyppi | Näyttö | Käyttötapaus |
|---|---|---|
| "secret" | Oletuksena piilotettu (•••••), klikkaa paljastaaksesi | Salasanat, API-avaimet, arkaluonteiset tiedot |
| "note" | Aina näkyvä tavallinen teksti | Käyttäjätunnukset, sähköpostit, URL-osoitteet, ei-arkaluonteiset tiedot |
| "totp" | Luo 6-numeroisia koodeja reaaliajassa | 2FA-salaisuudet (Base32-koodattu) |
| "link" | Klikattava hyperlinkki | URL-osoitteet, verkkosivustojen osoitteet |
| "email" | Sähköpostiosoite mailto-linkillä | Sähköpostiosoitteet |
| "username" | Aina näkyvä tavallinen teksti käyttäjäkuvakkeella | Käyttäjätunnukset, tilitunnukset |
// 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"
}Täydellinen esimerkki
Tässä on täydellinen ja kelvollinen tietorakenne, joka näyttää koko hierarkian useilla korteilla, tietueilla, osioilla ja eri arvotyypeillä.
{
"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
}
]
}Raakatila (Raw Mode)
Jos purettu tietosi ei noudata odotettua rakennetta, Hexbon näyttää sen silti, mutta raakatilassa. Tämä tarkoittaa, että näet tietosi yksinkertaisena JSON-muotona ilman rakenteellisen tiedon tarjoamia interaktiivisia ominaisuuksia.
| Ominaisuus | Rakenteellinen tila | Raakatila |
|---|---|---|
| Interaktiiviset korttilaatikot | ||
| Vedä ja pudota -uudelleenjärjestely | ||
| Salaisuuksien peittäminen paljastuskytkimellä | ||
| Reaaliaikainen TOTP-koodien luonti | ||
| Muokkaus paikan päällä ja automaattinen tallennus | ||
| Kopioi leikepöydälle -painikkeet |
Tietosi ovat aina turvassa
Raakatila vaikuttaa vain esitystapaan, ei turvallisuuteen. Tietosi on aina AES-256-GCM-salattu rakenteesta riippumatta. Et vain saa interaktiivisia käyttöliittymäominaisuuksia, jos rakenne ei täsmää.
Validoi tietorakenteesi
Käytä interaktiivista validointityökaluamme tarkistaaksesi tietorakenteesi reaaliajassa.
Kokeile validointityökalua