2 AWS の準備
仮想デバイスが AWS IoT Core に接続するための準備をします。必要なものは 4 つです。
| もの | 役割 |
|---|---|
| Thing | デバイスの登録。Shadow は Thing ごとに 1 つある |
| 証明書と秘密鍵 | デバイスの身分証明。MQTT の接続(TLS)で使う |
| ポリシー | その証明書で 何をしてよいか(どのトピックに送受信できるか) |
| エンドポイント | 接続先。アカウントごとに違う URL |
2.1 Python と AWS CLI の準備
code.zip を展開した code/ で作業します。
cd code
python3 -m venv .venv
source .venv/bin/activate # Windows は .venv\Scripts\activate
pip install -r requirements.txt # paho-mqtt と boto3
aws sts get-caller-identity # AWS CLI が使えることを確認2.2 作成スクリプトを実行する
bash setup/create_thing.sh # Thing 名を省略すると handson-aircon-01
bash setup/create_thing.sh my-aircon # 名前を指定する場合東京リージョン(ap-northeast-1)に作ります。別のリージョンにするときは AWS_REGION=us-east-1 bash setup/create_thing.sh のように指定します。 完了すると、certs/ に証明書と秘密鍵、device/config.json に接続情報ができます。
スクリプトの中身を順に見ていきます。
2.2.1 Thing を作る
aws iot create-thing --thing-name "${THING}" --region "${REGION}"2.2.2 証明書と秘密鍵を作る
aws iot create-keys-and-certificate --set-as-active --region "${REGION}" \
--certificate-pem-outfile certs/device.pem.crt \
--private-key-outfile certs/private.pem.key- 秘密鍵は 作成時の 1 回しか ダウンロードできません。なくしたら証明書を作り直します
certs/は Git にコミットしないでください(.gitignoreに入れる)。ESP32 ではsecrets.hなどに分けて、同じく管理対象外にします
あわせて、AWS 側の正しさを確かめるための ルート CA 証明書(AmazonRootCA1.pem)をダウンロードします。
2.2.3 ポリシーで「できること」を絞る
{
"Version": "2012-10-17",
"Statement": [
{ "Effect": "Allow", "Action": "iot:Connect",
"Resource": "arn:aws:iot:<region>:<account>:client/<thing>*" },
{ "Effect": "Allow", "Action": ["iot:Publish", "iot:Receive"],
"Resource": "arn:aws:iot:<region>:<account>:topic/$aws/things/<thing>/shadow/*" },
{ "Effect": "Allow", "Action": "iot:Subscribe",
"Resource": "arn:aws:iot:<region>:<account>:topicfilter/$aws/things/<thing>/shadow/*" }
]
}iot:Connect:クライアント ID が Thing 名で始まる接続だけを許すiot:Publish/iot:Receive:この Thing の Shadow のトピックだけ に送受信できるiot:Subscribe:購読はトピックではなく トピックフィルタ(topicfilter/)で指定する
ネット上の例でよく見る "Action": "iot:*", "Resource": "*" は、証明書が漏れたときに 同じアカウントのすべてのデバイスを操作できてしまう ので避けます。
zsh で "arn:aws:iot:$REGION:$ACCOUNT:client/..." と書くと、$ACCOUNT:c が zsh の 修飾子 として解釈されて ARN が壊れます(MalformedPolicyException)。 変数は ${ACCOUNT} のように 波かっこで囲む か、スクリプトを bash で実行します。
2.2.4 証明書にひも付ける
aws iot attach-policy --policy-name "${POLICY}" --target "${CERT_ARN}"
aws iot attach-thing-principal --thing-name "${THING}" --principal "${CERT_ARN}"2.2.5 エンドポイントを調べる
aws iot describe-endpoint --endpoint-type iot:Data-ATS
# xxxxxxxxxxxxxx-ats.iot.ap-northeast-1.amazonaws.comこのエンドポイントは、デバイスの MQTT 接続 で使います。デバイスは必ずこれを指定します。
クラウド側から Shadow を読み書きする SDK(send.py や Lambda の iot-data)では、指定は任意です。 現在の boto3・AWS CLI・JavaScript SDK v3 は、指定しなければリージョン共通の data-ats.iot.<region>.amazonaws.com を使い、そのままで動きます(実測)。 send.py では、デバイスと同じ接続先であることを明確にするため、アカウント固有のエンドポイントを指定しています。
2.3 作ったものを片付ける
ハンズオンが終わったら、必ず削除します。
bash setup/cleanup.shShadow → 証明書のひも付け解除 → 証明書の無効化と削除 → ポリシー → Thing の順に削除します。証明書は、有効(ACTIVE)なままでは削除できないので、先に無効(INACTIVE)にしています。
- 接続には Thing・証明書と秘密鍵・ポリシー・エンドポイント が必要
- ポリシーは その Thing の Shadow のトピックだけ に絞る
- 秘密鍵は 1 回しか取得できず、コミットしない
- 終わったら
cleanup.shで削除する