ONVIF 用にコネクタを構成する

Azure IoT Operations では、ONVIF 用コネクタを使用して、Azure IoT Operations クラスターに接続されている ONVIF 準拠カメラを検出して使用できます。

Azure IoT Operations の資産は、物理資産またはデバイスを表すために作成する論理エンティティです。 Azure IoT Operations 資産には、その動作と特性を記述するカスタムプロパティ、データポイント、ストリーム、およびイベントを含めることができます。資産は、1 つ以上のデバイスに関連付けられています。 Azure IoT Operations は、資産定義を Azure Device Registry に格納します。

Azure IoT Operations の デバイス は、物理資産またはデバイスへの接続を定義する論理エンティティです。デバイスがないと、物理デバイスまたは資産から MQTT ブローカーにデータをフローすることはできません。デバイスと資産を構成すると、物理資産またはデバイスへの接続が確立され、データポイントの値、イベント、ストリームが Azure IoT Operations インスタンスに到着します。デバイスには、1 つ以上の受信エンドポイントがあります。 Azure IoT Operations は、デバイス定義を Azure Device Registry に格納します。

コネクタは、ONVIF カメラを Azure IoT Operations インスタンスに接続し、Azure Device Registry に登録します。その後、コネクタは自動的に次を検出します。

ONVIF デバイスのパン傾きズーム (PTZ) などの機能。
ONVIF デバイスによって公開されるメディアエンドポイント。
フレームレート、解像度、エンコードなどのメディアストリームの詳細。

カメラの登録後、管理操作の例を次に示します。

カメラの構成を取得して更新し、出力イメージの構成を調整します。
カメラのパン、傾き、ズーム (PTZ) を制御する。

メディアコネクタは、これらのカメラによって公開されているメディアソースにアクセスできます。

メディアコネクタ、ONVIF 用コネクタ、Azure IoT Operations、コンパニオンサービスを組み合わせることで、Azure IoT Operations を使用して次のようなユースケースを実装できます。

待機時間とドウェル時間追跡により、顧客が一列に並んで費やした時間を追跡します。
品目と POS レシートを比較して、正しい注文が梱包されていることを追跡するための注文の精度。
アセンブリライン上の製品の欠陥を検出するためのカメラによる欠陥検出と品質保証。
衝突検出、安全ゾーン検出、個人用安全装置検出などの安全監視。

この記事では、操作エクスペリエンス Web UI と Azure CLI を使用して次の操作を行う方法について説明します。

準拠しているカメラの ONVIF エンドポイントを持つデバイスを追加します。
ONVIF エンドポイントで検出された資産とデバイスを表示します。
ONVIF カメラによって公開されるメディアエンドポイントを表すデバイスを作成します。
メディアエンドポイントからスナップショットをキャプチャし、MQTT ブローカーに発行する資産を作成します。

ONVIF 用コネクタでは、次の認証方法がサポートされています。

ユーザー名/パスワード認証
テスト目的での匿名アクセス

ONVIF カメラへの TLS 接続を確立するには、コネクタの証明書信頼リストを構成します。

前提条件

リソース同期規則が有効になっている Azure IoT Operations のデプロイされたインスタンス。リソース同期規則を有効にするには、Azure IoT Operations インスタンスで次のコマンドを実行します。このコマンドは、カスタムの場所に必要なアクセス許可も設定します。

az iot ops enable-rsync -n <my instance> -g <my resource group>

操作エクスペリエンス Web UI にサインインするには、Kubernetes - Azure Arc インスタンスを含むリソースグループに対する共同作成者以上のアクセス許可を持つ Microsoft Entra ID アカウントが必要です。 Microsoft アカウント (MSA) ではサインインできません。詳細については、「操作エクスペリエンス Web UI へのアクセスのトラブルシューティング」を参照してください。

Azure IoT Operations クラスターからアクセスできる ONVIF 準拠のカメラ。

ONVIF コンプライアンス

ONVIF には、検出、デバイス、メディア、イメージング、分析、イベント、パン傾斜ズーム (PTZ) サービスなど、コンプライアンスに関するいくつかのカテゴリがあります。詳細については、「 ONVIF - プロファイル、アドオン、および仕様」を参照してください。

Azure IoT Operations の ONVIF コネクタは、次のプロファイルを実装するカメラデバイスのサポートに重点を置いています。

コネクタを使用すると、次の機能がサポートされます。

