2021-02-17 15:56:36 +08:00
|
|
|
=pod
|
|
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
|
|
PKCS12_decrypt_skey, PKCS12_decrypt_skey_ex - PKCS12 shrouded keyBag
|
|
|
|
|
decrypt functions
|
|
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
|
|
#include <openssl/pkcs12.h>
|
|
|
|
|
|
|
|
|
|
PKCS8_PRIV_KEY_INFO *PKCS12_decrypt_skey(const PKCS12_SAFEBAG *bag,
|
|
|
|
|
const char *pass, int passlen);
|
|
|
|
|
PKCS8_PRIV_KEY_INFO *PKCS12_decrypt_skey_ex(const PKCS12_SAFEBAG *bag,
|
|
|
|
|
const char *pass, int passlen,
|
|
|
|
|
OSSL_LIB_CTX *ctx,
|
|
|
|
|
const char *propq);
|
|
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
|
|
PKCS12_decrypt_skey() Decrypt the PKCS#8 shrouded keybag contained within I<bag>
|
|
|
|
|
using the supplied password I<pass> of length I<passlen>.
|
|
|
|
|
|
2021-04-30 07:11:42 +08:00
|
|
|
PKCS12_decrypt_skey_ex() is similar to the above but allows for a library contex
|
2021-02-17 15:56:36 +08:00
|
|
|
I<ctx> and property query I<propq> to be used to select algorithm implementations.
|
|
|
|
|
|
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
|
|
|
|
|
|
Both functions will return the decrypted key or NULL if an error occurred.
|
|
|
|
|
|
|
|
|
|
=head1 CONFORMING TO
|
|
|
|
|
|
|
|
|
|
IETF RFC 7292 (L<https://tools.ietf.org/html/rfc7292>)
|
|
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
|
|
L<PKCS8_decrypt_ex(3)>,
|
|
|
|
|
L<PKCS8_encrypt_ex(3)>,
|
|
|
|
|
L<PKCS12_add_key_ex(3)>,
|
|
|
|
|
L<PKCS12_SAFEBAG_create_pkcs8_encrypt_ex(3)>
|
|
|
|
|
|
|
|
|
|
=head1 HISTORY
|
|
|
|
|
|
|
|
|
|
PKCS12_decrypt_skey_ex() was added in OpenSSL 3.0.
|
|
|
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
|
|
Copyright 2021 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
|
|
|
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
|
|
|
this file except in compliance with the License. You can obtain a copy
|
|
|
|
|
in the file LICENSE in the source distribution or at
|
|
|
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
|
|
|
|
|
|
=cut
|
