Installing the New outlook add-in for Office 365
Article ID: 402742
Updated On:
Products
Issue/Introduction
The new Outlook add-in for users of Office 365 is built using Microsoft’s latest standards and leverages the Native Add- in API (NAA). It uses the Microsoft Graph API for improved integration, which has resulted in changes to both the request and
response formats. As a result, the add-in has been updated to align with this modern architecture. Although this new add-in is built using newer technology, its core functionality remains the same as the existing add-in The add-in:
• Submits the selected email to Symantec for analysis.
• Forwards the email to the administrator with an updated subject line, depending on how you configure the add-in's behavior on the Email Submissions Settings page in the ClientNet portal.
• Moves the email to the user's Deleted Items folder after successful submission.
Environment
Email Security.cloud
Resolution
Before installing the Email Submission add-in, Microsoft Office 365 tenant administrators must pre-authorize API access on behalf of all users in the organization. Follow these steps to pre-authorize the add-in.
1. Click the Consent URL to begin the Pre-authorization process:
The Permissions Requested dialog appears.
2. The Permissions Requested dialog displays the name of the add-in, followed by a list of resources that the add-in
needs to access. Click Accept to grant permission for the add-in to access the required resources.
3. Under certain circumstances, a second Permissions Requested dialog is displayed. Check the box next to Consent
on behalf of your organisation and then click Accept.
4. A message informing you that the Microsoft GRAPH authorization has succeeded or failed is displayed. If
authorization fails, follow the instructions provided to resolve the issue.
Install as an administrator:
Follow these steps to install and deploy the updated Email Submission Outlook add-in for Office 365 for all of the users in
your organization.
1. Click the Microsoft Administrator Portal link and navigate to Integrated apps.
2. Click the Upload custom apps tab.
3. On the Upload Apps to deploy screen, select Office Add-in.
4. Select Provide link to manifest file, enter :
https://outlookaddin.submissions.emailsecurity.symantec.com/manifest.xml
and then click Validate.
5. Click Next.
6. On the Add users screen, select Entire organization and click Next.
7. On the Accept permissions requests screen, click Next.
8. On the Review and finish deployment screen, verify that your choices are correctly shown, and then click Finish Deployment.
NOTE : It can take up to 72 hours for your deployment to complete.
9. Once deployment completes, open Outlook and select an existing email in your Inbox. Locate the Broadcom Email Submission button in the Apps section of the Outlook application ribbon, and then click the button. The Broadcom Email Submission add-in appears.
NOTE : The add-in is not visible in the Outlook application ribbon when you are composing a new message. It activates only when you display messages that have already been received.
10. On the Broadcom Email Submission add-in screen, under the heading Do you want to report this email?, check that the Name, From and Subject information is correct, and then click Yes. Verify that the email is submitted and deleted.
11. On the Permissions Requested screen, check the Consent on behalf of your organization box and then click Accept. You will only have to do this once.
12. After you click Accept, you will see a screen that displays Configured permissions and Other permissions granted for Broadcom. Review these permissions to ensure that you have correctly granted all desired permissions.
Feedback
