メインコンテンツまでスキップ

4. Abstract Service Interfaces (抽象サービスインターフェース)

4. Abstract Service Interfaces (抽象サービスインターフェース)​

このセクションでは, SNMP アーキテクチャの主要コンポーネント間の抽象サービスインターフェースについて説明します。これらのインターフェースは抽象プリミティブを使用して定義されており, コンポーネント間で渡す必要がある情報を表しますが, それがどのように渡されるかは指定しません。

抽象サービスインターフェースはいくつかのカテゴリに編成されています:

  • ディスパッチャープリミティブ (Dispatcher Primitives): アプリケーションとディスパッチャー間のインターフェース
  • メッセージ処理サブシステムプリミティブ (Message Processing Subsystem Primitives): ディスパッチャーとメッセージ処理モデル間のインターフェース
  • アクセス制御サブシステムプリミティブ (Access Control Subsystem Primitives): アプリケーションとアクセス制御サブシステム間のインターフェース
  • セキュリティサブシステムプリミティブ (Security Subsystem Primitives): メッセージ処理モデルとセキュリティモデル間のインターフェース

4.1. Dispatcher Primitives (ディスパッチャープリミティブ)​

ディスパッチャーは, SNMP メッセージの送受信のためのサービスをアプリケーションに提供します。メッセージと PDU をルーティングするための中心点として機能します。

4.1.1. Generate Outgoing Request or Notification (送信リクエストまたは通知の生成)​

アプリケーションは sendPdu プリミティブを使用して, PDU を含む SNMP メッセージを送信するようディスパッチャーに要求します。

プリミティブ:

statusInformation =
  sendPdu(
    IN  transportDomain
    IN  transportAddress
    IN  messageProcessingModel
    IN  securityModel
    IN  securityName
    IN  securityLevel
    IN  contextEngineID
    IN  contextName
    IN  pduVersion
    IN  PDU
    IN  expectResponse
    IN  sendPduHandle
    OUT destTransportDomain
    OUT destTransportAddress
  )

パラメータ:

  • transportDomain: 使用するトランスポートプロトコル (例: UDP)
  • transportAddress: 宛先アドレス
  • messageProcessingModel: 使用するメッセージ形式
  • securityModel: 使用するセキュリティモデル
  • securityName: メッセージが送信される代理としてのプリンシパル
  • securityLevel: セキュリティレベル (noAuthNoPriv, authNoPriv, または authPriv)
  • contextEngineID: コンテキストエンジン ID
  • contextName: コンテキスト名
  • pduVersion: PDU バージョン
  • PDU: 送信する PDU
  • expectResponse: 応答が期待されるかどうか
  • sendPduHandle: このリクエストを識別するハンドル
  • destTransportDomain: (OUT) 使用された実際のトランスポートドメイン
  • destTransportAddress: (OUT) 使用された実際のトランスポートアドレス
  • statusInformation: (OUT) 成功またはエラー表示

4.1.2. Process Incoming Request or Notification PDU (受信リクエストまたは通知 PDU の処理)​

ディスパッチャーは processPdu プリミティブを使用して, 受信したリクエストまたは通知 PDU をアプリケーションに配信します。

プリミティブ:

processPdu(
  IN  messageProcessingModel
  IN  securityModel
  IN  securityName
  IN  securityLevel
  IN  contextEngineID
  IN  contextName
  IN  pduVersion
  IN  PDU
  IN  maxSizeResponseScopedPDU
  IN  stateReference
)

パラメータ:

  • messageProcessingModel: 使用されたメッセージ形式
  • securityModel: 使用されたセキュリティモデル
  • securityName: メッセージが送信された代理としてのプリンシパル
  • securityLevel: メッセージに適用されたセキュリティレベル
  • contextEngineID: コンテキストエンジン ID
  • contextName: コンテキスト名
  • pduVersion: PDU バージョン
  • PDU: 受信した PDU
  • maxSizeResponseScopedPDU: 応答の最大サイズ
  • stateReference: キャッシュされた状態情報への参照

