4D Doc Center : On SQL Authentication Database Method

4D v12.4

On SQL Authentication Database Method


$1, $2, $3 -> On SQL Authentication Database Method -> Resultado

Parâmetro	Tipo	Descrição
$1	Texto	User name
$2	Texto	Password
$3	Texto	(Optional) IP address of client at origin of the request
Resultado	Booleano	True = request accepted, False = request refused

O On SQL Authentication Database Method pode ser utilizado para filtrar os pedidos enviadas ao servidor SQL integrado de 4D. Este filtro pode estar baseado no nome e senha, assim como 7(opcional) no endereço IP do usuário. O desenvolvedor pode utilizar sua própria tabela de usuários ou a dos usuários 4D para avaliar os identificadores de conexão. Quando tiver validada a conexão, o comando CHANGE CURRENT USER pode ser utilizado para controlar o acesso das pedidos dentro do banco 4D.

Quando existir, o On SQL Authentication Database Method é chamado automaticamente por 4D ou 4D Server em cada conexão externa ao servidor SQL. Portanto o Sistema interno de gestão dos usuários de 4D não está ativado. A conexão é aceita apenas se o método de banco retorna True em $0 e se o comando CHANGE CURRENT USER for executado com êxito. Se uma destas condições não for cumprida, o pedido é recusado.

Nota: a instrução SQL LOGIN(SQL_INTERNAL;$usuário;$senha) não chama ao On SQL Authentication Database Method já que é uma conexão interna neste caso.

O método de banco de dados recebe até três parâmetros de tipo Texto, passados por 4D ($1, $2 e $3) e retorna um booleano, $0. Esta é a descrição desses parâmetros:

Parâmetros	Tipo	Descrição
$1	Texto	Nome de usuário
$2	Texto	Senha
$3	Texto	(opcional) Endereço IP do cliente na origem do pedido
$0	Booleano	True = pedido aceito, False = pedido recusado

Deve declarar estes parâmetros desta forma:

  ` Método de base On Web Authentication

 C_TEXT($1;$2;$3;$4)

 C_BOOLEAN($0)

  ` Código para o método

A senha ($2) é recebida como texto padrão.

Deve controlar os identificadores da conexão SQL no On SQL Authentication Database Method. Por exemplo, pode verificar o nome e a senha utilizando uma tabela de usuários personalizada. Se os identificadores forem válidos, passe True em $0 para aceitar a conexão.

Do contrário, passe False em $0; neste caso, a conexão é recusada.

Por padrão, $0 é igual a False. Se On SQL Authentication Database Method existir e se $0 não estiver definido, todas as conexões são recusadas.

Nota: Se On SQL Authentication Database Method não existir, a conexão é avaliada utilizando o Sistema integrado de gestão de usuários de 4D (Se estiver ativado, em outras palavras, se uma senha tiver sido atribuída ao Desenhista). Se este Sistema não estiver ativado, os usuários estão conectados com os direitos de acesso do Desenhista (acesso livre).

Se passa True em $0, deve chamar com sucesso ao comando CHANGE CURRENT USER no On SQL Authentication Database Method para que a pedido seja aceito e para que 4D abra uma sessão SQL para o usuário.

O uso do comando CHANGE CURRENT USER pode ser usada para implementar um sistema de autenticação virtual que tem a dupla vantagem de permitir o controle das ações de conexão e de esconder os identificadores da conexão na sessão SQL 4D.

Este exemplo do On SQL Authentication Database Method verifica que o pedido de conexão provenha da rede interna, confirma os identificadores e depois atribui os direitos de acessos "sql_user" para a sessão SQL.

 C_TEXT($1;$2;$3;$4)

 &NBSP;C_BOOLEAN($0)

 &NBSP; `$1: usuário

 &NBSP; `$2: senha

 &NBSP; `{$3: endereço IP do cliente}

 &NBSP;ON ERR CALL("SQL_erro")

 &NBSP;If(EndIPInterno($3))

 &NBSP; `O método EndIPInterno verifica Se o endereço IP é interno

 &NBSP;If($1="victor") & ($2="hugo")

 &NBSP;CHANGE CURRENT USER("sql_user";"")

 &NBSP;If(OK=1)

 $0:=True

Else

 $0:=False

End if

Else

$0:=False

End if

Else

$0:=False

End if

Cdflo