翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS IoT Core クイック接続チュートリアルを試す
このチュートリアルでは、最初のモノのオブジェクトを作成し、そのオブジェクトにデバイスを接続して、MQTT メッセージを送信する様子を観察します。
このチュートリアルは 15～20 分を要します。
このチュートリアルは、 をすぐに使い始めて、限られたシナリオでどのように機能するか AWS IoT を確認するユーザーに最適です。より多くの機能やサービスに興味を持つきっかけとなる例を探している場合は、[実践的なチュートリアル AWS IoT Core で を試す](iot-gs-first-thing.md) を試してください。
このチュートリアルでは、非常に小さな IoT ソリューション AWS IoT Core の一部として の*モノのリソース*に接続するデバイスでソフトウェアをダウンロードして実行します。デバイスは、Raspberry Pi などの IoT デバイスにすることも、Linux、OS と OSX、または Windows を実行しているコンピュータにすることもできます。Long Range WAN (LoRaWAN) デバイスを に接続する場合は AWS IoT、[「＞デバイスとゲートウェイを AWS IoT Core for LoRaWAN に接続する](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-getting-started.html)」のチュートリアルを参照してください。
デバイスが [AWS IoT コンソール](https://console.aws.amazon.com//iot/home)を実行できるブラウザをサポートしている場合は、そのデバイスでこのチュートリアルを完了することをお勧めします。
**注記**
デバイスに互換性のあるブラウザがない場合は、コンピュータでこのチュートリアルに従ってください。手順でファイルをダウンロードするように求められたら、それをコンピュータにダウンロードしてから、ダウンロードしたファイルを Secure Copy (SCP) または同様のプロセスを使用してデバイスに転送します。
このチュートリアルでは、IoT デバイスが AWS アカウントのデバイスデータエンドポイントのポート 8443 と通信する必要があります。そのポートにアクセスできるかどうかをテストするには、「[デバイスデータエンドポイントとの接続をテストする](iot-quick-start-test-connection.md)」の手順を試してください。
## ステップ 1. チュートリアルを開始する
可能であれば、デバイスでこの手順を完了してください。それ以外の場合は、この手順の後半でファイルをデバイスに転送する準備をしてください。
チュートリアルを開始するには、[AWS IoT コンソール](https://console.aws.amazon.com//iot/home)にログインします。 AWS IoT コンソールのホームページの左側で、**Connect** を選択し、**Connect one device **を選択します。
![\[この AWS IoT コンソールのホームページには、1 つのデバイスを接続する方法が表示されます。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-quick-connect.PNG)
## ステップ 2. モノのオブジェクトを作成する
1. **[Prepare your device]** (デバイスを準備する) セクションで、画面の指示に従ってデバイスを AWS IoTに接続する準備をします。
![\[AWS IoT コンソールでデバイスを準備する方法。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-prepare-device.png)
1. **[Register and secure your device]** (デバイスを登録して保護する) セクションで、**[Create a new thing]** (新しいモノの作成) または **[Choose an existing thing]** (既存のモノを選択) を選択してください。**[Thing name]** (モノの名前) フィールドで、モノのオブジェクトの名前を入力します。この例で使用されているモノの名前は **TutorialTestThing** です。
**重要**
続行する前に、モノの名前をもう一度確認します。
モノのオブジェクトの作成後にモノの名前を変更することはできません。モノの名前を変更するには、正しいモノの名前の新しいモノのオブジェクトを作成し、間違った名前のモノのオブジェクトを削除する必要があります。
**[Additional configurations]** (追加の設定) セクションで、リストされているオプション設定を使用して、モノのリソースをさらにカスタマイズします。
モノのオブジェクトに名前を付けて、追加の設定を選択したら、**[Next]** (次へ) を選択します。
![\[AWS IoT コンソールを使用して、デバイスを登録して保護します。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-register-and-secure-your-device.png)
1. **プラットフォームと SDK の選択**セクションで、使用する AWS IoT Device SDK のプラットフォームと言語を選択します。この例では、Linux/OSX プラットフォームと Python SDK を使用しています。次のステップに進む前に python3 と pip3 がターゲットデバイスにインストールされていることを確認してください。
**注記**
コンソールのページの下部で、選択した SDK に必要な前提条件であるソフトウェアの一覧を確認してください。
次のステップに進む前に、必要なソフトウェアをターゲットコンピュータにインストールしておく必要があります。
プラットフォームとデバイスの SDK 言語を選択したら、[**Next**] (次へ) を選択します。
![\[AWS IoT コンソールを使用してプラットフォームと SDK を選択します。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-choose-platform-and-SDK.png)
## ステップ 3. デバイスにファイルをダウンロードする
このページは、 AWS IoT が接続キットを作成した後に表示されます。このキットには、デバイスが必要とする以下のファイルとリソースが含まれています。
+ デバイスの認証に使用するモノの証明書ファイル
+ モノのオブジェクトが AWS IoTとインタラクションすることを承認するポリシーリソース
+ AWS Device SDK をダウンロードし、デバイスでサンプルプログラムを実行するスクリプト
1. 続行する準備ができたら、[**Download connection kit for**] (接続キットのダウンロード) ボタンを選択して、前に選択したプラットフォーム用の接続キットをダウンロードします。
![\[これは、証明書ファイルをダウンロードする AWS IoT コンソールのページです。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-download-connection-kit_1.png)
1. この手順をデバイスで実行している場合は、コマンドラインコマンドを実行できるディレクトリに接続キットファイルを保存します。
この手順をデバイスで実行していない場合は、接続キットファイルをローカルディレクトリに保存し、そのファイルをデバイスに転送します。
1. **[Unzip connection kit on your device]** (デバイスで接続キットを解凍) セクションで、接続キットファイルが置かれているディレクトリに **unzip connect\$1device\$1package.zip** と入力します。
Windows PowerShell コマンドウィンドウを使用していて、**unzip** コマンドが機能しない場合は、**unzip** を **expand-archive** に置き換えて、コマンドラインをもう一度試してください。
1. デバイスに接続キットファイルを作成したら、**[Next]** (次へ) を選択してチュートリアルを続行します。
![\[AWS IoT 接続キットのダウンロード後のコンソール証明書ファイルのダウンロードページ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-download-connection-kit_2.png)
## ステップ 4. サンプルを実行する
この手順は、コンソールに表示される指示に従って、デバイスのターミナルまたはコマンドウィンドウで実行します。コンソールに表示されるコマンドは、[ステップ 2. モノのオブジェクトを作成する](#iot-quick-start-configure) で選択したオペレーティングシステム用のコマンドです。ここに示されているものは、Linux/OSX オペレーティングシステム用です。
1. デバイスのターミナルまたはコマンドウィンドウで、接続キットファイルを含む ディレクトリで、 AWS IoT コンソールに表示されるステップを実行します。
![\[AWS IoT コンソールのクイックスタートインストールと実行ページ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-run-connection-kit.png)
1. コンソールで**[Step 2]** (ステップ 2) のコマンドを入力すると、デバイスのターミナルまたはコマンドウィンドウで、次のような出力が表示されます。この出力は、プログラムが AWS IoT Coreとの間で送受信しているメッセージからのものです。
![\[AWS IoT コンソールのクイックスタートプログラム出力例。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-connect-console-output-python_updated.png)
サンプルプログラムの実行中は、テストメッセージ `Hello World!` も表示されます。テストメッセージは、デバイスのターミナルまたはコマンドウィンドウに表示されます。
**注記**
トピックのサブスクリプションと発行の詳細については、選択した SDK のサンプルコードを参照してください。
1. この手順のコンソールで [Step 2] (ステップ 2) からのコマンドを繰り返して、サンプルプログラムを再度実行できます。
1. (オプション) [AWS IoT コンソール](https://console.aws.amazon.com//iot/home)で IoT クライアントからのメッセージを表示するには、 AWS IoT コンソールのテストページで [MQTT テストクライアント](https://console.aws.amazon.com//iot/home#/test)を開きます。 ****Python SDK を選択した場合、**[MQTT test client]** (MQTT テストクライアント) の **[Topic filter]** (トピックフィルター) に **sdk/test/*python*** などのトピックを入力して、デバイスからのメッセージをサブスクライブします。トピックフィルターは、大文字と小文字を識別し、**[Step 1]** (ステップ 1) で選択した SDK のプログラミング言語によって異なります。トピックのサブスクリプションと発行の詳細については、選択した SDK のコード例を参照してください。
1. テストトピックを購読後、デバイスで **./start.sh** を実行します。詳細については、「[MQTT クライアントで AWS IoT MQTT メッセージを表示する](view-mqtt-messages.md)」を参照してください。
**./start.sh** の実行後、次のようなメッセージが MQTT クライアントに表示されます。
```
{
"message": "Hello World!" [1]
}
```
`[]` で囲われている `sequence` 番号は、新しい `Hello World!` メッセージを受信するたびに 1 ずつ増加し、プログラムを終了すると停止します。
1. チュートリアルを終了して概要を表示するには、 AWS IoT コンソールで**続行**を選択します。
![\[AWS IoT コンソールのクイックスタート完了ページ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-connect-complete_updated1.png)
1. これで、 AWS IoT クイック接続チュートリアルの概要が表示されます。
![\[AWS IoT コンソールのクイックスタートの概要ページ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/aws-iot-learn-device-is-connected.png)
## ステップ 5. さらに詳しく
クイックスタートを完了した後、 AWS IoT さらに詳しく調べるアイデアをいくつか紹介します。
+
**[MQTT テストクライアントで MQTT メッセージを表示する](https://console.aws.amazon.com/iot/home#/test)**
[AWS IoT コンソール](https://console.aws.amazon.com//iot/home)から、 AWS IoT コンソールの **[テスト]** ページで [[MQTT クライアント]](https://console.aws.amazon.com//iot/home#/test) を開くことができます。**MQTT テストクライアント**で **\$1** にサブスクライブし、デバイスで前の手順で説明したようにプログラム **./start.sh** を実行します。詳細については、「[MQTT クライアントで AWS IoT MQTT メッセージを表示する](view-mqtt-messages.md)」を参照してください。
+
**[Device Advisor](https://docs.aws.amazon.com//iot/latest/developerguide/device-advisor.html) を使用してデバイスでテストを実行する**
Device Advisor を使用して、デバイスが安全かつ確実に に接続し、操作できるかどうかをテストします AWS IoT。
+
**[インタラクティブチュートリアル](interactive-demo.md)**
インタラクティブチュートリアルを開始するには、 AWS IoT コンソールの**学習**ページから、**「 の AWS IoT 仕組み**」タイルで、**チュートリアルの開始**を選択します。
+
**[より多くのチュートリアルを見る](iot-gs-first-thing.md)**
このクイックスタートでは、 のサンプルのみを提供します AWS IoT。さらに AWS IoT 詳しく調べ、強力な IoT ソリューションプラットフォームにする機能については、 で開発プラットフォームの準備を開始します[実践的なチュートリアル AWS IoT Core で を試す](iot-gs-first-thing.md)。
# デバイスデータエンドポイントとの接続をテストする
このトピックでは、アカウントの*デバイスデータエンドポイント* ( AWS IoTに接続するために IoT デバイスが使用するエンドポイント) に対するデバイスの接続をテストする方法について説明します。
この手順は、テストするデバイス上で実行するか、テストするデバイスに接続された SSH ターミナルセッションを使用して実行します。
**Topics**
+ [デバイスデータエンドポイントを検索する](#iot-quick-start-test-connection-endpoint)
+ [接続をすばやくテストする](#iot-quick-start-test-connection-ping)
+ [アプリを入手してデバイスのデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-app)
+ [デバイスデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-test)
## デバイスデータエンドポイントを検索する
この手順では、[AWS IoT コンソール](https://console.aws.amazon.com//iot/home)でデバイスデータエンドポイントを検索して IoT デバイスへの接続をテストする方法について説明します。
**デバイスデータエンドポイントを検索するには**
1. [AWS IoT コンソール](https://console.aws.amazon.com//iot/home)の **[接続]** で、**[ドメイン設定]** に移動します。
1. **[ドメイン設定]** ページで、**[ドメイン設定]** コンテナに移動し、**ドメイン名**をコピーします。エンドポイント値は に固有 AWS アカウント であり、 の例に似ています`a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com`。
1.
デバイスデータポイントを保存します。このデバイスデータエンドポイントは、次の手順で使用します。
## 接続をすばやくテストする
この手順では、デバイスデータエンドポイントとの一般的な接続をテストしますが、デバイスが使用する特定のポートはテストされません。このテストでは一般的なプログラムを使用します。通常、これは、デバイスが AWS IoTに接続できるかどうかを確認するには十分です。
デバイスが使用する特定のポートとの接続をテストする場合は、この手順をスキップして、「[アプリを入手してデバイスのデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-app)」に進みます。
**デバイスデータエンドポイントをすばやくテストするには**
1. ターミナルまたはデバイスのコマンドラインウィンドウで、サンプルデバイスデータエンドポイント (`a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com`) をアカウントのデバイスデータエンドポイントで置き換え、次のコマンドを入力します。
------
#### [ Linux ]
```
ping -c 5 a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com
```
------
#### [ Windows ]
```
ping -n 5 a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com
```
------
1. 次のような出力が `ping` に表示された場合、デバイスデータエンドポイントに正常に接続されています。と AWS IoT 直接通信しませんでしたが、サーバーが見つかったため、このエンドポイントを介して AWS IoT が使用可能である可能性があります。
```
PING a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com (xx.xx.xxx.xxx) 56(84) bytes of data.
64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=1 ttl=231 time=127 ms
64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=2 ttl=231 time=127 ms
64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=3 ttl=231 time=127 ms
64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=4 ttl=231 time=127 ms
64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=5 ttl=231 time=127 ms
```
この結果に満足したら、ここでテストを終了できます。
AWS IoTが使用する特定のポートとの接続をテストする場合、「[アプリを入手してデバイスのデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-app)」に進んでください。
1. `ping` で正常な出力が返されなかった場合、エンドポイントの値を参照して、正しいエンドポイントが入力されていること、およびデバイスがインターネットに接続されていることを確認してください。
## アプリを入手してデバイスのデータエンドポイントとポートへの接続をテストする
`nmap` を使用して、より詳細な接続テストを実行できます。この手順では、`nmap` がデバイスにインストールされているかどうかをテストします。
**デバイスに `nmap` がインストールされていることを確認するには**
1. ターミナルまたはテストするデバイスのコマンドラインウィンドウで、次のコマンドを入力し、`nmap` がインストールされていることを確認します。
```
nmap --version
```
1. 次のような出力が表示された場合、`nmap` がインストールされていて、[デバイスデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-test) に接続できます。
```
Nmap version 6.40 ( http://nmap.org )
Platform: x86_64-koji-linux-gnu
Compiled with: nmap-liblua-5.2.2 openssl-1.0.2k libpcre-8.32 libpcap-1.5.3 nmap-libdnet-1.12 ipv6
Compiled without:
Available nsock engines: epoll poll select
```
1. 前のステップに示すような応答がない表示されない場合、デバイスに `nmap` をインストールする必要があります。デバイスのオペレーティングシステムの手順を選択します。
------
#### [ Linux ]
この手順を実行するには、コンピュータにソフトウェアをインストールするためのアクセス許可が必要です。
**Linux コンピュータに nmap をインストールするには**
1. ターミナルまたはデバイスのコマンドラインウィンドウで、それが実行している Linux のバージョンに対応するコマンドを入力します。
1. Debian または Ubuntu の場合:
```
sudo apt install nmap
```
1. CentOS または RHEL の場合:
```
sudo yum install nmap
```
1. 次のコマンドを使用してインストールをテストします。
```
nmap --version
```
1. 次のような出力が表示された場合、`nmap` がインストールされていて、[デバイスデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-test) に接続できます。
```
Nmap version 6.40 ( http://nmap.org )
Platform: x86_64-koji-linux-gnu
Compiled with: nmap-liblua-5.2.2 openssl-1.0.2k libpcre-8.32 libpcap-1.5.3 nmap-libdnet-1.12 ipv6
Compiled without:
Available nsock engines: epoll poll select
```
------
#### [ macOS ]
この手順を実行するには、コンピュータにソフトウェアをインストールするためのアクセス許可が必要です。
**macOS コンピュータに nmap をインストールするには**
1. ブラウザで [https://nmap.org/download\$1macosx](https://nmap.org/download#macosx) を開き、**Latest stable release** (最新の安定したリリース) を開きます。
プロンプトが表示されたら、[**Open with DiskImageInstaller**] (DiskImageInstaller で開く) を選択します。
1. インストールウィンドウで、パッケージを **Applications** フォルダに移動します。
1. **[検索]** で **Applications** フォルダ内の `nmap-xxxx-mpkg` パッケージを見つけます。パッケージを **Ctrl-click** し、**[開く]** を選択してパッケージを開きます。
1. セキュリティダイアログボックスを確認します。**nmap** をインストールする準備ができたら、[**開く**] を選択して **nmap** をインストールします。
1. **Terminal** で、次のコマンドを使用してインストールをテストします。
```
nmap --version
```
1. 次のような出力が表示された場合、`nmap` がインストールされていて、[デバイスデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-test) に接続できます。
```
Nmap version 7.92 ( https://nmap.org )
Platform: x86_64-apple-darwin17.7.0
Compiled with: nmap-liblua-5.3.5 openssl-1.1.1k nmap-libssh2-1.9.0 libz-1.2.11 nmap-libpcre-7.6 nmap-libpcap-1.9.1 nmap-libdnet-1.12 ipv6 Compiled without:
Available nsock engines: kqueue poll select
```
------
#### [ Windows ]
この手順を実行するには、コンピュータにソフトウェアをインストールするためのアクセス許可が必要です。
**Windows コンピュータに nmap をインストールするには**
1. ブラウザで [https://nmap.org/download\$1windows](https://nmap.org/download#windows) を開き、セットアッププログラムの **Latest stable release** (最新の安定したリリース) をダウンロードします。
プロンプトが表示されたら、[**ファイルを保存]** を選択します。ファイルをダウンロードしたら、ダウンロードフォルダからファイルを開きます。
1. セットアップファイルのダウンロードが完了したら、ダウンロードした **nmap-xxxx-setup.exe** 開いてアプリをインストールします。
1. プログラムのインストール時に、デフォルト設定を受け入れます。
このテストには Npcap アプリは必要ありません。このアプリをインストールしない場合は、このオプションの選択を解除できます。
1. **Command** で、次のコマンドを使用してインストールをテストします。
```
nmap --version
```
1. 次のような出力が表示された場合、`nmap` がインストールされていて、[デバイスデータエンドポイントとポートへの接続をテストする](#iot-quick-start-test-connection-test) に接続できます。
```
Nmap version 7.92 ( https://nmap.org )
Platform: i686-pc-windows-windows
Compiled with: nmap-liblua-5.3.5 openssl-1.1.1k nmap-libssh2-1.9.0 nmap-libz-1.2.11 nmap-libpcre-7.6 Npcap-1.50 nmap-libdnet-1.12 ipv6
Compiled without:
Available nsock engines: iocp poll select
```
------
## デバイスデータエンドポイントとポートへの接続をテストする
この手順では、選択したポートを使用して IoT デバイスのデバイスデータエンドポイントへの接続をテストします。
**デバイスデータエンドポイントとポートへの接続をテストするには**
1. ターミナルまたはデバイスのコマンドラインウィンドウで、サンプルデバイスデータエンドポイント (`a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com`) をアカウントのデバイスデータエンドポイントで置き換え、次のコマンドを入力します。
```
nmap -p 8443 a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com
```
1. 次のような出力が `nmap` に表示された場合、`nmap` は、選択したポートのデバイスデータエンドポイントに正常に接続できました。
```
Starting Nmap 7.92 ( https://nmap.org ) at 2022-02-18 16:23 Pacific Standard Time
Nmap scan report for a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com (xx.xxx.147.160)
Host is up (0.036s latency).
Other addresses for a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com (not scanned): xx.xxx.134.144 xx.xxx.55.139 xx.xxx.110.235 xx.xxx.174.233 xx.xxx.74.65 xx.xxx.122.179 xx.xxx.127.126
rDNS record for xx.xxx.147.160: ec2-EXAMPLE-160.eu-west-1.compute.amazonaws.com
PORT STATE SERVICE
8443/tcp open https-alt
MAC Address: 00:11:22:33:44:55 (Cimsys)
Nmap done: 1 IP address (1 host up) scanned in 0.91 seconds
```
1. `nmap` で正常な出力が返されなかった場合、エンドポイントの値を参照して、正しいエンドポイントが入力されていること、およびデバイスがインターネットに接続されていることを確認してください。
ステップ 1 で使用したポート (`8443`) を置き換えることによって、デバイスデータエンドポイントのその他のポート (プライマリ HTTPS ポートのポート443 など) をテストできます。