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.