Compartilhar via


Habilitar e definir 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, a Segurança de Acesso ao Código não tem suporte. No .NET Framework, o uso da Segurança de Acesso ao Código não é uma prática recomendada e não é recomendado.

Habilitar configurações de segurança do ClickOnce

A segurança de acesso de código para aplicativos ClickOnce deve ser habilitada para publicar o aplicativo. Isso é feito automaticamente quando você publica um aplicativo usando o Assistente de Publicação. Para obter mais informações sobre segurança de acesso de código e zonas de segurança, consulte Segurança de Acesso ao Código para Aplicativos ClickOnce.

Em alguns casos, habilitar a segurança de acesso ao código pode afetar o desempenho ao compilar ou depurar seu 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 de Publicação .

Para desabilitar as 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 .

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

    Observação

    Sempre que o aplicativo for publicado com o Assistente de Publicação, essa caixa de seleção será selecionada; você deve desmarcá-la novamente após cada publicação bem-sucedido.

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 Esta é uma aplicação de confiança parcial.

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

  5. Na lista suspensa Zona de onde seu aplicativo será instalado, selecione uma zona de segurança.

Definir permissões personalizadas para um aplicativo ClickOnce

Você pode 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 de que o aplicativo precisa. Você pode fazer isso personalizando as 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 Esta é uma aplicação de confiança parcial.

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

  5. Na lista suspensa de Zonas de onde seu aplicativo será instalado, clique em (Personalizado).

  6. Clique em Editar Permissões XML.

    O arquivo app.manifest é aberto no Editor XML.

  7. Antes do </applicationRequestMinimum> elemento, adicione o código XML para permissões necessárias para seu aplicativo.

    Observação

    Você pode usar o ToXml método 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 ToXml método.

Configurar a depuração para uma zona de segurança

Você pode especificar as configurações de segurança relacionadas à depuração em uma zona.

  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 Esta é uma aplicação de confiança parcial.

  5. Selecione Avançado.

  6. Selecione Conceder acesso ao aplicativo ao seu site de origem

    Se você marcar essa caixa de seleção, o aplicativo poderá acessar o site ou o compartilhamento de servidor no qual ele é publicado. Por padrão, essa opção está selecionada.

  7. Na caixa Depurar este aplicativo como se tivesse sido baixado do seguinte URL, insira o URL.

    Se você precisar permitir que o aplicativo acesse o compartilhamento de site ou servidor correspondente à URL de Instalação especificada na página Publicar , insira essa URL aqui.