moby/docs/reference/api
Daniel Hiltgen 8dce8e9901 Add token pass-thru for AuthConfig
This change allows API clients to retrieve an authentication token from
a registry, and then pass that token directly to the API.

Example usage:

    REPO_USER=dhiltgen
    read -s PASSWORD
    REPO=privateorg/repo
    AUTH_URL=https://auth.docker.io/token
    TOKEN=$(curl -s -u "${REPO_USER}:${PASSWORD}" "${AUTH_URL}?scope=repository:${REPO}:pull&service=registry.docker.io" |
        jq -r ".token")

    HEADER=$(echo "{\"registrytoken\":\"${TOKEN}\"}"|base64 -w 0 )
    curl -s -D - -H "X-Registry-Auth: ${HEADER}" -X POST "http://localhost:2376/images/create?fromImage=${REPO}"

Signed-off-by: Daniel Hiltgen <daniel.hiltgen@docker.com>
2015-12-03 11:40:27 -08:00
..
_static retooling for hugo 2015-06-15 13:19:38 -07:00
images retooling for hugo 2015-06-15 13:19:38 -07:00
docker-io_api.md docs: fix broken link to 1.7 Hub API 2015-12-01 17:57:12 +01:00
docker_io_accounts_api.md retooling for hugo 2015-06-15 13:19:38 -07:00
docker_remote_api.md Add token pass-thru for AuthConfig 2015-12-03 11:40:27 -08:00
docker_remote_api_v1.14.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.15.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.16.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.17.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.18.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.19.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.20.md update 'top' api endpoint documentation 2015-11-23 15:41:34 -08:00
docker_remote_api_v1.21.md docs: move API changes to the correct API version 2015-11-25 14:10:18 +01:00
docker_remote_api_v1.22.md Add token pass-thru for AuthConfig 2015-12-03 11:40:27 -08:00
hub_registry_spec.md Enabled GitHub Flavored Markdown 2015-10-11 07:49:54 -07:00
README.md Fixes found by docs validation tool 2015-11-23 11:19:38 +10:00
registry_api.md Fixing seds, deleting old stuff 2015-06-17 21:05:37 -07:00
registry_api_client_libraries.md remove unused row-even and row-odd css classes 2015-07-19 21:27:12 +02:00
remote_api_client_libraries.md added rx-docker-client library 2015-11-13 08:23:57 +05:30

This directory holds the authoritative specifications of APIs defined and implemented by Docker. Currently this includes:

  • The remote API by which a docker node can be queried over HTTP
  • The registry API by which a docker node can download and upload images for storage and sharing
  • The index search API by which a docker node can search the public index for images to download
  • The docker.io OAuth and accounts API which 3rd party services can use to access account information