4.1.3. Generate Outgoing Response (送信応答の生成)​

アプリケーションは returnResponsePdu プリミティブを使用して, ディスパッチャーに応答メッセージの送信を要求します。

プリミティブ:

result =
  returnResponsePdu(
    IN  messageProcessingModel
    IN  securityModel
    IN  securityName
    IN  securityLevel
    IN  contextEngineID
    IN  contextName
    IN  pduVersion
    IN  PDU
    IN  maxSizeResponseScopedPDU
    IN  stateReference
    IN  statusInformation
  )

パラメータ:

  • messageProcessingModel: 使用するメッセージ形式 (processPdu から)
  • securityModel: 使用するセキュリティモデル (processPdu から)
  • securityName: プリンシパル (processPdu から)
  • securityLevel: セキュリティレベル (processPdu から)
  • contextEngineID: コンテキストエンジン ID (processPdu から)
  • contextName: コンテキスト名 (processPdu から)
  • pduVersion: PDU バージョン (processPdu から)
  • PDU: 送信する応答 PDU
  • maxSizeResponseScopedPDU: 応答の最大サイズ (processPdu から)
  • stateReference: 状態情報 (processPdu から)
  • statusInformation: リクエスト処理に関する状態情報
  • result: (OUT) 成功またはエラー表示

4.1.4. Process Incoming Response PDU (受信応答 PDU の処理)​

ディスパッチャーは processResponsePdu プリミティブを使用して, 応答 PDU をアプリケーションに配信します。

プリミティブ:

processResponsePdu(
  IN  messageProcessingModel
  IN  securityModel
  IN  securityName
  IN  securityLevel
  IN  contextEngineID
  IN  contextName
  IN  pduVersion
  IN  PDU
  IN  statusInformation
  IN  sendPduHandle
)

パラメータ:

  • messageProcessingModel: 使用されたメッセージ形式
  • securityModel: 使用されたセキュリティモデル
  • securityName: プリンシパル
  • securityLevel: 適用されたセキュリティレベル
  • contextEngineID: コンテキストエンジン ID
  • contextName: コンテキスト名
  • pduVersion: PDU バージョン
  • PDU: 受信した応答 PDU
  • statusInformation: メッセージ処理に関する状態情報
  • sendPduHandle: 元の sendPdu リクエストからのハンドル

4.1.5. Registering Responsibility for Handling SNMP PDUs (SNMP PDU 処理の責任の登録)​

アプリケーションは, 特定の種類の PDU を受信するために, ディスパッチャーに登録する必要があります。

登録のプリミティブ:

statusInformation =
  registerContextEngineID(
    IN  contextEngineID
    IN  pduType
  )

登録解除のプリミティブ:

unregisterContextEngineID(
  IN  contextEngineID
  IN  pduType
)

パラメータ:

  • contextEngineID: 登録するコンテキストエンジン ID
  • pduType: 受信する PDU の種類 (Get, GetNext, GetBulk, Set, Trap, InformRequest など)
  • statusInformation: (OUT) 成功またはエラー表示

一度に, 指定された contextEngineID と pduType の組み合わせに対して登録できるアプリケーションは 1 つだけです。

4.2. Message Processing Subsystem Primitives (メッセージ処理サブシステムプリミティブ)​

メッセージ処理サブシステムは, メッセージの準備とメッセージからのデータ抽出のためのサービスをディスパッチャーに提供します。

4.2.1. Prepare Outgoing SNMP Request or Notification Message (送信 SNMP リクエストまたは通知メッセージの準備)​

ディスパッチャーは prepareOutgoingMessage プリミティブを使用して, メッセージ処理モデルに送信用のメッセージの準備を要求します。

プリミティブ:

