翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
設定
Device Advisor を初めて使用する場合は、事前に以下のタスクをすべて実行してください。
IoT モノの作成
まず、IoT モノを作成し、モノに証明書をアタッチします。モノの作成方法のチュートリアルについては、「モノのオブジェクトを作成する」を参照してください。
デバイスIAMロールとして使用する ロールを作成する
注記
Device Advisor コンソールを使用して、デバイスロールをすばやく作成できます。Device Advisor コンソールを使用してデバイスロールを設定する手順については、「コンソールでの Device Advisor の開始方法」を参照してください。
-
AWS Identity and Access Management コンソール
に移動し、Device Advisor テスト AWS アカウント に使用する にログインします。 -
左側のナビゲーションペインで、[Policies] (ポリシー) を選択します。
-
[Create policy] (ポリシーの作成) を選択します。
-
[Create policy] (ポリシーの作成) で、次の操作を実行します。
-
[Service] (サービス) で、[IoT] を選択します。
-
[アクション] で、次のいずれかを実行します。
-
(推奨) IoT Thing に添付されているポリシーまたは前のセクションで作成した証明書に基づいてアクションを選択します。
-
[フィルターアクション] ボックスで次のアクションを検索して選択します。
-
Connect
-
Publish
-
Subscribe
-
Receive
-
RetainPublish
-
-
-
[リソース] で、クライアント、トピック、およびトピックのリソースを制限します。これらのリソースを制限することは、セキュリティのベストプラクティスです。リソースを制限するには、次の手順を実行します。
-
Connect アクションARNのクライアントリソースの指定を選択します。
-
を追加 ARNを選択し、次のいずれかを実行します。
注記
clientId は、デバイスが Device Advisor とやり取りするために使用するMQTTクライアント ID です。
-
ビジュアルARNエディタでリージョン、accountID、および clientID を指定します。
-
テストケースを実行する IoT トピックの Amazon リソースネーム (ARNs) を手動で入力します。
-
-
[追加] を選択します。
-
受信 ARN のトピックリソースを指定 を選択し、さらに 1 つのアクションを選択します。
-
を追加 ARNを選択し、次のいずれかを実行します。
注記
トピック名は、デバイスがメッセージを発行するMQTTトピックです。
-
ビジュアルARNエディタでリージョン、accountID、およびトピック名を指定します。
-
テストケースを実行する IoT トピックARNsの を手動で入力します。
-
-
[追加] を選択します。
-
サブスクライブアクションARNの topicFilter リソースを指定を選択します。
-
を追加 ARNを選択し、次のいずれかを実行します。
注記
トピック名は、デバイスがサブスクライブするMQTTトピックです。
-
ビジュアルARNエディタでリージョン、accountID、およびトピック名を指定します。
-
テストケースを実行する IoT トピックARNsの を手動で入力します。
-
-
[追加] を選択します。
-
-
-
[Next: Tags] (次へ: タグ) を選択します。
-
[次へ: レビュー] を選択します。
-
[ポリシーの確認] でポリシーの [名前] を入力します。
-
[Create policy] を選択します。
-
左のナビゲーションペインで、[Roles] (ロール) を選択します。
-
[ロールの作成] を選択します。
-
[信頼されたエンティティの選択] で、[カスタム信頼ポリシー] を選択します。
-
次の信頼ポリシーを [カスタム信頼ポリシー] ボックスに入力します。Confused Deputy Problem (混乱した代理の問題) から保護するために、グローバル条件コンテキストキー
aws:SourceArn
とaws:SourceAccount
をポリシーに追加します。重要
aws:SourceArn
は、format: arn:aws:iotdeviceadvisor:
と一致する必要があります。region:account-id
:*.
がお客様の AWS IoT リージョンと一致し、region
がお客様のカスタマーアカウント ID と一致することを確認してください。詳細については、クロスサービスでの混乱した代理処理を防止するを参照してください。account-id
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowAwsIoTCoreDeviceAdvisor", "Effect": "Allow", "Principal": { "Service": "iotdeviceadvisor.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:iotdeviceadvisor:*:111122223333:suitedefinition/*" } } } ] }
-
[Next (次へ)] を選択します。
-
ステップ 4 で作成したポリシーを選択します。
-
(オプション) [アクセス許可の境界の設定] で、[アクセス許可の境界を使用してロールのアクセス許可の上限を設定する] を選択し、作成したポリシーを選択します。
-
[Next (次へ)] を選択します。
-
[Role name] (ロール名) と [Role description] (ロールの説明) を入力します。
-
[ロールの作成] を選択します。
IAM ユーザーが Device Advisor を使用するためのカスタム管理ポリシーを作成する
-
https://console.aws.amazon.com/iam/
で IAM コンソールに移動します。プロンプトが表示されたら、 AWS 認証情報を入力してサインインします。 -
左のナビゲーションペインの [ポリシー] を選択します。
-
ポリシーの作成を選択し、JSONタブを選択します。
-
Device Advisor を使用するために必要なアクセス許可を追加します。ポリシードキュメントは、トピック [Security best practices] (セキュリティのベストプラクティス) にあります。
-
[ポリシーの確認] を選択します。
-
[Name (名前)] と [Description (説明)] を入力します。
-
[ポリシーの作成] を選択します。
Device Advisor を使用する IAM ユーザーを作成する
注記
Device Advisor テストを実行するときに使用する IAM ユーザーを作成することをお勧めします。管理者ユーザーから Device Advisor のテストを実行すると、セキュリティ上のリスクが生じる可能性があるため、お勧めしません。
-
IAM コンソールに移動します。https://console.aws.amazon.com/iam/
プロンプトが表示されたら AWS 、サインインするための認証情報を入力します。 -
左のナビゲーションペインで、[Users] (ユーザー) を選択します。
-
[Add User] を選択します。
-
ユーザー名を入力します。
-
ユーザーが の AWS 外部で を操作する場合は、プログラムによるアクセスが必要です AWS Management Console。プログラムによるアクセスを許可する方法は、 がアクセスするユーザーのタイプによって異なります AWS。
ユーザーにプログラマチックアクセス権を付与するには、以下のいずれかのオプションを選択します。
プログラマチックアクセス権を必要とするユーザー 目的 方法 ワークフォースアイデンティティ
(IAMIdentity Center で管理されるユーザー)
一時的な認証情報を使用して AWS CLI、、 AWS SDKs、または へのプログラムによるリクエストに署名します AWS APIs。 使用するインターフェイスの指示に従ってください。
-
については AWS CLI、「 AWS Command Line Interface ユーザーガイド」の「 を使用する AWS CLI ための の設定 AWS IAM Identity Center」を参照してください。
-
AWS SDKs、ツール、および については AWS APIs、AWS SDKs「 およびツールリファレンスガイド」のIAM「 Identity Center 認証」を参照してください。
IAM 一時的な認証情報を使用して AWS CLI、、 AWS SDKs、または へのプログラムによるリクエストに署名します AWS APIs。 「 ユーザーガイド」の「 AWS リソースでの一時的な認証情報の使用」の手順に従います。 IAM IAM (非推奨)
長期認証情報を使用して、、 AWS SDKs AWS CLI、または AWS APIs へのプログラムによるリクエストに署名します。使用するインターフェイスの指示に従ってください。
-
については AWS CLI、「 AWS Command Line Interface ユーザーガイド」のIAM「ユーザー認証情報を使用した認証」を参照してください。
-
および ツールについては AWS SDKs、「 AWS SDKsおよびツールリファレンスガイド」の「長期認証情報を使用した認証」を参照してください。
-
については AWS APIs、「 IAMユーザーガイド」のIAM「 ユーザーのアクセスキーの管理」を参照してください。
-
-
[Next: Permissions] (次へ: アクセス許可) を選択します。
-
アクセス権限を付与するには、ユーザー、グループ、またはロールにアクセス許可を追加します。
-
以下のユーザーとグループ AWS IAM Identity Center:
アクセス許可セットを作成します。「AWS IAM Identity Center ユーザーガイド」の「権限設定を作成する」の手順に従ってください。
-
ID プロバイダーIAMを介して で管理されるユーザー:
ID フェデレーションのロールを作成します。IAM 「 ユーザーガイド」の「サードパーティー ID プロバイダー (フェデレーション) のロールを作成する」の手順に従います。
-
IAM ユーザー:
-
ユーザーが担当できるロールを作成します。「 IAMユーザーガイド」のIAM「 ユーザーのロールを作成する」の手順に従います。
-
(お奨めできない方法) ポリシーをユーザーに直接アタッチするか、ユーザーをユーザーグループに追加する。「 IAMユーザーガイド」の「ユーザーにアクセス許可を追加する (コンソール)」の手順に従います。
-
-
-
作成したカスタム管理ポリシーの名前を検索ボックスに入力します。次に、[ポリシー名] のチェックボックスをオンにします。
-
[Next: Tags] (次へ: タグ) を選択します。
-
[Next: Review] を選択します。
-
[Create user] を選択します。
-
[閉じる] を選択します。
Device Advisor は、ユーザーに代わって AWS リソース (モノ、証明書、エンドポイント) にアクセスする必要があります。IAM ユーザーには必要なアクセス許可が必要です。また、必要なアクセス許可ポリシーをIAMユーザーにアタッチ CloudWatch すると、Device Advisor は Amazon にログを発行します。
デバイスを設定する
Device Advisor は、サーバー名表示 (SNI) TLS拡張機能を使用してTLS設定を適用します。デバイスは、接続時にこの拡張を使用し、Device Advisor のテストエンドポイントと同じサーバー名を渡す必要があります。
Device Advisor は、テストが Running
状態にあるときにTLS接続を許可します。各テスト実行の前後にTLS接続を拒否します。このため、Device Advisor で完全に自動化されたテストを行うために、デバイス接続の再試行メカニズムを使用することをお勧めします。TLS 接続、MQTT接続、MQTT公開など、複数のテストケースを含むテストスイートを実行できます。複数のテストケースを実行する場合、デバイスが 5 秒ごとにテストエンドポイントに接続することを推奨します。その後、自動化された方法で順番に複数のテストケースを実行できます。
注記
デバイスソフトウェアをテストする準備を整えるには、 が接続SDKできる を使用することをお勧めします AWS IoT Core。次に、 用に提供されている Device Advisor テストエンドポイントSDKで を更新する必要があります AWS アカウント。
Device Advisor が、アカウントレベルのエンドポイントとデバイスレベルのエンドポイントの 2 種類のエンドポイントをサポートします。ユースケースに最も適したエンドポイントを選択します。異なるデバイスを使用して複数のテストスイートを同時に実行するには、デバイスレベルのエンドポイントを使用します。
次のコマンドを実行して、デバイスレベルのエンドポイントを取得します。
X.509 クライアント証明書を使用しているMQTTお客様:
aws iotdeviceadvisor get-endpoint --thing-arn
your-thing-arn
or
aws iotdeviceadvisor get-endpoint --certificate-arn
your-certificate-arn
署名バージョン 4 を使用している MQTT を超える WebSocket お客様向け:
aws iotdeviceadvisor get-endpoint --device-role-arn
your-device-role-arn
--authentication-method SignatureVersion4
一度に 1 つのテストスイートを実行するには、アカウントレベルのエンドポイントを選択します。次のコマンドを実行して、アカウントレベルのエンドポイントを取得します。
aws iotdeviceadvisor get-endpoint