Partilhar via


Ferramenta de compilador WsUtil

A ferramenta de compilador do Windows Web Services, WsUtil.exe, oferece suporte ao modelo de serviço e de serialização de tipos de dados. Ele processa WSDL, esquema XML e documentos de política, e gera cabeçalhos C e arquivos de origem. Esta ferramenta é semelhante à ferramenta de compilador WSDL para código gerenciado, mas destina-se ao código nativo.

Para dar suporte ao modelo de serviço , WsUtil.exe gera cabeçalhos para serem usados tanto para o cliente quanto para o serviço. Ele gera arquivos de proxy C para o lado do cliente e arquivos de stub C para o lado do serviço, conforme necessário.

Para suportar serialização, o compilador gera cabeçalhos para descrições de elementos para definições de elementos globais e todas as informações de definição de tipo nos arquivos proxy que são consumidas pelo mecanismo de serialização.

Para obter opções de linha de comando para processar arquivos WSDL, arquivos de esquema XML e arquivos de diretiva de serviço Web, consulte os seguintes tópicos:

Segurança

Ao usar o WsUtil, esteja ciente dos seguintes problemas e observe as precauções apropriadas:

  • Wsutil não recupera metadados XML através da rede e wsutil não resolve importar e/ou incluir instruções nos arquivos de metadados de entrada. O Wsutil abre e lê arquivos wsdl, xsd e policy. Os metadados XML não são resistentes a violações. Certifique-se de usar apenas wsdl, xsd e arquivos de política são adquiridos de fonte confiável e certifique-se de proteger os arquivos contra adulteração antes e depois de usá-los. Analise cuidadosamente o conteúdo dos arquivos de entrada e valide se o conteúdo dos arquivos é seguro para uso no aplicativo. Wsutil.exe não faz nenhuma verificação de autenticidade dos arquivos de metadados.
  • Wsutil gera arquivos de cabeçalho e stub, que não são resistentes a violações. Você precisa definir os direitos de acesso de nível correto em arquivos de origem gerados por wsutil.exe para impedir o acesso não autorizado a esses arquivos. Wsutil usa System.IO.StreamWriter para criar os arquivos de saída.
  • Os usuários precisam estar cientes de que o Wsutil pode substituir seus arquivos locais, e eles devem ter cuidado para especificar nomes de arquivos e diretórios seguros para arquivos de saída usando a opção /out.
  • Wsutil ou wsutilhelper.dll carregado em wsutil.exe, pode terminar inesperadamente ou consumir uma grande quantidade de recursos do sistema quando sob ataque ou no processamento de uma grande quantidade de metadados de entrada. A ferramenta é projetada para ser usada apenas durante o tempo de desenvolvimento Esta ferramenta deve ser usada apenas como uma ferramenta de tempo de desenvolvimento. Pode não ser seguro para uso na camada intermediária para processar informações de política.
  • Wsutilhelper.dll DLL auxiliar é carregada no wsutil.exe gerenciado para processar informações de política. O usuário deve certificar-se de que nenhum binário malicioso com o mesmo nome de arquivo existe no caminho binário. Da mesma forma, o usuário deve certificar-se no ambiente de compilação, o caminho binário está configurado corretamente que não há nenhum binário malicioso com o mesmo nome "wsutil.exe" existe.
  • Wsutil gera anotação SAL para operações e campos de estrutura quando possível. O usuário de arquivos gerados por wsutil deve seguir o requisito especificado através da anotação SAL.

Visão geral da camada de modelo de serviço

de serialização

Web Service Compiler Tool

de suporte WSDL

Suporte de esquema

de Apoio à Política