[要約] RFC 7220は、Port Control Protocol(PCP)のためのDescriptionオプションについての仕様です。このRFCの目的は、PCPメッセージに関連するポートの説明情報を提供するための標準化を行うことです。

Internet Engineering Task Force (IETF)                      M. Boucadair
Request for Comments: 7220                                France Telecom
Category: Standards Track                                       R. Penno
ISSN: 2070-1721                                                  D. Wing
                                                                   Cisco
                                                                May 2014
        

Description Option for the Port Control Protocol (PCP)

ポート制御プロトコル(PCP)の説明オプション

Abstract

概要

This document extends the Port Control Protocol (PCP) with the ability to associate a description with a PCP-instantiated mapping. It does this by defining a new DESCRIPTION option.

このドキュメントは、ポートコントロールプロトコル(PCP)を拡張し、説明をPCPインスタンス化されたマッピングに関連付ける機能を備えています。これは、新しいDESCRIPTIONオプションを定義することによって行われます。

Status of This Memo

本文書の状態

This is an Internet Standards Track document.

これはInternet Standards Trackドキュメントです。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741.

このドキュメントは、IETF(Internet Engineering Task Force)の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ(IESG)による公開が承認されました。インターネット標準の詳細については、RFC 5741のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc7220.

このドキュメントの現在のステータス、エラッタ、およびフィードバックの提供方法に関する情報は、http://www.rfc-editor.org/info/rfc7220で入手できます。

Copyright Notice

著作権表示

Copyright (c) 2014 IETF Trust and the persons identified as the document authors. All rights reserved.

