Personal tools
Namespaces

Variants
Actions

Password Manager For WHMCS

From ModulesGarden Wiki
Revision as of 08:29, 4 March 2022 by Karolina (Talk | contribs)

Jump to: navigation, search


Contents

About Password Manager For WHMCS

Password Manager For WHMCS gives you the possibility to store passwords and share them safely with your staff and clients.

The module offers various mechanisms allowing you to smoothly manage valuable data such as passwords or licenses, in case of resellers, send email reminders, or integrate with your WHMCS client area.
Owing to implementation of advanced two way encryption, Password Manager For WHMCS provides a high security level for your and your customers' critical data.

  • Administrator Area Features:
✔ Create Private Access Details
✔ Share Access Details With Clients & Administrators
✔ Display Clients Access Details In Clients Summary And Clients Tickets
✔ Define Access To Clients Access Details:
✔ Full Access - Any Administrator Can View Any Password
✔ Restricted Access - Allowed Administrators Can View Any Password
✔ Shared Access - Allowed Administrators Can View Shared Passwords
✔ Store All Access Details In Encrypted Format
✔ Add Notes To Password
✔ Set Direct Links To Website Or Login Page With Password Used
✔ Display Password Owner
✔ Toggle Availability Of Private Passwords And Product Passwords For Clients
✔ Forbid Password Management For Chosen Clients/Client Groups
✔ Exclude Products/Product Groups From Being Displayed
✔ Allow Clients To Set Master Password For Owned Passwords
✔ Define Client Passwords Limit Per User
✔ Adjust Lenght And Characters For Random Password Generation
✔ Notify Upon Password Change
✔ Send Password Change Reminder
✔ Define Email Templates For Reminder And Notification
✔ Define Time Period For Password Change Reminder
  • Client Area Features:
✔ Display And Manage Access Details
✔ Display And Add Additional Access Details Of Owned Services
✔ Generate Random Passwords
✔ Share Access Details With Administrators And Clients
✔ Create Shared Categories
✔ Assign Categories To Access Details
✔ Restrict Access To Owned Passwords Using Master Password
✔ Restrict Contacts Access To Passwords
  • General Info:
✔ High-Level Security With Advanced Two-Way Encryption
✔ Multi-Language Support
✔ Supports PHP 7.2 Up To PHP 7.4
✔ Supports WHMCS Themes "Six" And "Lara"
✔ Supports WHMCS V7.10 And Later
✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install Password Manager For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.
PM1.png
2. In the downloaded file you might find one or two packages that support different PHP versions.

In the most recent versions of the module, you will find only one package that supports PHP 7.2 and later.

PHP72 74.png
Previous updates of the module may contain two packages dedicated to various PHP versions.

The first one that supports PHP 5.6 up to PHP 7.1, and the second one addressed to PHP 7.2 up to PHP 7.4.
Note: Keep in mind that PHP versions 5.6 up to 7.1 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

PHP56 74.png
Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.
3. Extract the package and upload its content into the main WHMCS directory.

The content of the package to upload should look like this.

Ftyrtr.png
4. When you install Password Manager For WHMCS for the first time you have to rename 'license_RENAME.php' file.

File is located in 'modules/addons/PasswordManager/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

PM3.png
5. In order to configure your license key, you have to edit a previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

PM4.png
6. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS administrator area. Go to 'System Settings' 'Addon Modules'.
Afterwards, find 'Password Manager' and press 'Activate' button.

PM5.png
7. In the next step you need to permit access to the module.

To do so, click on 'Configure' button, select administrator groups which should have access to this addon and press 'Save Changes'.

PM6.png
8. You have just successfully installed Password Manager For WHMCS!

You can access your module under 'Addons' 'Password Manager'.

PM2 7.png

Configuration and Management

Password Manager For WHMCS allows to share passwords in your WHMCS.

In this short guide we will present you the possibilities of our module.

Configuration

Before you start your work with our Password Manager For WHCMS, please move to 'Settings' tab, where you will configure access restrictions to products
passwords, define email notifications and manage security settings.

Client Product Password

First of all, decide whether you wish to allow to display a full list of client's products and services login details by selecting option: 'Client Product Password'.
If enabled, access details to client's products and services will be displayed in the client area → 'Password Manager'.

'Exclude Client Groups' - enter any client group name to disable product's access details from being displayed for clients in these groups.
'Exclude Clients' - disable product access details for pointed here clients.
'Exclude Product Groups' - enter any product group names, to which access details will not be shown.
'Exclude Products' - access details for products, which are entered here, will be disabled.

PM2 10.png

Client Private Passwords

The next section is dedicated to the management of private passwords of clients.
If you wish to allow your clients to manage their personal access details, select the 'Client Private Passwords' option.
Your clients can be also permitted to set their own 'Master Password' to provide additional protection for their stored passwords. Next, move to the specific configuration:

