Allow SRTP policies to be reloaded
[asterisk/asterisk.git] / include / asterisk / res_srtp.h
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2010 FIXME
5  *
6  * See http://www.asterisk.org for more information about
7  * the Asterisk project. Please do not directly contact
8  * any of the maintainers of this project for assistance;
9  * the project provides a web site, mailing lists and IRC
10  * channels for your use.
11  *
12  * This program is free software, distributed under the terms of
13  * the GNU General Public License Version 2. See the LICENSE file
14  * at the top of the source tree.
15  */
16
17 /*! \file
18  * \brief SRTP resource
19  */
20
21 #ifndef _ASTERISK_RES_SRTP_H
22 #define _ASTERISK_RES_SRTP_H
23
24 struct ast_srtp;
25 struct ast_srtp_policy;
26 struct ast_rtp_instance;
27
28 struct ast_srtp_cb {
29         int (*no_ctx)(struct ast_rtp_instance *rtp, unsigned long ssrc, void *data);
30 };
31
32 struct ast_srtp_res {
33         /*! Create a new SRTP session for an RTP instance with a default policy */
34         int (*create)(struct ast_srtp **srtp, struct ast_rtp_instance *rtp, struct ast_srtp_policy *policy);
35         /* Replace an existing SRTP session with a new session, along with a new default policy */
36         int (*replace)(struct ast_srtp **srtp, struct ast_rtp_instance *rtp, struct ast_srtp_policy *policy);
37         /*! Destroy an SRTP session, along with all associated policies */
38         void (*destroy)(struct ast_srtp *srtp);
39         /* Add a new stream to an existing SRTP session.  Note that the policy cannot be for a wildcard SSRC */
40         int (*add_stream)(struct ast_srtp *srtp, struct ast_srtp_policy *policy);
41         /* Change the source on an existing SRTP session. */
42         int (*change_source)(struct ast_srtp *srtp, unsigned int from_ssrc, unsigned int to_ssrc);
43         /* Set a callback function */
44         void (*set_cb)(struct ast_srtp *srtp, const struct ast_srtp_cb *cb, void *data);
45         /* Unprotect SRTP data */
46         int (*unprotect)(struct ast_srtp *srtp, void *buf, int *size, int rtcp);
47         /* Protect RTP data */
48         int (*protect)(struct ast_srtp *srtp, void **buf, int *size, int rtcp);
49         /* Obtain a random cryptographic key */
50         int (*get_random)(unsigned char *key, size_t len);
51 };
52
53 /* Crypto suites */
54 enum ast_srtp_suite {
55         AST_AES_CM_128_HMAC_SHA1_80 = 1,
56         AST_AES_CM_128_HMAC_SHA1_32 = 2,
57         AST_F8_128_HMAC_SHA1_80     = 3
58 };
59
60 struct ast_srtp_policy_res {
61         struct ast_srtp_policy *(*alloc)(void);
62         void (*destroy)(struct ast_srtp_policy *policy);
63         int (*set_suite)(struct ast_srtp_policy *policy, enum ast_srtp_suite suite);
64         int (*set_master_key)(struct ast_srtp_policy *policy, const unsigned char *key, size_t key_len, const unsigned char *salt, size_t salt_len);
65         void (*set_ssrc)(struct ast_srtp_policy *policy, unsigned long ssrc, int inbound);
66 };
67
68 #endif /* _ASTERISK_RES_SRTP_H */