Overview
Centralized Deployment is a method that can be used in certain Office 365 and hybrid environments. To check if this method suits you, please see Office 365 Compatibiliity Checker article before reading further.
Using this method you can deploy the add-in either to all users or selected group of users. The Hoxhunt add-in is added or removed when group members are added or removed accordingly.
General requirements:
- The admin deploying the add-in and the users receiving the add-in must be on a version of Exchange Server that supports OAuth authentication. By default, Exchange Multi-Tenant and Dedicated VNext deployments support OAuth.
- Users must be using Office 365 ProPlus (and are signed into Office using their Organizational ID), and have Exchange Online and active Exchange Online mailboxes.
- Your subscription's directory must either be in, or federated to Azure Active Directory.
For environments that don't meet the requirements for Centralized Deployment, you can deploy Hoxhunt Outlook add-in via the Exchange Admin Center by using Powershell. Please see this article.
Contents of this article
- Centralized Deployment of Hoxhunt add-in
- Edit, remove or add users / groups for Hoxhunt add-in
Centralized Deployment of Hoxhunt add-in
1. In the Office 365 Admin Center, Navigate to “Settings” -> “Services & add-ins”.
2. Click “+ Deploy Add-in”.
3. New Add-in page opens, choose “Next”.
4. Choose “I have a URL for the manifest file.”, copy and paste the following manifest URL into the highlighted text field:
https://officejs.hoxhunt.com/api/v1/manifest/default/manifest.xml
Click “Next” to proceed.
5. A summary of the Hoxhunt add-in will be displayed. This information is based on the manifest URL that you copy pasted in the previous step.
Click “Next” to proceed.
6. Choose “Optional, enabled”. This will automatically deploy the add-in to the assigned users, but they can choose to remove it.
Click “Next” to proceed.
7. Choose who has access to the add-in. You can select Everyone, Specific users/groups, or Only me.
Select “Specific users/groups”, and search for the users or group you want to distribute the plug-in to.
When you have chosen the users/groups to distribute the add-in to, they will be shown below the search box.
Click “Save” to continue.
8. A Confirmation page is shown that confirms the add-in has been assigned to the users/groups you selected.
Click “Close” to proceed.
Please note:
-
it may take a few minutes to an hour for the add-in to appear for the newly selected user group. According to Microsoft it may take up to 24 hours but usually it's much less.
-
If you are unable to see Hoxhunt add-in in desktop Outlook even after restarting the application, please check if the button is available in Outlook Web Application (OWA). Please check this article to locate Hoxhunt button in OWA.
9. The add-in will be displayed under the “Services & add-ins” listing.
Edit, remove or add users / groups for Hoxhunt add-in
1. In the Office 365 Admin Center, Navigate to “Settings” -> “Services & add-ins”.
2. To edit, remove or add groups or users for the add-in, click the “HoxHunt Report” name in your “Services & add-ins” listing.
3. Go to section “Who has access?”. Click “Edit” on the right-hand side.
4. Add or remove selected users/groups by searching the users/groups on highlighted the text field. Click “Save” to save the changes and proceed.
Please note:
-
it may take a few minutes to an hour for the add-in to appear for the newly selected user group. According to Microsoft it may take up to 24 hours but usually it's much less.
-
If you are unable to see Hoxhunt add-in in desktop Outlook even after restarting the application, please check if the button is available in Outlook Web Application (OWA). Please check this article to locate Hoxhunt button in OWA.
- Optionally, you can use PowerShell cmdlets to see further information about the deployment:
https://docs.microsoft.com/en-us/office365/enterprise/use-the-centralized-deployment-powershell-cmdlets-to-manage-add-ins