4D Doc Center : AUTHENTICATE WEB SERVICE

4D v12.4

AUTHENTICATE WEB SERVICE


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

Parâmetro	Tipo	Descrição
nome	cadeia	Nome de usuário
senha	cadeia	Senha de usuário
metAutenticaçao	Inteiro longo	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 AUTHENTICATE WEB SERVICE 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 CONFIRM.

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 CALL WEB SERVICE. É então necessário chamar ao comando AUTHENTICATE WEB SERVICE antes de chamar ao comando CALL WEB SERVICE.

O parâmetro opcional metAutenticaçao permite indicar o método de autenticação a utilizar para a próxima chamada do comando CALL WEB SERVICE. 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 AUTHENTICATE WEB SERVICE antes de cada comando CALL WEB SERVICE. Entretanto é possível conservar temporariamente esta informação utilizando uma opção do comando SET WEB SERVICE OPTION. Neste caso, não é necessário executar o comando AUTHENTICATE WEB SERVICE antes de cada CALL WEB SERVICE.

Se a autenticação fracassar, o servidor SOAP devolve um erro que pode identificar utilizando o comando Get Web Service error 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(...)