次の方法で共有

セキュリティ エージェントの認証方法

  • [アーティクル]

この記事では、IoT Hub で認証するために AzureIoTSecurity エージェントで使用できるさまざまな認証方法について説明します。

IoT Hub の Defender for IoT にオンボードされるデバイスごとに Defender-IoT-micro-agent が必要です。 デバイスを認証するために、Defender for IoT では 2 つの方法のいずれかを使用できます。 既存の IoT ソリューションにとって最適な方法を選択してください。

  • SecurityModule オプション
  • デバイス オプション

認証方法

Defender for IoT AzureIoTSecurity エージェントで認証を実行するための 2 つの方法を次に示します。

  • Defender-IoT-micro-agent 認証モード
    このエージェントは、デバイス ID とは独立に Defender-IoT-micro-agent ID を使用して認証されます。 この認証の種類は、セキュリティ エージェントで Defender-IoT-micro-agent を通して専用の認証方法 (対称キーのみ) を使用するようにしたい場合に使用します。

  • デバイス認証モード
    この方法では、セキュリティ エージェントは最初にデバイス ID に対して認証します。 初期認証の後、Defender for IoT エージェントによって、REST API とデバイスの認証データを使用した IoT ハブへの REST 呼び出しが実行されます。 Defender for IoT エージェントは次に、IoT Hub に Defender-IoT-micro-agent 認証方法とデータを要求します。 最後の手順では、Defender for IoT エージェントによって、Defender for IoT モジュールに対して認証が実行されます。

この認証の種類は、セキュリティ エージェントで既存のデバイス認証方法 (自己署名証明書または対称キー) を再利用する場合に使用します。

構成方法については、セキュリティ エージェントのインストール パラメーターに関するセクションを参照してください。

認証方法の既知の制限

  • SecurityModule 認証モードでは、対称キーの認証のみがサポートされています。
  • デバイス認証モードでは、証明機関署名付き証明書はサポートされていません。

セキュリティ エージェントのインストール パラメーター

セキュリティ エージェントをデプロイする際には、認証の詳細を引数として指定する必要があります。 これらの引数を次の表に示します。

Linux のパラメーター名 Windows のパラメーター名 短縮形のパラメーター 説明 Options
authentication-identity AuthenticationIdentity aui 認証 ID SecurityModule または Device
authentication-method AuthenticationMethod aum 認証方法 SymmetricKey または SelfSignedCertificate
file-path FilePath f 証明書または対称キーを含むファイルの完全な絶対パス
host-name HostName hn IoT Hub の FQDN 例:ContosoIotHub.azure-devices.net
device-id deviceId di Device ID 例:MyDevice1
certificate-location-kind CertificateLocationKind cl 証明書ストレージの場所 LocalFile または Store

セキュリティ エージェントのインストール スクリプトを使用すると、次の構成が自動的に実行されます。 セキュリティ エージェントの認証を手動で編集するには、構成ファイルを編集します。

デプロイ後に認証方法を変更する

インストール スクリプトを使用してセキュリティ エージェントをデプロイすると、構成ファイルが自動的に作成されます。

デプロイ後に認証方法を変更するには、構成ファイルを手動で編集する必要があります。

C# ベースのセキュリティ エージェント

次のパラメーターを使用して、Authentication.config を編集します。

<Authentication>
  <add key="deviceId" value=""/>
  <add key="gatewayHostname" value=""/>
  <add key="filePath" value=""/>
  <add key="type" value=""/>
  <add key="identity" value=""/>
  <add key="certificateLocationKind" value="" />
</Authentication>

C ベースのセキュリティ エージェント

次のパラメーターを使用して、LocalConfiguration.json を編集します。

"Authentication" : {
    "Identity" : "",
    "AuthenticationMethod" : "",
    "FilePath" : "",
    "DeviceId" : "",
    "HostName" : ""
}

関連項目