Prerequisites

• Ensure you have access to Hudu as an Admin or Super Admin Role.
• Hudu Version needs to be 2.1.5.7 or higher

Enable Hudu Integration

1. As an Hudu Administrator, log in to Hudu and navigate to Admin > API
   
   
2. On the Create API Key Screen type in a name such as Quickpass-Integration, select the Passwords Access and Can Perform Desctructive Actions? boxes.
   
3. Copy the newly generated API Key (note characters on the Key Creation screen will be obscured after a 5 minute period so ensure you copy them before that time out period expires)
   
4. Log in to the Quickpass admin website at https://admin.getquickpass.com using your Quickpass Administrator account.
5. Click Integrations in the left-hand menu.
   
6. In the Integrations page, click the Hudu logo.
   
   
7. You will be prompted to enter the API key you created earlier in Hudu. Paste in the API key and enter the Domain Name for the URL that you use when logging into the Hudu Portal.
   
8. Click Connect to complete the Process.
9. If properly connected to Hudu the Logo Box will show with a checkmark in the top left corner
   
   
   After the API for Hudu is connected to Quickpass, you can begin to either import Hudu Companies to create new Quickpass customers or match existing Quickpass customers with Hudu Companies.

Hudu Integration Options

• If you have never used Quickpass and have no pre-existing Quickpass customers, proceed to Option 1 - Import Hudu Companies as New Quickpass Customers.
• If you have pre-existing Quickpass customers, proceed to Option 2 - Matching Hudu Companies to Existing Quickpass Customers.
  
  

Option 1 - Import Hudu Companies as New Quickpass Customers

Importing Hudu Companies

1. In Quickpass, click Integrations in the left-hand menu.
   
2. Click the Hudu Logo and then Match Customers in the top-right corner.
   
3. In the Match Customers screen, look for the Create New/ Manual Match section of the page.  Then either click the "All" link below the Quickpass icon to select all Hudu Companies  or individually select which Hudu Companies you wish to have created in Quickpass. 
   
4. The matched Quickpass customer(s) and Hudu Companies will show in the Hudu Customers screen.
   
5. In the Customers screen you will now see a Hudu logo for the Quickpass Customer in the Integrations column.
   

Option 2 - Matching Hudu Companies to Existing Quickpass Customers

1. This section assumes you have manually created a customer by clicking the Add New Customer link on the Customers Section of the Dashboard, entered the Customer Name, and clicked the Create button.

2. Click Integrations in the left-hand menu and then click the Hudu logo in the Integrations page.

3. Click the MATCH CUSTOMERS button on the top-right of the screen
   
   1. If the Quickpass Customer Name has an exact match to the name of the Hudu Companies, the Automatch section will automatically be populated with the matching companies.
      
      
      
   2. If the Quickpass Customer Name does not have a exact match to the name of a Hudu Company,

      You can use the "Search Hudu Companies" to filter the list or manually scroll through the list of Companies.

      Search for and then Drag the Hudu Companies from the left-hand side over to the corresponding Quickpass Customer on the right-hand side. The organization will turn green in the IT Glue Customer column. 
      
      

   3. Click Add 

4. When done click the Back to Integrations link in the top left of the screen. 

   You will now see the linked Hudu Company with Quickpass Customers on the Customers page
   

5. Note: After a new Quickpass customer has been created you have the choice of using the Customer with Active Directory, Local Accounts, and Office 365.

    

   Downloading and Installing the Server Agent on Customer Systems

   1. Refer to this KB Article https://support.getquickpass.com/hc/en-us/articles/360035206994-How-to-install-the-Server-Agent-Manual-and-Silent

    

   Setting up Office 365

   1. If you wish to setup Office 365 follow this KB article https://support.getquickpass.com/hc/en-us/articles/360039678373-How-to-Connect-a-Azure-Office-365-tenant-to-Quickpass-Customer 

    

   Then return to this article and proceed to the section titled Import Accounts from Active Directory, Local Accounts, or Office 365 to Quickpass.

    

    

   Import Accounts from Active Directory, Local Accounts, or Office 365 to Quickpass

   NOTE: An Automatic Process has been developed to import LOCAL Administrator accounts.  See this Article for details.

   1. Select the Customer you wish to import accounts from in the Customers screen. 

   

   2. Click the Accounts menu of the account type you wish to match to Hudu on the left-hand menu.

   

   3. Click + ADD ACCOUNTS in the top-right corner and select Manual Import

   

   4. If you have both Active Directory and Office 365 connected to the same Quickpass customer you will see an option to import Active Directory, Local Accounts or Office 365 accounts.   Select the appropriate directory source you wish to import accounts from.  (Note this does not appear if you have selected the Password Sync: On option for Office 365)

   

   5. If you selected Active Directory, select the Organizational Unit (OU) where your admin user(s) are located in Active Directory.

   Note: Only OU's with user objects will appear on this screen. 

   

   6. Select the Accounts from Active Directory that you want to import into Quickpass. 

   

   7. Click Add in the top-left corner to import the users. Those accounts will now be imported as Administrator Accounts.

   

   8. If you selected Office 365 Administrator Accounts you will be taken directly to the screen to select any Office 365 Administrator accounts you may have.
      
      
      Select the account(s) you want to import into Quickpass and click the Add button in the top left.  Those accounts will now be imported as Administrator Accounts.
      
      
   9. If you selected Local Accounts, you will be taken to a screen to select the name of the systems that have the agent installed on them.  Note:  This option will only appear if you have the agent installed on AD Member/Workstation or Standalone Server/Workstation.
      
      
      You will then be shown a screen with all of the local accounts on that device.
      
      
      Select the accounts you want to import into Quickpass and click the Add button in the top left.  Those accounts will now be imported as Administrator Accounts.
      For additional details on linking Local Administrators and Local User accounts to Hudu please see: How to Import Local Accounts
      For additional details on linking Local Accounts to Hudu Assets passwords please see: LINK

   Note:  For the Service Accounts type - By default the Restart toggle switch is set to On. This is the recommended setting since after a password is updated on a Windows service if you don't restart it eventually the service will stop when its Active Directory Kerberos token expires. Generally this happens every 10 hours.

    

    

   Next Steps

   Matching Imported Accounts to Hudu Password Entries

   https://support.getquickpass.com/hc/en-us/articles/4408663929239-Hudu-Matching-Administrator-Service-and-End-User-Accounts

   Manually Resetting Matched Account Passwords in Quickpass

   https://support.getquickpass.com/hc/en-us/articles/1500011628061-Manually-Resetting-Matched-Account-Passwords-in-Quickpass 

   Rotate Administrator Account Passwords On-Demand

   https://support.getquickpass.com/hc/en-us/articles/360039179834-How-to-Rotate-Administrator-Account-Passwords-On-Demand 

   Setup Scheduled Password Rotation of Administrator Accounts with Hudu

   https://support.getquickpass.com/hc/en-us/articles/360038042153-How-to-Setup-Scheduled-Password-Rotation-of-Administrator-Accounts 

   Setup Scheduled Password Rotation of Service Accounts with Hudu

   https://support.getquickpass.com/hc/en-us/articles/360052090173-How-to-Setup-Scheduled-Password-Rotation-of-Service-Accounts