Ferramenta do Compilador WsUtil
A ferramenta do compilador dos Serviços Web do Windows, WsUtil.exe, dá suporte ao modelo de serviço e à serialização de tipos de dados. Ele processa documentos de política e esquema WSDL, XML e gera cabeçalhos C e arquivos de origem. Essa ferramenta é semelhante à ferramenta do 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 a serem usados para o cliente e o serviço. Ele gera o arquivo proxy C para o lado do cliente e arquivos stub C para o lado do serviço, conforme necessário.
Para dar suporte à serialização, o compilador gera cabeçalhos para descrições de elementos para definições de elemento global e todas as informações de definição de tipo nos arquivos proxy consumidos pelo mecanismo de serialização.
Para obter opções de linha de comando para processar arquivos WSDL, arquivos de esquema XML e arquivos de política de serviço Web, consulte os seguintes tópicos:
- Ferramenta do Compilador de Serviço Web
- Contratos de serviço e WSDL
- Suporte de esquema
- Suporte a políticas
Segurança
Ao usar o WsUtil, esteja ciente dos seguintes problemas e observe as precauções apropriadas:
- O Wsutil não recupera metadados XML pela rede e o 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 política. Os metadados XML não são resistentes a adulterações. Certifique-se de que você use apenas arquivos wsdl, xsd e policy que sejam adquiridos de origem confiável e certifique-se de proteger os arquivos contra adulteração antes e depois de usá-los. Examine 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.
- O Wsutil gera arquivos de cabeçalho e stub, que não são resistentes a adulterações. Você precisa definir os direitos de acesso de nível corretos em arquivos de origem gerados por wsutil.exe para impedir o acesso não autorizado a esses arquivos. O 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 devem ter cuidado para especificar nomes de arquivo e diretórios seguros para arquivos de saída usando a opção /out.
- O Wsutil ou wsutilhelper.dll carregado em wsutil.exe, pode terminar inesperadamente ou consumir uma grande quantidade de recursos do sistema quando estiver sob ataque ou ao processar uma quantidade muito grande de metadados de entrada. A ferramenta foi projetada para ser usada somente durante o tempo de desenvolvimento Essa ferramenta deve ser usada apenas como uma ferramenta de tempo de desenvolvimento. Pode não ser seguro para uso na camada intermediária processar informações de política.
- Wsutilhelper.dll DLL auxiliar é carregada em wsutil.exe gerenciadas para processar informações de política. O usuário deve garantir que nenhum binário mal-intencionado com o mesmo nome de arquivo exista no caminho binário. Da mesma forma, o usuário deve verificar se, no ambiente de build, o caminho binário está configurado corretamente de que não há nenhum binário mal-intencionado com o mesmo nome "wsutil.exe".
- O Wsutil gera anotação SAL para operações e campos de estrutura quando possível. O usuário de arquivos gerados pelo wsutil deve seguir o requisito especificado por meio da anotação SAL.
Tópicos relacionados