Aparência
finnest ofb
Smoke-test the OFB receiver and initiator of a target: a plan by default, real reads with --live, one real write on request.
receiver smoke walks the OFB receiver journey and initiator smoke the payment initiator journey of the selected target. Each is a plan by default (nothing leaves the process), makes only reads with --live, and makes its one real write with --create-connection or --create-payment (sandbox only), with the holder CPF piped to --stdin and --yes. A write never runs in CI and prints its idempotency key and retry command before the request.
Grupo: Diagnóstico e suporte · Nível: secundário
Uso
bash
finnest ofb <subcomando> [opções]Exemplos
bash
finnest ofb receiver smoke --cloud=aws --environment=sandbox
finnest ofb receiver smoke --cloud=aws --environment=sandbox --live --transmitter <authorisation-server-id>
finnest ofb initiator smoke --cloud=azure --environment=sandbox --live --transmitter <authorisation-server-id>Opções
--log-level <level>— Diagnostic verbosity: error, warn, info, debug, or trace.--plain— Force headless output even on an interactive TTY.--verbose— Enable debug-level diagnostics.
As opções globais de saída também se aplicam.
Subcomandos
receiver— Walk the OFB receiver journey of a target (smoke): a plan by default, real reads with --live.initiator— Walk the OFB payment initiator journey of a target (smoke): a plan by default, real reads with --live.
finnest ofb receiver
Walk the OFB receiver journey of a target (smoke): a plan by default, real reads with --live.
smoke walks the OFB receiver journey of the selected target: the participants list of the Directory its environment follows (prod: the production Directory; the --transmitter authorisation server must be listed), the finnest-ofb realm discovery, the receiver callback page and, with the stored DCR operator secret and --transmitter, the DCR state at that transmitter. Without --live nothing leaves the process: every step is shown as planned. --live makes those reads and writes nothing. --create-connection makes the one real write: a consent at the --transmitter server for the holder whose CPF is piped to --stdin (never argv; it is never printed or logged), then, once the holder authorises it at the printed link, a sync and reads of customers, accounts, balances, transactions and credit cards. It needs --live, --transmitter, --stdin and --yes, never runs in CI, and in prod prints a REAL WRITE warning first. Before the request it prints its x-idempotency-key and the exact retry command; re-running with the same CPF and --idempotency-key <uuid> replays that consent instead of creating a second one. The token comes from the finnest-ofb-smoke client (its secret is FINNEST_OFB_SMOKE_CLIENT_SECRET); --auth-base points it at a port-forward of the realm.
Exemplos
bash
finnest ofb receiver smoke --cloud=aws --environment=sandbox
finnest ofb receiver smoke --cloud=aws --environment=sandbox --live --transmitter <authorisation-server-id>
printf '%s' "$HOLDER_CPF" | finnest ofb receiver smoke --cloud=aws --environment=sandbox --live --create-connection --stdin --transmitter <authorisation-server-id> --auth-base http://127.0.0.1:8080 --yesOpções
--cloud <cloud>— Target cloud for setup, deploy, and diagnostics.--environment <environment>— Target environment: sandbox or prod.--config <path>— Path to an explicit Finnest TOML configuration file.--config-only <path>— Load only this Finnest TOML file; do not merge ambient user or project config.--config-overlay <path>— Overlay this Finnest TOML file over operator and project config.--live— Make the real reads (Directory participants, cluster, deployed routes); without it nothing leaves the process.--create-connection— Receiver smoke (opin, ofb): create one real connection (consent at the transmitter) with the holder CPF from --stdin; requires --live, --transmitter and --yes.--transmitter <authorisation-server-id>— Receiver or initiator smoke: the Directory authorisation server id of the transmitter.--idempotency-key <uuid>— Receiver or initiator smoke: the UUID the write (--create-connection or --create-payment) carries as x-idempotency-key; reuse the one a refused write printed, so it is replayed instead of made a second time.--stdin— Read secret material (secrets write) or the holder CPF (opin conformance rp, opin and ofb receiver smoke --create-connection, ofb initiator smoke --create-payment) from piped stdin, never from argv.--yes— Approve a mutating operation.--auth-base <url>— Authorization server base URL (the non-mTLS host, or a local port-forward to it) the command reaches the realm through.--log-level <level>— Diagnostic verbosity: error, warn, info, debug, or trace.--plain— Force headless output even on an interactive TTY.--verbose— Enable debug-level diagnostics.
As opções globais de saída também se aplicam.
finnest ofb receiver smoke
Walk the OFB receiver journey: a plan by default, real reads with --live, one real consent and its data reads with --create-connection.
Opções
--cloud <cloud>— Target cloud for setup, deploy, and diagnostics.--environment <environment>— Target environment: sandbox or prod.--config <path>— Path to an explicit Finnest TOML configuration file.--config-only <path>— Load only this Finnest TOML file; do not merge ambient user or project config.--config-overlay <path>— Overlay this Finnest TOML file over operator and project config.--live— Make the real reads (Directory participants, cluster, deployed routes); without it nothing leaves the process.--create-connection— Receiver smoke (opin, ofb): create one real connection (consent at the transmitter) with the holder CPF from --stdin; requires --live, --transmitter and --yes.--transmitter <authorisation-server-id>— Receiver or initiator smoke: the Directory authorisation server id of the transmitter.--idempotency-key <uuid>— Receiver or initiator smoke: the UUID the write (--create-connection or --create-payment) carries as x-idempotency-key; reuse the one a refused write printed, so it is replayed instead of made a second time.--stdin— Read secret material (secrets write) or the holder CPF (opin conformance rp, opin and ofb receiver smoke --create-connection, ofb initiator smoke --create-payment) from piped stdin, never from argv.--yes— Approve a mutating operation.--auth-base <url>— Authorization server base URL (the non-mTLS host, or a local port-forward to it) the command reaches the realm through.--log-level <level>— Diagnostic verbosity: error, warn, info, debug, or trace.--plain— Force headless output even on an interactive TTY.--verbose— Enable debug-level diagnostics.
As opções globais de saída também se aplicam.
finnest ofb initiator
Walk the OFB payment initiator journey of a target (smoke): a plan by default, real reads with --live.
smoke walks the OFB payment initiator journey of the selected target: the participants list of the Directory its environment follows (read only: that list holds data-sharing transmitters, so the banking app validates the --transmitter payment server when the consent is created), the finnest-ofb realm discovery, the initiator callback page and, with the stored DCR operator secret and --transmitter, the DCR state at that transmitter. Without --live nothing leaves the process. --live makes those reads and writes nothing. --create-payment makes the one real write, and only where the target follows the Directory sandbox (prod is refused before any request): a payment consent with the terms in --payment-file (JSON: consent, the payments v5 consent data without loggedUser, and payment, with cnpjInitiator and optional remittanceInformation, endToEndId and transactionIdentification, the Pix TxId INIC, QRDN and APDN require; one immediate payment of at most R$ 1,00, no schedule) for the holder whose CPF is piped to --stdin (never argv; it is never printed or logged), then, once the holder authorises it at the printed link, the Pix payment (sent again under its key while the callback has not yet stored the consent token) and its settlement. It needs --live, --transmitter, --stdin, --payment-file and --yes, and never runs in CI. Before the consent request it prints its x-idempotency-key and the exact retry command; the payment key is derived from it, so a retry with the same --idempotency-key replays the same consent and payment.
Exemplos
bash
finnest ofb initiator smoke --cloud=aws --environment=sandbox
finnest ofb initiator smoke --cloud=aws --environment=sandbox --live --transmitter <authorisation-server-id>
printf '%s' "$HOLDER_CPF" | finnest ofb initiator smoke --cloud=aws --environment=sandbox --live --create-payment --payment-file ./payment.json --stdin --transmitter <authorisation-server-id> --auth-base http://127.0.0.1:8080 --yesOpções
--cloud <cloud>— Target cloud for setup, deploy, and diagnostics.--environment <environment>— Target environment: sandbox or prod.--config <path>— Path to an explicit Finnest TOML configuration file.--config-only <path>— Load only this Finnest TOML file; do not merge ambient user or project config.--config-overlay <path>— Overlay this Finnest TOML file over operator and project config.--live— Make the real reads (Directory participants, cluster, deployed routes); without it nothing leaves the process.--create-payment— Initiator smoke (ofb): create one real Pix payment, only where the target follows the Directory sandbox, with the holder CPF from --stdin and the terms in --payment-file; requires --live, --transmitter, --payment-file and --yes.--payment-file <path>— Initiator smoke (ofb): the JSON file with the consent and payment terms of the --create-payment payment (at most R$ 1,00).--transmitter <authorisation-server-id>— Receiver or initiator smoke: the Directory authorisation server id of the transmitter.--idempotency-key <uuid>— Receiver or initiator smoke: the UUID the write (--create-connection or --create-payment) carries as x-idempotency-key; reuse the one a refused write printed, so it is replayed instead of made a second time.--stdin— Read secret material (secrets write) or the holder CPF (opin conformance rp, opin and ofb receiver smoke --create-connection, ofb initiator smoke --create-payment) from piped stdin, never from argv.--yes— Approve a mutating operation.--auth-base <url>— Authorization server base URL (the non-mTLS host, or a local port-forward to it) the command reaches the realm through.--log-level <level>— Diagnostic verbosity: error, warn, info, debug, or trace.--plain— Force headless output even on an interactive TTY.--verbose— Enable debug-level diagnostics.
As opções globais de saída também se aplicam.
finnest ofb initiator smoke
Walk the OFB initiator journey: a plan by default, real reads with --live, one real sandbox Pix payment with --create-payment.
Opções
--cloud <cloud>— Target cloud for setup, deploy, and diagnostics.--environment <environment>— Target environment: sandbox or prod.--config <path>— Path to an explicit Finnest TOML configuration file.--config-only <path>— Load only this Finnest TOML file; do not merge ambient user or project config.--config-overlay <path>— Overlay this Finnest TOML file over operator and project config.--live— Make the real reads (Directory participants, cluster, deployed routes); without it nothing leaves the process.--create-payment— Initiator smoke (ofb): create one real Pix payment, only where the target follows the Directory sandbox, with the holder CPF from --stdin and the terms in --payment-file; requires --live, --transmitter, --payment-file and --yes.--payment-file <path>— Initiator smoke (ofb): the JSON file with the consent and payment terms of the --create-payment payment (at most R$ 1,00).--transmitter <authorisation-server-id>— Receiver or initiator smoke: the Directory authorisation server id of the transmitter.--idempotency-key <uuid>— Receiver or initiator smoke: the UUID the write (--create-connection or --create-payment) carries as x-idempotency-key; reuse the one a refused write printed, so it is replayed instead of made a second time.--stdin— Read secret material (secrets write) or the holder CPF (opin conformance rp, opin and ofb receiver smoke --create-connection, ofb initiator smoke --create-payment) from piped stdin, never from argv.--yes— Approve a mutating operation.--auth-base <url>— Authorization server base URL (the non-mTLS host, or a local port-forward to it) the command reaches the realm through.--log-level <level>— Diagnostic verbosity: error, warn, info, debug, or trace.--plain— Force headless output even on an interactive TTY.--verbose— Enable debug-level diagnostics.
As opções globais de saída também se aplicam.