statusInformation =
  prepareOutgoingMessage(
    IN  transportDomain
    IN  transportAddress
    IN  messageProcessingModel
    IN  securityModel
    IN  securityName
    IN  securityLevel
    IN  contextEngineID
    IN  contextName
    IN  pduVersion
    IN  PDU
    IN  expectResponse
    IN  sendPduHandle
    OUT destTransportDomain
    OUT destTransportAddress
    OUT outgoingMessage
    OUT outgoingMessageLength
  )

パラメータ:

  • 入力パラメータは sendPdu と同じ
  • outgoingMessage: (OUT) 送信準備ができたメッセージ
  • outgoingMessageLength: (OUT) メッセージの長さ
  • statusInformation: (OUT) 成功またはエラー表示

メッセージ処理モデル:

  1. contextEngineID, contextName, PDU から scopedPDU を作成
  2. セキュリティモデルを呼び出してセキュリティ処理を適用
  3. セキュア化されたメッセージを適切なメッセージ形式でラップ
  4. 送信準備ができた完全なメッセージを返す

4.2.2. Prepare an Outgoing SNMP Response Message (送信 SNMP 応答メッセージの準備)​

ディスパッチャーは prepareResponseMessage プリミティブを使用して, メッセージ処理モデルに応答メッセージの準備を要求します。

プリミティブ:

result =
  prepareResponseMessage(
    IN  messageProcessingModel
    IN  securityModel
    IN  securityName
    IN  securityLevel
    IN  contextEngineID
    IN  contextName
    IN  pduVersion
    IN  PDU
    IN  maxSizeResponseScopedPDU
    IN  stateReference
    IN  statusInformation
    OUT destTransportDomain
    OUT destTransportAddress
    OUT outgoingMessage
    OUT outgoingMessageLength
  )

パラメータ:

  • 入力パラメータには元のリクエストからの状態情報が含まれる
  • outgoingMessage: (OUT) 準備された応答メッセージ
  • outgoingMessageLength: (OUT) メッセージの長さ
  • result: (OUT) 成功またはエラー表示

メッセージ処理モデル:

  1. stateReference を使用してキャッシュされた情報を取得
  2. contextEngineID, contextName, PDU から scopedPDU を作成
  3. セキュリティモデルを呼び出してセキュリティ処理を適用
  4. セキュア化されたメッセージを適切なメッセージ形式でラップ
  5. 送信準備ができた完全なメッセージを返す
  6. キャッシュされた状態情報を解放

4.2.3. Prepare Data Elements from an Incoming SNMP Message (受信 SNMP メッセージからのデータ要素の準備)​

ディスパッチャーは prepareDataElements プリミティブを使用して, メッセージ処理モデルに受信メッセージからのデータ抽出を要求します。

プリミティブ:

result =
  prepareDataElements(
    IN  transportDomain
    IN  transportAddress
    IN  wholeMsg
    IN  wholeMsgLength
    OUT messageProcessingModel
    OUT securityModel
    OUT securityName
    OUT securityLevel
    OUT contextEngineID
    OUT contextName
    OUT pduVersion
    OUT PDU
    OUT pduType
    OUT sendPduHandle
    OUT maxSizeResponseScopedPDU
    OUT statusInformation
    OUT stateReference
  )

パラメータ:

  • transportDomain: メッセージが到着したトランスポートプロトコル
  • transportAddress: 送信元アドレス
  • wholeMsg: 受信したメッセージ
  • wholeMsgLength: メッセージの長さ
  • すべての OUT パラメータには抽出されたデータ要素が含まれる
  • result: (OUT) 成功またはエラー表示

メッセージ処理モデル:

  1. メッセージ形式を解析
  2. セキュリティモデルを呼び出してセキュリティを処理
  3. scopedPDU を抽出
  4. scopedPDU を解析して contextEngineID, contextName, PDU を抽出
  5. メッセージが応答を必要とする場合, 状態情報をキャッシュ
  6. 抽出されたすべてのデータ要素を返す

