GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
OpenXPKI::Crypto::Backend::OpenSSL::Engine(3) User Contributed Perl Documentation OpenXPKI::Crypto::Backend::OpenSSL::Engine(3)

OpenXPKI::Crypto::Backend::OpenSSL::Engine

This class is the base class and the interface of all other engines. This defines the interface how HSMs are supported by OpenXPKI.

The constructor supports the following parameters:
  • OPENSSL (the OpenSSL binary)
  • NAME (a symbolic name for the token)
  • KEY (filename of the key)
  • PASSWD (sometimes keys are passphrase protected)
  • CERT (filename of the certificate)
  • INTERNAL_CHAIN (filename of the certificate chain)

tries to set the passphrase for the used token and checks the passphrase for its correctness. If the passhrase is missing, shorter than 4 characters or simply wrong then an exception is thrown. There is no parameters because we get the passphrase from the OpenXPKI::Crypto::Secret object.

Examples: $engine->login ();

enforces the logout form the token.

returns true if the token is usable for non-pivate-key operations.

returns true if the private key is usable.

returns the operational mode of the engine (standby, session or daemon).

returns the used OpenSSL engine or the empty string if no engine is used.

returns the OpenSSL engine section from the configuration or the empty string if no engine is used or the engine section is empty.

returns the OpenSSL engine_usage section from the configuration or the empty string if no engine is used or the engine_usage section is empty.

returns the OpenSSL key_store section from the configuration.

returns as hash with some information on the key (name, storage, secret avail)

returns the name of the private key. In case the key is stored in the datapool, this returns the name of a tempfile holding the key blob.

returns the passphrase if one is present.

returns the filename of the certificate.

returns the filename of the internal (CA specific) certificate chain.

returns "e" or "engine" if the key is stored in an OpenSSL engine.

returns the wrapper around the OpenSSL binary if such a wrapper is used (e.g. nCipher's chil engine). Otherwise the empty string is returned.

returns the parameters for the engine which are needed for the initialization. This is a simple string.

expects a scalar with the complete error log inside. It returns the error log but without all normal stuff which is generated by the used engine. The function is used to filter false error messages from STDERR.

expects a scalar with the complete output inside. It returns the output but without the noise which is generated by the used engine. The function is used to filter engine specific messages from STDOUT.
2022-05-14 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.