summaryrefslogtreecommitdiff
path: root/doc/rfc/rfc7999.txt
blob: baae8e099d3451c79db72427f9fab470bd1158ab (plain) (blame)
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
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
Internet Engineering Task Force (IETF)                           T. King
Request for Comments: 7999                                    C. Dietzel
Category: Informational                                           DE-CIX
ISSN: 2070-1721                                              J. Snijders
                                                                     NTT
                                                              G. Doering
                                                             SpaceNet AG
                                                              G. Hankins
                                                                   Nokia
                                                            October 2016


                          BLACKHOLE Community

Abstract

   This document describes the use of a well-known Border Gateway
   Protocol (BGP) community for destination-based blackholing in IP
   networks.  This well-known advisory transitive BGP community named
   "BLACKHOLE" allows an origin Autonomous System (AS) to specify that a
   neighboring network should discard any traffic destined towards the
   tagged IP prefix.

Status of This Memo

   This document is not an Internet Standards Track specification; it is
   published for informational purposes.

   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).  Not all documents
   approved by the IESG are a candidate for any level of Internet
   Standard; see Section 2 of RFC 7841.

   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/rfc7999.













King, et al.                  Informational                     [Page 1]
^L
RFC 7999                   BLACKHOLE Community              October 2016


Copyright Notice

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

   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.

Table of Contents

   1. Introduction ....................................................3
      1.1. Requirements Language ......................................3
   2. BLACKHOLE Community .............................................4
   3. Operational Recommendations .....................................4
      3.1. IP Prefix Announcements with BLACKHOLE Community Attached ..4
      3.2. Local Scope of Blackholes ..................................4
      3.3. Accepting Blackholed IP Prefixes ...........................5
   4. Vendor Implementation Recommendations ...........................6
   5. IANA Considerations .............................................6
   6. Security Considerations .........................................6
   7. References ......................................................7
      7.1. Normative References .......................................7
      7.2. Informative References .....................................7
   Acknowledgements ...................................................8
   Authors' Addresses .................................................9



















King, et al.                  Informational                     [Page 2]
^L
RFC 7999                   BLACKHOLE Community              October 2016


1.  Introduction

   Network infrastructures have been increasingly hampered by DDoS
   attacks.  In order to dampen the effects of these DDoS attacks, IP
   networks have offered blackholing with BGP [RFC4271] using various
   mechanisms such as those described in [RFC3882] and [RFC5635].

   DDoS attacks targeting a certain IP address may cause congestion of
   links used to connect to adjacent networks.  In order to limit the
   impact of such a scenario on legitimate traffic, networks adopted a
   mechanism called "BGP blackholing".  A network that wants to trigger
   blackholing needs to understand the triggering mechanism adopted by
   its neighboring networks.  Different networks provide different
   mechanisms to trigger blackholing, including but not limited to pre-
   defined blackhole next-hop IP addresses, specific BGP communities, or
   out-of-band BGP sessions with a special BGP speaker.

   Having several different mechanisms to trigger blackholing in
   different networks makes it an unnecessarily complex, error-prone,
   and cumbersome task for network operators.  Therefore, a well-known
   BGP community [RFC1997] is defined for operational ease.

   Having such a well-known BGP community for blackholing also further
   simplifies network operations because:

   o  Implementing and monitoring blackholing becomes easier when
      implementation and operational guides do not cover many variations
      to trigger blackholing.

   o  The number of support requests from customers about how to trigger
      blackholing in a particular neighboring network will be reduced as
      the codepoint for common blackholing mechanisms is unified and
      well-known.

1.1.  Requirements Language

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are to
   be interpreted as described in [RFC2119] only when they appear in all
   upper case.  They may also appear in lower case or mixed case as
   English words, without normative meaning.










King, et al.                  Informational                     [Page 3]
^L
RFC 7999                   BLACKHOLE Community              October 2016


2.  BLACKHOLE Community

   This document defines the use of a new well-known BGP transitive
   community, BLACKHOLE.

   The semantics of this community allow a network to interpret the
   presence of this community as an advisory qualification to drop any
   traffic being sent towards this prefix.

3.  Operational Recommendations