4.3. Access Control Subsystem Primitives (アクセス制御サブシステムプリミティブ)​

アクセス制御サブシステムは, 管理対象オブジェクトへのアクセスを許可すべきかどうかを判断するためのサービスをアプリケーションに提供します。

プリミティブ:

statusInformation =
  isAccessAllowed(
    IN  securityModel
    IN  securityName
    IN  securityLevel
    IN  viewType
    IN  contextName
    IN  variableName
  )

パラメータ:

  • securityModel: 使用中のセキュリティモデル
  • securityName: アクセスを試みているプリンシパル
  • securityLevel: メッセージのセキュリティレベル
  • viewType: アクセスの種類 (read, write, または notify)
  • contextName: アクセスされているコンテキスト
  • variableName: 管理対象オブジェクトの OID
  • statusInformation: (OUT) 許可または拒否

アクセス制御モデルは, 設定されたポリシーに基づいて, 指定された操作を許可すべきかどうかを判断します。

4.4. Security Subsystem Primitives (セキュリティサブシステムプリミティブ)​

セキュリティサブシステムは, セキュリティの適用とチェックのためのサービスをメッセージ処理モデルに提供します。

4.4.1. Generate a Request or Notification Message (リクエストまたは通知メッセージの生成)​

メッセージ処理モデルは generateRequestMsg プリミティブを使用して, セキュリティサブシステムに送信リクエストまたは通知メッセージへのセキュリティ処理の適用を要求します。

プリミティブ:

statusInformation =
  generateRequestMsg(
    IN  messageProcessingModel
    IN  globalData
    IN  maxMessageSize
    IN  securityModel
    IN  securityEngineID
    IN  securityName
    IN  securityLevel
    IN  scopedPDU
    OUT securityParameters
    OUT wholeMsg
    OUT wholeMsgLength
  )

パラメータ:

  • messageProcessingModel: 使用されているメッセージ形式
  • globalData: メッセージ形式固有のヘッダーデータ
  • maxMessageSize: サポートされる最大メッセージサイズ
  • securityModel: 使用するセキュリティモデル
  • securityEngineID: 権威あるエンジン ID
  • securityName: プリンシパル
  • securityLevel: 希望するセキュリティレベル
  • scopedPDU: セキュア化する scoped PDU
  • securityParameters: (OUT) セキュリティモデル固有のパラメータ
  • wholeMsg: (OUT) 完全にセキュア化されたメッセージ
  • wholeMsgLength: (OUT) メッセージの長さ
  • statusInformation: (OUT) 成功またはエラー表示

4.4.2. Process Incoming Message (受信メッセージの処理)​

メッセージ処理モデルは processIncomingMsg プリミティブを使用して, セキュリティサブシステムに受信メッセージの処理を要求します。

プリミティブ:

statusInformation =
  processIncomingMsg(
    IN  messageProcessingModel
    IN  maxMessageSize
    IN  securityParameters
    IN  securityModel
    IN  securityLevel
    IN  wholeMsg
    IN  wholeMsgLength
    OUT securityEngineID
    OUT securityName
    OUT scopedPDU
    OUT maxSizeResponseScopedPDU
    OUT securityStateReference
  )

パラメータ:

  • messageProcessingModel: 使用されているメッセージ形式
  • maxMessageSize: サポートされる最大メッセージサイズ
  • securityParameters: メッセージからのセキュリティモデル固有のパラメータ
  • securityModel: メッセージで示されているセキュリティモデル
  • securityLevel: 希望するセキュリティレベル
  • wholeMsg: 受信したメッセージ
  • wholeMsgLength: メッセージの長さ
  • securityEngineID: (OUT) 権威あるエンジン ID
  • securityName: (OUT) プリンシパル
  • scopedPDU: (OUT) 抽出および検証された scoped PDU
  • maxSizeResponseScopedPDU: (OUT) 応答の最大サイズ
  • securityStateReference: (OUT) キャッシュされたセキュリティ状態への参照
  • statusInformation: (OUT) 成功またはエラー表示