デバイス情報と機能の検出。
デバイスからのイベントの監視。
デバイスによって公開されているメディア URI の検出。 ONVIF 用コネクタを使用すると、メディアコネクタでこれらの URI を使用できるようになります。
フィルターの適用、モーションおよび改ざんイベントの受信などのイメージング制御。
デバイス PTZ の操作制御。

ONVIF 用のコネクタをデプロイする

Azure IoT Operations をデプロイすると、デプロイにはさまざまなコネクタが含まれます。操作エクスペリエンス Web UI でコネクタ (ONVIF、メディア、HTTP/REST など) を使用するには、管理者が Azure IoT Operations インスタンスにコネクタテンプレートインスタンスを追加する必要があります。

すべてのコネクタは、キャプチャされたデータを MQTT ブローカーに発行できます。

コネクタテンプレートインスンスをお使いの Azure IoT Operations インスタンスに追加するには:

Azure portal で、Azure IoT Operations インスタンスに移動し、[コネクタテンプレート] を選択し、[コネクタテンプレートインスタンスの追加] を選択します。
Akri コネクタテンプレートの追加ウィザードの最初のページで、追加するコネクタテンプレートの種類とバージョン (ONVIF、Media、HTTP/REST、SSE、MQTT など) を選択します。次に、[メタデータ] を選択します。
[メタデータ] ページで、既定値をそのまま使用し、[デバイスの受信エンドポイントの種類] を選択します。
[デバイスの受信エンドポイントの種類] ページで、既定値をそのまま使用し、[診断の構成] を選択します。
[診断構成] ページで、既定値をそのまま使用し、[ランタイム構成] を選択します。
[ ランタイム構成 ] ページで、既定値をそのまま使用し、[ 確認] を選択します。
[レビュー] ページで、コネクタテンプレートインスタンスの詳細をレビューし、[作成] を選択してコネクタテンプレートインスタンスを作成します。

OT ユーザーは、操作エクスペリエンス Web UI を使用して、コネクタエンドポイントを持つデバイスを作成できるようになりました。

ONVIF エンドポイントを使用してデバイスを作成する

準拠しているカメラの ONVIF エンドポイントを含むデバイスを追加するには:

操作エクスペリエンス Web UI で、左側のナビゲーションウィンドウから [デバイス ] を選択します。
[新規作成] を選択します。 [ デバイスの詳細 ] ページで、 my-onvif-cameraなどのデバイスの名前を入力します。受信エンドポイントを定義するには、Microsoft.Onvif タイルで [新規] を選択します。 ONVIF カメラの詳細を次のように入力します。

[ 保存] を 選択して、エンドポイントをデバイスに追加します。 [デバイスの詳細] ページに ONVIF エンドポイントが表示されるようになりました。
[ デバイスの詳細 ] ページで、[ 次へ] を選択します。
[カスタムプロパティの追加] ページでは、必要に応じてデバイスのカスタムプロパティを更新または追加できます。完了したら、[次へ] を選びます。
[概要] ページには、デバイスの詳細が表示されます。詳細を確認し、[ 作成 ] を選択してデバイスを作成します。数分後、[ デバイス ] ページに新しいデバイスが表示されます。

次のコマンドを実行してください:

az iot ops ns device create -n onvif-connector-cli -g {your resource group name} --instance {your instance name}

az iot ops ns device endpoint inbound add onvif --device onvif-connector-cli -g {your resource group name} -i {your instance name}  --name onvif-connector-cli-0 --endpoint-address http://myonvifcam:2020/onvif/device_service

詳細については、 az iot ops ns device を参照してください。

次の Bicep テンプレートをデプロイして、ONVIF 用コネクタの受信エンドポイントを持つデバイスを作成します。プレースホルダーの <AIO_NAMESPACE_NAME> と <CUSTOM_LOCATION_NAME> は、それぞれ Azure IoT Operations 名前空間名とカスタムの場所名に置き換えます。

param aioNamespaceName string = '<AIO_NAMESPACE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

resource device 'Microsoft.DeviceRegistry/namespaces/devices@2025-10-01' = {
  name: 'onvif-connector'
  parent: namespace
  location: resourceGroup().location
  extendedLocation: {
    type: 'CustomLocation'
    name: customLocation.id
  }
  properties: {
    endpoints: {
      outbound: {
        assigned: {}
      }
      inbound: {
        'onvif-connector-0': {
          endpointType: 'Microsoft.Onvif'
          address: 'http://myonvifcam:2020/onvif/device_service'
        }
      }
    }
  }
}

