03.
— Section 3
Credentials
macOS Keychain
Neno lako la siri halifikii diski kamwe.
jmapcli haihifadhi siri yoyote kwenye diski. Neno lako la siri (au tokeni ya bearer) inaishi katika Keychain ya kuingia ya macOS; faili la akaunti — ~/.config/jmapcli/config.json, hali 0600 — huhifadhi tu URL ya seva, jina lako la mtumiaji na bendera ya msingi. Mpya kwenye Keychain kutoka kwa terminal? Mtiririko wote wa kazi ni amri tatu za security zilizojengwa ndani.
1 · Hifadhi siri — na uisomee tena. macOS inakuuliza thamani, kwa hivyo siri haijawahi kuandikwa kwenye mstari wa amri, kuonyeshwa kwenye skrini, au kuandikwa kwenye historia ya shell yako.
# store it — you’re prompted for the secret, nothing echoes
$ security add-generic-password -U -s jmap-password -a you@example.com -l "Boogie JMAP password" -w
# read it back at any time
$ security find-generic-password -s jmap-password -a you@example.com -w
# remove it
$ security delete-generic-password -s jmap-password -a you@example.com
- -s
- huduma — jina ambalo jmapcli hutafuta: jmap-password kwa neno la siri, au jmap-token kwa tokeni ya bearer (k.m. Fastmail); weka moja tu unayotumia.
- -a
- akaunti — anwani yako ya barua pepe (jina lile lile la mtumiaji unalotoa kwa jmapcli).
- -l
- lebo — utakachokiona katika programu ya Keychain Access; -U husasisha kipengee kilichopo mahali pake.
- -w
- bila thamani — uliza siri. Hii ndiyo sehemu inayoizuia kutoka kwa ~/.zsh_history na orodha ya michakato.
2 · Uelekeze jmapcli kwenye seva yako. Sajili akaunti mara moja; siri huvutwa moja kwa moja kutoka kwa kipengee cha Keychain ulichohifadhi, kwa hivyo haionekani kamwe kwenye mstari wa amri.
$ jmapcli login --url https://mail.example.com --username you@example.com \
--password "$(security find-generic-password -s jmap-password -a you@example.com -w)"
# token auth: swap --password for --token (and store under jmap-token above)
$ jmapcli list # from here on, every command reads the Keychain for you
# OAuth — no app password to create, copy, or rotate.
# Your browser opens once; the token lands in the Keychain under jmap-oauth.
$ jmapcli login --url https://api.fastmail.com --username you@fastmail.com --oauth
# Stalwart — or any server that speaks RFC 8252 — same flag.
$ jmapcli login --url https://mail.example.com --username you@example.com --oauth
3.1
Hakuna chochote katika historia yako, kumbukumbu — au muktadha wa AI
Mara siri inapokuwa katika Keychain, amri za kila siku (list, send, draft, sync) hazibebei neno la siri, kwa hivyo haiwezi kunaswa katika ~/.zsh_history, orodha ya michakato au kumbukumbu za CI. Hiyo ndiyo inayofanya jmapcli kuwa salama kuendeshwa kutoka kwa zana za terminal-AI — wakala hupewa mteja wa JMAP, si siri yako.
— zsh
CI · agents
3.2
Badilisha au toka
Umebadilisha neno lako la siri? Endesha tena mstari wa security add-generic-password … -w — -U huiandika upya mahali pake. Ili kuondoa akaunti, jmapcli logout hufuta ingizo la usanidi na siri ya Keychain katika hatua moja (--all hufuta kila akaunti).
— rotate
logout
3.3
Kwa kila Mac kwa makusudi
Keychain ya kuingia hailandanishwi kupitia iCloud — mpaka uliokusudiwa, ili neno lako la siri lisiwahi kuondoka kwenye Mac ulioliandika. Rudia hatua ya security mara moja kwa kila Mac; config.json inaweza kuwa katika folda ya nyumbani iliyolandanishwa kwa sababu haibeba siri yoyote.
— per
machine
Boogie