5) Service Configuration Utility

Starting with version 3.6.1, the Service Configuration Utility is packaged with Pleasant Password Server.

This tool allows administrators to view and configure various components of the Password Server service:

  • Database type
  • Database Connection String
  • Server Port
  • SSL Certificate

Starting the Utility

This utility requires Administrative privileges to run, and is accessible after installation / upgrade through:

  • Start menu -> Programs -> Pleasant Password Server-> Service Configuration

Backup your Connection String

WARNING: Please take great care when using this utility.

  • The default SQLite database is protected using the very secure AES-256 encryption algorithm.
  • The encryption key is stored in the connection string and stored in a protected and encrypted registry key
  • This key is accessible via the Service Configuration Utility

It is not recoverable if lost or deleted. Without the encryption key you cannot access your database.

Follow these instructions:
  • Backup your Connection String to secure location before making any modifications so that you can recover access to your database if something goes wrong.
  • This utility only instructs Pleasant Password Manager on how to connect to the database, but does not make any changes to the database itself.

Note: If the encryption key for your SQLite database is lost or changed, there will be no way to recover data!

Using the Service Configuration Utility

serviceConfMain.png

Currently, the Service Configuration Utility supports configuring the type of database Password Server uses to store your passwords and user information, as well as the database location, the server port that the web service uses to communicate, and the SSL certifcate that is used.

Database Configuration

databaseConf.PNG

The Service Configuration Utility supports changing the connection string and database provider. The default provider is SQLite, but can be changed to either MS SQL or PostgreSQL. If you prefer to use an alternative database provider, you must enter a valid connection string for that type. If you do not know the correct connection string format for your database type, you may be able to find it here:

http://www.connectionstrings.com

Once the Connection String field is set and the appropriate provider selected from the Database Provider drop down menu, click Save Changes to write these settings to the registry.

Port Configuration 

portConf.PNG

The Service Configuration Utility enables changing the port (default: 10001) that Password Server uses for the web service and any client applications. To change the port:

  1. Make sure nothing else is using the port you want to switch to (click Start, type cmd, right-click Command Prompt, click Run as administrator, then run netstat -b -p TCP -q from the prompt and verify that the port you want does not appear in the Local Address column).
  2. Type the port you want into the Port Number field, click Set Port, then restart the Password Server service.

Certificate Configuration

The Service Configuration Utility allows for custom SSL certificates to be imported and used by Password Server. To import an SSL certificate, click Import Certificate and enter the password that was set to protect the private key of your certificate.

Click Clear to revert to the default placeholder certificate (Note: this will not delete anything).

To delete a certificate (optional), use the MMC Certificates snap-in (Computer account, Personal store).

Tag page
You must login to post a comment.