Help Center/ Software Repository for Container/ User Guide (Ankara Region)/ Image Management/ Obtaining a Long-Term Valid Docker Login Command
Updated on 2024-12-02 GMT+08:00

Obtaining a Long-Term Valid Docker Login Command

Scenario

This section describes how to obtain a Docker login command that is permanently valid.

For security purposes, you are advised to obtain the command in a development environment.

Process

You can obtain a long-term valid login command as the following process:

Figure 1 Process

Procedure

  1. Obtain the programmatic access permission. (If the current user has the permission, skip this step.)

    1. Log in to the management console as an administrator.
    2. Click in the upper left corner and select a region and a project.
    3. Click in the navigation pane on the left and choose Management & Deployment > Identity and Access Management.
    4. Enter the name of the user to whom you want to grant the programmatic access permission in the search box on the Users page.
    5. Click the user to go to its details page.
    6. Click next to Access Type.
    7. Select Programmatic access. (You can select only programmatic access or both access types.)

  2. Obtain the region, project name, and image repository address.

    1. Log in to the management console, click your username in the upper right corner, and click My Credentials.
    2. In the project list on the API Credentials page, search for the project corresponding to the current region.
    3. Obtain the image repository address by referring to 1.b. The domain name at the end of the login command is the image repository address.

  3. Obtain an AK/SK.

    The access key ID (AK) and secret access key (SK) are a pair of access keys used together to authenticate users who wish to make API requests. The AK/AS pair provides functions similar to a password. If you already have an AK/SK, skip this step.

    1. Log in to the management console, click your username in the upper right corner, and click My Credentials.
    2. In the navigation pane on the left, choose Access Keys and click Create Access Key.
    3. Download the access key, which includes the AK and SK.

      Keep the access key secure and do not disclose it to any unauthorized personnel.

  4. Log in to a Linux PC and run the following command to obtain the login key:

    printf "$AK" | openssl dgst -binary -sha256 -hmac "$SK" | od -An -vtx1 | sed 's/[ \n]//g' | sed 'N;s/\n//'

    In the command, $AK and $SK indicate the AK and SK obtained in Step 3.

    Figure 2 Sample command output

  5. Put the information you obtained in the following format to generate a long-term valid login command:

    docker login -u [Regional project name]@[AK] -p [Login key] [Image repository address]

    In the command, the regional project name and image repository address are obtained in Step 2, the AK in Step 3, and the login key in Step 4.

    The login key is encrypted and cannot be decrypted. Therefore, other users cannot obtain the SK from -p.

    The login command can be used on other devices.

  6. Run the history -c command to clear the operation records.