- Access to retrieve Auvik API credentials.
- Admin or super-admin user role within Hudu.
At any time, you can come back to your Hudu admin area >> Integrations >> Auvik to make changes to the integration.
Integration Features
- Companies.
- Create client spaces within Hudu directly from Auvik companies, or seamlessly merge them into existing (already-created) client spaces.
- Configurations.
- Pull configuration/device information from Auvik; sorted into asset layouts based on set sort rules.
What Hudu needs from Auvik
- Auvik Domain.
- Auvik Domain Prefix.
- Auvik Username.
- Auvik API Key.
Guides
Enabling Integrations
- Navigate to Hudu admin area >> Integrations.
- Select Auvik from the list.
If you're running on a Hudu version before 2.1.5.15, you'll need to select create integration.
Obtaining the Auvik Information
- Navigate to your Auvik account.
- We recommend creating a new user with locked-down permissions.
- Go to the left-hand side of Auvik and click Manage Users >> Roles
- Click Add Role.
- Under Inventory API, give the role the following permissions:
-
- Save the settings. It should look like this:
- Assign the role to the user you would like to use for the integration.
- When creating the user, assign it a role with access to all client spaces that you'd like to bring over.
- Login (to Auvik) as the user and generate an API Key under the bottom-left edit profile tab.
- Copy the API key and paste it into Hudu exactly.
- Alternate required information:
- Auvik Domain: Look in your Auvik Dashboard at the URL. You will need to take the FQDN without the first subdomain.
- For example, the URL mytest.us2.my.auvik.com would need to be replaced with us2.my.auvik.com
- Auvik Domain Prefix: This is the first part of the subdomain that we didn't use in the last step.
- For example: from the URL mytest.us2.my.auvik.com, you would put only mytest
- Auvik Username: This is the username of the account you set up earlier.
- API key: This is the API key copied from earlier.
- Auvik Domain: Look in your Auvik Dashboard at the URL. You will need to take the FQDN without the first subdomain.
- Save the settings.
Make sure to test the integration for a successful connection before continuing; do not continue on until you see a connection successful message display.
- Start the sync. After inputting all settings and ensuring the connection was successful; start the sync to push initial data to Hudu from Auvik (this is required before moving on).
Matching Companies
Hudu recommends matching one company first, for testing purposes, to ensure that your information comes over correctly.
- The first time your integration connection runs successfully, it will attempt to bring in companies from Auvik; these are then added to the Matched Companies List of that integration.
- Navigate to the Hudu admin area >> Integrations >> and find Auvik from the list. Click into it.
- It should now have a button that says Match Companies.
- Go through the list of companies and either bulk create/match all OR decide to:
- Match the company to an existing (already created) client in Hudu;
- Create a matched client within Hudu from an Auvik company;
- Leave unmatched, the company (and corresponding data) will not be created/brought into Hudu.
- Once you have matched your companies, you must re-run the integration import to fill in all the data for the newly matched/created companies.
Sort Rules
Configuration types that are not sorted using sort rules will not be brought into Hudu.
- Save your settings and stop/start your integration sync again to reflect your changes.
FAQ
Answer: Native integrations will automatically re-sync (update) every 3 hours.
You can also use either the global or the card-specific re-sync features to refresh native integration syncs at any point.
Answer: If the Auvik sync has been loading for a significant amount of time (it can take up to 10 minutes), follow the steps below:
-
- Test the connection to ensure Hudu and Auvik are communicating correctly.
- Verify your Auvik credentials.
- Refresh the page (while a sync is actively running).
- Stop the sync and restart the sync.
Answer: It should appear on subsequent re-syncs. If it is still not appearing, ensure that it has not been archived; and still exists in your sort rules.
Notes: Active integrations sync automatically every 3 hours; manual re-syncs can be performed either within an integrations’ settings page or by clicking the top right re-sync button.