翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

WiFi Simple Setup のプロビジョニング先を設定する

このページ:

プロビジョンド要件

WiFi Simple Setup をサポートするには、プロビジョンドデバイスがこれらの要件を満たしている必要があります。

ハードウェアとセキュリティ

認証マテリアル

重要: UPC/EAN とペアリングされた SN は、お客様の AWS アカウント内のマネージドモノごとに一意である必要があります。

ソフトウェアコンポーネント

注: corePKCS11 PAL は、ソフトウェアのみの実装ではなく、実際の HSM/TPM ハードウェアとインターフェイスする必要があります。

製造要件

デバイスメーカーは、製造中に安全なマテリアルと識別子をプロビジョニングする必要があります。

安全なマテリアルプロビジョニング

クレーム証明書とプライベートキー:

デバイス識別子:

バーコードの要件

物理ラベルには以下を含める必要があります。

フリートプロビジョニングの設定

AWS アカウント設定:

プロビジョニング先機能を有効にする

アカウントのリンク中に CreateManagedThing API を使用してデバイスの WSS を有効にします。

デバイス登録

{
  "role": "DEVICE",
  "credentialLockerId": "ad5cdc9f786b4dbe9490e57c0b1d900e",
  "authenticationMaterialType": "WIFI_SETUP_QR_BAR_CODE",
  "authenticationMaterial": "SN:123456789331;UPC:123456789331",
  "wiFiSimpleSetupConfiguration": {
    "enableAsProvisionee": true,
    "timeoutInMinutes": 15
  }
}
      

パラメータ :

再試行または再アクティブ化

UpdateManagedThing を使用して、最初の失敗後に再試行します。

{
  "managedThingId": "existing-device-id",
  "wiFiSimpleSetupConfiguration": {
    "enableAsProvisionee": true,
    "timeoutInMinutes": 15
  }
}
      

バーコードスキャンワークフロー

バーコードスキャンからデバイスのアクティベーションまでend-to-endのワークフローを完了します。

ステップ 1: 準備

ステップ 2: スキャンして登録する

ステップ 3: クラウドのアクティベーション

クラウド処理は自動的に次のようになります。

GetManagedThing レスポンスの例:

{
  "managedThingId": "device-id", 
  "role": "DEVICE",
  "credentialLockerId": "ad5cdc9f786b4dbe9490e57c0b1d900e",
  "authenticationMaterialType": "WIFI_SETUP_QR_BAR_CODE",
  "authenticationMaterial": "SN:123456789331;UPC:123456789331",
  "wiFiSimpleSetupConfiguration": {
    "enableAsProvisioner": false,
    "supportAsProvisioner": false,
    "enableAsProvisionee": true,
    "wssExpirationTimeStamp": "2025-06-04T20:22:04.069610Z"
  }
}
      

キーフィールド:

ステップ 4: デバイスの電源をオンにする

アクティベーションウィンドウとタイムアウト

WSS は、時間制限付きのウィンドウとオペレーションタイムアウトを使用してセキュリティを強化し、プロビジョニングを管理します。

アクティベーションウィンドウ

デフォルト: バーコードスキャンからデバイスのアクティベーションまで 15 分

設定:

有効期限の動作:

オペレーションタイムアウト

ベストプラクティス

WSS 設定を再試行する

最初の WSS 設定が失敗した場合、UpdateManagedThing API を使用して再試行します。

ワークフローを再試行する

ステップ 1: 失敗を特定する

ステップ 2: UpdateManagedThing を使用して再試行する

{
  "managedThingId": "device-managed-thing-id",
  "wiFiSimpleSetupConfiguration": {
    "enableAsProvisionee": true,
    "timeoutInMinutes": 15
  }
}
      

ステップ 3: 再アクティブ化

一般的な再試行シナリオ

重要: UpdateManagedThing 呼び出しごとに新しい 15 分のウィンドウが作成されます。3～4 回障害が発生した場合は、プロビジョナーのステータスの確認、デバイスの機能の検証、またはユーザーガイドのセットアップの使用を検討してください。

プロビジョニング先機能を無効化する

プロビジョニング先デバイスの WSS を無効化または削除します。

UpdateManagedThing API の使用

{
  "managedThingId": "device-managed-thing-id",
  "wiFiSimpleSetupConfiguration": {
    "enableAsProvisionee": false
  }
}
      

DeleteManagedThing API の使用

{
  "managedThingId": "device-managed-thing-id"
}
      

比較

セキュリティに関する考慮事項

次の場合は disable/delete を使用します。

を無効化/削除したら、次の点を考慮してください。