podsec-create-imagemakeruser(1)
| PODSEC-CREATE-IMAGEMAKERUSER(1) | General Commands Manual | PODSEC-CREATE-IMAGEMAKERUSER(1) |
NAME
podsec-create-imagemakeruser - create container image maker users
SYNOPSIS
podsec-create-imagemakeruser [username[@repo_path]] ...
DESCRIPTION
The script creates container image maker users with the following rights: - change the password set by the containerization tool security administrator; - create, modify, and delete container images.
When creating each user, you must specify: - user password;
- ○
- key type: RSA, DSA and Elgamal, DSA (signing only), RSA (signing only), key available on the card;
- ○
- key expiration date;
- ○
- full name;
- ○
- Email (used later to sign images);
- ○
- note;
- ○
- password for signing images.
The script must be called after calling the podsec-create-policy script ## OPTIONS The list of users and the registrar paths for which they sign images are passed as parameters in the format: username@repository_path - The list must not contain users with the same paths.
- ○
- If the user is the only one and the path is not specified, then the registry.local path is accepted - If the user name is not specified, the name imagemaker@registry.local is accepted as the first parameter.
EXAMPLES
podsec-create-imagemakeruser immkk8s@registry.local/k8s-c10f1 imklocal@registry.local immkalt@registry.altlinux.org Three users with signing rights are created: - immkk8s - local kubernetes images with the path registry.local/k8s-c10f1;
- ○
- imklocal - local registry.local images except kubernetes images - immkalt - registrar images registry.altlinux.org ## SECURITY CONSIDERATIONS - This script should only be run on a node with the registry.local , sigstore-local domains. If this is not the case, the script stops.
- ○
- Image developers must control the list of signed images themselves. If the user imklocal signs an image with the path registry.local/k8s-c10f1, then the deployment of this image will fail, since the public key of the user immkk8s will be used for signature verification, not ` imklocal`.
- ○
- All users created in the cluster must be located on the same server with the storage.local domain. The WEB server for image signatures must also be deployed there.
- ○
- All public keys of users are located in the /var/sigstore/keys/ directory and must be copied to each server in the cluster to the /var/sigstore/keys/ directory - Image signatures are stored in the ` /var/sigstore/sigstore/directory with the registrar names discarded. if the system controls signatures of images from different registrars (for example:registry.altlinux.organdregistry.local) and the imageregistry.local/k8s-c10f1/pause:3.9with@sha256 =347a15493d0a38d9ce74f23ea9f081583728a20dbdc11d7c17ef286d9cade3ecis signed, then all images with thissha256will be considered signed:registry.altlinux.orh/k8s-c10f1/pause:3.9`, ... ## SEE ALSO - Con tainer image maker https://github.com/alt-cloud/podsec/tree/master/SigningImages.
- ○
- Description of periodic integrity monitoring of container images and containerization tool settings https://github.com/alt-cloud/podsec/tree/master/ImageSignatureVerification
AUTHOR
Aleksey Kostarev, Basealt LLC kaf@basealt.ru
| October 2024 |