1. 'Exclude Client Groups' - disable private access details management for selected here client groups.
2. 'Exclude Client' - disable management of private access details for pointed here clients.
3. 'Passwords Limit Per User' - set up the limit of private access details for one client.
4. 'Exclude Client From Limit' - enter clients for which the set up above limit will not be effective.

PM2 11.png

Email Notifications

This section allows you to define email notification templates that will be sent by the module on specific actions to clients and administrators.

1. 'Password Change Reminder' - select an email template that will be used to remind clients or administrators about the need to change the password.
2. 'Password Change Notification' - select an email template that will be used to notify clients and about a password being changed.
Please note that you have to select templates for clients and administrators separately. If you want to disable any of the notification, simply select 'Unassign' from dropdown menu.

PM2 11 1.png

Security Settings

Under 'Security Settings' tab, you have to define the level of access to clients' passwords for administrators and grant them extended permissions.

You may grant your administrators:

  • Full access to clients' passwords - any administrator will be allowed to view clients' passwords
  • Restricted access - only administrators with chosen roles will get the access to the passwords
  • Shared access - only passwords marked as 'Shared' will be visible for chosen administrator roles.

You may also select here administrators group which will be granted 'Extended Permissions'.
It means that administrators from this group will be allowed to view clients access details when 'Visibility For Administrators:' is checked.

PM2 11 2.png

Other

In the very last section you may manage additional options that 'Password Manager For WHMCS ' has to offer.
  • Password Manager Button - select to enable access to 'Password Manager' for your clients in their client area
  • Profile Tab - select this option to add 'Passwords' tab in the client's profile in the administrator area
  • Support Tickets Tab - if you select this option, Passwords' tab will be available on the support tickets site.
  • Password Random Characters - define a set of characters to be used for random passwords generation
  • Password Strength - define the length of randomly generated passwords
  • Contacts Permissions - select to allow clients to control permissions for access to their passwords for their contacts
  • Hide Guide - enable or disable the guide shown in 'Dashboard'


Do not forget to save the changes when you finish the settings configuration.

PM2 11 21.png

Categories

Categories allow you to prepare predefined sets of clients and administrators.

Through assigning a category to a password, clients and administrators from that category are granted the permission to view this password.
Move to 'Categories' → 'Administrator Categories' where you can add new sets, press 'Add Category' to begin.

PM2 11 3.png
Now, fill out the form with category name and description.

Assign desired clients and administrators to the category and press 'Add'.

PM2 11 4.png
The list of administrator categories with any details such as the number of clients in it and administrators allowed to access the details is now visible.
You may always edit the category or delete if needed. Use the action buttons to do so.
PM2 11 5.png

Access Details

'Access Details' section includes a list of provided access details. Here you can create new access details and decide who can view them.

Press 'Add New' to begin.

PM2 11 6.png
Fill in 'Name', enter access details into 'Username' and 'Password'.

You can also make your logging in easier through entering website URL and website log in URL consecutively into 'Website URL' and 'Log In URL'.
To leave a note associated with access details you are creating, type it into 'Note' textbox.
Move to 'Sharing' part to continue.

PM2 12.png
In this section choose 'Category' and select 'Administrators', 'Administrator Groups' and 'Clients' who should have access to this details.

Note: There is disjunction relation between 'Administrators' and 'Administrator Roles'.
For example, if you assign administrators X and Z and administrator role Y in which administrator X is, then all administrators assigned to group Y will see these access details together with administrator Z.
Here, you may also allow clients to edit or delete these details, simple mark 'Permissions' checkbox. 'Permissions' allows you to define clients/administrators/category members privileges.
Note: If you leave 'Clients' checkbox unmarked, your client will not see these access details even if they are chosen in 'Clients' option.
When ready, proceed to 'Notifications' section.

PM2 13.png
Finally, you can set up notifications rules.

'Send Password Change Notification' - message is sent upon password being changed.
'Password Reminder' - a notification is sent to remind about the necessity to change the password for security reasons.
You can inject passwords into each of them through marking adequate checkboxes.

Press 'Add' button to finish the process and confirm creation of access details.

PM2 14.png

Access Details List

On the list of access details you will see some basic info, such as ID and name, username and password with the possibility to view the password.
PM2 16.png
There is also information on the access details owner and administrator groups allowed, number of clients allowed and category assigned
(press the category to see who exactly is in it). Finally, you can check set up edit permissions.
PM2 17.png
Use action buttons to manage the entered access details.

1. Log into your website (if URL has been provided)
2. See access details
3. Edit access details
4. Delete access details

PM2 15.png

Contacts

In 'Contacts' , you can see and manage the permissions of clients' contacts/sub-accounts with regard to the access they shall have to the clients' passwords.
PM2 33.png
If you want to change any permission, simply click the 'Edit' action.
PM2 34.png

Dashboard

A short summary on the clients' and administrators' access details and categories is available on the dashboard.
PM2 16 1.png
The last tab in the addon is 'Documentation'. When pressed, it redirects you to this very site.
PM2 16 2.png

