File: rfc2384.txt

package info (click to toggle)
doc-rfc 20181229-2
  • links: PTS, VCS
  • area: non-free
  • in suites: buster
  • size: 570,944 kB
  • sloc: xml: 285,646; sh: 107; python: 90; perl: 42; makefile: 14
file content (451 lines) | stat: -rw-r--r-- 13,649 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
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
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451






Network Working Group                                        R. Gellens
Request for Comments: 2384                       QUALCOMM, Incorporated
Category: Standards Track                                   August 1998


                             POP URL Scheme

Status of this Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (1998).  All Rights Reserved.

1.  Introduction

   [POP3] is a widely-deployed mail access protocol.  Many programs
   access POP3 message stores, and thus need POP3 configuration
   information.  Since there are multiple configuration elements which
   are required in order to access a mailbox, a single string
   representation is convenient.

   A POP3 mailbox (like an [IMAP4] mailbox) is a network resource, and
   URLs are a widely-supported generalized representation of network
   resources.

   A means of specifying a POP3 mailbox as a URL will likely be useful
   in many programs and protocols. [ACAP] is one case where a string
   encapsulation of elements required to access network services is
   needed.  For example, an [IMAP4] message store is usually specified
   in ACAP datasets as an [IMAP-URL].

   This memo defines a URL scheme for referencing a POP mailbox.

2.  Conventions Used in this Document

   The key words "MUST", "MUST NOT", "SHOULD", "SHOULD NOT", and "MAY"
   in this document are to be interpreted as defined in "Key words for
   use in RFCs to Indicate Requirement Levels" [KEYWORDS].







Gellens                     Standards Track                     [Page 1]

RFC 2384                     POP URL Scheme                  August 1998


3.  POP Scheme

   The POP URL scheme designates a POP server, and optionally a port
   number, authentication mechanism, authentication ID, and/or
   authorization ID.

   The POP URL follows the common Internet scheme syntax as defined in
   RFC 1738 [BASIC-URL] except that clear text passwords are not
   permitted.  If :<port> is omitted, the port defaults to 110.

   The POP URL is described using [ABNF] in Section 8.

   A POP URL is of the general form:

        pop://<user>;auth=<auth>@<host>:<port>

   Where <user>, <host>, and <port> are as defined in RFC 1738, and some
   or all of the elements, except "pop://" and <host>, may be omitted.

4.  POP User Name and Authentication Mechanism

   An authorization (which mailbox to access) and authentication (whose
   password to check against) identity (referred to as "user name" for
   simplicity) and/or authentication mechanism name may be supplied.
   These are used in a "USER", "APOP", "AUTH" [POP-AUTH], or extension
   command after making the connection to the POP server.  If the URL
   doesn't supply an authentication identifier, the program interpreting
   the POP URL SHOULD request one from the user.

   An authentication mechanism can be expressed by adding ";AUTH=<enc-
   auth-type>" to the end of the user name.  If the authentication
   mechanism name is not preceded by a "+", it is a SASL POP [SASL]
   mechanism.  If it is preceded by a "+", it is either "APOP" or an
   extension mechanism.

   When an <enc-auth-type> is specified, the client SHOULD request
   appropriate credentials from that mechanism and use the "AUTH",
   "APOP", or extension command instead of the "USER" command.  If no
   user name is specified, one SHOULD be obtained from the mechanism or
   requested from the user as appropriate.

   The string ";AUTH=*" indicates that the client SHOULD select an
   appropriate authentication mechanism.  It MAY use any mechanism
   supported by the POP server.

   If an <enc-auth-type> other than ";AUTH=*" is specified, the client
   SHOULD NOT use a different mechanism without explicit user
   permission.



Gellens                     Standards Track                     [Page 2]

RFC 2384                     POP URL Scheme                  August 1998


   If a user name is included with no authentication mechanism, then
   ";AUTH=*" is assumed.

   Since URLs can easily come from untrusted sources, care must be taken
   when resolving a URL which requires or requests any sort of
   authentication.  If authentication credentials are supplied to the
   wrong server, it may compromise the security of the user's account.
   The program resolving the URL should make sure it meets at least one
   of the following criteria in this case:

   (1) The URL comes from a trusted source, such as a referral server
   which the client has validated and trusts according to site policy.
   Note that user entry of the URL may or may not count as a trusted
   source, depending on the experience level of the user and site
   policy.

   (2) Explicit local site policy permits the client to connect to the
   server in the URL.  For example, if the client knows the site domain
   name, site policy may dictate that any hostname ending in that domain
   is trusted.

   (3) The user confirms that connecting to that domain name with the
   specified credentials and/or mechanism is permitted.

   (4) A mechanism is used which validates the server before passing
   potentially compromising client credentials.

   (5) An authentication mechanism is used which will not reveal
   information to the server which could be used to compromise future
   connections.

   A URL containing ";AUTH=*" should be treated with extra care since it
   might fall back on a weaker security mechanism. Finally, clients are
   discouraged from using a plain text password as a fallback with
   ";AUTH=*" unless the connection has strong encryption (e.g., a key
   length of greater than 56 bits).

   Note that if unsafe or reserved characters such as " " or ";" are
   present in the user name or authentication mechanism, they MUST be
   encoded as described in RFC 1738 [BASIC-URL].

5.  Relative POP URLs

   Relative POP URLs are not permitted.







Gellens                     Standards Track                     [Page 3]

RFC 2384                     POP URL Scheme                  August 1998


6.  Multinational Considerations

   Since 8-bit characters are not permitted in URLs, [UTF8] characters
   are encoded as required by the URL specification [BASIC-URL].

