手順4.1 IAM ユーザーを作成する

1. IAM へ移動し、「アクセス管理」→「ポリシー」を開き、「ポリシーを作成」をクリックします。

2. 「JSON」を選択し、以下のように入力して、「次のステップ: タグ」をクリックします。ポリシードキュメントは https://download.atmark-techno.com/armadillo-iot-g3/startup-guide/IAM_policy.json からダウンロードすることも出来ます。

   {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Sid": "VisualEditor0",
             "Effect": "Allow",
             "Action": [
                 "iam:List*",
                 "iam:Get*",
                 "iam:PassRole",
                 "iam:CreateRole",
                 "iam:UpdateRole",
                 "iam:DeleteRole",
                 "iam:CreatePolicy",
                 "iam:DeletePolicy",
                 "iam:AttachRolePolicy",
                 "iam:PutRolePolicy",
                 "cloudformation:*",
                 "iot:List*",
                 "iot:Get*",
                 "iot:Connect",
                 "iot:Subscribe",
                 "iot:Describe*",
                 "iot:*Publish",
                 "iot:Receive",
                 "iot:CreatePolicy",
                 "iot:Attach*Policy",
                 "iot:*RoleAlias",
                 "iot:CreateThing",
                 "iot:UpdateThing",
                 "iot:RegisterThing",
                 "iot:UpdateThingShadow",
                 "iot:AttachThingPrincipal",
                 "iot:CreateKeysAndCertificate",
                 "iot:UpdateCertificate",
                 "apigateway:GET",
                 "s3:GetObject",
                 "s3:PutObject",
                 "s3:ListBucket",
                 "s3:CreateBucket",
                 "cognito-idp:*List*",
                 "cognito-idp:*Get*",
                 "cognito-idp:Describe*",
                 "cognito-idp:AdminCreateUser",
                 "cognito-idp:AdminEnableUser",
                 "es:List*",
                 "es:Get*",
                 "es:Describe*",
                 "es:ESHttp*"
             ],
             "Resource": "*"
         }
     ]
   }
           

   図4.6 ポリシードキュメント

   
   

3. 何も選択せずに、「次のステップ: 確認」をクリックします。

4. ポリシー名を入力し、「ポリシーの作成」をクリックします。ここでは、ポリシー名を "policy_for_AWS_test" としています。

5. IAM から、「アクセス管理」→「ユーザー」を開き、「ユーザーを追加」をクリックします。

6. 下記の通り入力、選択し、「次のステップ: アクセス権限」をクリックします。

   • ユーザー名を入力する

   • AWS 認証情報タイプは両方選択する

   • コンソールのパスワードは「自動生成パスワード」を選択する

   • パスワードのリセットが必要にチェックを入れる

7. 「既存のポリシーを直接アタッチ」をクリックし、先程作成したポリシーを選択して、「次のステップ: タグ」をクリックします。

8. 何も選択せずに、「次のステップ: 確認」をクリックします。

9. 内容を確認し、「ユーザーの作成」をクリックします。

10. 「.csvのダウンロード」をクリックし、 "new_user_credentials.csv" をダウンロードして、「閉じる」をクリックします。

手順4.2 ポリシーの設定をする

1. 作業用PCにポリシー設定用のテンプレートファイルをダウンロードします。

   [PC /]$ wget https://download.atmark-techno.com/armadillo-iot-g3/startup-guide/create_policy.template
           

   図4.7 テンプレートファイルのダウンロード

   
   

2. Cloud Formation へ移動し、「スタックの作成」→「新しいリソースを使用（標準）」をクリックします。

3. 「テンプレートファイルのアップロード」を選択し、「ファイルの選択」で先程ダウンロードしたテンプレートファイルをアップロードして、「次へ」をクリックします。

4. スタック名を入力し、「次へ」をクリックします。

5. そのまま「次へ」をクリックします。

6. チェックボックスを選択し、「スタックの作成」をクリックします。

7. 作成したスタックのステータスが “CREATE_COMPLETE” になったら作成完了です。ステータスは更新ボタンを押すと反映されます。

手順4.3 エンドポイントを確認する

1. IoT Core へ移動し、サイドバー下部にある設定をクリックします。

2. ここで表示されるエンドポイントは後ほど使用しますので、メモしておいてください。

手順4.4 モノを作成する

1. IoT Coreから、「管理」→「すべてのデバイス」→「モノ」を開き、「モノを作成」をクリックします。

2. 「1つのモノを作成」を選択し、「次へ」をクリックします。

3. モノの名前を “my_test_armadillo” と入力します。

