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.sh

Shadow → 証明書のひも付け解除 → 証明書の無効化と削除 → ポリシー → Thing の順に削除します。証明書は、有効(ACTIVE)なままでは削除できないので、先に無効(INACTIVE)にしています。

重要この章のまとめ
  • 接続には Thing・証明書と秘密鍵・ポリシー・エンドポイント が必要
  • ポリシーは その Thing の Shadow のトピックだけ に絞る
  • 秘密鍵は 1 回しか取得できず、コミットしない
  • 終わったら cleanup.sh で削除する