Administrator Area Integration

Our module integrates with your administrator area as well as client area.

Passwords of any client can be viewed in summary page as it is shown below, but only if you enable this option in 'Settings' section in the addon.
You may add new passwords directly from this site, simply press 'Add New' and you will be moved to the 'New Access Details' form.

PM2 17 1.png
Your support operators are also able to access clients passwords from within ticket.

As you may have noticed, these places allow them not only to see passwords, but also create new ones.
Note: this tab is available only if option has been enabled in the addon.

PM2 17 2.png

Client Area

Your clients can access client area password management page through 'Password Manager' button in navigation bar.

To allow integration with client area, a proper option must be enabled in 'Addon' → 'Settings' → 'Other'.

PM2 18.png
In 'Password Manager', your clients can view access details depending on the settings configured by the administrator and level of access allowed for the client.
Underneath you can see a client's area with full access to any option given.

As you can see, there are five sections available: 'Owned Passwords', 'Shared Passwords', 'Product Passwords' , 'Categories' and 'Contacts'.

PM2 19.png

Owned Passwords

If you enabled 'Client Private Passwords' your clients will be allowed to view, manage and create their own access details.

Please note that 'Shared' column with information on whether the details are allowed for administrators or not is available only if you select 'Shared Access' in the addon's settings.

PM2 20.png
Preview the password and use action buttons to manage the access details:

1. Log into URL
2. See the details
3. Edit the details
4. Remove the access details

PM2 21.png

Add Access Details

To create access details, press 'Add New' button as shown on the following screen.
PM2 22.png
Type the new password name and enter access details into 'Username' and 'Password'. You can also generate random password.

Optionally, provide 'Website URL' and 'Log In' URL to be allowed to log into your site directly from 'Password Manager' page.
Leave a note if you need.

PM2 23.png
You may now move to 'Sharing' section. There, you can decide which category the new access details will be assigned to.
Choose one from the dropdown menu or select 'Unassign' to leave it without any category. Depending on the category you select, the access details will be available for those specified in its configuration.

Additionally, define which actions can be made on shared passwords.
Moreover, you can specify custom email addresses to share your credentials with other customers.

PM2 24.png
Finally, in ' Notifications' section, set up conditions of delivering password notifications. Enable this option if needed and define when the reminders should be sent.
You can also define whether you wish to receive the new password in the message.

Do not forget to press 'Add' to finish.

PM2 25.png
If the administrator has enabled the 'Master Password' option in 'Client Private Passwords' , the clients will have the ability to set an additional protection for their owned passwords.
PM2 35.png
Simply provide and confirm a new password that will protect the access to owned passwords.

Note - if you lose or forget this password, you will also lose the access to your saved credentials in this section!

PM2 36.png
From now on, access to the 'Owned Passwords' section will require the master password.
PM2 37.png

Shared Passwords

Under 'Shared Passwords' your clients can view and manage access details that administrators shared with them, gave permission to view.
PM2 26.png
Preview the password and use action buttons to manage the access details:

1. Log into URL if it has been provided
2. See the details
3. Edit the details (General/Sharing/Notifications)
4. Remove the details

PM2 27.png

Product Passwords

'Product Passwords' section includes any access details to your client's products that they own.
For convenience, clients can also assign additional passwords to selected services similarly like in 'Owned Passwords' section.

Remember that as an administrator, you have to enable this option in the 'Addon' → 'Settings'→ 'Client Product Password'.

PM2 28.png

Categories

Move to 'Categories' tab. There is a list of created by the client categories which are used to allocate passwords for sharing.

To create a new one, press 'Add Category' button.

PM2 29.png
Fill in category name and description and press 'Add'.

Created category can be seen by this client as well as administrators in the administrator area.

PM2 30.png
Clients may edit their categories, delete and add new ones any time they wish.
PM2 31.png
Any categories created by clients will be automatically visible for administrators in the addon where you can manage them.
PM2 32.png

Contacts

If the clients have contacts/sub accounts, their access can be restricted to the selected sections of Password Manager.

To proceed, just select the contact and press Edit.

PM2 38.png
In the opened window, select which sections chosen contacts may have access to.
PM2 39.png

Tips

1. Any additional options under 'Addons' → 'Passwords Manager' → 'Settings' → 'Other' are by default enabled on the module activation.
If you change any of these settings you will loose access to some of the module's functionalities.
2. Password Manager For WHMCS ensures full protection of your access details using its own security tools and WHMCS internal two way encryption system.
Note: custom encryption key is stored in 'configuration.php' file.
3. As this module supports templates system, any changes made in the module's templates files will be saved after the upgrade process.
4. Password Manager For WHMCS module is a perfect solution for all resellers whose aim is to provide licenses to their clients in the most secure way possible.

Update Instructions

Essential guidance through the process of updating the module is offered here.

Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!
To take advantage of it, simply use the License Upgrade button located on the product's page and a discounted invoice will be generated automatically.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Password Manager For WHMCS