5) Service Configuration Utility

(Version 3.6.1+)

The Service Configuration Utility packaged with Pleasant Password Server, allows administrators to configure various service components, which include:

  • Database Type: stores your passwords and user information
  • Database Location: where this is stored
  • Encryption Key: protective security measure
  • Server Port: which the web service uses to communicate
  • TLS/SSL Certificate: defaulted to a placeholder 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

Service-Config-Utility-Main-pic.png

Backup your Connection String

(SQLite Databases)

Before making any modifications, backup your connection string: so that you can recover access to your database if something goes wrong. This contains the database connection parameters & the encryption key.

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.

Service-Config-Utility-pic.png

  • Store the entire contents of the Connection String field in a secure backup location, so that you can recover access to your database if something goes wrong. It's possible to expand the width of this window to see all text.
  • Note: This utility only instructs Pleasant Password Manager on how to connect to the database, but does not make any changes to the database itself.

Related topic: Database Backup and Restore

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

Database Configuration

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:

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 

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

portConf.PNG

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.