3.1.  IP Prefix Announcements with BLACKHOLE Community Attached

   Accepting and honoring the BLACKHOLE community, or ignoring it, is a
   choice that is made by each operator.  This community MAY be used in
   all bilateral and multilateral BGP deployment scenarios.  In a
   bilateral peering relationship, use of the BLACKHOLE community MUST
   be agreed upon by the two networks before advertising it.  In a
   multilateral peering relationship, the decision to honor or ignore
   the BLACKHOLE community is to be made according to the operator's
   routing policy.  The community SHOULD be ignored, if it is received
   by a network that it not using it.

   When a network is under DDoS duress, it MAY announce an IP prefix
   covering the victim's IP address(es) for the purpose of signaling to
   neighboring networks that any traffic destined for these IP
   address(es) should be discarded.  In such a scenario, the network
   operator SHOULD attach the BLACKHOLE community.

   The BLACKHOLE community MAY also be used as one of the trigger
   communities in a destination-based Remote Triggered Blackhole (RTBH)
   [RFC5635] configuration.

3.2.  Local Scope of Blackholes

   A BGP speaker receiving an announcement tagged with the BLACKHOLE
   community SHOULD add the NO_ADVERTISE or NO_EXPORT community as
   defined in [RFC1997], or a similar community, to prevent propagation
   of the prefix outside the local AS.  The community to prevent
   propagation SHOULD be chosen according to the operator's routing
   policy.

   Unintentional leaking of more specific IP prefixes to neighboring
   networks can have adverse effects.  Extreme caution should be used
   when purposefully propagating IP prefixes tagged with the BLACKHOLE
   community outside the local routing domain, unless policy explicitly
   aims at doing just that.




King, et al.                  Informational                     [Page 4]
^L
RFC 7999                   BLACKHOLE Community              October 2016


3.3.  Accepting Blackholed IP Prefixes

   It has been observed in provider networks running BGP that
   announcements of IP prefixes longer than /24 for IPv4 and /48 for
   IPv6 are usually not accepted on the Internet (see Section 6.1.3 of
   [RFC7454]).  However, blackhole prefix length should be as long as
   possible in order to limit the impact of discarding traffic for
   adjacent IP space that is not under DDoS duress.  The blackhole
   prefix length is typically as specific as possible, /32 for IPv4 or
   /128 for IPv6.

   BGP speakers in a bilateral peering relationship using the BLACKHOLE
   community MUST only accept and honor BGP announcements carrying the
   BLACKHOLE community under the two following conditions:

   o  The announced prefix is covered by an equal or shorter prefix that
      the neighboring network is authorized to advertise.

   o  The receiving party agreed to honor the BLACKHOLE community on the
      particular BGP session.

   In topologies with a route server or other multilateral peering
   relationships, BGP speakers SHOULD accept and honor BGP announcements
   under the same conditions.

   An operator MUST ensure that origin validation techniques (such as
   the one described in [RFC6811]) do not inadvertently block legitimate
   announcements carrying the BLACKHOLE community.

   The BLACKHOLE community is not intended to be used with Network Layer
   Reachability Information (NLRI) [RFC5575] to distribute traffic flow
   specifications.

   The error handling for this community follows the process in
   [RFC7606] that causes a malformed community to be treated as
   withdrawn.

   Operators are encouraged to store all BGP updates in their network
   carrying the BLACKHOLE community for long-term analysis or internal
   audit purposes.











King, et al.                  Informational                     [Page 5]
^L
RFC 7999                   BLACKHOLE Community              October 2016


4.  Vendor Implementation Recommendations

   Without an explicit configuration directive set by the operator,
   network elements SHOULD NOT discard traffic destined towards IP
   prefixes that are tagged with the BLACKHOLE community.  The operator
   is expected to explicitly configure the network element to honor the
   BLACKHOLE community in a way that is compliant with the operator's
   routing policy.

   Vendors MAY provide a shorthand keyword in their configuration
   language to reference the well-known BLACKHOLE community attribute
   value.  The suggested string to be used is "blackhole".

5.  IANA Considerations

   The IANA has registered BLACKHOLE in the "BGP Well-known Communities"
   registry.

      BLACKHOLE (= 0xFFFF029A)

   The low-order two octets in decimal are 666, a value commonly
   associated with BGP blackholing among network operators.

6.  Security Considerations

   BGP contains no specific mechanism to prevent the unauthorized
   modification of information by the forwarding agent.  This allows
   routing information to be modified or removed; it also allows false
   information to be added by forwarding agents.  Recipients of routing
   information are not able to detect this modification.  BGPsec
   [BGPSEC] does not resolve this situation.  Even when BGPsec is in
   place, a forwarding agent can alter, add, or remove BGP communities.

   The unauthorized addition of the BLACKHOLE community to an IP prefix
   by an adversary may cause a denial-of-service attack based on denial
   of reachability.

   In order to further limit the impact of unauthorized BGP
   announcements carrying the BLACKHOLE community, the receiving BGP
   speaker SHOULD verify by applying strict filtering (see
   Section 6.2.1.1.2 of [RFC7454]) that the peer announcing the prefix
   is authorized to do so.  If not, the BGP announcement should be
   filtered.








