tom_secrets_client 0.2.2
tom_secrets_client: ^0.2.2 copied to clipboard
The Dart client of the Tom Secrets Manager: finds the local secrets service, speaks its client protocol (frames, hello, get, getMany, getFile) and parses and formats secret references.
Changelog #
0.2.2 #
- The README rewritten as the package's manual; API summaries of the client and the admin library in
doc/api/. tomSecretsStartService: a status line that is not JSON or not an object is a failed start (no_answer), not an exception.
0.2.1 #
pairing_mode.dartin the admin library: the service's pairing mode astsm pairdrives it — the handover (TomSecretsPairingHandover), what the pairing gave (TomSecretsPairingReport) and the conversation (TomSecretsServicePairing:received,setUp,close).
0.2.0 #
distribution.dartin the admin library: the layout of the manager app's distribution, which carriestsmand the service in itstsm/binfolder (tomSecretsServiceCandidates,tomSecretsDistributionApp).TomSecretsAdminKeyringin the admin library: the admin keys in the keychain with the index of their starts (tsm.admin.index);keep,forget,pruneOthers.
0.1.0 #
- The admin side, in its own library
package:tom_secrets_client/admin.dartfor the manager app,tsmand the service:TomSecretsAdminClient(the mutual challenge andclaim),TomSecretsRuntime(the runtime directory),tomSecretsStartServicewith the admin-key handover,tomSecretsDataDirectory/tomSecretsBootstrapPath(TSM_DATA_DIR, else the OS's application-data folder), and the keychain names (tomSecretsKeychainService,tomSecretsAdminKeyHandle). - The client endpoint of the Tom Secrets Manager protocol, version 1: finding
the service (runtime directory, Unix socket, or on Windows the localhost
port and the client token re-read at every connect), frames with their
limits and strict JSON payloads,
hello/welcome,get,getManyand (phase B)getFileover binary chunks with its SHA-256 check. - Waiting for an unlock or an approval:
wait,timeoutastimeoutMs, progress notices with the approval code. TomSecretReference.parse/format: the reference grammar, its canonical form and the malformed reasons, refused locally.TomSecretValue: text or bytes, entry (sourcegithub,fileorcache), bindings, version, expiry, client token; maskedtoString,disposeoverwrites the buffer.TomSecretsClientExceptionwithTomSecretsErrorKind: the protocol's kinds plusnotRunning;rateLimitedwaited out on request.