CLI command

skarbiec credential declare-endpoint

Declare the canonical Skarbiec endpoint used by remote credential commands.

Invocation#

Shell
skarbiec credential declare-endpoint <url>

Purpose#

Declare the canonical Skarbiec endpoint used by remote credential commands.

Required inputs and options#

  • Requires one URL, positional or --url: the canonical Skarbiec's address from this machine. The marker it writes is the one Stado's service directory materializes from the registry, so the ordinary way it comes to exist is stado service directory publish; an address given here is the operator's own word.

Output and state effects#

  • Creates/protects the forwards directory, atomically writes a mode-0600 forward file, re-reads it through the canonical parser, and prints path, endpoint, authority, and answering.

Refusals#

  • Refuses without a URL, naming stado service directory publish as the way the marker is normally written; refuses non-absolute, path-bearing, non-numeric-port, non-loopback HTTP, or unsupported HTTPS endpoints; whether a valid endpoint currently answers is reported separately.