Share via


Security Page, Project Designer

The Security page of the Project Designer is used to configure code access security settings for applications that are deployed by using ClickOnce deployment. For more information, see Code Access Security for ClickOnce Applications.

To access the Security page, click a project node in Solution Explorer, and then, on the Project menu, click Properties. When the Project Designer appears, click the Security tab.

Security Settings

  • Enable ClickOnce Security Settings
    Determines whether security settings are enabled at design time. When this option is cleared, all other options on the Security page are unavailable.

    Note

    When you publish an application by using the Publish wizard, this option is automatically enabled.

    When you select this option, you have the choice of selecting one of two radio buttons: This is a full trust application or This is a partial trust application.

    By default, for WPF Web Browser Application projects, this option is selected.

    By default, for all other project types, this option is cleared.

  • This is a full trust application
    If you select this option, the application receives Full Trust permissions when it is installed or run on a client computer. Avoid using Full Trust if possible, because your application will be granted unrestricted access to resources such as the file system and the registry.

    By default, for WPF Web Browser Application projects, this option is set to Partial Trust.

    By default, for all other project types, this option is set to Full Trust.

  • This is a partial trust application
    If you select this option, the application receives Partial Trust permissions when it is installed or run on a client computer. Partial Trust means that the code access security permissions for your application include only those permissions that are required by your application. For more information about configuring security permissions, see Code Access Security for ClickOnce Applications.

    You can specify the Partial Trust security settings by configuring the options in the ClickOnce Security Permissions area.

ClickOnce Security Permissions

  • Zone your application will be installed from
    Specifies a default set of code-access security permissions to use as a starting point when you configure permissions. Choose (Custom) to start with no permissions enabled, or choose Internet or Local Intranet for a restricted permission set.

    By default, for WPF Web Browser Application projects, this option is set to Internet. By default, the Internet zone for that project type includes the permissions WebBrowserPermission and MediaPermission, which are not used in other project types.

    Note

    Always customize the permission set to include only those permissions that are required by your application. For more information, see How to: Set Custom Permissions for a ClickOnce Application.

  • Permissions required by the application
    Contains a table of code security permissions.

    The Included column contains a green check-mark icon for any permissions that are included. It contains a yellow warning icon if the permission included is not included by default in the specified security zone.

    The Permission column contains the names of all permission sets; permission sets that have been modified are displayed in bold text.

    The Setting column contains a drop-down list with three choices. Clicking Include includes the permission, clicking Exclude excludes it, and clicking (Zone Default) includes or excludes it depending on the value selected in the Zone your application will be deployed from list.

    Note

    Changing permissions for a WPF Web Browser Application will cause it to fail at run time. The application will not run in a modified zone because it cannot gain the elevated privileges required in order to be granted the permissions. For more information, see Code Access Security for ClickOnce Applications.

  • Calculate Permissions
    Starts the Permission Calculator tool, which analyzes your application and sets the permissions in the Permissions required by the application table according to the results. For more information, see How to: Determine the Permissions for a ClickOnce Application.

    Note

    Choosing this option overwrites all existing permission settings.

  • Properties
    Opens the Permission Settings Dialog Box for the selected permission set in the Permissions required by the application table. The options available in the dialog box vary by permission set.

  • Reset
    Resets all permissions in the Permissions required by the application table to the default values for the zone selected in the Zone your application will be installed from list.

  • Advanced
    Opens the Advanced Security Settings Dialog Box, which is used to configure settings for debugging the application with restricted permissions.

See Also

Tasks

How to: Enable ClickOnce Security Settings

How to: Set a Security Zone for a ClickOnce Application

How to: Set Custom Permissions for a ClickOnce Application

How to: Determine the Permissions for a ClickOnce Application

How to: Debug a ClickOnce Application with Restricted Permissions

Concepts

Code Access Security for ClickOnce Applications

ClickOnce Deployment Overview

Reference

Advanced Security Settings Dialog Box

Permission Settings Dialog Box

WebBrowserPermission

MediaPermission

Other Resources

Securing ClickOnce Applications

ClickOnce Deployment

Projects, User Interface Elements