| sidebar_position | 13 |
|---|---|
| title | identity |
Manage identities for signing changes.
atomic identity <COMMAND> [OPTIONS]
atomic identity new <NAME> [OPTIONS]
atomic identity list [OPTIONS]
atomic identity show <NAME> [OPTIONS]
atomic identity default [NAME] [OPTIONS]
atomic identity delete <NAME> [OPTIONS]
atomic identity whoami [OPTIONS]
atomic identity register <SERVER_URL> [OPTIONS]
atomic identity sign [OPTIONS]
atomic identity verify --signature <SIGNATURE> --public-key <PUBLIC_KEY>The identity command manages the Ed25519 identities used to sign changes in
Atomic. Each identity has a name, an optional email, a type, and a usage
context, along with a public/private key pair.
Identities can be created, listed, inspected, set as default, deleted, and
registered with a remote atomic-storage server. The sign and verify
subcommands provide low-level access to the underlying Ed25519 signing
primitives.
Every subcommand accepts the global flags -v, --verbose (emit extra
diagnostic output) and --no-color (disable ANSI color in output).
atomic identity new <NAME> [OPTIONS]<NAME>— Name for the new identity.
-e, --email <EMAIL>— Email address for the identity.-t, --type <IDENTITY_TYPE>— Identity type. [default:user]-u, --usage <USAGE>— Usage context for this identity. [default:personal]-d, --description <DESCRIPTION>— Description of the identity.--set-default— Set this identity as the default.--set-default-for-usage— Set this identity as the default for its usage context.
# Create a basic identity
atomic identity new alice
# Create an identity with an email and set it as the default
atomic identity new alice --email alice@example.com --set-default
# Create an identity with a description and usage context
atomic identity new work \
--email alice@company.com \
--usage work \
--description "Work identity" \
--set-default-for-usageatomic identity list [OPTIONS]-u, --usage <USAGE>— Filter by usage context.-t, --type <IDENTITY_TYPE>— Filter by identity type.-v, --verbose— Show additional details.-f, --format <FORMAT>— Output format. [default:table]
# List all identities
atomic identity list
# List identities filtered by usage context
atomic identity list --usage work
# List with extra detail
atomic identity list --verboseatomic identity show <NAME> [OPTIONS]<NAME>— Name of the identity to show.
-f, --format <FORMAT>— Output format. [default:default]--show-public-key— Show the full public key.
# Show details for an identity
atomic identity show alice
# Include the full public key
atomic identity show alice --show-public-keyatomic identity default [NAME] [OPTIONS][NAME]— Name of the identity to set as default.
-u, --usage <USAGE>— Usage context to set the default for.--clear— Clear the default identity instead of setting one.
# Set the default identity
atomic identity default alice
# Set the default for a specific usage context
atomic identity default work --usage work
# Clear the default identity
atomic identity default --clearatomic identity delete <NAME> [OPTIONS]<NAME>— Name of the identity to delete.
-f, --force— Delete without confirmation.
# Delete an identity (with confirmation)
atomic identity delete old-identity
# Delete without confirmation
atomic identity delete old-identity --forceatomic identity whoami [OPTIONS]-u, --usage <USAGE>— Show identity for a specific usage context.-f, --format <FORMAT>— Output format. [default:default]
# Show the current default identity
atomic identity whoami
# Show the default identity for a usage context
atomic identity whoami --usage workRegister an identity with a remote atomic-storage server.
atomic identity register <SERVER_URL> [OPTIONS]<SERVER_URL>— URL of the atomic-storage server.
-i, --identity <IDENTITY>— Name of the identity to register.--server-name <SERVER_NAME>— Custom name for the auto-created server profile.
# Register the default identity with a server
atomic identity register https://atomic.storage
# Register a specific identity
atomic identity register https://atomic.storage --identity alice
# Register and name the auto-created server profile
atomic identity register https://atomic.storage \
--identity alice \
--server-name productionSign bytes from stdin and output a JSON signature object.
atomic identity sign [OPTIONS]-i, --identity <IDENTITY>— Identity to sign with. Defaults to the current default identity.
# Sign data with the default identity
echo -n "hello" | atomic identity sign
# Sign data with a specific identity
echo -n "hello" | atomic identity sign --identity aliceVerify an Ed25519 signature against bytes from stdin.
atomic identity verify --signature <SIGNATURE> --public-key <PUBLIC_KEY>--signature <SIGNATURE>— Base64-encoded signature to verify.--public-key <PUBLIC_KEY>— Base32-encoded public key to verify against.
# Verify a signature against bytes from stdin
echo -n "hello" | atomic identity verify \
--signature "BASE64_SIGNATURE" \
--public-key "BASE32_PUBLIC_KEY"# Create an identity and make it the default
atomic identity new alice --email alice@example.com --set-default
# Confirm it is the current default
atomic identity whoami
# List all identities
atomic identity listatomic identity new alice --email alice@example.com --set-default
atomic identity register https://atomic.storage# Produce a JSON signature object
echo -n "hello" | atomic identity sign --identity alice
# Verify a signature against a known public key
echo -n "hello" | atomic identity verify \
--signature "BASE64_SIGNATURE" \
--public-key "BASE32_PUBLIC_KEY"atomic server— Manage remote server configuration