WEB SERVICE AUTHENTICATE

WEB SERVICE AUTHENTICATE ( nome ; senha {; metAutenticaçao} {; *} )

Parâmetro	Tipo		Descrição
nome	Text	→	nome de usuário
senha	Text	→	senha de usuário
metAutenticaçao	Integer	→	Método autenticação 0 ou omitido = não especificado; 1= BASIC; 2=DIGEST
*	Operador	→	Se passado: autenticação por proxy

Descrição

O comando WEB SERVICE AUTHENTICATE permite utilizar os serviços web que necessitem da autenticação da aplicação cliente (autenticação simples). Os métodos BASIC e DIGEST são compatíveis, assim como a presença de um proxy.

Nota: para mais informação sobre os métodos de autenticação BASIC e DIGEST, revise a seção Conexões de Segurança.

Nos parâmetros nome e senha, passe a informação de identificação requerida (nome de usuário e senha). Esta informação será codificada e adicionada à petição HTTP enviada ao serviço web utilizando o comando WEB SERVICE CALL. É então necessário chamar ao comando WEB SERVICE AUTHENTICATE antes de chamar ao comando WEB SERVICE CALL.

O parâmetro opcional metAutenticaçao permite indicar o método de autenticação a utilizar para a próxima chamada do comando WEB SERVICE CALL. Pode passar um dos seguintes valores:

• 2 = utilizar o método de autenticação DIGEST
• 1 = utilizar o método de autenticação BASIC
• 0 (ou omitir o parâmetro) = utilizar o método apropriado. Neste caso, 4D envia uma petição adicional para negociar o método de autenticação.

Se passar o parâmetro *, você indica que a informação de autenticação é para ser enviada a um proxy HTTP. Essa configuração deve ser implementada quando houver um proxy que exige autenticação entre o cliente Web Service client e o próprio Web Service. Se o Web Service for autenticado, uma autenticação dupla for exigida (ver o exemplo).

Como padrão, a informação de autenticação se reinicia depois de cada petição. Portanto, deve utilizar o comando WEB SERVICE AUTHENTICATE antes de cada comando WEB SERVICE CALL. Entretanto é possível conservar temporariamente esta informação utilizando uma opção do comando WEB SERVICE SET OPTION. Neste caso, não é necessário executar o comando WEB SERVICE AUTHENTICATE antes de cada WEB SERVICE CALL.

Se a autenticação fracassar, o servidor SOAP devolve um erro que pode identificar utilizando o comando WEB SERVICE Get info.

Exemplo

Autenticação com um serviço web localizado atrás de um proxy:

  //Autenticação ao serviço web em modo DIGEST
 AUTHENTICATE WEB SERVICE("SoapUser";"123";2)
  //Autenticação ao proxy em modo default
 AUTHENTICATE WEB SERVICE("ProxyUser";"456";*)
 CALL WEB SERVICE(...)

Ver também

WEB SERVICE CALL
WEB SERVICE Get info

Propriedades

Número do comando	786
Thread-seguro	✓