Databázová schéma

Šesť migrácií len na publikovanie a len dopredu (bez down(), časová značka sa doplní pri publikovaní, balík ich nikdy nenačítava sám). Žiadna tabuľka balíka nepoužíva soft delete a žiadny model sa nedá vymeniť — bezpečnostný stav sa ukladá len cez tieto modely a engine.

Pečate, denník a kontrolné body žijú na pripojení každého zapečateného modelu a zdieľajú jeho transakciu. Ak máte zapečatené modely na viacerých pripojeniach, publikujte a spustite 0002–0004 na každom a uveďte ich v ledger.connections.

Prechod z predbežnej verzie

Migrácia 0004_create_sentinel_seals_table bola upravená priamo, aby pridala stĺpec attributes_mac s povolenou hodnotou null (MAC dokumentu atribútov pre pečate s vypočítanými poľami); nová migrácia neexistuje. Ak ste spustili staršiu predbežnú kópiu, migrácie znovu publikujte a 0004 spustite znova, alebo stĺpec do sentinel_seals pridajte sami — string('attributes_mac', 192)->nullable() — ešte pred ďalším zapečateným zápisom. Inštalácie z aktuálnych migrácií stĺpec už majú.

Modely

Čítajte ich na reporting (Seal::query()->where('key_id', $kid)->count()), nikdy do nich nezapisujte: každý zápis vlastní engine a úpravy zachytia MAC, reťaz aj obálky. Každá časová značka balíka sa castuje cez Casts\UtcDateTime (UTC, mikrosekundy, CarbonImmutable), takže časové pásmo aplikácie nikdy nepresiakne do uložených ani MAC-om chránených časov.

Factories

• KeyFactory — ->hmac(), ->ed25519(), ->ecdsaP256(), ->verifyOnly(), ->revoked(), ->retired(), ->pending(), ->ring(), všetky s platnými obálkami.
• SealFactory — ->forSealable(Model $m, string $seal), štrukturálne platná, no nepodpísaná: pre testy Malformed a negatívne testy.
• LedgerEntryFactory — ->forSealable(Model $m, string $seal), ->tombstone(SealEvent $event = SealEvent::Deleted); plus CheckpointFactory.
• IdempotencyKeyFactory — ->processing(), ->completed(), ->expired().
• NonceFactory — ->issued(), ->seen(), ->consumed(), ->expired().

Uchovávanie

Ochrana tabuliek

Sentinel odhalí zmeny aj v týchto tabuľkách, no databázové oprávnenia manipuláciu sťažia už na začiatku. Používateľ aplikácie potrebuje INSERT a SELECT na sentinel_ledger a sentinel_checkpoints, na denníku len UPDATE (checkpoint_id) a jedno oprávnenie na zámok riadku, ktoré si vyžaduje každý engine, pretože sentinel:checkpoint zamyká koniec kontrolných bodov cez SELECT … FOR UPDATE. Nikdy nie DELETE. Prístupové údaje k úložisku kotvy držte oddelene od databázových.

-- PostgreSQL
GRANT SELECT, INSERT ON sentinel_ledger, sentinel_checkpoints TO app;
GRANT UPDATE (checkpoint_id) ON sentinel_ledger TO app;
GRANT UPDATE (seq) ON sentinel_checkpoints TO app;

-- MySQL
GRANT SELECT, INSERT ON app_db.sentinel_ledger TO 'app'@'%';
GRANT SELECT, INSERT ON app_db.sentinel_checkpoints TO 'app'@'%';
GRANT UPDATE (checkpoint_id) ON app_db.sentinel_ledger TO 'app'@'%';
GRANT LOCK TABLES ON app_db.* TO 'app'@'%';