4. 「名前のないシャドウ (クラシック)」を選択し、シャドウステートメントを以下のように入力して、「次へ」をクリックします。

   {
   	"state": {
   		"desired": {
   		"LED_state": 0
   		},
   		"reported": {
   		"LED_state": 0
   		}
   	}
   }
   				

   図4.8 シャドウステートメント

   
   

5. 「新しい証明書を自動生成 (推奨)」を選択し、「次へ」をクリックします。

6. “PolicyForThing” を選択し、「モノを作成」をクリックします。

7. ポップアップで表示された画面で、デバイス証明書、パブリックキーファイル、プライベートキーファイルをそれぞれダウンロードし、「完了」をクリックします。

8. ダウンロードしたファイルは、デバイス証明書が "[ハッシュ値64桁]-certificate.pem.crt"、パブリックキーファイルが "[ハッシュ値64桁]-public.pem.key"、プライベートキーファイルが "[ハッシュ値64桁]-private.pem.key" という名前で保存されます。以下の例では各ファイルを「Downloads ディレクトリ」に保存しています。

   [PC ~/Downloads]# ls
   [ハッシュ値64桁]-certificate.pem.crt
   [ハッシュ値64桁]-private.pem.key
   [ハッシュ値64桁]-public.pem.key
   				

手順4.5 証明書と秘密鍵を Armadillo に転送する

1. 先程ダウンロードした証明書と秘密鍵を USB や SD カードに入れ、Armadillo に接続します。

2. Armadillo のホームディレクトリに 「certs ディレクトリ」を作成します。

   [armadillo ~]# mkdir certs
   [armadillo ~]# cd certs
   			

3. 「certs ディレクトリ」内に証明書と秘密鍵を転送し、それぞれ以下のようにリネームします。

   [armadillo ~/certs]# mv [ハッシュ値64桁]-certificate.pem.crt certificate.pem.crt
   [armadillo ~/certs]# mv [ハッシュ値64桁]-private.pem.key private.pem.key
   [armadillo ~/certs]# ls
   certificate.pem.crt	private.pem.key
   			

手順4.6 サンプルアプリケーションの環境を構築する

1. 作業用PCに環境構築用のテンプレートファイルをダウンロードします。

   [PC /]$ wget https://download.atmark-techno.com/armadillo-iot-g3/startup-guide/sample_application.template
           

   図4.9 テンプレートファイルのダウンロード

   
   

2. Cloud Formation へ移動し、「スタックの作成」→「新しいリソースを使用（標準）」をクリックします。

3. 「テンプレートファイルのアップロード」を選択し、「ファイルの選択」で先程ダウンロードしたテンプレートファイルをアップロードして、「次へ」をクリックします。

4. スタック名を入力し、「次へ」をクリックします。

5. “RoleForCloudFormation” を選択し、「次へ」をクリックします。

6. チェックボックスを選択し、「スタックの作成」をクリックします。

7. 作成したスタックのステータスが “CREATE_COMPLETE” になったら作成完了です。この環境構築には30分ほど時間を要します。

手順4.7 データを IoT Core へ送る

1. IoT Core へ移動し、「テスト」→「MQTT テストクライアント」をクリックします。

2. “topic/sensors”と入力し、「サブスクライブ」をクリックします。

3. Armadillo に戻って、サンプルコードを実行します。[endpoint] は「エンドポイントを確認する」で確認したエンドポイントを入力してください。

   [armadillo ~]# wget https://download.atmark-techno.com/armadillo-iot-g3/startup-guide/publish.py
   [armadillo ~]# python3 publish.py [endpoint]
   				

   図4.10 サンプルコードを実行する

   
   

4. IoT Core を確認すると、送信されたデータが表示されます。

手順4.8 LED を操作する

1. API Gateway を開き、”operateLED_API” をクリックします。

2. 「ステージ」から ”dev” を開き、URL を確認します。

3. 「API キー」から “my_APIkey” を開き、「表示」をクリックして API キーを確認します。

4. Armadillo に戻って、publish.py を終了させた場合は、もう一度実行します。

5. 作業用 PC から、以下のコマンドを実行すると、Armadillo の LED3 が点灯します。ここで、[URL] と [APIキー] の部分を先程確認した URL と API キーに置き換えてください。

             [PC /]$ curl -X POST "[URL]/data?LED=1" -H "x-api-key: [API キー]"
           

   図4.11 LEDを点灯させる

   
   

6. 作業用 PC から、以下のコマンドを実行すると、Armadillo の LED3 が消灯します。

             [PC /]$ curl -X POST "[URL]/data?LED=0" -H "x-api-key: [API キー]"
           

   図4.12 LEDを消灯させる