7.  Examples

   The following examples demonstrate how a POP client program might
   translate various POP URLs into a series of POP commands. Commands
   sent from the client to the server are prefixed with "C:", and
   responses sent from the server to the client are prefixed with "S:".

   The URL:

        <pop://rg@mailsrv.qualcomm.com>

   Results in the following client commands:

        <request password from user>
        <connect to mailsrv.qualcomm.com, port 110>
        S: +OK POP3 server ready <1896.697170952@mailsrv.qualcomm.com>
        C: USER rg
        S: +OK
        C: PASS secret
        S: +OK rg's mailbox has 2 messages (320 octets)

   The URL:

        <pop://rg;AUTH=+APOP@mail.eudora.com:8110>

   Results in the following client commands:

        <client requests password from user>
        <connect to mail.eudora.com, port 8110>
        S: +OK POP3 server ready <1896.697170952@mail.eudora.com>
        C: APOP rg c4c9334bac560ecc979e58001b3e22fb
        S: +OK mailbox has 1 message (369 octets)

   The URL:

        <pop://baz;AUTH=SCRAM-MD5@foo.bar>

   Results in the following client commands:

        <connect to foo.bar, port 110>

        S: +OK POP3 server ready <1896.697170952@foo.bar>
        C: AUTH SCRAM-MD5 AGNocmlzADx0NG40UGFiOUhCMEFtL1FMWEI3MmVnQGVsZW



Gellens                     Standards Track                     [Page 4]

RFC 2384                     POP URL Scheme                  August 1998


           Fub3IuaW5ub3NvZnQuY29tPg==
        S: + dGVzdHNhbHQBAAAAaW1hcEBlbGVhbm9yLmlubm9zb2Z0LmNvbQBq
           aGNOWmxSdVBiemlGcCt2TFYrTkN3
        C: AQAAAMg9jU8CeB4KOfk7sUhSQPs=
        S: + U0odqYw3B7XIIW0oSz65OQ==
        C:
        S: +OK mailbox has 1 message (369 octets)

8.  ABNF for POP URL scheme

   The POP URL scheme is described using [ABNF]:

        achar            = uchar / "&" / "=" / "~"
                                ; see [BASIC-URL] for "uchar" definition

        auth             = ";AUTH=" ( "*" / enc-auth-type )

        enc-auth-type    = enc-sasl / enc-ext

        enc-ext          = "+" ("APOP" / 1*achar)
                              ;APOP or encoded extension mechanism name

        enc-sasl         = 1*achar
                              ;encoded version of [SASL] "auth_type"

        enc-user         = 1*achar
                              ;encoded version of [POP3] mailbox

        pop-url          = "pop://" server

        server           = [user-auth "@"] hostport
                              ;See [BASIC-URL] for "hostport" definition

        user-auth        = enc-user [auth]

9.  Security Considerations

   Security considerations discussed in the [POP3] specification and the
   [BASIC-URL] specification are relevant.  Security considerations
   related to authenticated URLs are discussed in section 4 of this
   document.

   Many email clients store the plain text password for later use after
   logging into a POP server.  Such clients MUST NOT use a stored
   password in response to a POP URL without explicit permission from
   the user to supply that password to the specified host name.





Gellens                     Standards Track                     [Page 5]

RFC 2384                     POP URL Scheme                  August 1998


10.  Acknowledgements

   This document borrows heavily from Chris Newman's [IMAP-URL]
   specification, and has attempted to follow the advice in [URL-
   GUIDELINES].

11.  References

   [ABNF]           Crocker, D., and P. Overell, "Augmented BNF for
                    Syntax Specifications: ABNF", RFC 2234, November
                    1997.

   [ACAP]           Newman, C., and J. Myers, "ACAP -- Application
                    Configuration Access Protocol", RFC 2244, November
                    1997.

   [BASIC-URL]      Berners-Lee, T., Masinter, L., and M. McCahill,
                    "Uniform Resource Locators (URL)", RFC 1738,
                    December 1994.

   [IMAP-URL]       Newman, C., "IMAP URL Scheme", RFC 2192, September
                    1997.

   [IMAP4]          Crispin, M., "Internet Message Access Protocol -
                    Version 4rev1", RFC 2060, December 1996.

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

   [POP-AUTH]       Myers, J., "POP3 AUTHentication command", RFC 1734,
                    December 1994.

   [POP3]           Myers, J., and M. Rose, "Post Office Protocol --
                    Version 3", STD 53, RFC 1939, May 1996.

   [SASL]           Myers, J., "Simple Authentication and Security Layer
                    (SASL)", RFC 2222, October 1997.

   [URL-GUIDELINES] Masinter, Alvestrand, Zigmond, "Guidelines for new
                    URL Schemes", Work in Progress.

   [UTF8]           Yergeau, F., "UTF-8, a transformation format of ISO
                    10646", RFC 2279, January 1998.








Gellens                     Standards Track                     [Page 6]

RFC 2384                     POP URL Scheme                  August 1998


12.  Author's Address

   Randall Gellens
   QUALCOMM, Incorporated
   6455 Lusk Blvd.
   San Diego, CA  92121-2779
   U.S.A.

   Phone: +1 619 651 5115
   Fax:   +1 619 651 5334
   EMail: Randy@Qualcomm.Com








































Gellens                     Standards Track                     [Page 7]

RFC 2384                     POP URL Scheme                  August 1998


13.  Full Copyright Statement

   Copyright (C) The Internet Society (1998).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
























Gellens                     Standards Track                     [Page 8]