物理デバイスが 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
0. 準備
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": []
}
2. モノに証明書をアタッチする
変数の確認
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}
結果(例)
(戻り値なし)
3. 事後作業
コマンド
aws iot list-thing-principals \
--thing-name ${IOT_THING_NAME}
結果(例)
{
"principals": [
"arn:aws:iot:ap-northeast-1:XXXXXXXXXXXX:cert/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
]
}