Install a Site Certificate

To install an intermediate Site certificate, use arguments from the table below.

Argument

Description

Possible Values

--address

Address of the MFP (required)

 

--deviceuser

The account to use for authenticating into the device (required)

 

--devicepassword

The password of the account for authenticating into the device

 

--onlyssl

Allow only an SSL connection to the device.

  • If false: The Tool will attempt to connect using SSL and if a connection cannot be made, it will attempt a non-SSL connection. The Tool will not validate certificates when communicating via SSL.

  • If true: The Tool will only attempt to connect using SSL. To connect to a device, it must already have been configured with a certificate for SSL communications.

true, false (default: false)

--certvalidation

Used only when “onlyssl” is set to true. If “certvalidation” is also set to true, a connection to the device will only be established if the SSL certificate can be validated as a trusted certificate. Trusted Root Certificates are managed through the built-in Windows Certificate Management.

true, false (default: false)

--certfile

The location of the certificate file. If not specified, the tool will attempt to read the certificate contents from standard input.

 

Please note that some devices require a PKCS7 certificate while others request a Base64 encoded PEM.

Sample Output - Success

Starting device session

Locking device

Reading certificate file

Installing site certificate

Unlocking device

Ending device session

Sample Output – Success reading from standard input

Starting device session

Locking device

Reading certificate from standard input

Installing site certificate

Unlocking device

Ending device session

 

Sample Output – Invalid file format sent to MFP

Starting device session

Locking device

Reading certificate file

Installing site certificate

Failed to install site certificate. Error code: 4, Message: An error occurred communicating with the device

Unlocking device

Ending device session