Integrating SIGN+ using Native Tools

SIGN+ Installer

AppViewX SIGN+ Installer is a utility executable included in the SIGN+ Package. It installs the prerequisites needed to use AppViewX CSP and PKCS#11 Provider with various native signing tools. This installer manages the necessary configurations and libraries, and it dynamically generates README files with the required usage commands for different tools.

SIGN+ Installer Usage

Windows

Prerequisites : Administrator Privileges

Extract the SIGN+_Package.zip and open the extracted folder.
Run SIGN+_Installer.exe as an Administrator.
Enter the AppViewX/AD Password or oAuth Client Secret to install the prerequisites for using AppViewX CSP/PKCS#11 provider with native signing tools.

Linux

Extract the SIGN+_Package.zip and open the extracted folder.
Use the following command to provide execution permissions to the SIGN+_Installer executable file.
```
chmod +x <path_to_SIGN+_Installer>
```
Execute the SIGN+_Installer executable using the following command.
```
./<path_to_SIGN+_Installer>
```
Enter the AppViewX/AD Password or oAuth Client Secret to install the prerequisites for using PKCS#11 provider with native signing tools.

MacOS

Extract the SIGN+_Package.zip and open the extracted folder.
Use the following command to provide execution permissions to the SIGN+_Installer executable file.
```
chmod +x <path_to_SIGN+_Installer>
```
Execute the SIGN+_Installer executable using the following command.
```
./<path_to_SIGN+_Installer>
```
Note: If the executable is blocked from running on macOS, go to System Settings > Privacy & Security > Security, locate SIGN+_Installer, and click "Allow Anyway" to proceed with execution.
Enter the AppViewX/AD Password or oAuth Client Secret to install the prerequisites for using PKCS#11 provider with native signing tools.
The PKCS#11 library for macOS is compiled for x64 architecture to maintain backward compatibility. Therefore, when using PKCS#11 with other tools on ARM-based Macs (M-series), make sure to download and use the x64 versions of the respective tools (e.g., Jarsigner, Java) for signing.

Note: When executing the Installer from a newly downloaded package, if a previous installation with the same configuration (same connector URL) exists on the machine, you will see the message:

“An installation already exists with the existing configurations. Do you want to update the existing configurations along with the newly downloaded policies? Enter 'yes' or 'no':”

Enter “Yes” to add the signing policies from the newly downloaded package to the previous installation.
Enter “No” to overwrite the previous installation with the signing policies from the newly downloaded package.

SIGN Installer Functionalities

Help - Usage

Sample Command and Output

"SIGN+_Installer.exe" -h


SIGN+ Installer Usage:

  Valid Commands:
        SIGN+_Installer --password <password> --overwriteInstallation <yes|no>
        SIGN+_Installer UpdatePassword
        SIGN+_Installer Uninstall
        SIGN+_Installer --help

Silent Installation - Usage

Windows

SIGN+_Installer.exe --password <password> --overwriteInstallation <yes|no>

Linux and MacOS

./SIGN+_Installer --password <password> --overwriteInstallation <yes|no>

The above command can be used to install the SIGN+ Package in non-interactive mode by providing the password (for user-based authentication) or Client Secret (for OAuth-based authentication) and specifying 'yes' or 'no' to override the previous installation.

UpdatePassword - Usage

The UpdatePassword option in the SIGN+_Installer executable allows you to update the password or Client Secret of the existing installation.

Windows

SIGN+_Installer.exe UpdatePassword

Linux and MacOS

./SIGN+_Installer UpdatePassword

Sample Command and Output

Updating Password for Username/Password based Authentication.

"SIGN+_Installer.exe" UpdatePassword


Updating AppViewX/AD Password

Enter your Current AppViewX/AD password :  ********

Enter your New AppViewX/AD password     :  ********
Confirm your password                   :  ********

Updated Configuration File Successfully

Password Updated Successfully

Updating Client Secret for oAuth based Authentication.

"SIGN+_Installer.exe" UpdatePassword
Updating Client Secret

Enter your Current Client Secret :  ***********

Enter your New Client Secret     :  ************
Confirm your Client Secret       :  ************

Updated Configuration File Successfully

Password Updated Successfully

Uninstall - Usage

The Uninstall option in the SIGN+_Installer executable can be used to clean up the SIGN+ installation by removing the library files, configuration files, and log files.

Sample Command and Output

"SIGN+_Installer.exe" Uninstall
AppViewX SIGN+ Uninstaller


Deleting Configuration Files..
Deleting Library Files..
Deleting Temporary Log Files..

Uninstallation Successful

Press Enter key to exit...