Skip to content

CoAPゲートウェイ

CoAPゲートウェイは、リソース制約のあるデバイス向けに設計された軽量デバイス接続を可能にします。低消費電力・低帯域幅のシナリオに適しており、CoAPベースのパブリッシュサブスクライブ機構をサポートしています。

動作モード

CoAPゲートウェイは、以下の2つの動作モードをサポートしています。

  • コネクションレスモード
    • Publish-Subscribe Broker for CoAP プロトコルに準拠しています。
    • 接続認証、セッション管理、ハートビートの維持は不要です。
    • サポートされる機能:
      • メッセージのパブリッシュ
      • トピックのサブスクライブ
  • コネクションモード
    • 接続認証、セッション永続化、ハートビート機構を導入しています。
    • クライアントは接続を確立し、セッショントークン(Token)を取得する必要があります。以降の通信ではクエリ文字列にトークンを含める必要があります。
    • サポートされる機能:
      • 接続の作成
      • 接続の切断
      • セッション永続化(オプションのハートビート)
      • 認証

コネクションモードはCoAPゲートウェイの設定ページで構成可能です。

TIP

コネクションモードは接続管理APIを追加するのみで、パブリッシュ、サブスクライブ、サブスクライブ解除の操作は引き続き可能ですが、すべてのリクエストにClientIdTokenが必要です。

基本設定

CoAPゲートウェイの操作列にある設定ボタンをクリックし、基本設定を行います。

  • Connection Required:コネクションモードの有効・無効を切り替えます。デフォルトは有効です。
    • true:コネクションモードを有効にします。このモードではクライアントは接続認証、セッション永続化、セッショントークン(Token)を用いた通信が必要となり、より厳密な接続管理が求められるシナリオに適しています。
    • false:コネクションモードを無効にし、コネクションレスモードに切り替えます。このモードではクライアントは接続管理なしにメッセージのパブリッシュとサブスクライブのみを行います。
  • Notification Message Type:CoAPメッセージの通知タイプを指定します。デフォルトはqosです。
    • qos:QoS(サービス品質)で、メッセージ配信の信頼性制御に使用されます。
    • con:確認可能メッセージで、送信後にクライアントのアック(ACK)が必要です。
    • non:非確認メッセージで、アック不要。重要度の低いまたは破棄可能なメッセージに適しています。
  • Heartbeat:CoAPゲートウェイとクライアント間のハートビート間隔を設定します。ハートビートメッセージは接続状態を検知し、接続維持に役立ちます。タイムアウトすると接続が切断される可能性があります。デフォルトは30秒です。
  • Subscribe QoS:サブスクライブしたメッセージのサービス品質レベルを設定します。デフォルトはcoapです。
  • Publish QoS:パブリッシュするメッセージのサービス品質レベルを設定します。デフォルトはcoapです。
  • MountPoint:CoAPゲートウェイのマウントポイントを設定します。マウントポイントはCoAPプロトコルにおけるURLパスのプレフィックスで、異なるアプリケーションやクライアントによるデータ交換やアクセスのための特定のURLパス構造を定義できます。

設定完了後、更新をクリックして保存してください。

クライアント

CoAPページのクライアントタブには、デプロイメントに接続されているクライアントの基本情報が表示されます。操作列から特定のクライアントを切断することも可能です。

クライアント接続ガイド

詳細はCoAPクライアント接続ガイドをご参照ください。

接続アドレスとポート

接続アドレスおよびポート情報はデプロイメント概要ページで確認できます。

パブリッシュ・サブスクライブ

CoAPゲートウェイはPublish-Subscribe Broker for CoAPに基づくパブリッシュ・サブスクライブ機能を実装しています。権限管理はクライアント認可で一元管理されます。

クライアントライブラリ

開発およびテストには以下のクライアントライブラリを推奨します。

認証管理

この機能はコネクションモードでのみ利用可能です。ClientIdusernamepasswordはクライアントのCreate Connectionリクエストで提供されます。

ゲートウェイページのCoAPゲートウェイの操作列にある認証ボタンをクリックすると認証管理ページが開き、認証情報の追加、編集、削除が行えます。