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

Enabling the Hudu Integration can be done in 2 ways.  Via the Hudu created Integration or via a Manual API Key.

Manual API Key

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.
   
   
   NOTE: If you would like to use the IP Restrictions (Hudu refers to them as OPTIONAL: ALLOWED IP ADDRESSES), please refer to this KB for the IP(s) that you will have to add, in order for your Hudu environment to allow Quickpass to communicate with the Hudu API.
   
   https://support.getquickpass.com/hc/en-us/articles/4402712146711-Firewall-Port-Exceptions-IP-Whitelisting-for-Agent-and-API-Communication
   
   
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. Proceed to the Quickpass Integration process.

Hudu created Integration

1. On the Admin Page click the Integrations Link
   
2. Find the Quickpass Logo and click the Create API Key link
   
   NOTE: At this time the API Key Generated will NOT have any IP Restrictions. If this is important to you, please use the Manual method at this time.  Hudu has agreed to add our IP Addresses to their quick Integration in the future and this article will be updated when that takes place.
   
   
3. An API Key will be automatically generated and will show at the top of the API Keys Page.  Copy this value, and proceed with the remainder of the setup process.
   

Quickpass Integration

1. Log in to the Quickpass admin website at https://admin.getquickpass.com for North America/Oceania or https://eu-admin.getquickpass.com/ for Europe using your Quickpass Administrator account.
2. Click Integrations in the left-hand menu.
   
3. In the Integrations page, click the Hudu logo.
   
   
4. 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.
   NOTE: Ensure you are using the full Address for your Hudu access (ex. hudu.companyname.com) without the HTTPS://
   
5. Click Connect to complete the Process.
6. 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 page, click the checkbox on the far-right side of each of the Hudu organizations that you would like to import. This will set up Quickpass to create the new customer and link it to Hudu. Click Save in the top right corner to complete the action.

   4. If you have customers that already exist in Quickpass, but have not yet been matched to Hudu, you may see some automatic matches, indicated by the 3-star icon. These automatic matches will link up automatically when you click Save.

   5. As you're making your selections and matches, you may want to filter your view to only see specific companies. You can click the Match Status menu to reveal your filtering options.

   6. If you move to one of the filtered views (Unmatched, Suggested Matches, or Matched), you will need to click Confirm Matches to proceed.

   7. The Confirm Matches button will take you back to the "All" view, allowing you to review your selections and matches before clicking Save.

    

    

    

    

    

   8. Once the Companies are imported, they will appear on the Quickpass Customers page. You will also notice the Hudu logo in the Integrations column.

   

    

   You can view the status of linked Hudu Customer with Quickpass Customers, navigate to Integrations > select Hudu. 

   

    

   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.

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.
   

3. Click the MATCH CUSTOMERS button on the top-right of the screen. 
   
4. You can use the "Search" box to filter the list or manually scroll through the list of Hudu Companies that you would want to match to a Quickpass Customer
   
   
5. Any Customer name that has an exact match for a Hudu Company will appear at the top of the screen with an  indicator to advise that it was Automatically Matched to a Quickpass Customer.
   
   If this is the correct Hudu Company to Quickpass Customer match, click Save to complete the Match.
   If this is NOT the correct Hudu Company to Quickpass Customer match, click the Trash Can icon to remove the Automatic match and proceed to the next step to manually match it.
   
6. If the Company Name in Hudu does not have an exact match to a Quickpass Customer, click the Match with Quickpass Customer box.
   
7. Place the Radio Button in the proper Quickpass Customer you manually created and click Select.  You can search for the Quickpass Customer or scroll through the list/pages.
   
8. When you have matched up all of your Hudu Customers to the Quickpass Customers click the Save button in the top right.
   
9. When done you will now see the linked Hudu Companies with Quickpass Customers on the Customers page.

10. 

     

    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

    Importing End User Accounts:

    1. Active Directory with O365/Azure
    2. Active Directory without O365/Azure
    3. Azure/O365 Only
    4. Manual Import

    Importing Administrator Accounts

    1. Automatic Administrator Import
    2. Automatic Local Administrator Import

    Import Service Accounts

    1. Import and Set Rotation

        

        

    Next Steps

    Hudu Self Hosted/On Prem Implementation

    https://support.getquickpass.com/hc/en-us/articles/9917337621399-Hudu-On-Premise-Integration

    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