2 * Copyright (c) 2015 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 #include <sys/random.h>
17 #include <vnet/ipsec/ipsec.h>
18 #include <vnet/ipsec/esp.h>
19 #include <vnet/udp/udp_local.h>
20 #include <vnet/fib/fib_table.h>
21 #include <vnet/fib/fib_entry_track.h>
22 #include <vnet/ipsec/ipsec_tun.h>
23 #include <vnet/ipsec/ipsec.api_enum.h>
27 * SA packet & bytes counters
29 vlib_combined_counter_main_t ipsec_sa_counters = {
31 .stat_segment_name = "/net/ipsec/sa",
33 /* Per-SA error counters */
34 vlib_simple_counter_main_t ipsec_sa_err_counters[IPSEC_SA_N_ERRORS];
36 ipsec_sa_t *ipsec_sa_pool;
39 ipsec_call_add_del_callbacks (ipsec_main_t * im, ipsec_sa_t * sa,
40 u32 sa_index, int is_add)
42 ipsec_ah_backend_t *ab;
43 ipsec_esp_backend_t *eb;
46 case IPSEC_PROTOCOL_AH:
47 ab = pool_elt_at_index (im->ah_backends, im->ah_current_backend);
48 if (ab->add_del_sa_sess_cb)
49 return ab->add_del_sa_sess_cb (sa_index, is_add);
51 case IPSEC_PROTOCOL_ESP:
52 eb = pool_elt_at_index (im->esp_backends, im->esp_current_backend);
53 if (eb->add_del_sa_sess_cb)
54 return eb->add_del_sa_sess_cb (sa_index, is_add);
61 ipsec_mk_key (ipsec_key_t * key, const u8 * data, u8 len)
63 memset (key, 0, sizeof (*key));
65 if (len > sizeof (key->data))
66 key->len = sizeof (key->data);
70 memcpy (key->data, data, key->len);
74 * 'stack' (resolve the recursion for) the SA tunnel destination
77 ipsec_sa_stack (ipsec_sa_t * sa)
79 ipsec_main_t *im = &ipsec_main;
80 dpo_id_t tmp = DPO_INVALID;
82 tunnel_contribute_forwarding (&sa->tunnel, &tmp);
84 if (IPSEC_PROTOCOL_AH == sa->protocol)
85 dpo_stack_from_node ((ipsec_sa_is_set_IS_TUNNEL_V6 (sa) ?
86 im->ah6_encrypt_node_index :
87 im->ah4_encrypt_node_index), &sa->dpo, &tmp);
89 dpo_stack_from_node ((ipsec_sa_is_set_IS_TUNNEL_V6 (sa) ?
90 im->esp6_encrypt_node_index :
91 im->esp4_encrypt_node_index), &sa->dpo, &tmp);
96 ipsec_sa_set_async_mode (ipsec_sa_t *sa, int is_enabled)
100 sa->crypto_key_index = sa->crypto_async_key_index;
101 sa->crypto_enc_op_id = sa->crypto_async_enc_op_id;
102 sa->crypto_dec_op_id = sa->crypto_async_dec_op_id;
103 sa->integ_key_index = ~0;
104 sa->integ_op_id = ~0;
108 sa->crypto_key_index = sa->crypto_sync_key_index;
109 sa->crypto_enc_op_id = sa->crypto_sync_enc_op_id;
110 sa->crypto_dec_op_id = sa->crypto_sync_dec_op_id;
111 sa->integ_key_index = sa->integ_sync_key_index;
112 sa->integ_op_id = sa->integ_sync_op_id;
117 ipsec_sa_set_crypto_alg (ipsec_sa_t * sa, ipsec_crypto_alg_t crypto_alg)
119 ipsec_main_t *im = &ipsec_main;
120 sa->crypto_alg = crypto_alg;
121 sa->crypto_iv_size = im->crypto_algs[crypto_alg].iv_size;
122 sa->esp_block_align = clib_max (4, im->crypto_algs[crypto_alg].block_align);
123 sa->crypto_sync_enc_op_id = im->crypto_algs[crypto_alg].enc_op_id;
124 sa->crypto_sync_dec_op_id = im->crypto_algs[crypto_alg].dec_op_id;
125 sa->crypto_calg = im->crypto_algs[crypto_alg].alg;
126 ASSERT (sa->crypto_iv_size <= ESP_MAX_IV_SIZE);
127 ASSERT (sa->esp_block_align <= ESP_MAX_BLOCK_SIZE);
128 if (IPSEC_CRYPTO_ALG_IS_GCM (crypto_alg) ||
129 IPSEC_CRYPTO_ALG_CTR_AEAD_OTHERS (crypto_alg))
131 sa->integ_icv_size = im->crypto_algs[crypto_alg].icv_size;
132 ipsec_sa_set_IS_CTR (sa);
133 ipsec_sa_set_IS_AEAD (sa);
135 else if (IPSEC_CRYPTO_ALG_IS_CTR (crypto_alg))
137 ipsec_sa_set_IS_CTR (sa);
142 ipsec_sa_set_integ_alg (ipsec_sa_t * sa, ipsec_integ_alg_t integ_alg)
144 ipsec_main_t *im = &ipsec_main;
145 sa->integ_alg = integ_alg;
146 sa->integ_icv_size = im->integ_algs[integ_alg].icv_size;
147 sa->integ_sync_op_id = im->integ_algs[integ_alg].op_id;
148 sa->integ_calg = im->integ_algs[integ_alg].alg;
149 ASSERT (sa->integ_icv_size <= ESP_MAX_ICV_SIZE);
153 ipsec_sa_set_async_op_ids (ipsec_sa_t * sa)
156 if (ipsec_sa_is_set_USE_ESN (sa))
159 if (sa->crypto_sync_enc_op_id == VNET_CRYPTO_OP_##n##_ENC) \
160 sa->crypto_async_enc_op_id = VNET_CRYPTO_OP_##n##_TAG16_AAD12_ENC; \
161 if (sa->crypto_sync_dec_op_id == VNET_CRYPTO_OP_##n##_DEC) \
162 sa->crypto_async_dec_op_id = VNET_CRYPTO_OP_##n##_TAG16_AAD12_DEC;
163 foreach_crypto_aead_alg
169 if (sa->crypto_sync_enc_op_id == VNET_CRYPTO_OP_##n##_ENC) \
170 sa->crypto_async_enc_op_id = VNET_CRYPTO_OP_##n##_TAG16_AAD8_ENC; \
171 if (sa->crypto_sync_dec_op_id == VNET_CRYPTO_OP_##n##_DEC) \
172 sa->crypto_async_dec_op_id = VNET_CRYPTO_OP_##n##_TAG16_AAD8_DEC;
173 foreach_crypto_aead_alg
177 #define _(c, h, s, k, d) \
178 if (sa->crypto_sync_enc_op_id == VNET_CRYPTO_OP_##c##_ENC && \
179 sa->integ_sync_op_id == VNET_CRYPTO_OP_##h##_HMAC) \
180 sa->crypto_async_enc_op_id = VNET_CRYPTO_OP_##c##_##h##_TAG##d##_ENC; \
181 if (sa->crypto_sync_dec_op_id == VNET_CRYPTO_OP_##c##_DEC && \
182 sa->integ_sync_op_id == VNET_CRYPTO_OP_##h##_HMAC) \
183 sa->crypto_async_dec_op_id = VNET_CRYPTO_OP_##c##_##h##_TAG##d##_DEC;
184 foreach_crypto_link_async_alg
190 ipsec_sa_update (u32 id, u16 src_port, u16 dst_port, const tunnel_t *tun,
193 ipsec_main_t *im = &ipsec_main;
199 p = hash_get (im->sa_index_by_sa_id, id);
201 return VNET_API_ERROR_NO_SUCH_ENTRY;
203 sa = ipsec_sa_get (p[0]);
204 sa_index = sa - ipsec_sa_pool;
206 if (is_tun && ipsec_sa_is_set_IS_TUNNEL (sa) &&
207 (ip_address_cmp (&tun->t_src, &sa->tunnel.t_src) != 0 ||
208 ip_address_cmp (&tun->t_dst, &sa->tunnel.t_dst) != 0))
210 /* if the source IP is updated for an inbound SA under a tunnel protect,
211 we need to update the tun_protect DB with the new src IP */
212 if (ipsec_sa_is_set_IS_INBOUND (sa) &&
213 ip_address_cmp (&tun->t_src, &sa->tunnel.t_src) != 0 &&
214 !ip46_address_is_zero (&tun->t_src.ip))
216 if (ip46_address_is_ip4 (&sa->tunnel.t_src.ip))
218 ipsec4_tunnel_kv_t old_key, new_key;
219 clib_bihash_kv_8_16_t res,
220 *bkey = (clib_bihash_kv_8_16_t *) &old_key;
222 ipsec4_tunnel_mk_key (&old_key, &sa->tunnel.t_src.ip.ip4,
223 clib_host_to_net_u32 (sa->spi));
224 ipsec4_tunnel_mk_key (&new_key, &tun->t_src.ip.ip4,
225 clib_host_to_net_u32 (sa->spi));
227 if (!clib_bihash_search_8_16 (&im->tun4_protect_by_key, bkey,
230 clib_bihash_add_del_8_16 (&im->tun4_protect_by_key, &res, 0);
231 res.key = new_key.key;
232 clib_bihash_add_del_8_16 (&im->tun4_protect_by_key, &res, 1);
237 ipsec6_tunnel_kv_t old_key = {
239 .remote_ip = sa->tunnel.t_src.ip.ip6,
240 .spi = clib_host_to_net_u32 (sa->spi),
244 .remote_ip = tun->t_src.ip.ip6,
245 .spi = clib_host_to_net_u32 (sa->spi),
247 clib_bihash_kv_24_16_t res,
248 *bkey = (clib_bihash_kv_24_16_t *) &old_key;
250 if (!clib_bihash_search_24_16 (&im->tun6_protect_by_key, bkey,
253 clib_bihash_add_del_24_16 (&im->tun6_protect_by_key, &res,
255 clib_memcpy (&res.key, &new_key.key, 3);
256 clib_bihash_add_del_24_16 (&im->tun6_protect_by_key, &res,
261 tunnel_unresolve (&sa->tunnel);
262 tunnel_copy (tun, &sa->tunnel);
263 if (!ipsec_sa_is_set_IS_INBOUND (sa))
265 dpo_reset (&sa->dpo);
267 sa->tunnel_flags = sa->tunnel.t_encap_decap_flags;
269 rv = tunnel_resolve (&sa->tunnel, FIB_NODE_TYPE_IPSEC_SA, sa_index);
273 hash_unset (im->sa_index_by_sa_id, sa->id);
274 pool_put (ipsec_sa_pool, sa);
278 /* generate header templates */
279 if (ipsec_sa_is_set_IS_TUNNEL_V6 (sa))
281 tunnel_build_v6_hdr (&sa->tunnel,
282 (ipsec_sa_is_set_UDP_ENCAP (sa) ?
284 IP_PROTOCOL_IPSEC_ESP),
289 tunnel_build_v4_hdr (&sa->tunnel,
290 (ipsec_sa_is_set_UDP_ENCAP (sa) ?
292 IP_PROTOCOL_IPSEC_ESP),
298 if (ipsec_sa_is_set_UDP_ENCAP (sa))
300 if (dst_port != IPSEC_UDP_PORT_NONE &&
301 dst_port != clib_net_to_host_u16 (sa->udp_hdr.dst_port))
303 if (ipsec_sa_is_set_IS_INBOUND (sa))
305 ipsec_unregister_udp_port (
306 clib_net_to_host_u16 (sa->udp_hdr.dst_port),
307 !ipsec_sa_is_set_IS_TUNNEL_V6 (sa));
308 ipsec_register_udp_port (dst_port,
309 !ipsec_sa_is_set_IS_TUNNEL_V6 (sa));
311 sa->udp_hdr.dst_port = clib_host_to_net_u16 (dst_port);
313 if (src_port != IPSEC_UDP_PORT_NONE &&
314 src_port != clib_net_to_host_u16 (sa->udp_hdr.src_port))
315 sa->udp_hdr.src_port = clib_host_to_net_u16 (src_port);
321 ipsec_sa_add_and_lock (u32 id, u32 spi, ipsec_protocol_t proto,
322 ipsec_crypto_alg_t crypto_alg, const ipsec_key_t *ck,
323 ipsec_integ_alg_t integ_alg, const ipsec_key_t *ik,
324 ipsec_sa_flags_t flags, u32 salt, u16 src_port,
325 u16 dst_port, const tunnel_t *tun, u32 *sa_out_index)
327 vlib_main_t *vm = vlib_get_main ();
328 ipsec_main_t *im = &ipsec_main;
336 p = hash_get (im->sa_index_by_sa_id, id);
338 return VNET_API_ERROR_ENTRY_ALREADY_EXISTS;
340 if (getrandom (rand, sizeof (rand), 0) != sizeof (rand))
341 return VNET_API_ERROR_INIT_FAILED;
343 pool_get_aligned_zero (ipsec_sa_pool, sa, CLIB_CACHE_LINE_BYTES);
345 clib_pcg64i_srandom_r (&sa->iv_prng, rand[0], rand[1]);
347 fib_node_init (&sa->node, FIB_NODE_TYPE_IPSEC_SA);
348 fib_node_lock (&sa->node);
349 sa_index = sa - ipsec_sa_pool;
351 vlib_validate_combined_counter (&ipsec_sa_counters, sa_index);
352 vlib_zero_combined_counter (&ipsec_sa_counters, sa_index);
353 for (int i = 0; i < IPSEC_SA_N_ERRORS; i++)
355 vlib_validate_simple_counter (&ipsec_sa_err_counters[i], sa_index);
356 vlib_zero_simple_counter (&ipsec_sa_err_counters[i], sa_index);
359 tunnel_copy (tun, &sa->tunnel);
362 sa->stat_index = sa_index;
363 sa->protocol = proto;
366 sa->thread_index = (vlib_num_workers ()) ? ~0 : 0;
367 if (integ_alg != IPSEC_INTEG_ALG_NONE)
369 ipsec_sa_set_integ_alg (sa, integ_alg);
370 clib_memcpy (&sa->integ_key, ik, sizeof (sa->integ_key));
372 ipsec_sa_set_crypto_alg (sa, crypto_alg);
373 ipsec_sa_set_async_op_ids (sa);
375 clib_memcpy (&sa->crypto_key, ck, sizeof (sa->crypto_key));
377 sa->crypto_sync_key_index = vnet_crypto_key_add (
378 vm, im->crypto_algs[crypto_alg].alg, (u8 *) ck->data, ck->len);
379 if (~0 == sa->crypto_sync_key_index)
381 pool_put (ipsec_sa_pool, sa);
382 return VNET_API_ERROR_KEY_LENGTH;
385 if (integ_alg != IPSEC_INTEG_ALG_NONE)
387 sa->integ_sync_key_index = vnet_crypto_key_add (
388 vm, im->integ_algs[integ_alg].alg, (u8 *) ik->data, ik->len);
389 if (~0 == sa->integ_sync_key_index)
391 pool_put (ipsec_sa_pool, sa);
392 return VNET_API_ERROR_KEY_LENGTH;
396 if (sa->crypto_async_enc_op_id && !ipsec_sa_is_set_IS_AEAD (sa))
397 sa->crypto_async_key_index =
398 vnet_crypto_key_add_linked (vm, sa->crypto_sync_key_index,
399 sa->integ_sync_key_index); // AES-CBC & HMAC
401 sa->crypto_async_key_index = sa->crypto_sync_key_index;
405 ipsec_sa_set_async_mode (sa, 1);
407 else if (ipsec_sa_is_set_IS_ASYNC (sa))
409 vnet_crypto_request_async_mode (1);
410 ipsec_sa_set_async_mode (sa, 1 /* is_enabled */);
414 ipsec_sa_set_async_mode (sa, 0 /* is_enabled */);
417 err = ipsec_check_support_cb (im, sa);
420 clib_warning ("%s", err->what);
421 pool_put (ipsec_sa_pool, sa);
422 return VNET_API_ERROR_UNIMPLEMENTED;
425 err = ipsec_call_add_del_callbacks (im, sa, sa_index, 1);
428 pool_put (ipsec_sa_pool, sa);
429 return VNET_API_ERROR_SYSCALL_ERROR_1;
432 if (ipsec_sa_is_set_IS_TUNNEL (sa) &&
433 AF_IP6 == ip_addr_version (&tun->t_src))
434 ipsec_sa_set_IS_TUNNEL_V6 (sa);
436 if (ipsec_sa_is_set_IS_TUNNEL (sa) && !ipsec_sa_is_set_IS_INBOUND (sa))
438 sa->tunnel_flags = sa->tunnel.t_encap_decap_flags;
440 rv = tunnel_resolve (&sa->tunnel, FIB_NODE_TYPE_IPSEC_SA, sa_index);
444 pool_put (ipsec_sa_pool, sa);
449 /* generate header templates */
450 if (ipsec_sa_is_set_IS_TUNNEL_V6 (sa))
452 tunnel_build_v6_hdr (&sa->tunnel,
453 (ipsec_sa_is_set_UDP_ENCAP (sa) ?
455 IP_PROTOCOL_IPSEC_ESP),
460 tunnel_build_v4_hdr (&sa->tunnel,
461 (ipsec_sa_is_set_UDP_ENCAP (sa) ?
463 IP_PROTOCOL_IPSEC_ESP),
468 if (ipsec_sa_is_set_UDP_ENCAP (sa))
470 if (dst_port == IPSEC_UDP_PORT_NONE)
471 sa->udp_hdr.dst_port = clib_host_to_net_u16 (UDP_DST_PORT_ipsec);
473 sa->udp_hdr.dst_port = clib_host_to_net_u16 (dst_port);
475 if (src_port == IPSEC_UDP_PORT_NONE)
476 sa->udp_hdr.src_port = clib_host_to_net_u16 (UDP_DST_PORT_ipsec);
478 sa->udp_hdr.src_port = clib_host_to_net_u16 (src_port);
480 if (ipsec_sa_is_set_IS_INBOUND (sa))
481 ipsec_register_udp_port (clib_host_to_net_u16 (sa->udp_hdr.dst_port),
482 !ipsec_sa_is_set_IS_TUNNEL_V6 (sa));
485 hash_set (im->sa_index_by_sa_id, sa->id, sa_index);
488 *sa_out_index = sa_index;
494 ipsec_sa_del (ipsec_sa_t * sa)
496 vlib_main_t *vm = vlib_get_main ();
497 ipsec_main_t *im = &ipsec_main;
500 sa_index = sa - ipsec_sa_pool;
501 hash_unset (im->sa_index_by_sa_id, sa->id);
502 tunnel_unresolve (&sa->tunnel);
504 /* no recovery possible when deleting an SA */
505 (void) ipsec_call_add_del_callbacks (im, sa, sa_index, 0);
507 if (ipsec_sa_is_set_IS_ASYNC (sa))
509 vnet_crypto_request_async_mode (0);
510 if (!ipsec_sa_is_set_IS_AEAD (sa))
511 vnet_crypto_key_del (vm, sa->crypto_async_key_index);
514 if (ipsec_sa_is_set_UDP_ENCAP (sa) && ipsec_sa_is_set_IS_INBOUND (sa))
515 ipsec_unregister_udp_port (clib_net_to_host_u16 (sa->udp_hdr.dst_port),
516 !ipsec_sa_is_set_IS_TUNNEL_V6 (sa));
518 if (ipsec_sa_is_set_IS_TUNNEL (sa) && !ipsec_sa_is_set_IS_INBOUND (sa))
519 dpo_reset (&sa->dpo);
520 vnet_crypto_key_del (vm, sa->crypto_sync_key_index);
521 if (sa->integ_alg != IPSEC_INTEG_ALG_NONE)
522 vnet_crypto_key_del (vm, sa->integ_sync_key_index);
523 pool_put (ipsec_sa_pool, sa);
527 ipsec_sa_unlock (index_t sai)
531 if (INDEX_INVALID == sai)
534 sa = ipsec_sa_get (sai);
536 fib_node_unlock (&sa->node);
540 ipsec_sa_lock (index_t sai)
544 if (INDEX_INVALID == sai)
547 sa = ipsec_sa_get (sai);
549 fib_node_lock (&sa->node);
553 ipsec_sa_find_and_lock (u32 id)
555 ipsec_main_t *im = &ipsec_main;
559 p = hash_get (im->sa_index_by_sa_id, id);
562 return INDEX_INVALID;
564 sa = ipsec_sa_get (p[0]);
566 fib_node_lock (&sa->node);
572 ipsec_sa_unlock_id (u32 id)
574 ipsec_main_t *im = &ipsec_main;
577 p = hash_get (im->sa_index_by_sa_id, id);
580 return VNET_API_ERROR_NO_SUCH_ENTRY;
582 ipsec_sa_unlock (p[0]);
588 ipsec_sa_clear (index_t sai)
590 vlib_zero_combined_counter (&ipsec_sa_counters, sai);
591 for (int i = 0; i < IPSEC_SA_N_ERRORS; i++)
592 vlib_zero_simple_counter (&ipsec_sa_err_counters[i], sai);
596 ipsec_sa_walk (ipsec_sa_walk_cb_t cb, void *ctx)
601 pool_foreach (sa, ipsec_sa_pool)
603 if (WALK_CONTINUE != cb (sa, ctx))
610 * Function definition to get a FIB node from its index
613 ipsec_sa_fib_node_get (fib_node_index_t index)
617 sa = ipsec_sa_get (index);
623 ipsec_sa_from_fib_node (fib_node_t * node)
625 ASSERT (FIB_NODE_TYPE_IPSEC_SA == node->fn_type);
626 return ((ipsec_sa_t *) (((char *) node) -
627 STRUCT_OFFSET_OF (ipsec_sa_t, node)));
632 * Function definition to inform the FIB node that its last lock has gone.
635 ipsec_sa_last_lock_gone (fib_node_t * node)
638 * The ipsec SA is a root of the graph. As such
639 * it never has children and thus is never locked.
641 ipsec_sa_del (ipsec_sa_from_fib_node (node));
645 * Function definition to backwalk a FIB node
647 static fib_node_back_walk_rc_t
648 ipsec_sa_back_walk (fib_node_t * node, fib_node_back_walk_ctx_t * ctx)
650 ipsec_sa_stack (ipsec_sa_from_fib_node (node));
652 return (FIB_NODE_BACK_WALK_CONTINUE);
656 * Virtual function table registered by SAs
657 * for participation in the FIB object graph.
659 const static fib_node_vft_t ipsec_sa_vft = {
660 .fnv_get = ipsec_sa_fib_node_get,
661 .fnv_last_lock = ipsec_sa_last_lock_gone,
662 .fnv_back_walk = ipsec_sa_back_walk,
665 /* Init per-SA error counters and node type */
667 ipsec_sa_init (vlib_main_t *vm)
669 fib_node_register_type (FIB_NODE_TYPE_IPSEC_SA, &ipsec_sa_vft);
671 #define _(index, val, err, desc) \
672 ipsec_sa_err_counters[index].name = \
673 (char *) format (0, "SA-" #err "%c", 0); \
674 ipsec_sa_err_counters[index].stat_segment_name = \
675 (char *) format (0, "/net/ipsec/sa/err/" #err "%c", 0); \
676 ipsec_sa_err_counters[index].counters = 0;
682 VLIB_INIT_FUNCTION (ipsec_sa_init);
685 * fd.io coding-style-patch-verification: ON
688 * eval: (c-set-style "gnu")