1 2 3 4 5 6 7 Network Working Group S. Legg 8 Request for Comments: 3727 Adacel Technologies 9 Category: Standards Track February 2004 10 11 12 ASN.1 Module Definition for the 13 LDAP and X.500 Component Matching Rules 14 15 Status of this Memo 16 17 This document specifies an Internet standards track protocol for the 18 Internet community, and requests discussion and suggestions for 19 improvements. Please refer to the current edition of the "Internet 20 Official Protocol Standards" (STD 1) for the standardization state 21 and status of this protocol. Distribution of this memo is unlimited. 22 23 Copyright Notice 24 25 Copyright (C) The Internet Society (2004). All Rights Reserved. 26 27 Abstract 28 29 This document updates the specification of the component matching 30 rules for Lightweight Directory Access Protocol (LDAP) and X.500 31 directories (RFC3687) by collecting the Abstract Syntax Notation One 32 (ASN.1) definitions of the component matching rules into an 33 appropriately identified ASN.1 module so that other specifications 34 may reference the component matching rule definitions from within 35 their own ASN.1 modules. 36 37 1. Introduction 38 39 The structure or data type of data held in an attribute of a 40 Lightweight Directory Access Protocol (LDAP) [LDAP] or X.500 [X500] 41 directory is described by the attribute's syntax. Attribute syntaxes 42 range from simple data types, such as text string, integer, or 43 boolean, to complex data types, for example, the syntaxes of the 44 directory schema operational attributes. RFC 3687 [CMR] defines a 45 generic way of matching user selected components in a directory 46 attribute value of any arbitrarily complex attribute syntax. 47 48 This document updates RFC 3687 by collecting the Abstract Syntax 49 Notation One (ASN.1) [ASN1] definitions of RFC 3687 into an 50 appropriately identified ASN.1 module so that other specifications 51 may reference these definitions from within their own ASN.1 modules. 52 53 54 55 56 57 58 Legg Standards Track [Page 1] 59 61 RFC 3727 Module for Component Matching February 2004 62 63 64 2. Module Definition for Component Matching 65 66 ComponentMatching 67 {iso(1) 2 36 79672281 xed(3) module(0) component-matching(4)} 68 69 -- Copyright (C) The Internet Society (2004). This version of 70 -- this ASN.1 module is part of RFC 3727; see the RFC itself 71 -- for full legal notices. 72 73 DEFINITIONS 74 EXPLICIT TAGS 75 EXTENSIBILITY IMPLIED ::= BEGIN 76 77 IMPORTS 78 MATCHING-RULE, 79 RelativeDistinguishedName 80 FROM InformationFramework 81 {joint-iso-itu-t ds(5) module(1) 82 informationFramework(1) 4} ; 83 84 ComponentAssertion ::= SEQUENCE { 85 component ComponentReference (SIZE(1..MAX)) OPTIONAL, 86 useDefaultValues BOOLEAN DEFAULT TRUE, 87 rule MATCHING-RULE.&id, 88 value MATCHING-RULE.&AssertionType } 89 90 ComponentReference ::= UTF8String 91 92 ComponentFilter ::= CHOICE { 93 item [0] ComponentAssertion, 94 and [1] SEQUENCE OF ComponentFilter, 95 or [2] SEQUENCE OF ComponentFilter, 96 not [3] ComponentFilter } 97 98 componentFilterMatch MATCHING-RULE ::= { 99 SYNTAX ComponentFilter 100 ID { 1 2 36 79672281 1 13 2 } } 101 102 allComponentsMatch MATCHING-RULE ::= { 103 ID { 1 2 36 79672281 1 13 6 } } 104 105 directoryComponentsMatch MATCHING-RULE ::= { 106 ID { 1 2 36 79672281 1 13 7 } } 107 108 109 -- Additional Useful Matching Rules -- 110 111 rdnMatch MATCHING-RULE ::= { 112 113 114 115 Legg Standards Track [Page 2] 116 118 RFC 3727 Module for Component Matching February 2004 119 120 121 SYNTAX RelativeDistinguishedName 122 ID { 1 2 36 79672281 1 13 3 } } 123 124 presentMatch MATCHING-RULE ::= { 125 SYNTAX NULL 126 ID { 1 2 36 79672281 1 13 5 } } 127 128 END 129 130 The InformationFramework ASN.1 module from which the MATCHING-RULE 131 and RelativeDistinguishedName definitions are imported is defined in 132 X.501 [X501]. 133 134 The object identifiers used in this document have been assigned for 135 use in specifying the component matching rules by Adacel 136 Technologies, under an arc assigned to Adacel by Standards Australia. 137 138 3. Security Considerations 139 140 This document collects together the ASN.1 definitions of the 141 component matching rules into an ASN.1 module, but does not modify 142 those definitions in any way. See RFC 3687 [CMR] for the security 143 considerations of using the component matching rules. 144 145 4. References 146 147 4.1. Normative References 148 149 [CMR] Legg, S., "Lightweight Directory Access Protocol (LDAP) and 150 X.500 Component Matching Rules", RFC 3687, February 2004. 151 152 [X501] ITU-T Recommendation X.501 (1993) | ISO/IEC 9594-2:1994, 153 Information Technology - Open Systems Interconnection - The 154 Directory: Models 155 156 [ASN1] ITU-T Recommendation X.680 (07/02) | ISO/IEC 8824-1:2002, 157 Information technology - Abstract Syntax Notation One 158 (ASN.1): Specification of basic notation 159 160 4.2. Informative References 161 162 [LDAP] Hodges, J. and R. Morgan, "Lightweight Directory Access 163 Protocol (v3): Technical Specification", RFC 3377, September 164 2002. 165 166 [X500] ITU-T Recommendation X.500 (1993) | ISO/IEC 9594-1:1994, 167 Information Technology - Open Systems Interconnection - The 168 Directory: Overview of concepts, models and services 169 170 171 172 Legg Standards Track [Page 3] 173 175 RFC 3727 Module for Component Matching February 2004 176 177 178 5. Author's Address 179 180 Steven Legg 181 Adacel Technologies Ltd. 182 250 Bay Street 183 Brighton, Victoria 3186 184 AUSTRALIA 185 186 Phone: +61 3 8530 7710 187 Fax: +61 3 8530 7888 188 EMail: steven.legg (a] adacel.com.au 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 Legg Standards Track [Page 4] 230 232 RFC 3727 Module for Component Matching February 2004 233 234 235 6. Full Copyright Statement 236 237 Copyright (C) The Internet Society (2004). This document is subject 238 to the rights, licenses and restrictions contained in BCP 78 and 239 except as set forth therein, the authors retain all their rights. 240 241 This document and the information contained herein are provided on an 242 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE 243 REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE 244 INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR 245 IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF 246 THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 247 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 248 249 Intellectual Property 250 251 The IETF takes no position regarding the validity or scope of any 252 Intellectual Property Rights or other rights that might be claimed 253 to pertain to the implementation or use of the technology 254 described in this document or the extent to which any license 255 under such rights might or might not be available; nor does it 256 represent that it has made any independent effort to identify any 257 such rights. Information on the procedures with respect to 258 rights in RFC documents can be found in BCP 78 and BCP 79. 259 260 Copies of IPR disclosures made to the IETF Secretariat and any 261 assurances of licenses to be made available, or the result of an 262 attempt made to obtain a general license or permission for the use 263 of such proprietary rights by implementers or users of this 264 specification can be obtained from the IETF on-line IPR repository 265 at http://www.ietf.org/ipr. 266 267 The IETF invites any interested party to bring to its attention 268 any copyrights, patents or patent applications, or other 269 proprietary rights that may cover technology that may be required 270 to implement this standard. Please address the information to the 271 IETF at ietf-ipr (a] ietf.org. 272 273 Acknowledgement 274 275 Funding for the RFC Editor function is currently provided by the 276 Internet Society. 277 278 279 280 281 282 283 284 285 286 Legg Standards Track [Page 5] 287 289