[JAWS-UG CLI] IoT #6 モノへのデバイス証明書のアタッチ

物理デバイスが AWS IoT と通信するには、X.509 証明書が必要になります。

Thing Registry 内でデバイスを表しているモノと、デバイスの証明書を関連付けることができます。

前提条件

IoTへの権限

AWS IoTに対してフル権限があること。

AWS CLI

以下のバージョンで動作確認済

• AWS CLI 1.11.14

コマンド

aws --version

結果(例)

      aws-cli/1.11.14 Python/2.7.10 Darwin/15.6.0 botocore/1.4.71

バージョンが古い場合は最新版に更新しましょう。

コマンド

sudo -H pip install -U awscli

1. 準備
   =======

0.1. リージョンの決定

変数の設定

export AWS_DEFAULT_REGION='ap-northeast-1'

0.2. 変数の確認

プロファイルが想定のものになっていることを確認します。

変数の確認

aws configure list

結果(例)

            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile       iotFull-handson-mbpr13        env    AWS_DEFAULT_PROFILE
      access_key     ****************XXXX shared-credentials-file
      secret_key     ****************XXXX shared-credentials-file
          region        ap-northeast-1        env    AWS_DEFAULT_REGION

0.3. 証明書IDの指定

コマンド

aws iot list-certificates \
        --query 'certificates[].certificateId'

結果(例)

      {
        "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }

変数の指定

IOT_CERT_ID='<利用する証明書の証明書ID>'

ARNを取得します。

コマンド

IOT_CERT_ARN=$( \
        aws iot describe-certificate \
          --certificate-id ${IOT_CERT_ID} \
          --query 'certificateDescription.certificateArn' \
          --output text \
) \
        && echo ${IOT_CERT_ARN}

結果(例)

      arn:aws:iot:ap-northeast-1:XXXXXXXXXXXX:cert/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

0.4. モノ名の指定

コマンド

IOT_THING_NAME="handson-thing-$( date '+%Y%m%d' )"

1. 事前作業
   ===========

コマンド

aws iot list-thing-principals  \
        --thing-name ${IOT_THING_NAME}

結果

      {
          "principals": []
      }

1. モノに証明書をアタッチする
   =============================

変数の確認

cat << ETX

        IOT_THING_NAME: ${IOT_THING_NAME}
        IOT_CERT_ARN:   ${IOT_CERT_ARN}

ETX

コマンド

aws iot attach-thing-principal \
        --thing-name ${IOT_THING_NAME} \
        --principal ${IOT_CERT_ARN}

結果(例)

      (戻り値なし)

1. 事後作業
   ===========

コマンド

aws iot list-thing-principals  \
        --thing-name ${IOT_THING_NAME}

結果(例)

      {
        "principals": [
          "arn:aws:iot:ap-northeast-1:XXXXXXXXXXXX:cert/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        ]
      }

完了