3.1. サーバー証明書のアップロード (handson-iam-authentication)

手順の目的

X.509証明書をアップロードし、サーバー証明書"handson-iam-authentication"を作成します。

設定値の指定

手順に必要な設定値を変数に格納をします。

1. サーバー証明書名

サーバー証明書名を指定します。

変数の設定:

IAM_SERVER_CERTIFICATE_NAME='handson-iam-authentication'

2. サーバー証明書パス

サーバー証明書パスを指定します。

変数の設定:

IAM_SERVER_CERTIFICATE_PATH='/handson-cli/'

3. X.509証明書ファイル名

X.509証明書用ディレクトリ名を指定します。

変数の設定:

DIR_OPENSSL_CERTIFICATE="${HOME}/tmp-handson-iam-authentication"

X.509証明書ファイル名を指定します。

変数の設定:

FILE_OPENSSL_CERTIFICATE="${DIR_OPENSSL_CERTIFICATE}/certificate.pem" \
  && echo ${FILE_OPENSSL_CERTIFICATE}

結果(例):

/home/cloudshell-user/tmp-handson-iam-authentication/certificate.pem

4. X.509証明書秘密鍵ファイル名

X.509証明書秘密鍵ファイル名を指定します。

変数の設定:

FILE_OPENSSL_PRIVATE_KEY="${DIR_OPENSSL_CERTIFICATE}/private-key.pem" \
  && echo ${FILE_OPENSSL_PRIVATE_KEY}

結果(例):

/home/cloudshell-user/tmp-handson-iam-authentication/private-key.pem

設定値の確認

各変数に正しい設定値が格納されていることを確認します。

変数の確認:

cat << END

  # 1. IAM_SERVER_CERTIFICATE_NAME:"handson-iam-authentication"
       IAM_SERVER_CERTIFICATE_NAME="${IAM_SERVER_CERTIFICATE_NAME}"
  # 2. IAM_SERVER_CERTIFICATE_PATH:"/handson-cli/"
       IAM_SERVER_CERTIFICATE_PATH="${IAM_SERVER_CERTIFICATE_PATH}"
  # 3. FILE_OPENSSL_CERTIFICATE:"${HOME}/tmp-handson-iam-authentication/certificate.pem"
       FILE_OPENSSL_CERTIFICATE="${FILE_OPENSSL_CERTIFICATE}"
  # 4. FILE_OPENSSL_PRIVATE_KEY:"${HOME}/tmp-handson-iam-authentication/private-key.pem"
       FILE_OPENSSL_PRIVATE_KEY="${FILE_OPENSSL_PRIVATE_KEY}"

END

各変数について、上の行と下の行の値の内容もしくは形式が同じであることを確認します。 もし異なる場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行

X.509証明書をサーバー証明書としてアップロードします。

変数の確認:

cat << END

  # IAM_SERVER_CERTIFICATE_NAME:"handson-iam-authentication"
    IAM_SERVER_CERTIFICATE_NAME="${IAM_SERVER_CERTIFICATE_NAME}"
  # IAM_SERVER_CERTIFICATE_PATH:"/handson-cli/"
    IAM_SERVER_CERTIFICATE_PATH="${IAM_SERVER_CERTIFICATE_PATH}"
  # FILE_OPENSSL_CERTIFICATE:"${HOME}/tmp-handson-iam-authentication/certificate.pem"
    FILE_OPENSSL_CERTIFICATE="${FILE_OPENSSL_CERTIFICATE}"
  # FILE_OPENSSL_PRIVATE_KEY:"${HOME}/tmp-handson-iam-authentication/private-key.pem"
    FILE_OPENSSL_PRIVATE_KEY="${FILE_OPENSSL_PRIVATE_KEY}"

END

コマンド:

aws iam upload-server-certificate \
  --server-certificate-name ${IAM_SERVER_CERTIFICATE_NAME} \
  --path ${IAM_SERVER_CERTIFICATE_PATH} \
  --certificate-body file://${FILE_OPENSSL_CERTIFICATE} \
  --private-key file://${FILE_OPENSSL_PRIVATE_KEY}

結果(例):

{
    "ServerCertificateMetadata": {
        "Path": "/handson-cli/",
        "ServerCertificateName": "handson-iam-authentication",
        "ServerCertificateId": "ASCAEXAMPLE123EXAMPLE",
        "Arn": "arn:aws:iam::XXXXXXXXXXXX:server-certificate/handson-cli/handson-iam-authentication",
        "UploadDate": "2026-05-28T21:13:44+00:00",
        "Expiration": "2026-05-28T22:23:16+00:00"
    }
}

完了確認

「サーバー証明書"handson-iam-authentication"が存在する。」ことを確認します。

コマンド:

aws iam list-server-certificates \
  --query "ServerCertificateMetadataList[?ServerCertificateName == \`${IAM_SERVER_CERTIFICATE_NAME}\`].ServerCertificateName" \
  --output text

結果(例):

handson-iam-authentication

手順の完了確認

(参考) マネジメントコンソールの確認

サーバー証明書は、マネジメントコンソールで確認・操作できません。