WEB SERVICE AUTHENTICATE
WEB SERVICE AUTHENTICATE ( nome ; senha {; metAutenticaçao} {; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| nome | String | 🡒 | nome de usuário |
| senha | String | 🡒 | 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 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(...)