44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
|
% containers-auth.json(5)
|
||
|
|
|
||
|
|
# NAME
|
||
|
|
containers-auth.json - syntax for the registry authentication file
|
||
|
|
|
||
|
|
# DESCRIPTION
|
||
|
|
|
||
|
|
A credentials file stored at `${XDG_RUNTIME_DIR}/containers/auth.json` in
|
||
|
|
json format used to authenticate against container image registries.
|
||
|
|
|
||
|
|
## FORMAT
|
||
|
|
|
||
|
|
The auth.json file stores encrypted authentication information for the
|
||
|
|
user to container image registries. The file can have zero to many entries and
|
||
|
|
is created by a `login` command from a container tool such as `podman login` or
|
||
|
|
`buildah login`. Each entry includes the name of the registry and then an auth
|
||
|
|
token in the form of a base64 encoded string from the concatenation of the
|
||
|
|
username, a colon, and the password.
|
||
|
|
|
||
|
|
The following example shows the values found in auth.json after the user logged in to
|
||
|
|
their accounts on quay.io and docker.io:
|
||
|
|
|
||
|
|
```
|
||
|
|
{
|
||
|
|
"auths": {
|
||
|
|
"docker.io": {
|
||
|
|
"auth": "erfi7sYi89234xJUqaqxgmzcnQ2rRFWM5aJX0EC="
|
||
|
|
},
|
||
|
|
"quay.io": {
|
||
|
|
"auth": "juQAqGmz5eR1ipzx8Evn6KGdw8fEa1w5MWczmgY="
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
An entry can be removed by using a `logout` command from a container
|
||
|
|
tool such as `podman logout` or `buildah logout`.
|
||
|
|
|
||
|
|
# SEE ALSO
|
||
|
|
buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1)
|
||
|
|
|
||
|
|
# HISTORY
|
||
|
|
Feb 2020, Originally compiled by Tom Sweeney <tsweeney@redhat.com>
|