セキュリティモデル:

  1. メッセージが本物であることを確認 (認証が必要な場合)
  2. メッセージを復号化 (プライバシーが必要な場合)
  3. メッセージのタイムリー性を確認 (リプレイ攻撃を防ぐため)
  4. scopedPDU を抽出
  5. 応答が必要な場合, セキュリティ状態をキャッシュ
  6. 抽出されたすべてのデータを返す

4.4.3. Generate a Response Message (応答メッセージの生成)​

メッセージ処理モデルは generateResponseMsg プリミティブを使用して, セキュリティサブシステムに送信応答メッセージへのセキュリティ処理の適用を要求します。

プリミティブ:

statusInformation =
  generateResponseMsg(
    IN  messageProcessingModel
    IN  globalData
    IN  maxMessageSize
    IN  securityModel
    IN  securityEngineID
    IN  securityName
    IN  securityLevel
    IN  scopedPDU
    IN  securityStateReference
    OUT securityParameters
    OUT wholeMsg
    OUT wholeMsgLength
  )

パラメータ:

  • generateRequestMsg と似ていますが, securityStateReference を含む
  • securityStateReference: 元のリクエストからのキャッシュされた状態
  • その他のパラメータは generateRequestMsg と同様

セキュリティモデルは, キャッシュされたセキュリティ状態を使用して, リクエストで使用されたのと同じセキュリティ処理を応答に適用します。

4.5. Common Primitives (共通プリミティブ)​

4.5.1. Release State Reference Information (状態参照情報の解放)​

コンポーネントは stateRelease プリミティブを使用して, キャッシュされた状態情報を解放します。

プリミティブ:

stateRelease(
  IN  stateReference
)

パラメータ:

  • stateReference: 解放するキャッシュされた状態への参照

このプリミティブは, キャッシュされた状態情報が不要になったときにリソースを解放するために使用されます。通常, 次の場合に呼び出されます:

  • 応答が送信された
  • エラーが発生し, 応答が送信されない
  • 応答を待っている間にタイムアウトが発生した

4.6. Scenario Diagrams (シナリオ図)​

このセクションでは, 一般的な操作のプリミティブフローを示すシナリオ図を提供します。

4.6.1. Command Generator or Notification Originator (コマンドジェネレーターまたは通知発信者)​

以下の図は, アプリケーションがリクエストまたは通知を開始するときのフローを示しています:

Application          Dispatcher       Message Processing    Security
                                      Model                 Model

sendPdu ----------->
                     prepareOutgoing
                     Message -------->
                                      generateRequestMsg -->
                                                            (セキュリティを適用)
                                      <------------------
                     <--------------
                     (ネットワークにメッセージを送信)

(後で, 応答が到着)

                     (ネットワークからメッセージを受信)
                     prepareData
                     Elements ------->
                                      processIncomingMsg -->
                                                            (セキュリティを確認)
                                      <------------------
                     <--------------
processResponsePdu <-

4.6.2. Scenario Diagram for a Command Responder Application (コマンドレスポンダーアプリケーションのシナリオ図)​

以下の図は, アプリケーションがリクエストに応答するときのフローを示しています:

Application          Dispatcher       Message Processing    Security
                                      Model                 Model

                     (ネットワークからメッセージを受信)
                     prepareData
                     Elements ------->
                                      processIncomingMsg -->
                                                            (セキュリティを確認)
                                      <------------------
                     <--------------
processPdu <--------

                     (アプリケーションがリクエストを処理)

returnResponsePdu ->
                     prepareResponse
                     Message -------->
                                      generateResponseMsg ->
                                                            (セキュリティを適用)
                                      <------------------
                     <--------------
                     (ネットワークにメッセージを送信)

これらの図は, アーキテクチャのモジュール設計と, 異なるサブシステム間の関心事の明確な分離を示しています。

に最終更新