ユーザー名とパスワードを使用するようにデバイスを構成する

前の例では、Anonymous 認証モードを使用しています。このモードでは、ユーザー名やパスワードは必要ありません。

Username password 認証モードを使用するには、次の手順を実行します。

「Azure IoT Operations デプロイのシークレットを管理する」の手順に従って、Azure Key Vault にユーザー名とパスワードのシークレットを追加し、それらを Kubernetes クラスターに投影し、デバイス構成から参照します。

「Azure IoT Operations デプロイのシークレットを管理する」の手順に従って、Azure Key Vault にユーザー名とパスワードのシークレットを追加し、それらを Kubernetes クラスターに投影します。
az iot ops ns device endpoint inbound add コマンドと、--user-refパラメーターと--pass-ref パラメーターを使用して、作成した Azure Key Vault シークレットへの参照を追加します。

「Azure IoT Operations デプロイのシークレットを管理する」の手順に従って、Azure Key Vault にユーザー名とパスワードのシークレットを追加し、それらを Kubernetes クラスターに投影します。

次の例に示すように、コネクタの Bicep 構成の authentication ブロックを変更して、ユーザー名とパスワードの同期されたシークレットを参照します。

authentication: {
    method: 'UsernamePassword'
        usernamePasswordCredentials: {
            passwordSecretName: '<reference to synced password secret>'
            usernameSecretName: '<reference to synced username secret>'
        }
}

その他のセキュリティオプション

ONVIF 用コネクタの信頼された証明書の一覧を管理するには、「外部通信の証明書を管理する」を参照してください。

操作エクスペリエンスで受信エンドポイントを作成するときに、[ 詳細設定 ] タブで次のオプションを選択することもできます。

Option	タイプ	Description
無効なホスト名を受け入れる	はい/いいえ	ONVIF 接続の証明書で無効なホスト名を受け入れます。既定値は [いいえ] です
無効な証明書を受け入れる	はい/いいえ	ONVIF 接続の無効な証明書を受け入れます。既定値は [いいえ] です
ユーザー名トークン認証へのフォールバック	はい/いいえ	ONVIF 接続のダイジェスト認証が失敗した場合は UsernameToken 認証にフォールバックし、既定値は No

ヒント

Azure CLI を使用してこれらの設定を構成する方法の詳細については、 az iot ops ns device endpoint inbound add コマンドリファレンスを参照してください。

検出された資産とデバイスを表示する

ONVIF エンドポイントを使用してデバイスを作成すると、ONVIF のコネクタによって、エンドポイントで使用可能な ONVIF 資産とメディアデバイスが自動的に検出されます。操作エクスペリエンス Web UI で検出された資産とデバイスを表示するには、左側のナビゲーションウィンドウから [探索 ] を選択します。

[ インポート] を選択し、 検出された ONVIF 資産から資産を作成し、ONVIF 準拠カメラの機能を表す資産を作成します。たとえば、ONVIF カメラからイベントをキャプチャするアセットを作成したり、ONVIF カメラを制御したりできます。詳細については、「イベント管理と制御のための ONVIF 資産の作成」セクションを参照してください。
検出された ONVIF デバイスからデバイスをインポートして作成 を選択し、ONVIF 準拠カメラによって公開されるメディアエンドポイントに接続するデバイスを作成します。メディアデバイスを作成したら、メディアエンドポイントからスナップショットまたはビデオストリームをキャプチャするメディア資産を作成できます。詳細については、「メディアエンドポイントを使用したデバイスの作成」セクションを参照してください。

メディアエンドポイントを使用してデバイスを作成する

検出されたデバイスからメディアエンドポイントを持つデバイスを作成するには、次の手順に従います。

操作エクスペリエンス Web UI で、左側のナビゲーションウィンドウから [探索 ] を選択します。次に、検出されたデバイスを選択します。
検出されたメディアデバイス ( my-onvif-cameraなど) を選択します。次に、[ デバイスのインポートと作成] を選択します。
[デバイスの詳細] ページには、検出されたすべてのメディア受信エンドポイントが表示されます。 my-onvif-camera-mediaなど、デバイスの名前を入力し、各エンドポイントの認証方法を選択します。

ヒント

不要な受信エンドポイントを削除するには、そのエンドポイントを選択し、[ 受信エンドポイントの削除] を選択します。

