Mbed TLS v2.28.5
pkcs12.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright The Mbed TLS Contributors
8  * SPDX-License-Identifier: Apache-2.0
9  *
10  * Licensed under the Apache License, Version 2.0 (the "License"); you may
11  * not use this file except in compliance with the License.
12  * You may obtain a copy of the License at
13  *
14  * http://www.apache.org/licenses/LICENSE-2.0
15  *
16  * Unless required by applicable law or agreed to in writing, software
17  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
18  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  * See the License for the specific language governing permissions and
20  * limitations under the License.
21  */
22 #ifndef MBEDTLS_PKCS12_H
23 #define MBEDTLS_PKCS12_H
24 
25 #if !defined(MBEDTLS_CONFIG_FILE)
26 #include "mbedtls/config.h"
27 #else
28 #include MBEDTLS_CONFIG_FILE
29 #endif
30 
31 #include "mbedtls/md.h"
32 #include "mbedtls/cipher.h"
33 #include "mbedtls/asn1.h"
34 
35 #include <stddef.h>
36 
38 #define MBEDTLS_ERR_PKCS12_BAD_INPUT_DATA -0x1F80
39 
40 #define MBEDTLS_ERR_PKCS12_FEATURE_UNAVAILABLE -0x1F00
41 
42 #define MBEDTLS_ERR_PKCS12_PBE_INVALID_FORMAT -0x1E80
43 
44 #define MBEDTLS_ERR_PKCS12_PASSWORD_MISMATCH -0x1E00
45 
46 #define MBEDTLS_PKCS12_DERIVE_KEY 1
47 #define MBEDTLS_PKCS12_DERIVE_IV 2
48 #define MBEDTLS_PKCS12_DERIVE_MAC_KEY 3
50 #define MBEDTLS_PKCS12_PBE_DECRYPT 0
51 #define MBEDTLS_PKCS12_PBE_ENCRYPT 1
52 
53 #ifdef __cplusplus
54 extern "C" {
55 #endif
56 
57 #if defined(MBEDTLS_ASN1_PARSE_C)
58 
73 int mbedtls_pkcs12_pbe_sha1_rc4_128(mbedtls_asn1_buf *pbe_params, int mode,
74  const unsigned char *pwd, size_t pwdlen,
75  const unsigned char *input, size_t len,
76  unsigned char *output);
77 
119 int mbedtls_pkcs12_pbe(mbedtls_asn1_buf *pbe_params, int mode,
120  mbedtls_cipher_type_t cipher_type, mbedtls_md_type_t md_type,
121  const unsigned char *pwd, size_t pwdlen,
122  const unsigned char *data, size_t len,
123  unsigned char *output);
124 
125 #if defined(MBEDTLS_CIPHER_PADDING_PKCS7)
126 
167 int mbedtls_pkcs12_pbe_ext(mbedtls_asn1_buf *pbe_params, int mode,
168  mbedtls_cipher_type_t cipher_type, mbedtls_md_type_t md_type,
169  const unsigned char *pwd, size_t pwdlen,
170  const unsigned char *data, size_t len,
171  unsigned char *output, size_t output_size,
172  size_t *output_len);
173 
174 #endif /* MBEDTLS_CIPHER_PADDING_PKCS7 */
175 
176 #endif /* MBEDTLS_ASN1_PARSE_C */
177 
205 int mbedtls_pkcs12_derivation(unsigned char *data, size_t datalen,
206  const unsigned char *pwd, size_t pwdlen,
207  const unsigned char *salt, size_t saltlen,
208  mbedtls_md_type_t mbedtls_md, int id, int iterations);
209 
210 #ifdef __cplusplus
211 }
212 #endif
213 
214 #endif /* pkcs12.h */
int mbedtls_pkcs12_pbe_ext(mbedtls_asn1_buf *pbe_params, int mode, mbedtls_cipher_type_t cipher_type, mbedtls_md_type_t md_type, const unsigned char *pwd, size_t pwdlen, const unsigned char *data, size_t len, unsigned char *output, size_t output_size, size_t *output_len)
PKCS12 Password Based function (encryption / decryption) for cipher-based and mbedtls_md-based PBE&#39;s...
Configuration options (set of defines)
int mbedtls_pkcs12_pbe(mbedtls_asn1_buf *pbe_params, int mode, mbedtls_cipher_type_t cipher_type, mbedtls_md_type_t md_type, const unsigned char *pwd, size_t pwdlen, const unsigned char *data, size_t len, unsigned char *output)
PKCS12 Password Based function (encryption / decryption) for cipher-based and mbedtls_md-based PBE&#39;s...
mbedtls_cipher_type_t
Supported {cipher type, cipher mode} pairs.
Definition: cipher.h:110
Generic ASN.1 parsing.
int mbedtls_pkcs12_derivation(unsigned char *data, size_t datalen, const unsigned char *pwd, size_t pwdlen, const unsigned char *salt, size_t saltlen, mbedtls_md_type_t mbedtls_md, int id, int iterations)
The PKCS#12 derivation function uses a password and a salt to produce pseudo-random bits for a partic...
int mbedtls_md(const mbedtls_md_info_t *md_info, const unsigned char *input, size_t ilen, unsigned char *output)
This function calculates the message-digest of a buffer, with respect to a configurable message-diges...
This file contains an abstraction interface for use with the cipher primitives provided by the librar...
This file contains the generic message-digest wrapper.
int mbedtls_pkcs12_pbe_sha1_rc4_128(mbedtls_asn1_buf *pbe_params, int mode, const unsigned char *pwd, size_t pwdlen, const unsigned char *input, size_t len, unsigned char *output)
PKCS12 Password Based function (encryption / decryption) for pbeWithSHAAnd128BitRC4.
mbedtls_md_type_t
Supported message digests.
Definition: md.h:62