Védje az adataihoz való hozzáférést¶
A Cadrumo minden profilt a saját adatkulcsával titkosít. A profil jelmondata ezt a kulcsot nyitja a szokásos bejelentkezéshez és a napi munkához. Egy opcionális helyreállítási kód ugyanezt a kulcsot csak egyetlen célra nyitja meg: új jelmondat beállítására, ha a régit elfelejtették. A bejelentkezésben soha nem vesz részt.
Ezt az útmutatót használja a jelmondat biztonságos tárolásához, a helyreállítási kód beállításáról szóló döntéshez, a jelmondat megváltoztatásához vagy visszaállításához, a parancsok interaktív kérdés nélküli futtatásához, a biztonságos kijelentkezéshez, és a helyi állapot visszaállításához, amely csak a legvégső eszköz.
Mielőtt hozzákezd¶
Szüksége lesz:
Aktív profil - lásd adófizetői profil beállítása.
A profil jelenlegi jelmondata.
Használja a --language en, es, ca vagy hu opciót, amikor egy adott kimeneti nyelvre van szüksége.
Az összetett jelszó biztonságos tárolása¶
A jelszó megnyitja a titkosított adatok kulcsát. Kezelje ennek megfelelően:
Írja le a jelszót, és tartsa offline állapotban, a számítógépétől elkülönítve.
Tartson egy második példányt olyan helyen, ahol a lemez meghibásodása után is elérheti.
Soha ne tárolja megosztott héjprofilban, elkötelezett szkriptben vagy naplóban.
Ha elveszíti a jelmondatot, és nem állított be helyreállítási kódot, a titkosított adatok véglegesen olvashatatlanok. Az egyetlen kiút a visszaállítás, amely törli őket.
Ne nullázza, ha csak egyes rekordok nem nyílnak meg. Először karanténba kell helyezni őket. A karantén minden olvashatatlan, még mindig titkosított rekordot egy archívumba helyez át ugyanabban a tárolóban, és minden olvasható rekordot érintetlenül hagy, így semmit sem töröl, és futtatása előtt megtekinthető. Lásd: diagnosztizálja és javítsa meg a helyi beállításokat.
Helyreállítási kód beállítása (opcionális)¶
A helyreállítási kód a profil adatkulcsának második nyitási módja. Azért van, hogy egy elfelejtett jelmondatot ki lehessen cserélni, ne pedig a rekordokba kerüljön. Alapértelmezés szerint ki van kapcsolva: a profil egyetlen ajtóként a jelmondatával jön létre, és Ön döntheti el, hozzáad-e kódot.
Amikor terminálban hoz létre profilt, a Cadrumo egyszer megkérdezi, kér-e helyreállítási kódot, és alapértelmezésben a nem választ ajánlja. A teljes képernyős regisztráció ugyanezt a kérdést a saját képernyőjén teszi fel, Skip for now lehetőséggel. Mindkét esetben később is döntheti el.
Az aktív profilon így engedélyezheti:
aeat config profile recovery enable
A Cadrumo bekéri a jelenlegi jelmondatot, egyetlen alkalommal megjeleníti a kódot a terminálon, és megkéri, hogy írja vissza, mielőtt bármit is beállítana. A kód így néz ki: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX; beírásakor a kis- és nagybetűk, a kötőjelek és a szóközök nem számítanak. Írja le, és tartsa a jelmondatától és az adatokat őrző számítógéptől elkülönítve. A Cadrumo nem tart róla másolatot, és nem tudja újra megmutatni.
Aki birtokolja a kódot, új jelmondatot állíthat be a profilhoz, ezért úgy kezelje, ahogy magát a jelmondatot. Ellenőrzéshez vagy eltávolításhoz:
aeat config profile recovery status
aeat config profile recovery disable
A kikapcsolás bekéri a jelenlegi jelmondatot. Az újbóli engedélyezés friss kódot ad ki; a régi megszűnik működni.
A kód a szokásos jelmondatcserék után is érvényes marad. Mentési archívumban nem utazik: a visszaállított profil mindig helyreállítás nélkül indul, és a visszaállító parancs ezt közli is. Visszaállítás után engedélyezze újra, ha szeretné.
Elfelejtett jelmondat visszaállítása¶
Ha megvan a helyreállítási kód, és elfelejtette a jelmondatot:
aeat config passphrase reset PROFILE
Adja meg a helyreállítási kódot, majd kétszer az új jelmondatot. A program semmit sem ír vissza a képernyőre. A meglévő kulcsot az új jelmondat zárja be újra, így egyetlen rekord sem titkosítódik újra, és a helyreállítási kód utána is működik. A hibás kód, a helyreállítás nélküli profil, a túl rövid új jelmondat, illetve a két nem egyező másolat mind elutasításhoz vezet, és a profilt érintetlenül hagyja.
Interaktív kérdés nélküli visszaállításhoz küldje a {"recovery_code": "...", "new_passphrase": "...", "new_passphrase_confirmation": "..."} objektumot a --secrets-stdin vagy a --secrets-fd FD csatornán.
Helyreállítás engedélyezése terminál nélkül¶
Helyreállítási kód csak terminálon jeleníthető meg, ezért a terminál nélküli hívónak kifejezetten át kell vennie. Adja meg a --secrets-stdin vagy a --secrets-fd FD csatornát a {"passphrase": "..."} objektummal, valamint a --recovery-handoff-fd WRITE_FD és a --recovery-verification-fd READ_FD kapcsolót is. Olvasson pontosan egy {"recovery_code":"..."} alakú objektumot az első csővezetékből, tárolja a kódot biztonságosan, majd küldje ugyanazt a szigorú objektumot a második csővezetéken. Külön névtelen csővezetékeket és külön leírószámokat használjon; egyik leíró sem lehet 0, 1 vagy 2, és nem eshet egybe a --secrets-fd értékével. A folyamat minden leírót lezár az egyetlen határolt művelete után. A hiányzó fél, a hibás bizonyíték, az eltérés, a túl nagy tartalom, a leíróütközés vagy az I/O-hiba semmit sem állít be.
A jelmondat módosítása¶
Módosítsd a jelmondatot, amikor gyanítod, hogy látták, vagy bármilyen ütemezésben, amit a saját szabályzatod tartalmaz:
aeat config passphrase changeaeat config passphrase changeAdja meg az aktuális jelszót, majd az újat kétszer. Semmi sem visszhangzik.
A módosítás átcsomagolja a meglévő kulcsot ahelyett, hogy kicserélné, így:
Nincs újra titkosított rekord, és minden meglévő rekord olvasható marad.
A korábban beállított helyreállítási kód továbbra is helyes.
A parancsnokság mindkét tényt jelenti neked. Ha az aktuális jelszó hibás, az új túl rövid, vagy a két másolat nem egyezik, elutasítja és működőképesen hagyja a meglévő jelszót.
Ha interaktív prompt nélkül szeretné megváltoztatni a jelszót, adja át a három értéket egy JSON objektumként egy levél titkos csatornán keresztül:
aeat config passphrase change --secrets-stdinaeat config passphrase change --secrets-stdinHasználja a --secrets-stdin kapcsolót, ha a szabványos bemenet szabad. Használja ugyanazzal az objektummal a --secrets-fd FD kapcsolót, ha a szabványos bemenetet más adat használja. Küldje a {"current_passphrase": "...", "new_passphrase": "...", "new_passphrase_confirmation": "..."} objektumot. Jelszót soha ne adjon át parancssori argumentumként: az argumentumok láthatók a folyamatlistában és a parancsértelmező előzményeiben.
Futtatás jelmondat-bekérés nélkül¶
Az automatizálás nem tud válaszolni interaktív jelmondatkérésre. Adjon meg egy határolt UTF-8 JSON-objektumot kifejezett bemeneti csatornán. Ne tegyen profiljelmondatot, helyreállítási kódot vagy tanúsítvány-jelmondatot környezeti változóba vagy parancssori argumentumba. A CLI nem használja a CADRUMO_SECRET_PASSPHRASE változót titokbemeneti tartalékként.
Két különálló opciópár létezik:
Használja a levél szintű
--secrets-stdinvagy--secrets-fd FDkapcsolót, ha maga a parancs birtokolja a titkot. A levélparancsokat és pontos objektumaikat az alábbi lista tartalmazza.Használja gyökérszinten, a
configelőtt a--profile-secrets-stdinvagy--profile-secrets-fd FDkapcsolót, ha egy profilhoz kötött parancsnak hitelesítenie kell a kijelölt profilt, mert a tartós munkamenet nem volt folytatható. Az objektum:{"profile_passphrase": "..."}.
A gyökérszintű beállítások nem helyettesítik a levélparancs beállításait. A tanúsítványtitok tárolásához például ugyanabban a folyamatban szükség lehet a gyökérszintű profiljelszóra és a tanúsítvány jelszavára. Ezeket két, egymással nem ütköző csatornán adja át.
LEAF-parancsnokság tulajdonában lévő titok szállítása¶
Használja ugyanazt a két levélzászlót minden skalár-titkos parancsnál:
Parancs |
Szigorú JSON objektum |
|---|---|
Az |
A |
Az |
A |
Az |
A |
|
|
|
A |
|
A |
|
A |
Az |
A |
Minden objektum pontosan a bemutatott mezőket tartalmazza. A gépi csatornán végzett profillétrehozás soha nem kérdez a helyreállításról; utólag engedélyezze az engedélyezze a helyreállítást terminál nélkül részben leírt átadópárral. Az ismétlődő, hiányzó, többlet, túl nagy, hibás vagy nem UTF-8 bemenet elutasításra kerül. A korábbi visszaállítási password mező és a tanúsítvány secret mezője nem elfogadott.
Ellenőrizze az aktuális zászlókat anélkül, hogy titkot adna:
aeat --helpaeat --helpCADRUMO - local-first workflow with the Spanish Tax Agency (AEAT) Cadrumo keeps taxpayer data local and exposes exactly two command roots. The config root manages profiles, encrypted local data, recovery keys, profile sessions, AEAT authentication, and repair. The app root manages profile overview, ledger, modelo, review, and authenticated AEAT reads. A profile stores one taxpayer's local facts and settings. The active profile is the selected taxpayer context. A profile session provides resumable access to encrypted profile data. The ledger contains imported money movements. A modelo is an official AEAT declaration form, distinct from its local work unit or export. The review queue contains findings that need operator action. Profile labels stay visible. Tax identities, credentials, storage identifiers, object keys, and sensitive web-address content stay protected. For isolated state, set CADRUMO_LOCAL_STORAGE_ROOT and CADRUMO_SECRET_STORE_DIR. Pass profile secrets through --profile-secrets-stdin or --profile-secrets-fd, and command secrets through --secrets-stdin or --secrets-fd. Start or resume aeat config profile create NAME Create the first local taxpayer profile. aeat config profile list List registered profiles and identify the active one. aeat config login NAME Select a profile and start or renew its session. aeat config profile status Check profile readiness and its authoritative next action. aeat config profile edit [NAME] Complete or correct an incomplete profile. Core workflow aeat config profile status Show profile readiness. aeat app overview status Summarize profile and work state. aeat app ledger import Import bank or accounting transactions. aeat app ledger review Review imported rows that need attention. aeat app modelo work --help Create or operate modelo work units. aeat app modelo verification-report list List saved filing verification reports. aeat app review queue Show profile-wide items awaiting operator review. Resume or recover aeat config login NAME Start or renew an absent, closed, or expired profile session. aeat config repair Before changing configuration or stored data, run this read-only health report. aeat config repair profile Inspect a reported active-profile pointer problem. Command families aeat config Open profile, session, custody, storage, and repair commands. aeat app Open profile-scoped tax-work commands. Diagnostics aeat app overview status --verbose Show general state with additional detail. aeat --format json config repair Return the complete local health report as JSON. aeat config repair logs Show the log path and latest lines. aeat --version --detail Show the installed package identity. Profile authentication options --profile-secrets-stdin Read the exact target profile passphrase from one bounded JSON object on standard input after session resume fails. --profile-secrets-fd FD Read the exact target profile passphrase from one bounded JSON object on an inherited readable descriptor after session resume fails. Add --help for details. Remove sensitive log values, then report bugs at github.com/nevenincs/cadrumo/issues.
aeat config login --helpaeat config login --helpUsage: aeat config login [OPTIONS] [name]
Authenticate a profile and start a resumable session
Arguments:
name Profile UUID or exact label to log in; omit to use the selected
profile
Options:
--secrets-stdin Read the secrets as one bounded JSON object
from standard input instead of prompting.
--secrets-fd <int> File descriptor to read machine secrets
from.
--output-language, --language <es|en|ca|hu>
Output language for the response text (es,
en, ca, hu).
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to
copy it or customize the installation.
--help Show this message and exit.
aeat config profile create --helpaeat config profile create --helpUsage: aeat config profile create [OPTIONS] [profile_name]
Create a profile protected by a passphrase. At a terminal it then offers an
optional recovery code; skip it, or add it later with 'aeat config profile
recovery enable'.
Arguments:
profile_name Profile name to write the answers into
Options:
--quiet Run non-interactively using only the
supplied flag values; required flags left
unset cause an error. Sufficient on its own;
combine with --accept-defaults to fill the
rest from descriptor defaults.
--accept-defaults Fill every unsupplied flag from the
descriptor defaults, without prompting. Use
alongside --quiet, or on its own for an all-
defaults create.
--output-language <es|en|ca|hu>
CLI output language for this profile
--entity-type <str> Natural person, legal entity, or attribution
entity
--legal-entity-form <str> Recognised legal form when the entity type
is a legal entity
--tax-id <str> Tax identifier (NIF/CIF/DNI/NIE) for the
active profile
--name <str> Display name shown in local reviews
--surnames <str> Surnames or company name for export headers
--legal-name <str> Legal or company name for legal-entity
export headers
--fiscal-residency <str> Fiscal residency category: resident_irpf
(habitual resident in Spain) or
non_resident_irnr (non-resident, IRNR
taxation RDLeg 5/2004).
--country-of-fiscal-residence <str>
ISO 3166-1 alpha-2 code of the country of
fiscal residence (e.g. GB, DE, FR). Required
when fiscal-residency is non_resident_irnr.
--representante-fiscal-nif <str>
NIF/NIE of the fiscal representative in
Spain. Required for non-EU/EEA non-residents
(Art. 47 LGT + Art. 10 TRLIRNR RDLeg
5/2004).
--representante-fiscal-nombre <str>
Full name of the fiscal representative in
Spain.
--tax-residence-jurisdiction-scope <str>
Declared territorial regime: common
territory or the not-yet-supported foral
territory.
--tax-residence-ccaa <str> Tax-residence autonomous community, under
the common regime. If the value is not
recognised, the error lists the accepted
communities.
--address-postcode <str> Tax address postcode
--irpf-income-categories <str> IRPF income category; pass --irpf-income-
categories once per category
--activity <str> Business activity as plain text, or the IAE
heading if you know it
--activity-start-date <str> Censo registration / start-of-activity date
(YYYY-MM-DD). Optional; when set,
obligations for periods before this date are
not shown.
--incn-prior-12-months <str> Net turnover (importe neto de la cifra de
negocios) over the prior 12 months, in
euros. Above 6,000,000 EUR Modelo 202
mandates the Art. 40.3 LIS modality; below
it both modalities are available. Optional.
--new-entity-first-two-profit-periods / --no-new-entity-first-two-profit-periods
Mark this when a newly-created legal entity
is in one of its first two profit-making tax
periods (LIS Art. 29) to opt into the 15
percent reduced rate. Optional; unset leaves
the entity on its otherwise-applicable rate.
--ley-49-2002-option-declared / --no-ley-49-2002-option-declared
Record whether Modelo 036 casilla 651
declares the Ley 49/2002 Title II option.
--ley-49-2002-option-date <str>
Record the Modelo 036 casilla 653 date for
the Ley 49/2002 Title II option.
--ley-49-2002-renunciation-declared / --no-ley-49-2002-renunciation-declared
Record whether Modelo 036 casilla 652
declares renunciation of the Ley 49/2002
Title II regime.
--ley-49-2002-renunciation-date <str>
Record the Modelo 036 casilla 654 date for
the Ley 49/2002 Title II renunciation.
--iva-regime <str> IVA regime
--iva-m303-regime-composition <str>
Modelo 303 regime composition: general,
simplified, or mixed.
--iva-roi-enrolled / --no-iva-roi-enrolled
Enrolled in ROI
--iva-oss-enrolled / --no-iva-oss-enrolled
Enrolled in OSS
--iva-group-member-enrolled / --no-iva-group-member-enrolled
Enrolled as a member entity of an IVA group
--iva-group-dominant-entity-enrolled / --no-iva-group-dominant-entity-enrolled
Enrolled as the dominant entity of an IVA
group
--iva-sii-enrolled / --no-iva-sii-enrolled
Whether the taxpayer is enrolled in the SII
--iva-redeme-enrolled / --no-iva-redeme-enrolled
Whether the taxpayer is registered in REDEME
--iva-intracommunity-operations-exceed-50000-eur / --no-iva-intracommunity-operations-exceed-50000-eur
Intra-community operations exceed 50,000 EUR
--iva-cash-accounting-regime-enrolled / --no-iva-cash-accounting-regime-enrolled
Declare enrolment in the special IVA cash-
accounting regime.
--iva-voluntary-sii-enrolled / --no-iva-voluntary-sii-enrolled
Declare voluntary SII enrolment separately
from mandatory inclusion triggers.
--iva-hydrocarbon-deposit-advance-payment-deduction-entitled / --no-iva-hydrocarbon-deposit-advance-payment-deduction-entitled
Declare entitlement to deduct advance
payments under the hydrocarbon tax-deposit
regime.
--enrollment-large-company / --no-enrollment-large-company
Large-company enrollment
--enrollment-public-administration-budget-gt-6000000 / --no-enrollment-public-administration-budget-gt-6000000
Public administration budget over 6,000,000
--taxation-type <str> Income-tax return type: 1 = individual, 2 =
joint (family unit).
--taxpayer-sex <str> First taxpayer sex: H = male, M = female.
--taxpayer-marital-status <1|2|3|4|5>
First taxpayer marital status: 1 = single, 2
= married, 3 = widowed, 4 = separated or
divorced, 5 = registered civil partnership.
--situacion-familiar <casado|pareja_hecho_registrada|pareja_hecho_no_registrada|soltero|separado_divorciado>
Family situation under Art. 82 LIRPF:
determines whether joint taxation is
available and which family unit variant
applies.
--taxpayer-marriage-date <str> Start date of the current marriage (YYYY-MM-
DD). Only when marital status = 2 (married).
Derives casillas 0245/0246/0247 (matrimonio
sobrevenido, Art. 82 LIRPF).
--taxpayer-birth-date <str> First taxpayer birth date
--taxpayer-disability-grade <str>
First taxpayer disability grade: 1 =
33%-64%, 2 = 65% or higher, 3 = judicial
incapacity, 4 = third-party assistance or
reduced mobility.
--taxpayer-death-date <str> First taxpayer death date
--spouse-tax-id <str> Spouse NIF/NIE
--spouse-name <str> Spouse given name
--spouse-surnames <str> Spouse surnames
--spouse-birth-date <str> Spouse birth date
--spouse-sex <str> Spouse sex: H = male, M = female.
--spouse-disability-grade <str>
Spouse disability grade (if applicable): 1 =
33%-64%, 2 = 65% or higher, 3 = judicial
incapacity, 4 = third-party assistance or
reduced mobility.
--spouse-non-resident-irpf / --no-spouse-non-resident-irpf
Spouse is non-resident IRPF
--spouse-eu-eea-resident / --no-spouse-eu-eea-resident
Spouse is EU/EEA resident
--spouse-eu-eea-country <str> Spouse EU/EEA country
--family-descendants-eu-eea-deduction / --no-family-descendants-eu-eea-deduction
EU/EEA descendants in family-unit deduction
--family-minor-children-in-unit / --no-family-minor-children-in-unit
Minor children in family unit
--has-employees / --no-has-employees
Has employees and pays salaries with
retención
--pays-professionals-with-retencion / --no-pays-professionals-with-retencion
Pays professionals with retención
--art109-activity-income-withholding-ge-70pct / --no-art109-activity-income-withholding-ge-70pct
Art. 109 coverage - at least 70% of covered
professional, agricultural, livestock, or
forestry activity income subject to
withholding or payment on account
--pays-rent-with-retencion / --no-pays-rent-with-retencion
Pays local rent with retención
--pays-capital-income-with-retencion / --no-pays-capital-income-with-retencion
Pays capital income with retención
--modelo-111-no-retenciones-periods <str>
Comma-separated Modelo 111 no-obligation
periods, format YYYY:PERIOD (for example
2025:2T,2025:3T). Use only when no subject
payments were made.
--irpf-estimation-regime <str> IRPF estimation regime for economic-activity
income
--objective-estimation-modulos-iae-epigraph <str>
IAE epigraph for objective-estimation
modules, such as 972.
--objective-estimation-modulos-module-1-units <str>
Annual module 1 units for objective-
estimation modules.
--objective-estimation-modulos-module-2-units <str>
Annual module 2 units for objective-
estimation modules.
--objective-estimation-modulos-module-3-units <str>
Annual module 3 units for objective-
estimation modules.
--objective-estimation-modulos-module-4-units <str>
Annual module 4 units for objective-
estimation modules.
--objective-estimation-modulos-module-5-units <str>
Annual module 5 units for objective-
estimation modules.
--objective-estimation-modulos-module-6-units <str>
Annual module 6 units for objective-
estimation modules.
--objective-estimation-modulos-module-7-units <str>
Annual module 7 units for objective-
estimation modules.
--irpf-special-regime <str> IRPF special regime. "general" for most
taxpayers. "impatriado" for workers who
relocated to Spain and elected the Beckham
Law regime (Art. 93 LIRPF), available for
the first 6 years after relocation.
--irpf-special-regime-start-date <str>
Date the worker elected the inpatriate
regime (YYYY-MM-DD). Only when irpf-special-
regime is "impatriado". RIRPF Art. 116. The
regime expires at the end of the 6th
calendar year.
--does-intracomunitario / --no-does-intracomunitario
Conducts intracomunitario operations
--third-party-transactions-above-347-threshold / --no-third-party-transactions-above-347-threshold
Third-party transactions exceed Modelo 347
threshold
--bienes-extranjero-above-threshold / --no-bienes-extranjero-above-threshold
Foreign-held assets above legal threshold
--monedas-virtuales-extranjero-above-threshold / --no-monedas-virtuales-extranjero-above-threshold
Virtual currencies held abroad above Modelo
721 threshold
--llm-vision / --no-llm-vision Enable on-host LLM vision for reading
invoices.
--google-export / --no-google-export
Enable Google Sheets export.
--notes <str> Notes for your own records (optional)
--secrets-stdin Read the secrets as one bounded JSON object
from standard input instead of prompting.
--secrets-fd <int> File descriptor to read machine secrets
from.
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to
copy it or customize the installation.
--help Show this message and exit.
aeat config passphrase change --helpaeat config passphrase change --helpUsage: aeat config passphrase change [OPTIONS]
Change the passphrase without re-encrypting records or invalidating a
recovery code.
Options:
--secrets-stdin Read the secrets as one bounded JSON object
from standard input instead of prompting.
--secrets-fd <int> File descriptor to read machine secrets
from.
--output-language, --language <es|en|ca|hu>
Output language for the response text (es,
en, ca, hu).
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to
copy it or customize the installation.
--help Show this message and exit.
aeat config profile archive import --helpaeat config profile archive import --helpUsage: aeat config profile archive import [OPTIONS] {label}
Republish a profile capsule from a directory or a sealed archive, proving
its passphrase.
Arguments:
label Display name for the restored profile. [required]
Options:
--file <path> Path to the sealed archive or capsule
directory to restore. [required]
--secrets-stdin Read the secrets as one bounded JSON object
from standard input instead of prompting.
--secrets-fd <int> File descriptor to read machine secrets
from.
--output-language, --language <es|en|ca|hu>
Output language for the response text (es,
en, ca, hu).
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to
copy it or customize the installation.
--help Show this message and exit.
aeat config auth certificate secret set --helpaeat config auth certificate secret set --helpUsage: aeat config auth certificate secret set [OPTIONS]
Set (or rotate) the passphrase for a registered certificate source
Options:
--name <str> Registered certificate source the passphrase
is bound to [required]
--secrets-stdin Read the secrets as one bounded JSON object
from standard input instead of prompting.
--secrets-fd <int> File descriptor to read machine secrets
from.
--output-language, --language <es|en|ca|hu>
Output language for the response text (es,
en, ca, hu).
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to
copy it or customize the installation.
--help Show this message and exit.
Confirm every scalar-secret leaf exposes both explicit channels.
Profil hitelesítése egy parancshoz¶
Helyezzen egy gyökéropciót a parancs útvonala elé. Nevezze el a pontos profilt a célparancsban, amikor elfogad egy profilcélt. Például:
aeat --profile-secrets-stdin config profile view PROFILE
Ezt a forrást csak akkor használja a program, ha a pontos profil már ismert, a parancs profilmunkamenetet kíván, nincs illeszkedő élő munkamenet, és a megőrzött munkamenet folytatása sem sikerült. Olvasás nélkül elutasítja, ha a parancsnak nincs szüksége profilhitelesítésre, ha a pontos célnak már van élő vagy folytatott munkamenete, vagy ha a parancs önhitelesítő. A bejelentkezés, a létrehozás, a visszaállítás, a kijelentkezés, a jelmondatcsere, a jelmondat visszaállítása, valamint a helyreállítás engedélyezése és kikapcsolása nem fogadja el ezt a gyökérbizonyítékot.
Egy használható kulcstartó perzisztenciával nem rendelkező gazdagépen a sikeres gyökérhitelesítés csak az aktuális folyamatot folytatja. A parancs egy Notice-t bocsát ki, hogy a jelszót a következő folyamat során újra meg kell adni. Minden új folyamat megismétli a Argon2 jelszó származtatását; ezt a szándékos költséget nem tárolják egy gyengébb hitelesítő vagy átruházható bemutató tokenben.
Tartson két titkos forrást megkülönböztetve¶
Válassza ki a forrásokat, mielőtt bármelyik olvasásra kerülne:
Ne válasszon egyszerre stdint és leírót ugyanahhoz az opciópárhoz.
Ne rendeljen stdin-t mind a gyökér-, mind a levélszkóphoz.
Ne rendelje ugyanazt a leíró számot mindkét hatókörhöz.
Használja a root fd plus leaf stdin, root stdin plus leaf fd, vagy két különböző leírót, ha egy híváshoz mindkét objektumra szükség van.
Egy kiválasztott forrás, amely nem vonatkozik a feloldott parancsra vagy a pontos profilra, nem használhatóként elutasításra kerül. Ez megvédi a parancsfájlokat attól, hogy parancssori hiba után rossz célnak küldjenek hitelesítő adatokat.
Örökölt leíró biztonságos átadása¶
Használjon névtelen csövet, ha a szabványos bemenet már más értéket továbbít. A leíró mögötti objektum és annak élettartama a hívó tulajdona. A Cadrumo egy korlátozott olvasást végez, majd az olvasás megkezdése után helyileg bezárja a leírót, elutasítás esetén is. A 0 leíró stdin-megfelelőként engedélyezett; az 1 és 2, a negatív, a lezárt és a nem olvasható leírók elutasításra kerülnek.
POSIX rendszeren úgy indítsa a folyamatot, hogy a csővezeték olvasóleírója szerepel a gyermekfolyamat pass_fds engedélyezőlistáján, majd ezt a számot adja át a --secrets-fd vagy a --profile-secrets-fd kapcsolónak. Windowson ne feltételezze, hogy egy numerikus CRT-leíró közvetlenül öröklődik. Örökölhető Windows HANDLE-eket engedélyezzen, és a támogatott betöltő burkolóval alakítsa át őket az msvcrt.open_osfhandle hívással. A helyreállítás beállítása egy írható átadó HANDLE-t és egy olvasható ellenőrző HANDLE-t használ:
python -m cadrumo.entrypoints.cli._windows_profile_secret_bootstrap --profile-handle ROOT_HANDLE --secrets-handle LEAF_HANDLE -- config auth certificate secret set --name SOURCE
python -m cadrumo.entrypoints.cli._windows_profile_secret_bootstrap --recovery-handoff-handle WRITE_HANDLE --recovery-verification-handle READ_HANDLE -- config profile recovery enable --quiet --secrets-stdin
A --profile-handle vagy a --secrets-handle elhagyása, ha a meghíváshoz csak egy hatókörre van szükség. A csomagoló beszúrja a megfelelő kanonikus leíró opciót; ne adja hozzá a parancs farokhoz is. A közvetlenül elindított hordozható parancshoz az STDIN csatornát részesítse előnyben.
A Cadrumo megköti a bemenetet, a legjobb erőfeszítés alapján törli a változó olvasási puffereket, és azonnal felszabadítja a titkos hivatkozásokat. A Python megváltoztathatatlan karakterláncokat hozhat létre a JSON dekódolása és a titkos mezők érvényesítése során, így az alkalmazás nem igényel garantált memóriatörlést. Soha ne használja újra a csövet, ne irányítsa át egy normál fájlba, vagy naplózza a JSON objektumot.
Az interaktív parancsok csak ellenőrzött terminálon jelenhetnek meg. A szükséges explicit csatorna nélküli átirányított vagy nem interaktív hívás elutasításra kerül.
Kijelentkezés az aktív profilból¶
Futtassa a aeat config logout-t, amikor befejezte a munkát egy profillal. A kijelentkezés bezárja az aktív tárolási munkamenetet, eldobja a memóriában lévő kulcsfontosságú anyagokat, ártalmatlanítja a vödörmotorokat, és megtartja a következő pontos bejelentkezéshez kiválasztott profilt:
aeat config profile statusaeat config profile statusprofile docs-sequence-sandbox profile_id <profile-id> identity.tax_id sha256:1c9f9632 activities.description documentation examples iva.regime GENERAL tax_residence.ccaa <unset> Next step: `aeat app overview status`
aeat config logoutaeat config logoutlogged_out_profile docs-sequence-sandbox
aeat --format json config profile listaeat --format json config profile list{ "active_profile": "docs-sequence-sandbox", "command": "config.profile.list", "notices": [], "result": { "active_profile": "docs-sequence-sandbox", "profiles": [ { "active": true, "bucket_id": "<bucket-id>", "name": "docs-sequence-sandbox" } ] }, "schema_version": "2", "status": "success" }
Confirm logout closes the active session without deleting the profile.
A profilban semmi sem törlődik. Jelentkezzen be újra a aeat config login segítségével a kiválasztott profil használatához, vagy nevezzen meg egy másik pontos profilt, amikor visszatér.
A helyi állapot visszaállítása (végső eset)¶
A folytatás előtt exportáljon minden olyan profilt, amelyet meg szeretne tartani. A visszaállítás véglegesen törli az összes helyileg tárolt profilt, a kapcsolódó helyi hitelesítési állapotot és az aktív profil kiválasztását. Nem törli a máshol tárolt exportokat. A visszaállítás nem vonható vissza. A törlés szintén nem egy módja a tevékenység elrejtésének: az adatok minden olyan másolata, amely elhagyta a gépet (exportálás, iktatás, biztonsági mentés) a Cadrumo ellenőrzésén kívül esik, és semmi sem A Cadrumo visszahúzhatja őket.
aeat config reset start --yesaeat config reset start --yesaeat config reset statusaeat config reset statusaeat config reset status --operation-id \
0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefaeat config reset status --operation-id `
0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefaeat config reset resume --yesaeat config reset resume --yesaeat config reset resume --operation-id \
0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef --yes \
--override-retention --reason Legal retention duties reviewedaeat config reset resume --operation-id `
0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef --yes `
--override-retention --reason Legal retention duties reviewedA
startértéket csak akkor használja, amikor minden helyi profilt el akar távolítani. Erősítse meg a visszaállítást kifejezetten. A törlés előtt ellenőrzi a megőrzési követelményeket, és megtagadja az indítást, amíg egy másik visszaállítás befejezetlen.Használja a csak olvasható
statusparancsot a legutóbbi művelet megvizsgálásához a helyi adatok módosítása nélkül. Adjon meg egy műveletazonosítót egy pontos művelet megvizsgálásához. A státusz egy befejezetlen, szüneteltetett vagy befejezett műveletet jelent. Kimenete tartalmazza a műveletazonosítót és bármely szünet okát.Használja a
resumeparancsot egy megszakítás vagy szünet után. Erősítse meg újra a visszaállítást. Ugyanazt a befejezetlen műveletet folytatja, ahelyett hogy egy másikat hozna létre. Adjon meg egy műveletazonosítót egy pontos művelet folytatásához. A törlés megkezdése után a visszaállítás folytatása nem állítja vissza a törölt adatokat.
Ha jogi megőrzési követelmények szüneteltetik a visszaállítást, álljon meg, ha meg kell tartania az érintett rekordokat. Csak a jogi megőrzési következmény felülvizsgálata és elfogadása után írja felül a szünetet, és mindig adjon meg egy nem üres indokot. Ha felülírás nélkül ad meg indokot, a parancs megtagadja a folytatást.
A lezárt archív biztonsági mentési utasításokért lásd: Állítsa be az adófizetői profilját.
Következő lépések¶
Importálás, export és bizonyíték: lássa, hol ér véget a titkosított őrizet, és hol kezdődnek a szándékos, nyílt szövegű átadások.
Állítsa be adózói profilját: profilok létrehozása, exportálása és importálása.
Diagnosztizálja és javítsa ki a helyi beállításokat - karanténozza az olvashatatlan rekordokat, és javítsa ki a tárolási vagy integritási problémákat visszaállítás nélkül.
CLI-referencia: a teljes opcióreferencia.