wl user: - User management

Synopsis

wl {user|users} list
wl user create <name> --key <key>
wl user {sign|verify} [...] <file>
wl user edit [--editor <editor>] <file>
wl user modify [...] <file>
wl user publish <user>
wl user unpublish <user>

Description

Todo

Write general description about users.

Commands

wl {user|users} list [OPTIONS]

List all known users.

--verbose, -v

When this flag is passed, a more detailed output will be displayed.

--list-secret-keys, -K

Only display users for which the private key is available.

wl user create [OPTIONS] NAME

Create a new user manifest and save it.

Unless --key is provided, the command will generate a new key pair.

--key <fingerprint>

Use an existing key pair to create a user. The key pair must be in the key directory (~/.config/wildland/keys), as <fingerprint>.pub and <fingerprint>.sec files.

--path <path>

Specify a path in Wildland namespace (such as /users/User) for the user. Can be repeated.

--add-pubkey <public_key>

Add additional public key that can be used to verify manifests owned by this user. The whole key must be specified either as a fingerprint or a Wildland user path. In the case where a fingerprint is provided, the key will be stored in a <fingerprint>.pub file in the key directory (~/.config/wildland/keys). In the case of a user path, all public keys needed to resolve the user path will be added to the same directory. Can be repeated.

wl user delete [--force] [--cascade] [--delete-keys] NAME [NAME ...]

Delete a user from local filesystem.

This will consider manifests in the local filesystem (stored in ~/.config/wildland/) signed by the user. However, it will not delete locally stored key pairs (~/.config/wildland/keys/).

--force, -f

Delete even if there are manifests (containers/storage) signed by the user.

--cascade

Delete together with manifests (containers/storage) signed by the user.

--delete-keys

Delete together with public/private key pair owned by the user.

wl user {sign|verify|edit} [OPTIONS] <file>

See help for wl sign, wl verify, wl dump and wl edit.

wl user import [--path path] [--bridge-owner user] url_or_path

Imports a user. Accepts local paths to manifests, urls to manifests, Wildland urls to manifests and Wildland urls to Wildland objects.

For users, will import the user and create an appropriate bridge manifest referencing the user. In the process of bridge creation, the client will attempt to mount the imported user’s manifests catalog containers (if any) and find the imported user’s manifest file in /users/ directories within those containers. If successful, it will create a link object to that file and store is in the bridge manifest. Otherwise it will use the url or path that was passed as an argument to this command.

For Wildland object path, will import all referenced bridges and their reference users.

--path

Overwrite bridge paths with provided paths. Optional. Can be repeated. Works only if a single bridge is to imported (to avoid duplicate paths.

--bridge-owner

Override the owner of created bridge manifests with provided owner.

wl user refresh USER

Iterate over bridges and import all user manifest that those bridges refer to. Note: This command will override the existing users’ manifests.

Unless USER name is provided, the command will iterate over all bridges.

wl user modify [--add-path <path>] [--del-path <path>] [--add-pubkey <pubkey>] [--add-pubkey-user <user>] [--del-pubkey <pubkey>] [--add-catalog-entry <path>] [--del-catalog-entry <path>] <file>

Modify a user manifest given by <file>.

--add-path

Path to add. Can be repeated.

--del-path

Path to remove. Can be repeated.

--add-pubkey

Public key to add (either in the same format as in the public key file, or provided as a Wildland user path). Can be repeated.

--add-pubkey-user

User whose public key to add. Can be repeated.

--del-pubkey

Public key to remove (either in the same format as in the public key file, or provided as a Wildland user path). Can be repeated.

--add-catalog-entry

Container uri to add. Can be repeated.

--del-catalog-entry

Container uri to remove. Can be repeated.

wl user publish <user>

Publish a user manifest into user’s manifests catalog (first container from the catalog that provides read-write storage will be used).

wl user unpublish <user>

Unublish a user manifest from the whole of a user’s manifests catalog.