PHP Класс IMP_Smime, horde

Автор: Mike Cochrane ([email protected])

Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство	Тип	Описание
$_smime	Horde_Crypt_Smime	S/MIME object.

Открытые методы

Метод	Описание
__construct ( Horde_Crypt_Smime $smime )	Constructor.
addAdditionalCert ( string \| array $key, boolean $signkey = false )	Adds a list of additional certs to the prefs.
addFromPKCS12 ( string $pkcs12, string $password, string $pkpass = null, boolean $signkey = false )	Stores the public/private/additional certificates in the preferences from a given PKCS 12 file.
addPersonalPrivateKey ( string \| array $key, boolean $signkey = false )	Adds the personal private key to the prefs.
addPersonalPublicKey ( string \| array $key, boolean $signkey = false )	Adds the personal public key to the prefs.
addPublicKey ( string $cert )	Adds a public key to an address book.
certToHTML ( string $cert ) : string	Converts a PEM format certificate to readable HTML version.
checkForOpenSsl ( )	Checks for the presence of the OpenSSL extension to PHP.
decryptMessage ( string $text ) : string	Decrypts a message with user's public/private keypair.
deletePersonalKeys ( boolean $signkey = false )	Deletes the specified personal keys from the prefs.
deletePublicKey ( string $email )	Deletes a public key from a user's address book(s) by e-mail.
enabled ( ) : boolean	Return whether PGP support is current enabled in IMP.
encryptList ( ) : array	Returns the list of available encryption options for composing.
encryptMimePart ( Horde_Mime_Part $mime_part, Horde_Mail_Rfc822_List $recip ) : Horde_Mime_Part	Encrypts a MIME part using S/MIME using IMP defaults.
extractSignedContents ( string $data ) : string	Extracts the contents from signed S/MIME data.
getAdditionalCert ( integer $signkey = self::KEY_PRIMARY ) : string	Returns any additional certificates from the prefs.
getPassphrase ( integer $signkey = self::KEY_PRIMARY ) : mixed	Returns the user's passphrase from the session cache.
getPersonalPrivateKey ( integer $signkey = self::KEY_PRIMARY ) : string	Returns the personal private key from the prefs.
getPersonalPublicKey ( integer $signkey = self::KEY_PRIMARY ) : string	Returns the personal public key from the prefs.
getPublicKey ( string $address ) : string	Retrieves a public key by e-mail.
listPublicKeys ( ) : array	Retrieves all public keys from a user's address book(s).
parseCert ( string $cert ) : array	Extracts the contents of a PEM format certificate to an array.
publicKeyInfo ( string $cert ) : array	Returns information about a public certificate.
signAndEncryptMimePart ( Horde_Mime_Part $mime_part, Horde_Mail_Rfc822_List $recip ) : Horde_Mime_Part	Signs and encrypts a MIME part using S/MIME using IMP defaults.
signMimePart ( MIME_Part $mime_part ) : Horde_Mime_Part	Signs a MIME part using S/MIME using IMP defaults.
storePassphrase ( string $passphrase, integer $signkey = self::KEY_PRIMARY ) : boolean	Stores the user's passphrase in the session cache.
unsetPassphrase ( boolean $signkey = false )	Clears the passphrase from the session cache.
verifySignature ( string $text ) : stdClass	Verifies a signed message with a given public key.

Защищенные методы

Метод	Описание
_encryptParameters ( Horde_Mail_Rfc822_List $addr ) : array	Returns the params needed to encrypt a message being sent to the specified email address(es).
_signParameters ( ) : array	Returns the parameters needed for signing a message.

Описание методов

__construct() публичный Метод

Constructor.

public __construct ( Horde_Crypt_Smime $smime )
$smime	Horde_Crypt_Smime

_encryptParameters() защищенный Метод

Returns the params needed to encrypt a message being sent to the specified email address(es).

protected _encryptParameters ( Horde_Mail_Rfc822_List $addr ) : array
$addr	Horde_Mail_Rfc822_List	The recipient addresses.
Результат	array	The list of parameters needed by encrypt().

_signParameters() защищенный Метод

Returns the parameters needed for signing a message.

protected _signParameters ( ) : array
Результат	array	The list of parameters needed by encrypt().

addAdditionalCert() публичный Метод

Adds a list of additional certs to the prefs.

public addAdditionalCert ( string \| array $key, boolean $signkey = false )
$key	string \| array	The additional certifcate(s) to add.
$signkey	boolean	Is this the secondary key for signing?

addFromPKCS12() публичный Метод

Stores the public/private/additional certificates in the preferences from a given PKCS 12 file.

public addFromPKCS12 ( string $pkcs12, string $password, string $pkpass = null, boolean $signkey = false )
$pkcs12	string	The PKCS 12 data.
$password	string	The password of the PKCS 12 file.
$pkpass	string	The password to use to encrypt the private key.
$signkey	boolean	Is this the secondary key for signing?

addPersonalPrivateKey() публичный Метод

Adds the personal private key to the prefs.

public addPersonalPrivateKey ( string \| array $key, boolean $signkey = false )
$key	string \| array	The private key to add.
$signkey	boolean	Is this the secondary key for signing?

addPersonalPublicKey() публичный Метод

Adds the personal public key to the prefs.

public addPersonalPublicKey ( string \| array $key, boolean $signkey = false )
$key	string \| array	The public key to add.
$signkey	boolean	Is this the secondary key for signing?

addPublicKey() публичный Метод

Adds a public key to an address book.

public addPublicKey ( string $cert )
$cert	string	A public certificate to add.

certToHTML() публичный Метод

Converts a PEM format certificate to readable HTML version.

