Hudu
The Hudu integration provides several different options to give you control over what is synchronised from CIPP to Hudu.
Data is synchronized automatically once every 24 hours from Microsoft 365 / CIPP to Hudu. This is scheduled once you save the extension and map your tenants.
For User and Device information a Rich Text field called "Microsoft 365" is used. This field is created after the first sync once you've set your Field Mappings to the appropriate asset layout.
Configuring the integration
Step 1 - Obtain API Credentials
First login to your Hudu instance as an Administrator.
Browse to Admin -> Account Administration -> API Keys
Select + New API Key at the top right.
Fill out the details for the API Application:
Enter a Name such as 'CIPP Integration'.
Optional: Get a list of potential IP addresses from your function app to limit the API scope to just the function app.
Click Create New Key.
Copy the API key to a secure place.
Step 2 - CIPP Settings
You should now be ready to configure settings inside CIPP
Inside CIPP browse to Settings -> CIPP -> Extension Settings
Select the Hudu tab.
Please enter the FQDN you use to connect to Hudu:
https://yoursubdomain.huducloud.com or a self hosted address
Enter the API Key you created in Hudu.
Set the configuration to enabled to enable automatic synchronization once every 24 hours.
Click the Set Extension Settings button.
Once the settings are saved click the 'Test Extension' you should see a message at the top of the page saying 'Successfully Connected to Hudu Version: current version', if you do not see this please check your API Key and FQDN.
Step 4 - Mapping CIPP to Hudu
After the API settings are set you can now map Hudu Assets to Microsoft 365 / CIPP Items.
Organization Mapping
Go to the Hudu Organization Mapping Table.
You have two options for mapping organizations
Manually pick the Hudu Company from the dropdown lists and match them to the Microsoft 365 tenants. Then click the Set Mappings button.
Select the Automap Hudu Organizations button.
This will try to match Microsoft 365 tenants where the name exactly matches in both.
Click Save Mappings.
Field Mapping
Scroll down to the Hudu Field Mapping Table.
For each field you wish to populate in Hudu select the asset layout from the dropdown menu.
Click Save Mappings
Special Thanks
Special thanks to Luke Whitelock and his HuduM365Automation function app code.
Last updated