次に、[次へ] を選択します。
[ カスタムプロパティの追加] ページで、検出されたプロパティを確認できます。必要に応じて、デバイスにカスタムプロパティを更新、削除、または追加できます。完了したら、[次へ] を選びます。
[ 概要 ] ページで、デバイスの詳細を確認します。 [ 作成] を選択してデバイスを作成します。数分後、[ デバイス ] ページに新しいメディアデバイスが表示されます。

スナップショットをキャプチャするメディア資産を作成する

検出されたメディアデバイスを使用して、カメラからスナップショットをキャプチャし、MQTT ブローカーに発行する資産を作成できるようになりました。メディア資産を作成するには、次の手順に従います。

操作エクスペリエンス Web UI で、左側のナビゲーションウィンドウから [資産 ] を選択します。次に、[ 資産の作成] を選択します。
[ 資産の詳細] ページで、資産の名前 ( my-onvif-camera-media-assetなど) を入力します。次に、スナップショットのキャプチャに使用する検出されたエンドポイントを選択します。

メディア資産のカスタムプロパティを更新し、[ 次へ] を選択します。
[ ストリーム ] ページで、[ ストリームの追加] を選択します。 MQTT ブローカーにスナップショットを発行するストリームの例を構成するには、次の設定を使用します。
- ストリーム名: myassetvideo
- 宛先: MQTT
- トピック: myassetvideo
- タスクの種類: snapshot-to-mqtt
ヒント

ここで選択するトピックは、ONVIF コネクタが MQTT ブローカーにスナップショットを発行するときに、 azure-iot-operations/data/<asset-name>/ の下に自動的に入れ子になります。

その他の設定は既定値のままにします。その後、追加を選択します。ストリームが資産構成に追加されます。
次へを選択して、レビュー ページに移動します。資産の詳細を確認し、[ 作成 ] を選択して資産を作成します。数分後、[ 資産 ] ページに新しい資産が表示されます。

これで、ONVIF 準拠カメラからスナップショットをキャプチャし、MQTT ブローカーに発行するようにメディア資産が構成されました。

イベント管理および制御用の ONVIF 資産を作成する

ONVIF 準拠のカメラは、モーション検出などのイベントを生成し、パン、傾き、ズームなどの制御コマンドに応答できます。検出された ONVIF デバイスから、これらのイベントをキャプチャし、カメラを制御できる ONVIF アセットを作成できます。

操作エクスペリエンスに ONVIF デバイスを追加すると、検出された ONVIF 資産が自動的に作成されます。

イベントの管理と制御のために ONVIF 資産を作成するには:

検出された資産を選択し、[ インポートして資産を作成] を選択します。
[ 資産の詳細 ] ページで、資産の名前と説明を入力します。デバイスの受信エンドポイントは既に選択されており、カスタムプロパティは検出された資産から事前設定されています。

[次へ] を選択して続行します。
[ イベントグループ ] ページで、検出されたイベントを確認するイベントグループを選択します。使用しないイベントは削除できます。
保持するイベントごとに、その発行先の MQTT トピックを構成します。

[次へ] を選択して続行します。
[ 管理グループ ] ページで、ONVIF カメラの制御に使用するパン、傾斜、ズームなどのアクションを構成します。

管理グループの構成の詳細については、「カメラの管理と制御」を参照してください。

[次へ] を選択して続行します。
ONVIF 資産構成の概要を確認し、[ 作成 ] を選択して資産を作成します。数分後、[ 資産 ] ページに新しい資産が表示されます。

カメラを管理して制御する

ONVIF カメラを操作するために、ONVIF 用コネクタがサブスクライブする MQTT メッセージを発行できます。メッセージ形式は、 ONVIF ネットワークインターフェイスの仕様に基づいています。

ONVIF PTZ デモ用 Azure IoT Operations コネクタのサンプルアプリケーションでは、ONVIF 用コネクタを使用して次の操作を行う方法を示します。

メディア資産定義を使用して、カメラのメディアサービスからプロファイルトークンを取得します。
カメラの PTZ 機能を使用して位置と向きを制御する場合は、プロファイルトークンを使用します。

サンプルアプリケーションでは、Azure IoT Operations MQTT ブローカーを使用して、ONVIF のコネクタと対話するコマンドを送信します。詳細については、 MQTT ブローカーを使用した MQTT メッセージのパブリッシュとサブスクライブを参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-11