NAME

Sympa::Tools::SMIME - Tools for S/MIME messages and X.509 certificates

DESCRIPTION

Functions

find_keys ( $that, $operation ): Find the appropriate S/MIME keys/certs for $operation of $that.
$operation can be:

'sign': return the preferred signing key/cert
'decrypt': return a list of possible decryption keys/certs
'encrypt': return the preferred encryption key/cert

Returnss "($certs, $keys)". For 'sign' and 'encrypt', these are strings containing the absolute filename. For 'decrypt', these are arrayrefs containing absolute filenames.

parse_cert ( "text"|"file" => $content ): Parses X.509 certificate.
Options:

"file" => $filename
"text" => $text: Specifies PEM-encoded certificate.

Returns a hashref containing these items:

{email}: hashref with email addresses from cert as keys
{emails}: arrayref with email addresses from cert. This was added on Sympa 6.2.67b.
{subject}: distinguished name
{purpose}: hashref containing:

{enc}: true if v3 purpose is encryption
{sign}: true if v3 purpose is signing

TBD.

If parsing failed, returns "undef".

HISTORY

TBD.