Specific Security Considerations for Office Solutions
The security features provided by the Microsoft .NET Framework, Microsoft Office 2003, and the 2007 Microsoft Office system can help to protect your Visual Studio Tools for Office solutions against possible security threats. This topic explains some of those threats and provides recommendations to help protect against them. It also includes information about how Microsoft Office security settings affect Visual Studio Tools for Office solutions.
Trusted Code Is Repurposed in a New, Malicious Document
An attacker could take trusted code that is meant for one particular purpose (for example, downloading personal information for an employment application) and reuse it in another document (such as a worksheet). The code does not know that the original document is not running, and may open up other threats (such as revealing personal information or executing code with increased privileges) when opened by a different user. Alternatively, the attacker can simply modify the data in the worksheet such that, when sent to the victim, it behaves unexpectedly. By changing the values, formulas, or presentation characteristics of a worksheet linked to code, it is possible for a malicious user to attack another user by sending a modified file. It may also be possible for users to access information they are not supposed to see by modifying values in the worksheet.
Since both the assembly location and the document location must have sufficient evidence to execute, this attack is not easy to mount. For example, documents in e-mail attachments or on untrusted intranet servers do not have enough permissions to run.
To make this attack possible, the code itself must be written in such a way that it makes decisions based on potentially untrustworthy data. An example is creating a worksheet that has a hidden cell that contains the name of a database server. The user submits the worksheet to an ASPX page, which attempts to connect to that server using SQL authentication and a hard-coded SA password. An attacker could replace the contents of the hidden cell with a different computer name and get the SA password. To avoid this problem, never hard-code passwords, and always check server IDs against an internal list of servers that are known to be good before accessing the server.
Recommendations
Always validate input and data, whether it comes from the user, the document, a database, a Web service, or any other source.
Be careful about exposing particular types of functionality, such as getting privileged data on behalf of the user and putting it into an unprotected worksheet.
Depending on the type of application, it might make sense to verify that the original document is running before executing any code (for example, verifying that it is running from a document stored at a known, secure location).
It might be a good idea to display a warning when the document opens if your application performs any privileged actions. For example, you might create a splash screen or a startup dialog box saying that the application will access personal information, and have the user choose to continue or cancel. If an end user gets such a warning from a seemingly innocent document, he or she will be able to quit the application before anything is compromised.
Code Is Blocked by the Outlook Object Model Guard
Microsoft Office Outlook 2003 and Microsoft Office Outlook 2007 can restrict code from using certain properties, methods, and objects in the object model. By restricting access to these objects, Outlook helps to prevent e-mail worms and viruses from using the object model for malicious purposes. This security feature is known as the Outlook object model guard. If an add-in attempts to use a restricted property or method while the object model guard is enabled, Outlook displays a security warning that enables the user to stop the operation, or enables the user to grant access to the property or method for a limited period of time. If the user stops the operation, Outlook add-ins created by using Visual Studio Tools for Office will throw a COMException.
The object model guard can affect add-ins in different ways, depending on whether Outlook is used with Microsoft Exchange Server:
If Outlook is not used with Exchange, an administrator can enable or disable the object model guard for all add-ins on the computer.
If Outlook is used with Exchange, an administrator can enable or disable the object model guard for all add-ins on the computer, or the administrator can specify that certain add-ins can run without encountering the object model guard. Administrators can also modify the behavior of the object model guard for certain areas of the object model. For example, administrators can automatically allow add-ins to send e-mail programmatically, even if the object model guard is enabled.
For more information about the Outlook object model guard in Outlook 2003, including a list of the restricted methods and properties, see What's New in Microsoft Office Outlook 2003 for Developers?. For more information about Outlook security settings for Exchange administrators, see Customizing Outlook 2003 to Help Prevent Viruses.
Note
Outlook 2007 introduces several changes to the behavior of the object model guard to improve the developer and user experience while helping to keep Outlook secure. For more information, see Code Security Changes in Outlook 2007.
Minimizing Object Model Guard Warnings
To help avoid security warnings when you use restricted properties and methods, make sure that your add-in obtains Outlook objects from the Application field of the ThisAddIn class in your project. For more information about this field, see Programming Application-Level Add-Ins.
Only Outlook objects obtained from this object can be trusted by the object model guard. In contrast, objects that are obtained from a new Microsoft.Office.Interop.Outlook.Application object are not trusted, and the restricted properties and methods will raise security warnings if the object model guard is enabled.
The following code example displays a security warning if the object model guard is enabled. The To property of the Microsoft.Office.Interop.Outlook.MailItem class is restricted by the object model guard. The Microsoft.Office.Interop.Outlook.MailItem object is untrusted because the code gets it from a Microsoft.Office.Interop.Outlook.Application that is created using the new operator, instead of obtaining it from the Application field.
Private Sub UntrustedCode()
Dim application As New Microsoft.Office.Interop.Outlook.Application
Dim mailItem1 As Microsoft.Office.Interop.Outlook.MailItem = _
TryCast(application.CreateItem( _
Microsoft.Office.Interop.Outlook.OlItemType.olMailItem), _
Microsoft.Office.Interop.Outlook.MailItem)
mailItem1.To = "someone@example.com"
MessageBox.Show(mailItem1.To)
End Sub
private void UntrustedCode()
{
Microsoft.Office.Interop.Outlook.Application application =
new Microsoft.Office.Interop.Outlook.Application();
Microsoft.Office.Interop.Outlook.MailItem mailItem1 =
application.CreateItem(
Microsoft.Office.Interop.Outlook.OlItemType.olMailItem) as
Microsoft.Office.Interop.Outlook.MailItem;
mailItem1.To = "someone@example.com";
MessageBox.Show(mailItem1.To);
}
The following code example demonstrates how to use the restricted To property of a Microsoft.Office.Interop.Outlook.MailItem object that is trusted by the object model guard. The code uses the trusted Application field to get the Microsoft.Office.Interop.Outlook.MailItem.
Private Sub TrustedCode()
Dim mailItem1 As Microsoft.Office.Interop.Outlook.MailItem = _
TryCast(Me.Application.CreateItem( _
Microsoft.Office.Interop.Outlook.OlItemType.olMailItem), _
Microsoft.Office.Interop.Outlook.MailItem)
mailItem1.To = "someone@example.com"
MessageBox.Show(mailItem1.To)
End Sub
private void TrustedCode()
{
Microsoft.Office.Interop.Outlook.MailItem mailItem1 =
this.Application.CreateItem(
Microsoft.Office.Interop.Outlook.OlItemType.olMailItem) as
Microsoft.Office.Interop.Outlook.MailItem;
mailItem1.To = "someone@example.com";
MessageBox.Show(mailItem1.To);
}
Note
If Outlook is used with Exchange, then obtaining all Outlook objects from ThisAddIn.Application does not guarantee that your add-in will be able to access the entire Outlook object model. For example, if an Exchange administrator sets Outlook to automatically deny all attempts to access address information using the Outlook object model, then Outlook will not allow the previous code example to access the To property, even though the code example uses the trusted ThisAddIn.Application field.
Specifying Which Add-ins to Trust When Using Exchange
When Outlook is used with Exchange, administrators can specify that certain add-ins can run without encountering the object model guard. Outlook add-ins created by using Visual Studio Tools for Office cannot be trusted individually; they can only be trusted as a group.
Outlook trusts an add-in based on a hash code of the entry point DLL of the add-in. All Outlook add-ins created by using Visual Studio Tools for Office use the same entry point DLL (AddinLoader.dll for Outlook 2003 add-ins; VSTOLoader.dll for Outlook 2007 add-ins). This means that if an administrator trusts any add-in created by using Visual Studio Tools for Office to run without encountering the object model guard, then all other add-ins creating by using Visual Studio Tools for Office are also trusted. For more information about trusting specific add-ins to run without encountering the object model guard, see Customizing Outlook 2003 to Help Prevent Viruses.
Permission Changes Do Not Take Effect Immediately
If the administrator adjusts permissions for a document or assembly, users must quit and then restart all Office applications for those changes to be enforced.
Other applications that host Microsoft Office applications can also prevent the new permissions from being enforced. Users should quit all applications that use Office, hosted or stand-alone, when security policies are changed.
Trust Center Settings in the 2007 Microsoft Office System Do Not Affect Add-ins or Document-Level Customizations
Users can prevent add-ins from loading by setting an option in the Trust Center. However, application-level add-ins and document-level customizations created by using Visual Studio Tools for Office are not affected by these trust settings.
If the user prevents add-ins from loading by using the Trust Center, the following types of add-ins will not load:
Managed and unmanaged COM add-ins.
Managed and unmanaged smart tags.
Managed and unmanaged smart documents.
Managed and unmanaged Automation add-ins.
Managed and unmanaged real-time data components.
The following procedures describe how users can use the Trust Center to restrict add-ins from loading in the 2007 Microsoft Office system. These procedures do not affect add-ins or customizations created by using Visual Studio Tools for Office.
To disable add-ins in Excel 2007, PowerPoint 2007, or Word 2007
Click the Microsoft Office Button.
Click the ApplicationName Options button.
In the categories pane, click Trust Center.
In the details pane, click Trust Center Settings.
In the categories pane, click Add-ins.
In the details pane, select Require Application Add-ins to be Signed by Trusted Publisher or Disable all Application Add-ins.
To disable add-ins in InfoPath 2007, Outlook 2007, or Visio 2007
On the Tools menu, click Trust Center.
In the categories pane, click Macro Security.
In the details pane, select No Warnings and Disable All Macros or Warnings for signed macros; all unsigned macros are disabled.
In the categories pane, click Add-ins.
In the details pane, select Apply macro security settings to installed add-ins.
See Also
Concepts
Security in Office Solutions (2007 System)