PASSPORTAL PLUGIN DOCUMENTATION

Transcription

1 Contents Requirements... 2 Install or Update Passportal Plugin Solution Center... 3 Configuring Passportal Plugin... 5 Client mapping... 6 User Class Configuration... 7 About the Screens... 8 Passportal Tab... 8 View Password... 9 Create Password Import Passwords Windows Directory Agent About Installing the Windows Agent Change Log Known Issues... 16

2 Requirements The Passportal Plugin has been designed with the Following Assumptions and Minimum or Maximum requirements. The Plugin is designed for, and will only install on LabTech 10.5 Systems or above

3 Install or Update Passportal Plugin Solution Center WARNING: Installing or Updating the Passportal Plugin will cause the LabTech Database Agent to immediately restart which will terminate any scripts that are currently running. Before Installing the Plugin ensure that all scripts have completed. For additional information, refer to View Running Scripts. 1. Launch the Solution Centre and Navigate to Security Solutions and add Passportal to the installation queue. 2. Install the Plugin

4 3. Navigate to the Plugin Manager (Help > Plugin Manager) and Locate the following two plugins and right click and select enable a. Passportal Plugin b. Passportal Plugin Remote Agent 4. Reload the Database Agent Settings by going to Advanced > Reload Plugins > Update Remote Agent Plugins. 5. Reload the LabTech Control Center and continue to Configuring Passportal Plugin

5 Configuring Passportal Plugin Ensure that you have restarted the LabTech Control Center after installing or updating the Passportal Plugin. 1. Navigate to the System Dashboard > Config > Integration > Passportal. 2. Specify your Passportal Server Instance and Organization Passphrase 3. Save Settings and continue to Client mapping.

6 Client mapping 1. Select client mapping on the left side of the Passportal Tab, you will be prompted to Authenticate with Passportal. NOTE: This creates a permanent link between the specified Passportal account and the user account in which you are logged into LabTech Control Center. 2. Assign each LabTech client a Passportal client to create a link between Passportal and LabTech. Auto Map will attempt to match Passportal Clients to LabTech clients based on Client Name. 3. Save the client mapping settings and close window.

7 User Class Configuration LabTech 10.5 has introduced Plugin Permissions, to ensure that your LabTech users have visibility to the Passportal Plugin you will need to configure these permissions for each User Class you wish to access the Passportal Plugin. 1. Navigate to Tools > User Class Manager 2. Select the User Class which you wish to Modify and then Select the Plugin Tab / Section. 3. Check the Access box alongside Passportal Plugin 4. Expand the Passportal Plugin section and grant access to specific functions within the plugin. 5. Close the Window. NOTE: users will need to reload the LabTech Control Center for these changes to take effect.

8 About the Screens PASSPORTAL PLUGIN DOCUMENTATION Passportal Tab The Passportal tab will contain a list of all Passwords stored in Passportal which are linked to this particular Client, this tab is available on the following screens Client Screen Location Screen Computer Screen Option Description Create new password entry Perform action against all selected passwords Change view type Import passwords to Passportal from LabTech Refresh password List Option Description View password Copy password s username value to clipboard Copy password to clipboard Edit Password Disable / Deactivate Password Enable / Activate Password

9 View Password This screen is displayed when viewing a password. Option Description Copy to clipboard Launch URL

10 Create Password When creating a new password entry from the Password list you will be presented with this screen. Required Fields Client Username Credential Type Option Description Add new entry Cancel entry creation and swaps back to selection list Launch URL Generate random password

11 Import Passwords When importing passwords from LabTech to Passportal you will be presented with this screen which will show you all passwords that exist in LabTech for the client that have not yet been imported. Select which passwords you would like to import and assign a credential type and then select Import selected.

12 Windows Directory Agent About The Passportal Plugin allows you to deploy the Windows Agent (formerly known as the Active Directory Agent) which allows you to monitor or administrate passwords in a Windows Environment, the agent will run as a service on the device specified and periodically sync with Passportal. The Sync runs on a one Client to one Device relationship and can run in one of two modes. 1. Report Mismatches, this mode is a passive monitoring mode. It will attempt to match username/password pairs in Passportal with their equivalent usernames and passwords on the device. If there are any discrepancies (such as the password being changed) then the tool will flag that password entry. The flag will appear on the password, the client and on the dashboard on the Passportal website prompting Passportal users to change the password. 2. Change Password, this mode directly changes passwords on the device. When a password mismatch is detected it will change the password to match the password in Passportal. This allows Passportal users to easily push password changes.

13 Installing the Windows Agent 1. Navigate to the Passportal tab on the Client, Location or Computer Screen and click on the Install Windows Agent icon. 2. Depending on the configuration, you may be prompted to enable Windows Directory Services Sync for this client, you ll need to enable this before being able to proceed.

14 3. You ll be prompted to enter your Passportal credentials these are required for the installation of the agent and will be validated against the Passportal system. 4. Once the credentials have been validated you ll be prompted to complete a few additional details to allow the successful installation of the Windows Agent.

15 Change Log Version: August 31 st, 2016 New Features PASSPORTAL PLUGIN DOCUMENTATION Ability to install the Passportal Active Directory Agent o Addition of a remote agent plugin component has been added to support this. Ability to view disabled passwords o Ability to re-enable disabled passwords The with Selected option on the Password list has been expanded and now supports o Changing of Credential Type o Enable / Disable Password Ability to generate a random password on the create / edit password window Ability to specify AD Sync type for passwords on the create / edit password window An Options menu has been added to the bottom right of the Password list and contains o Logout from Passportal o View Disabled / Enabled Passwords o Launch Passportal Website Bug Fixes / Changes Updated Icon set & UI Clean-up Additional Error checking to attempt to prevent issues loading details from Passportal Active Directory Sync information is now shown by default on the Password List Resolved UI Issues with window Resizing Resolved UI issues with the Passportal window in LabTech 11 on the Computer Screen When Importing password from LabTech the Credential type will default to Imported Passwords When the stored passphrase is changed all user will be required to re-authenticate with Passportal Updated all Passportal API Requests to remove some inconsistent results Version: April 20 th 2016 Resolved an Issue the Passportal Tab / Section displaying incorrectly within LabTech 11 on the Computer Screen Added the ability to logout from Passportal from the Passportal Tab on the Computer, Location and Client Screens When Updating / Changing the Passphrase on the System Dashboard the Plugin will forcefully logout all users, they will be prompted to re-authenticate the next time they interact with Passportal. When importing passwords to Passportal the Credential Type will now default to Imported Password rather than requiring manual selection for each password, feel free to change these as required. Resolved an issue with searching the password list that could in rare situations result in a passwords being hidden from view.

16 Version: February 11 th 2016 Fixed an issue with incorrect text being displayed in the Plugin Manager when installed using the Solution Center. Version: February 10 th 2016 Initial Release Known Issues System Dashboard There is a limit of 500 items that can be returned for the following a. Passportal Clients b. Passwords c. Password Folders d. Password Credential Types