Skip to content

Commit

Permalink
Add documentation for credHelper
Browse files Browse the repository at this point in the history
Add documentation for credHelper. Close containers/podman#1675

Signed-off-by: Qi Wang <qiwan@redhat.com>
  • Loading branch information
QiWang19 committed Jun 4, 2020
1 parent 0f6b561 commit d33461c
Showing 1 changed file with 21 additions and 1 deletion.
22 changes: 21 additions & 1 deletion docs/containers-auth.json.5.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,28 @@ their accounts on quay.io and docker.io:
An entry can be removed by using a `logout` command from a container
tool such as `podman logout` or `buildah logout`.

In addition, credential helpers can be configured for specific registries and the credentials-helper
software can be used to manage the credentials in a more secure way than depending on the base64 encoded authentication
provided by `login`. If the credential helpers are configured for specific registries, the base64 encoded will not be used
for operations concerning credentials of the specified registries.

When the credential helper is in use on a Linux platform, the auth.json file would contain keys specify the registry domain, and values specify the suffix of the program to use (i.e. everything after docker-credential-). For example:

```
{
"auths": {
"localhost:5001": {}
},
"credHelpers": {
"registry.example.com": "secretservice"
}
}
```

For more information on Docker credential stores, please reference the [GitHub docker-credential-helpers project](https://github.com/docker/docker-credential-helpers/releases).

# SEE ALSO
buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1)
buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1), , skopeo-login(1), skopeo-logout(1)

# HISTORY
Feb 2020, Originally compiled by Tom Sweeney <tsweeney@redhat.com>

0 comments on commit d33461c

Please sign in to comment.