Mailbox requirement set 1.16 now available for Outlook add-ins

Mailbox requirement set 1.16 is now generally available for Outlook add-ins. This release reflects our continued investment in closing the gap between COM/VSTO and web add-ins, with a focus on message and information security.

Mailbox 1.16 introduces APIs and platform updates that enable your add-in to:

• Decrypt protected messages and attachments in an event-based workflow.
• Determine whether Exchange Web Services (EWS) tokens are supported in an organization.
• Easily identify inline attachments in mail items.
• Retrieve a larger number of recipients from mail items.
• Store more session-scoped state and data with a larger SessionData limit.

Handle message decryption with ease

Mailbox requirement set 1.16 introduces the OnMessageDecrypt event, which enables Outlook add-ins to automatically decrypt protected messages when a user opens them. The event-based workflow identifies encrypted messages, decrypts messages, displays the decrypted message content, and surfaces error notifications when needed. This workflow handles the operational steps so that you can focus on defining and implementing encryption and decryption protocols that meet your organization’s security requirements in the add-in.

To learn more about implementing decryption in your add-in, see Create an encryption Outlook add-in. To see a sample decryption add-in in action, try out the Encrypt and decrypt messages in Outlook sample.

Detect support for EWS tokens in an organization

While EWS tokens have been turned off for Exchange Online environments, some organizations still run on-premises environments. With the introduction of the Office.context.mailbox.diagnostics.ews.getTokenStatusAsync API, your add-in can now identify whether EWS callback tokens are supported in an organization. This enables your add-in to run the recommended authentication solutions when available while maintaining backward compatibility when needed.

Enhance data loss prevention and content processing workflows

Mailbox 1.16 also enhances existing APIs to support data loss prevention and content processing scenarios.

• The contentId property expands the attachment API so your add-in can easily identify inline attachments in mail items during content inspection and rendering workflows.
• The getAsync method of the Recipients API now returns up to 1,000 recipients from any recipient field of a mail item. This expanded limit helps your data loss prevention solutions evaluate larger recipient lists in a single operation.
• The SessionData object now supports up to 2,621,440 characters per add-in, so that your add-in can store and retrieve data more seamlessly within a single session.

Try the new Mailbox 1.16 capabilities in your Outlook add-in today. Happy coding!