MacOS 10.13 High Sierra Support. Epson will provide macOS 10.13 High Sierra drivers and software for Epson products on an on-going basis. To check for macOS 10.13 High Sierra support for your Epson product, please return to our Support Home page and search for your product.
Installing the PKCS #11 Module
Proxy Server supports Public Key Cryptography Standard (PKCS) #11, which defines theinterface used for communication between SSL and PKCS #11 modules. PKCS #11modules are used for standards-based connectivity to SSL hardware accelerators.Imported certificates and keys for external hardware accelerators are stored in the secmod.db file, which is generated when the PKCS #11 module is installed.The file is located in the server-root/alias directory.
Using the Tool modutil to InstallPKCS #11 Modules
You can install PKCS #11 modules in the form of .jar filesor object files using the modutil tool.
To Install PKCS #11 modules using the Tool modutil
Make sure that all servers, including the Administration Server,have been stopped.
Go to the server-root/alias directorycontaining the databases.
Add server-root/bin/proxy/admin/bin toyour PATH.
Locate modutil in server-root/bin/proxy/admin/bin.
Set the environment.
On UNIX: setenv
LD_LIBRARY_PATHserver-root/bin/proxy/lib:${LD_LIBRARY_PATH}
On Windows, add it to the PATH
LD_LIBRARY_PATHserver-root/bin/proxy/bin
You can find the PATH for your computer listed underserver-root/proxy-admserv/start.
In a terminal window, type modutil.
Theoptions will be listed.
Perform the actions required.
For example, to addthe PKCS #11 module in UNIX, enter:
modutil -add (name of PKCS#11 file) -libfile (yourlibfile for PKCS #11) -nocertdb-dbdir. (your db directory)
Exporting with the tool pk12util
Using pk12util enabless you to export certificatesand keys from your internal database and import them into an internal or externalPKCS #11 module. You can always export certificates and keys to your internaldatabase, but most external tokens will not allow you to export certificatesand keys. By default, pk12util uses certificate and keydatabases named cert8.db and key3.db.
To Export a Certificate and Key From an Internal Database
Go to the server-root/alias directorycontaining the databases.
Add server-root/bin/proxy/admin/bin toyour PATH.
Locate pk12util in server-root/bin/proxy/admin/bin.
Set the environment.
On UNIX:
setenvLD_LIBRARY_PATH/server-root/bin/proxy/lib:${LD_LIBRARY_PATH}
On Windows, add it to the PATH
LD_LIBRARY_PATHserver-root/bin/proxy/bin
You can find the PATH for your computer listed under: server-root/proxy-admserv/start.
In a terminal window, type pk12util.
The options will be listed.
Perform the actions required.
For example, in UNIXtype
pk12util -o certpk12 -n Server-Cert [-d /server/alias][-P https-test-host]
Type the database password.
Type the pkcs12 password.
To Import a Certificate and Key Into an Internal orExternal PKCS #11 Module
Go to the server-root/alias directorycontaining the databases.
Add server-root/bin/proxy/admin/bin toyour PATH.
Locate pk12util in server-root/bin/proxy/admin/bin.
Set the environment.
For example:
On UNIX:
setenvLD_LIBRARY_PATH/server-root/bin/proxy/lib:${LD_LIBRARY_PATH}
On Windows, add to the PATH
LD_LIBRARY_PATHserver-root/bin/proxy/bin
You can find the PATH for your computer listed under server-root/proxy-admserv/start.
In a terminal window, type pk12util.
The options will be listed.
Perform the actions required.
For example, in UNIXenter:
pk12util -i pk12_sunspot [-d certdir][-h “nCipher”][-Phttps-jones.redplanet.com-jones-]
-P mustfollow -h and must be the last argument.
Typethe exact token name including capital letters and spaces between quotationmarks.
Type the database password.
Type the pkcs12 password.
Starting the Server With an External Certificate
If you install a certificate for your server into an external PKCS #11module, for example, a hardware accelerator, the server will not be able tostart using that certificate until you edit the server.xml fileor specify the certificate name as described below.
The server always tries to start with the certificate named Server-Cert.However, certificates in external PKCS #11 modules include one of the module’stoken names in their identifier. For example, a server certificate installedon an external smartcard reader called smartcard0 wouldbe named smartcard0:Server-Cert.
To start a server with a certificate installed in an external module,you must specify the certificate name for the listen socket on which it runs.
Pkcs-11 Module For High Sierra Macos
To Select the Certificate Name for a Listen Socket
If security is not enabled on the listen socket, certificate informationwill not be listed. To select a certificate name for a listen socket, youmust first ensure that security is enabled on the listen socket. For moreinformation, see Enabling Security for Listen Sockets.
Pkcs-11 Module For High Sierra Mackerel
Access either the Administration Server or the Server Managerand click the Preferences tab.
Click the Edit Listen Sockets link.
Click the link for the listen socket that you want to associatewith a certificate.
Select a server certificate from the Server Certificate Name drop-downlist for the listen socket and click OK.
The list contains allinternal and external certificates installed.
You could also requirethe server to start with that server certificate instead, by manually editingthe server.xml file. Change the servercertnickname attribute in the SSLPARAMS to:
$TOKENNAME:Server-Cert
To find what valueto use for $TOKENNAME, go to the server’s Securitytab and select the Manage Certificates link. When you log in to the externalmodule where Server-Cert is stored, its certificates are displayed in thelist in the $TOKENNAME:$NICKNAME form.
If youdid not create a trust database,one will be created for you when you request or install a certificate foran external PKCS #11 module. The default database created has no passwordand cannot be accessed. Your external module will work, but you will not beable to request and install server certificates. If a default database hasbeen created without a password, use the Create Database page on the Securitytab to set the password.