Histórico da Página
Classe: tSktSslSrv
Permite o gerenciamento de conexões TCP seguras (SSL).
Hierarquia
A classe não possui hierarquia.
Construtores
New
Cria uma instância da classe tSktSslSrv.
...
Sintaxe
...
...
tSktSslSrv():New( < nSSL2 >, < nSSL3 >, < nTLS1 >, < cPassPhase >, < cCertificate >, < cKey >, |
Parâmetros
...
Nome | Tipo | Descrição | Obrigatório | Referência |
nSSL2 | Numérico | 0 (zero) indica desabilitado, senão habilitado | X |
|
nSSL3 | Numérico | 0 (zero) indica desabilitado, senão habilitado | X |
|
nTLS1 | Numérico | 0 (zero) indica desabilitado, senão habilitado | X |
|
cPassPhase | Caracter | Senha | X |
|
cCertificate | Caracter | arquivo de certificado | X |
|
cKey | Caracter | arquivo de chave | X |
|
cCertificate2 | Caracter | arquivo de certificado secundário |
|
|
cKey2 | Caracter | arquivo de chave secundário |
|
|
nHSM | Numérico | 0 (zero) indica desabilitado, senão habilitado |
|
|
nBugs | Numérico | 0 (zero) indica desabilitado, senão habilitado |
|
|
nState | Numérico | 0 (zero) indica desabilitado, senão habilitado |
|
|
nCacheSize | Numérico |
|
|
|
nVerbose | Numérico | 0 (zero) indica desabilitado, senão habilitado |
|
|
cModule | Caracter |
|
|
|
Retorno
|
| Nome | Tipo | Descrição |
oRet | Objeto | Cria um objeto da Classe Server Socket SSL (Servidor SSL) | ||
Observações |
|
|
Observações
Exemplo
|
| Local SSL2 := 1 |
Métodos
StartTcp
Faz o bind e o listen em uma porta específica do servidor e verifica os certificados e configurações da conexão SSL.
...
Sintaxe
|
| TSktSslSrv():StartTcp ( < nPort >, < cServerName > ) --> lRet |
Parâmetros
...
...
Nome | Tipo | Descrição | Obrigatório | Referência |
nPort | Numérico | Porta de conexão | X |
|
cServerName | Caracter | Identificação do servidor de conexão |
|
|
Retorno
...
| Nome | Tipo | Descrição |
lRet | Lógico | Retorna verdadeiro (.T) se conseguiu fazer o bind, o listen na porta e verificar as configurações da |
Observações
...
...
...
Exemplo
...
| lRet = oSockSrv:StartTcp(nPort) |
|
Accept
Sintaxe
Parâmetros
Retorno
Observações
Exemplo
Faz a aceitação de uma conexão SSL. |
| ||||
Sintaxe |
| ||||
| TSktSslSrv():Accept ( < nTimeOut > ) --> oObjConn | ||||
---|---|---|---|---|---|
Parâmetros |
| ||||
| Nome | Tipo | Descrição | Obrigatório | Referência |
nTimeOut | Numérico | Timeout de aguarde de aceitação em segundos | X |
| |
Retorno |
| ||||
| Nome | Tipo | Descrição | ||
oObjConn | Objeto | Se conseguiu aceiar uma conexão retorna um objeto do tipo "tSktSslConn" e em caso de falha | |||
Observações |
| ||||
| Se nTimeOut for 0 (zero) fica aguardando indefinidamente até aceitar uma conexão. | ||||
Exemplo |
| ||||
| oObjConn := oSockSrv:Accept( 0 ) | ||||
GetError
Sintaxe
Parâmetros
Retorno
Observações
Exemplo
Obtém o erro gerado no Servidor. |
|
| |||
Sintaxe |
| ||||
| TSktSslSrv():GetError ( < cMsgErr > ) --> nRet | ||||
---|---|---|---|---|---|
Parâmetros |
| ||||
| Nome | Tipo | Descrição | Obrigatório | Referência |
cMsgErr | Caracter | Contém a mensagem de erro | X | X | |
Retorno |
| ||||
| Nome | Tipo | Descrição | ||
nRet | Lógico | Contém o código do erro | |||
Observações |
| ||||
| Se não houver erro será retornado 0 (zero). | ||||
Exemplo |
| ||||
| nErrCode := oSockSrv:GetError(@cErrMsg) | ||||
Close
Sintaxe
Parâmetros
Retorno
Observações
Exemplo
Fecha o servidor SSL. |
| ||
Sintaxe |
| ||
| TSktSslSrv():Close() --> lRet | ||
---|---|---|---|
Parâmetros |
| ||
|
| ||
Retorno |
| ||
| Nome | Tipo | Descrição |
lRet | Lógico | Verdadeiro (.T.) se fechou corretamente ou falso (.F.) se houve algum erro no fechamento | |
Observações |
| ||
|
| ||
Exemplo |
| ||
| lRet := oSockSrv:Close() | ||
Propriedades
nAccepted
Sintaxe
Retorno
Observações
Exemplo
Indica o número de clientes que foram aceitos (conectados). |
| ||
Sintaxe |
| ||
| TSktSslSrv():nAccepted | ||
---|---|---|---|
Retorno |
| ||
| Nome | Tipo | Descrição |
nAccepted | Numérico | Indica o número de clientes que foram aceitos (conectados) | |
Observações |
| ||
|
| ||
Exemplo |
| ||
| nAccepted := oSockSrv:nAccepted | ||
lBinded
Sintaxe
Retorno
Observações
Exemplo
Indica se o servidor está conectado e escutando a porta. |
| ||
Sintaxe |
| ||
| TSktSslSrv():lBinded | ||
---|---|---|---|
Retorno |
| ||
| Nome | Tipo | Descrição |
lBinded | Lógico | Indica se o servidor está conectado e escutando a porta | |
Observações |
| ||
|
| ||
Exemplo |
| ||
| lBinded := oSockSrv:lBinded |
...
Protheus 11
Veja Também
tSktSslConn , SetSslObj , GetSslObj
Âncora | ||||
---|---|---|---|---|
|
Teste: 10