public certToHTML ( string $cert ) : string
$cert	string	PEM format certificate.
Результат	string	HTML detailing the certificate.

checkForOpenSsl() публичный Метод

Checks for the presence of the OpenSSL extension to PHP.

public checkForOpenSsl ( )

decryptMessage() публичный Метод

Decrypts a message with user's public/private keypair.

public decryptMessage ( string $text ) : string
$text	string	The text to decrypt.
Результат	string	See Horde_Crypt_Smime::decrypt().

deletePersonalKeys() публичный Метод

Deletes the specified personal keys from the prefs.

public deletePersonalKeys ( boolean $signkey = false )
$signkey	boolean	Return the secondary key for signing?

deletePublicKey() публичный Метод

Deletes a public key from a user's address book(s) by e-mail.

public deletePublicKey ( string $email )
$email	string	The e-mail address to delete.

enabled() публичный статический Метод

Return whether PGP support is current enabled in IMP.

public static enabled ( ) : boolean
Результат	boolean	True if PGP support is enabled.

encryptList() публичный Метод

Returns the list of available encryption options for composing.

public encryptList ( ) : array
Результат	array	Keys are encryption type constants, values are gettext strings describing the encryption type.

encryptMimePart() публичный Метод

Encrypts a MIME part using S/MIME using IMP defaults.

public encryptMimePart ( Horde_Mime_Part $mime_part, Horde_Mail_Rfc822_List $recip ) : Horde_Mime_Part
$mime_part	Horde_Mime_Part	The object to encrypt.
$recip	Horde_Mail_Rfc822_List	The recipient address(es).
Результат	Horde_Mime_Part	See Horde_Crypt_Smime::encryptMIMEPart().

extractSignedContents() публичный Метод

Extracts the contents from signed S/MIME data.

public extractSignedContents ( string $data ) : string
$data	string	The signed S/MIME data.
Результат	string	The contents embedded in the signed data.

getAdditionalCert() публичный Метод

Returns any additional certificates from the prefs.

public getAdditionalCert ( integer $signkey = self::KEY_PRIMARY ) : string
$signkey	integer	One of the IMP_Sime::KEY_* constants.
Результат	string	Additional signing certs for inclusion.

getPassphrase() публичный Метод

Returns the user's passphrase from the session cache.

public getPassphrase ( integer $signkey = self::KEY_PRIMARY ) : mixed
$signkey	integer	One of the IMP_Sime::KEY_* constants.
Результат	mixed	The passphrase, if set. Returns false if the passphrase has not been loaded yet. Returns null if no passphrase is needed.

getPersonalPrivateKey() публичный Метод

Returns the personal private key from the prefs.

public getPersonalPrivateKey ( integer $signkey = self::KEY_PRIMARY ) : string
$signkey	integer	One of the IMP_Sime::KEY_* constants.
Результат	string	The personal S/MIME private key.

getPersonalPublicKey() публичный Метод

Returns the personal public key from the prefs.

public getPersonalPublicKey ( integer $signkey = self::KEY_PRIMARY ) : string
$signkey	integer	One of the IMP_Sime::KEY_* constants.
Результат	string	The personal S/MIME public key.

getPublicKey() публичный Метод

The key will be retrieved from a user's address book(s).

public getPublicKey ( string $address ) : string
$address	string	The e-mail address to search for.
Результат	string	The S/MIME public key requested.

listPublicKeys() публичный Метод

Retrieves all public keys from a user's address book(s).

public listPublicKeys ( ) : array
Результат	array	All S/MIME public keys available.

parseCert() публичный Метод

Extracts the contents of a PEM format certificate to an array.

public parseCert ( string $cert ) : array
$cert	string	PEM format certificate.
Результат	array	All extractable information about the certificate.

publicKeyInfo() публичный Метод

Returns information about a public certificate.

public publicKeyInfo ( string $cert ) : array
$cert	string	The public certificate.
Результат	array	Two element array: the name and e-mail for the cert.

signAndEncryptMimePart() публичный Метод

Signs and encrypts a MIME part using S/MIME using IMP defaults.

public signAndEncryptMimePart ( Horde_Mime_Part $mime_part, Horde_Mail_Rfc822_List $recip ) : Horde_Mime_Part
$mime_part	Horde_Mime_Part	The object to sign and encrypt.
$recip	Horde_Mail_Rfc822_List	The recipient address(es).
Результат	Horde_Mime_Part	See Horde_Crypt_Smime::signAndencryptMIMEPart().

signMimePart() публичный Метод

Signs a MIME part using S/MIME using IMP defaults.

public signMimePart ( MIME_Part $mime_part ) : Horde_Mime_Part
$mime_part	MIME_Part	The MIME_Part object to sign.
Результат	Horde_Mime_Part	See Horde_Crypt_Smime::signMIMEPart().

storePassphrase() публичный Метод

Stores the user's passphrase in the session cache.

public storePassphrase ( string $passphrase, integer $signkey = self::KEY_PRIMARY ) : boolean
$passphrase	string	The user's passphrase.
$signkey	integer	One of the IMP_Sime::KEY_* constants.
Результат	boolean	Returns true if correct passphrase, false if incorrect.

unsetPassphrase() публичный Метод

Clears the passphrase from the session cache.

public unsetPassphrase ( boolean $signkey = false )
$signkey	boolean	Is this the secondary key for signing?

verifySignature() публичный Метод

Verifies a signed message with a given public key.

public verifySignature ( string $text ) : stdClass
$text	string	The text to verify.
Результат	stdClass	See Horde_Crypt_Smime::verify().

Описание свойств

$_smime защищенное свойство

S/MIME object.

protected Horde_Crypt_Smime $_smime
Результат	Horde_Crypt_Smime