mbed TLS v2.28.1
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
40 #define MBEDTLS_ERR_PKCS12_FEATURE_UNAVAILABLE -0x1F00
42 #define MBEDTLS_ERR_PKCS12_PBE_INVALID_FORMAT -0x1E80
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 
74  const unsigned char *pwd, size_t pwdlen,
75  const unsigned char *input, size_t len,
76  unsigned char *output );
77 
96 int mbedtls_pkcs12_pbe( mbedtls_asn1_buf *pbe_params, int mode,
97  mbedtls_cipher_type_t cipher_type, mbedtls_md_type_t md_type,
98  const unsigned char *pwd, size_t pwdlen,
99  const unsigned char *input, size_t len,
100  unsigned char *output );
101 
102 #endif /* MBEDTLS_ASN1_PARSE_C */
103 
131 int mbedtls_pkcs12_derivation( unsigned char *data, size_t datalen,
132  const unsigned char *pwd, size_t pwdlen,
133  const unsigned char *salt, size_t saltlen,
134  mbedtls_md_type_t mbedtls_md, int id, int iterations );
135 
136 #ifdef __cplusplus
137 }
138 #endif
139 
140 #endif /* pkcs12.h */
Generic ASN.1 parsing.
This file contains an abstraction interface for use with the cipher primitives provided by the librar...
mbedtls_cipher_type_t
Supported {cipher type, cipher mode} pairs.
Definition: cipher.h:110
Configuration options (set of defines)
This file contains the generic message-digest wrapper.
mbedtls_md_type_t
Supported message digests.
Definition: md.h:62
MBEDTLS_CHECK_RETURN_TYPICAL 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...
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_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 *input, size_t len, unsigned char *output)
PKCS12 Password Based function (encryption / decryption) for cipher-based and mbedtls_md-based PBE's.
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.