Copyright(c)2014 IETF Trustおよびドキュメントの作成者として識別された人物。全著作権所有。

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書は、BCP 78およびこの文書の発行日に有効なIETF文書に関するIETFトラストの法的規定(http://trustee.ietf.org/license-info)の対象となります。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

Table of Contents

目次

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Format  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
   3.  Behavior  . . . . . . . . . . . . . . . . . . . . . . . . . .   4
   4.  Security Considerations . . . . . . . . . . . . . . . . . . .   5
   5.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   5
   6.  References  . . . . . . . . . . . . . . . . . . . . . . . . .   5
     6.1.  Normative References  . . . . . . . . . . . . . . . . . .   5
     6.2.  Informative References  . . . . . . . . . . . . . . . . .   6
        
1. Introduction
1. はじめに

This document extends the base PCP [RFC6887] with the ability to associate a human-readable description with a PCP-instantiated mapping. It does this by defining a new DESCRIPTION option.

このドキュメントは、ベースのPCP [RFC6887]を拡張して、人間が読める記述をPCPでインスタンス化されたマッピングに関連付ける機能を備えています。これは、新しいDESCRIPTIONオプションを定義することによって行われます。

This PCP option can be used in simple scenarios with a PCP client and PCP server, as well as in more complex scenarios where an interworking function is used to proxy between a UPnP IGD Control Point and a PCP server [RFC6970].

このPCPオプションは、PCPクライアントとPCPサーバーを使用する単純なシナリオ、およびインターワーク機能を使用してUPnP IGDコントロールポイントとPCPサーバーをプロキシするより複雑なシナリオで使用できます[RFC6970]。

Querying the PCP server to get the description text of an existing mapping is out of scope.

PCPサーバーにクエリを実行して既存のマッピングの説明テキストを取得することは範囲外です。

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [RFC2119].

このドキュメントのキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、 RFC 2119 [RFC2119]で説明されているように解釈されます。

2. Format
2. フォーマット

The format of the DESCRIPTION option is shown in Figure 1.

DESCRIPTIONオプションのフォーマットを図1に示します。

       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |Option Code=128|  Reserved     |           Length              |
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
      |                           Description                         |
      :                                                               :
      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
        

This Option:

このオプション:

Option Name: DESCRIPTION Number: 128 Purpose: Used to associate a text description with a mapping Valid for Opcodes: MAP, PEER Length: Variable, maximum 1016 octets. May appear in: request. May appear in response only if it appeared in the associated request. Maximum occurrences: 1

オプション名:DESCRIPTION番号:128目的:テキストの説明をマッピングに関連付けるために使用されます。オペコードに有効:MAP、PEER長さ:可変、最大1016オクテット。表示される場合があります:リクエスト。関連するリクエストに表示された場合にのみ、応答として表示される場合があります。最大発生回数:1

Figure 1: DESCRIPTION Option

図1:DESCRIPTIONオプション

The 'Reserved' field is initialized as specified in Section 7.3 of [RFC6887].

[予約済み]フィールドは、[RFC6887]のセクション7.3で指定されているように初期化されます。

The Description field MUST carry UTF-8 encoded [RFC3629] description text. The description text MUST NOT be null terminated. The length of the description text is indicated by the Length field. In particular, the description text is not null terminated, and when a client or server receives a DESCRIPTION option, it MUST NOT rely on the presence of a NUL character in the wire format data to identify the end of the text.

Descriptionフィールドは、UTF-8でエンコードされた[RFC3629]説明テキストを運ぶ必要があります。説明テキストはnullで終了してはなりません。説明テキストの長さは、「長さ」フィールドで示されます。特に、説明テキストはnullで終了しておらず、クライアントまたはサーバーがDESCRIPTIONオプションを受け取ったときに、ワイヤー形式データのNUL文字の存在に依存してテキストの終わりを識別してはなりません(MUST NOT)。

This option can be used by a user (or an application) to indicate a description associated with a given mapping, such as "FTP server", "My remote access to my CP router", "Camera", "Network attached storage serve", etc.

このオプションをユーザー(またはアプリケーション)が使用して、「FTPサーバー」、「CPルーターへのリモートアクセス」、「カメラ」、「ネットワーク接続ストレージサーバー」など、特定のマッピングに関連付けられた説明を示すことができます。 、など

How the content of the DESCRIPTION option is used is deployment-specific. For example, the description text can be used by the entity managing the PCP server for many purposes, such as the following:

DESCRIPTIONオプションのコンテンツの使用方法は、デプロイメント固有です。たとえば、説明テキストは、PCPサーバーを管理するエンティティが次のような多くの目的に使用できます。

o The description text can be used as a hint when cleaning a mapping table by an administrator.

o 説明テキストは、管理者がマッピングテーブルをクリーニングする際のヒントとして使用できます。

o In some deployments making use of a portal to instruct PCP mappings (e.g., Section 5.2 of [PCP-DEPLOY]), the description text can be used to store a subscriber identifier.

o ポータルを使用してPCPマッピングを指示するいくつかの展開([PCP-DEPLOY]のセクション5.2など)では、説明テキストを使用してサブスクライバー識別子を格納できます。

3. Behavior
3. 動作

Support for the DESCRIPTION option by PCP servers and PCP clients is optional. This option (Code 128; see Figure 1) MAY be included in a PCP MAP/PEER request to associate a description with the requested mapping.

PCPサーバーとPCPクライアントによるDESCRIPTIONオプションのサポートはオプションです。このオプション(コード128、図1を参照)は、説明を要求されたマッピングに関連付けるために、PCP MAP / PEER要求に含めることができます(MAY)。

A PCP server MAY ignore the DESCRIPTION option sent to it by a PCP client (e.g., if it does not support the option or if it is configured to ignore it). To signal that it has not accepted the option, a PCP server simply does not include the DESCRIPTION option in the response. If the PCP client does not receive a DESCRIPTION option in a response to a request enclosing a DESCRIPTION option, this means the PCP server does not support the option or it is configured to ignore it.

PCPサーバーは、PCPクライアントから送信された説明オプションを無視する場合があります(たとえば、オプションをサポートしていない場合、またはオプションを無視するように構成されている場合)。オプションを受け入れなかったことを通知するために、PCPサーバーは単に応答にDESCRIPTIONオプションを含めません。 PCPクライアントが、DESCRIPTIONオプションを含む要求への応答でDESCRIPTIONオプションを受信しない場合、これはPCPサーバーがオプションをサポートしていないか、オプションを無視するように構成されていることを意味します。

If the DESCRIPTION option is not included in the PCP client request, the PCP server MUST NOT include the DESCRIPTION option in the associated response.

PCPクライアント要求にDESCRIPTIONオプションが含まれていない場合、PCPサーバーは、関連付けられた応答にDESCRIPTIONオプションを含めてはなりません(MUST NOT)。

A PCP server SHOULD be able to store at least 128 bytes for a description. When the PCP server receives a DESCRIPTION option, it first stores the value of the received Description field, truncating it if it cannot store the entire value. The server MUST then send the stored value back to the PCP client in the DESCRIPTION option in the response.

PCPサーバーは、説明用に少なくとも128バイトを格納できる必要があります(SHOULD)。 PCPサーバーは、DESCRIPTIONオプションを受信すると、最初に受信したDescriptionフィールドの値を格納し、値全体を格納できない場合は切り捨てます。次に、サーバーは、応答のDESCRIPTIONオプションで、保存された値をPCPクライアントに送り返す必要があります。

If the PCP client request contains invalid DESCRIPTION options (e.g., the content is not a legal UTF-8 string), the PCP server MUST ignore the request (i.e., MUST NOT return a DESCRIPTION option in the response).

PCPクライアント要求に無効なDESCRIPTIONオプションが含まれている場合(たとえば、コンテンツが有効なUTF-8文字列ではない場合)、PCPサーバーは要求を無視する必要があります(つまり、応答でDESCRIPTIONオプションを返してはなりません)。

To update the description text of a mapping maintained by a PCP server, the PCP client generates a PCP MAP/PEER renewal request that includes a DESCRIPTION option carrying the new description text. Upon receipt of the PCP request, the PCP server proceeds to the same operations to validate a MAP/PEER request refreshing an existing mapping. If validation checks are successfully passed, the PCP server replaces the old description text with the new one included in the DESCRIPTION option, and the PCP server returns the updated description text in the response, truncated (if necessary) as described above.

PCPサーバーによって維持されるマッピングの説明テキストを更新するために、PCPクライアントは、新しい説明テキストを保持するDESCRIPTIONオプションを含むPCP MAP / PEER更新要求を生成します。 PCP要求を受信すると、PCPサーバーは同じ操作に進み、既存のマッピングを更新するMAP / PEER要求を検証します。検証チェックに合格すると、PCPサーバーは古い説明テキストをDESCRIPTIONオプションに含まれる新しい説明テキストに置き換え、PCPサーバーは更新された説明テキストを上記のように(必要に応じて)切り捨てて応答で返します。

The PCP client uses an empty DESCRIPTION option (i.e., Length set to 0) to erase the description text associated with a mapping. To indicate that the PCP server has successfully cleared the description text associated with a mapping, the PCP server returns the empty DESCRIPTION option in the response.

PCPクライアントは、空のDESCRIPTIONオプション(つまり、Lengthを0に設定)を使用して、マッピングに関連付けられた説明テキストを消去します。 PCPサーバーがマッピングに関連付けられた説明テキストを正常にクリアしたことを示すために、PCPサーバーは応答で空のDESCRIPTIONオプションを返します。

4. Security Considerations
4. セキュリティに関する考慮事項

PCP-related security considerations are discussed in [RFC6887]. In addition, administrators of PCP servers SHOULD configure a maximum description length that does not lead to exhausting storage resources in the PCP server.

PCP関連のセキュリティの考慮事項は、[RFC6887]で説明されています。さらに、PCPサーバーの管理者は、PCPサーバーのストレージリソースを使い果たすことのない最大の説明長を構成する必要があります(SHOULD)。

If the PCP client and the PCP server are not under the same administrative entity, the DESCRIPTION option has the potential to leak privacy-related information. PCP clients should not use the DESCRIPTION option for such leakage. For example, the option should not be used to include user identifiers, locations, or names. Refer to Section 3.2 of [RFC6462] for a discussion on information leakage.

PCPクライアントとPCPサーバーが同じ管理エンティティの下にない場合、DESCRIPTIONオプションはプライバシー関連の情報を漏洩する可能性があります。 PCPクライアントは、このような漏洩に対してDESCRIPTIONオプションを使用しないでください。たとえば、ユーザー識別子、場所、名前を含めるためにこのオプションを使用しないでください。情報漏えいに関する議論については、[RFC6462]のセクション3.2を参照してください。

5. IANA Considerations
5. IANAに関する考慮事項

IANA has allocated the following value in the "PCP Options" registry (http://www.iana.org/assignments/pcp-parameters) from the optional-to-process range (see Section 19.4 of [RFC6887]):

IANAは、「PCPオプション」レジストリ(http://www.iana.org/assignments/pcp-parameters)に次の値をオプションからプロセスの範囲([RFC6887]のセクション19.4を参照)から割り当てました。

DESCRIPTION set to 128 (see Section 2)

説明は128に設定されます(セクション2を参照)

6. References
6. 参考文献
6.1. Normative References
6.1. 引用文献

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、1997年3月。

[RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD 63, RFC 3629, November 2003. [RFC6887] Wing, D., Ed., Cheshire, S., Boucadair, M., Penno, R., and P. Selkirk, "Port Control Protocol (PCP)", RFC 6887, April 2013.

[RFC3629] Yergeau、F。、「UTF-8、ISO 10646の変換フォーマット」、STD 63、RFC 3629、2003年11月。 、Penno、R。、およびP. Selkirk、「Port Control Protocol(PCP)」、RFC 6887、2013年4月。

6.2. Informative References
6.2. 参考引用

[PCP-DEPLOY] Boucadair, M., "Port Control Protocol (PCP) Deployment Models", Work in Progress, April 2014.

[PCP-DEPLOY] Boucadair、M。、「Port Control Protocol(PCP)Deployment Models」、Work in Progress、2014年4月。

[RFC6462] Cooper, A., "Report from the Internet Privacy Workshop", RFC 6462, January 2012.

[RFC6462]クーパー、A。、「インターネットプライバシーワークショップからの報告」、RFC 6462、2012年1月。

[RFC6970] Boucadair, M., Penno, R., and D. Wing, "Universal Plug and Play (UPnP) Internet Gateway Device - Port Control Protocol Interworking Function (IGD-PCP IWF)", RFC 6970, July 2013.

[RFC6970] Boucadair、M.、Penno、R。、およびD. Wing、「ユニバーサルプラグアンドプレイ(UPnP)インターネットゲートウェイデバイス-ポートコントロールプロトコルインターワーキング機能(IGD-PCP IWF)」、RFC 6970、2013年7月。

Authors' Addresses

著者のアドレス

Mohamed Boucadair France Telecom Rennes 35000 France

Mohamed Boucadair France Telecom Rennes 35000 France

   EMail: mohamed.boucadair@orange.com
        

Reinaldo Penno Cisco USA

レイナルドペンノシスコアメリカ

   EMail: repenno@cisco.com
        

Dan Wing Cisco Systems, Inc. 170 West Tasman Drive San Jose, California 95134 USA

Dan Wing Cisco Systems、Inc. 170 West Tasman Drive San Jose、California 95134 USA

   EMail: dwing@cisco.com