Habilitar e configurar as configurações de segurança do ClickOnce no Visual Studio

Você pode habilitar e definir as configurações de segurança do ClickOnce na página Segurança do Designer de Projeto. Neste artigo, você aprenderá a habilitar configurações de segurança, configurar zonas de segurança e configurar zonas de segurança personalizadas.

Observação

No ClickOnce para .NET Core e .NET 5 ou posterior, essa tarefa não tem suporte. Para obter mais informações, confira ClickOnce para .NET.

Habilitar configurações de segurança do ClickOnce

A segurança de acesso do código para aplicativos ClickOnce precisa ser habilitada para publicar o aplicativo. Isso é feito automaticamente quando você publica um aplicativo usando o assistente Publicar.

Em alguns casos, habilitar a segurança de acesso do código pode afetar o desempenho ao compilar ou depurar o aplicativo. Nesses casos, talvez você queira desabilitar temporariamente as configurações de segurança.

As configurações de segurança do ClickOnce podem ser habilitadas ou desabilitadas na página Segurança do Designer de Projeto.

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Segurança .

  3. Marque a caixa de seleção Habilitar Configurações de Segurança do ClickOnce.

    Agora, você pode personalizar as configurações de segurança do aplicativo na página Segurança.

    Observação

    Essa caixa de seleção é selecionada automaticamente sempre que o aplicativo é publicado com o assistente Publicar.

Para desabilitar configurações de segurança do ClickOnce

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Segurança .

  3. Desmarque a caixa de seleção Habilitar Configurações de Segurança do ClickOnce.

    O aplicativo será executado com as configurações de segurança de confiança total. Todas as configurações na página Segurança serão ignoradas.

    Observação

    Sempre que o aplicativo for publicado com o assistente Publicar, essa caixa de seleção será selecionada; você precisará limpá-la novamente após cada publicação bem-sucedida.

Definir uma zona de segurança para um aplicativo ClickOnce

Ao definir permissões de segurança de acesso de código para um aplicativo ClickOnce, você precisa começar com um conjunto base de permissões na página Segurança do Designer de Projeto.

Na maioria dos casos, você também pode escolher a zona da Internet que contém um conjunto limitado de permissões ou a zona intranet local que contém um conjunto maior de permissões. Se o aplicativo exigir permissões personalizadas, você poderá fazer isso escolhendo a zona de segurança Personalizada.

Para definir uma zona de segurança

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Segurança .

  3. Marque a caixa de seleção Habilitar Configurações de Segurança do ClickOnce.

  4. Selecione o botão de opção Este é um aplicativo de confiança parcial.

    Os controles na seção Permissões de segurança do ClickOnce estão habilitados.

  5. Na zona em que seu aplicativo será instalado na lista suspensa, selecione uma zona de segurança.

Definir permissões personalizadas para um aplicativo ClickOnce

É possível implantar um aplicativo ClickOnce que usa permissões padrão para as zonas da Internet ou intranet local. Como alternativa, você pode criar uma zona personalizada para as permissões específicas necessárias do aplicativo. É possível configurar permissões de segurança na página Segurança do Designer de Projeto.

Para personalizar uma permissão

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Segurança .

  3. Marque a caixa de seleção Habilitar Configurações de Segurança do ClickOnce.

  4. Selecione o botão de opção Este é um aplicativo de confiança parcial.

    Os controles na seção Permissões de segurança do ClickOnce estão habilitados.

  5. Na zona em que seu aplicativo será instalado na lista suspensa, clique (Personalizar).

  6. Clique em Editar Permissões XML.

    O arquivo app.manifest é aberto no Editor XML.

  7. Antes do elemento </applicationRequestMinimum>, adicione o código XML para as permissões exigidas pelo aplicativo.

    Observação

    É possível usar o método ToXml de um conjunto de permissões para gerar o código XML para o manifesto do aplicativo. Por exemplo, para gerar o XML para o EnvironmentPermission conjunto de permissões, chame o método ToXml.