King, et al.                  Informational                     [Page 6]
^L
RFC 7999                   BLACKHOLE Community              October 2016


   BGP announcements carrying the BLACKHOLE community should only be
   accepted and honored if the neighboring network is authorized to
   advertise the prefix.  The method of validating announcements is to
   be chosen according to the operator's routing policy.

   It is RECOMMENDED that operators use best common practices to protect
   their BGP sessions, such as the ones in [RFC7454].

7.  References

7.1.  Normative References

   [RFC1997]  Chandra, R., Traina, P., and T. Li, "BGP Communities
              Attribute", RFC 1997, DOI 10.17487/RFC1997, August 1996,
              <http://www.rfc-editor.org/info/rfc1997>.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <http://www.rfc-editor.org/info/rfc2119>.

   [RFC4271]  Rekhter, Y., Ed., Li, T., Ed., and S. Hares, Ed., "A
              Border Gateway Protocol 4 (BGP-4)", RFC 4271,
              DOI 10.17487/RFC4271, January 2006,
              <http://www.rfc-editor.org/info/rfc4271>.

   [RFC7606]  Chen, E., Ed., Scudder, J., Ed., Mohapatra, P., and K.
              Patel, "Revised Error Handling for BGP UPDATE Messages",
              RFC 7606, DOI 10.17487/RFC7606, August 2015,
              <http://www.rfc-editor.org/info/rfc7606>.

7.2.  Informative References

   [BGPSEC]   Lepinski, M., Ed. and K. Sriram, Ed., "BGPsec Protocol
              Specification", Work in Progress, draft-ietf-sidr-bgpsec-
              protocol-18, August 2016.

   [RFC3882]  Turk, D., "Configuring BGP to Block Denial-of-Service
              Attacks", RFC 3882, DOI 10.17487/RFC3882, September 2004,
              <http://www.rfc-editor.org/info/rfc3882>.

   [RFC5575]  Marques, P., Sheth, N., Raszuk, R., Greene, B., Mauch, J.,
              and D. McPherson, "Dissemination of Flow Specification
              Rules", RFC 5575, DOI 10.17487/RFC5575, August 2009,
              <http://www.rfc-editor.org/info/rfc5575>.






King, et al.                  Informational                     [Page 7]
^L
RFC 7999                   BLACKHOLE Community              October 2016


   [RFC5635]  Kumari, W. and D. McPherson, "Remote Triggered Black Hole
              Filtering with Unicast Reverse Path Forwarding (uRPF)",
              RFC 5635, DOI 10.17487/RFC5635, August 2009,
              <http://www.rfc-editor.org/info/rfc5635>.

   [RFC6811]  Mohapatra, P., Scudder, J., Ward, D., Bush, R., and R.
              Austein, "BGP Prefix Origin Validation", RFC 6811,
              DOI 10.17487/RFC6811, January 2013,
              <http://www.rfc-editor.org/info/rfc6811>.

   [RFC7454]  Durand, J., Pepelnjak, I., and G. Doering, "BGP Operations
              and Security", BCP 194, RFC 7454, DOI 10.17487/RFC7454,
              February 2015, <http://www.rfc-editor.org/info/rfc7454>.

Acknowledgements

   The authors would like to gratefully acknowledge many people who have
   contributed discussions and ideas to the development of this
   document.  They include Petr Jiran, Yordan Kritski, Christian Seitz,
   Nick Hilliard, Joel Jaeggli, Christopher Morrow, Thomas Mangin, Will
   Hargrave, Niels Bakker, David Farmer, Jared Mauch, John Heasley, and
   Terry Manderson.





























King, et al.                  Informational                     [Page 8]
^L
RFC 7999                   BLACKHOLE Community              October 2016


Authors' Addresses

   Thomas King
   DE-CIX Management GmbH
   Lichtstrasse 43i
   Cologne  50825
   Germany

   Email: thomas.king@de-cix.net


   Christoph Dietzel
   DE-CIX Management GmbH
   Lichtstrasse 43i
   Cologne  50825
   Germany

   Email: christoph.dietzel@de-cix.net


   Job Snijders
   NTT Communications
   Theodorus Majofskistraat 100
   Amsterdam  1065 SZ
   The Netherlands

   Email: job@ntt.net


   Gert Doering
   SpaceNet AG
   Joseph-Dollinger-Bogen 14
   Munich  80807
   Germany

   Email: gert@space.net


   Greg Hankins
   Nokia
   777 E. Middlefield Road
   Mountain View, CA  94043
   United States of America

   Email: greg.hankins@nokia.com






King, et al.                  Informational                     [Page 9]
^L