跳到主要内容

附录 A. 相对于 RFC 2255 的变更 (Appendix A. Changes Since RFC 2255)

A.1. 技术变更​

对 "URL 定义" 一节的内容做了以下技术变更:

修订了所有 ABNF, 以使用 [RFC4512] 中的公共产生式.

将引用 [RFC2396] 替换为引用 [RFC3986] (这允许在 URL 的 <host> 部分内使用字面 IPv6 地址, 并添加了注释以提醒读者注意此项增强).引用 [RFC3986] 要求对 ABNF 与文本进行更改, 以便不再使用 [RFC3986] 中未定义的产生式.例如, <hostport> 不是由 [RFC3986] 定义的, 因此已被替换为 host [COLON port].请注意, [RFC3986] 包含对 "Reserved" 与 "Unreserved" 字符集的新定义, 最终结果是, 当以下两个额外字符出现在用于构造 LDAP URL 的数据中的任何位置时, 应当进行百分号编码: "[" 与 "]" (这两个字符首先由 RFC 2732 加入 Reserved 集合).

更改了 <attrdesc> 的定义, 以引用 [RFC4511] 中的 <attributeSelector>.这允许在 URL 的 <attrdesc> 部分使用 "*".据信 RFC 2255 的现有实现已经支持这一点.

避免在 <dn>, <host>, <attrdesc> 与 <exvalue> 规则中使用 <prose-val> (方括号字符串) 产生式.

更改了 <ldapurl> 的 ABNF, 将 <dn> 组件与其前的 <SLASH> 分组在一起.

将 <extype> 规则更改为来自 [RFC4512] 的 <oid>.

更改了关于扩展类型的文本, 使其引用 [RFC4520].重新排列了规则顺序, 使其更贴近元素在 URL 中出现的顺序.

"Bindname Extension": 因缺乏已知实现而移除.

A.2. 编辑变更​

更改文档标题以包含 "LDAP:" 前缀.

IESG Note: 移除了关于缺乏令人满意的强制认证机制的说明.

"Status of this Memo" 一节: 更新样板文本以符合当前 I-D 指南.

"Abstract" 一节: 与引言材料分离.

"Table of Contents" 与 "Intellectual Property" 一节: 已添加.

"Introduction" 一节: 新章节; 与摘要分离.更改文本以表明本文档取代 RFC 2255 (而不是 RFC 1959).添加文本以表明 LDAP URL 用于引用与转介.修正笔误 (将无意义短语 "to perform to retrieve" 替换为 "used to retrieve").添加注释, 让读者知道 [RFC4511] 中描述的 LDAP 搜索操作的并非所有参数都能使用此格式表达.

"URL Definition" 一节: 移除了第二份 <ldapurl> 语法及其后两段 (RFC 2255 中的编辑错误).修正了 '!' 序列内的换行.重新格式化 ABNF 以提高可读性, 对齐注释并添加一些空行.在紧接 ABNF 之后的句子中, 将 "residing in the LDAP server" 替换为 "accessible from the LDAP server".移除了句子 "Individual attrdesc names are as defined for AttributeDescription in [RFC4511].", 因为现在在 ABNF 中直接使用 [RFC4511] 的 <attributeSelector>.重写了最后一段, 以澄清哪些字符必须进行百分号编码.添加文本以表明 LDAP URL 用于引用与转介.添加引用 RFC 4234 的 ABNF 的文本.澄清并加强了关于处理包含已实现与未实现扩展的 URL 的要求 (现在的方法与 [RFC4511] 为 LDAP 控件指定的方法密切匹配).

"Defaults for Fields of the LDAP URL" 一节: 已添加; 通过将关于默认值的文本从 "URL Definition" 一节移出而形成.将对属性名 "" 的直接引用替换为对 [RFC4511] 中定义的特殊 <alluserattrs> 选择器 "" 的引用.

"URL Processing" 一节: 已移除.

"Examples" 一节: 修改示例以使用 example.com 与 example.net 主机名.在其过滤器包含三个 null 字节的 LDAP URL 示例中添加了缺失的 '?'.移除了 DN 中某个逗号后的空格.修订 bindname 示例以使用 e-bindname.将一个示例中使用的属性名从 "int" 更改为 "four-octet", 以避免潜在混淆.添加了演示 DN 转义与 URL 百分号编码之间交互的示例.添加了一些示例以展示相对于 URL 的 <dn> 部分的 URL 等价性.在某些示例中使用大写, 以提醒读者某些记号不区分大小写.

"Security Considerations" 一节: 添加了关于连接重用的说明.添加了关于更新操作使用强认证方法的说明.添加了对 [RFC4513] 的引用.添加了说明: 仅仅打开连接就可能违反某些用户的隐私要求.采用工作组修订的 LDAP 术语规范, 将 "connection" 一词酌情替换为 "LDAP session" 或 "LDAP connection".

"Acknowledgements" 一节: 添加了本文档废弃 RFC 2255 的声明.添加了 Kurt Zeilenga, Jim Sermersheim 与 Hallvard Furuseth.

"Normative References" 一节: 按新 RFC 指南从 "References" 重命名.在整篇文档中将 [1] 风格更改为 [RFC4511] 风格.添加了对 RFC 4234 与 RFC 3629 的引用.将所有 RFC 1738 引用更新为指向 [RFC3986] 中的相应章节.将 LDAP 引用更新为指向 LDAPBis WG 文档.移除了对 LDAP Attribute Syntaxes 文档的引用, 并添加了对 [RFC4513], [RFC4520] 与 [RFC4510] 文档的引用.

"Informative References" 一节: 已添加.

页眉与 "Authors' Addresses" 一节: 在 Mark Smith 的姓名旁添加了 "editor".更新了所属单位与联系信息.

版权: 更新了年份.

全文: 在描述性文本中使用 ABNF 产生式名称时, 用 "<" 与 ">" 将其括起.