TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Usuário desconhecido (santos.vitor)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Ricardo Mansano Godoi

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Portuguese

Pagetitle
GetCredential
GetCredential

Obtém a credencial do usuário, no sistema operacional, no qual está autenticado.

Aviso
titleImportante

Esta função suporta apenas o Active Directory, não possui suporte ao Active Directory Federation Services.

🚨 Para uso de outros IDP (Identity provider) é necessário o Identity.

Abaixo mais detalhes sobre estes serviços:

O Active Directory ou AD é uma implementação da Microsoft de serviço de diretório no protocolo LDAP que armazena informações sobre objetos em rede de computadores e disponibiliza essas informações a usuários e administradores desta rede.

O Active Directory Federation Services ou ADFS é um provedor de identidade (IDP) fornecido pela Microsoft que funciona como um intermediário a um serviço ou domínio externo e permite a consulta e uso das credenciais existentes do Active Directory.

Sintaxe

Bloco de código
collapsefalse
GetCredential()

Retorno

Nome

Tipo

Descrição

cCredentialId

caractere

Retorna uma string que corresponde a credencial do usuário.

Observações

  • O retorno será um valor único por usuário e máquina.
  • A credencial retornada é da estação em que o Smart Client está sendo executado.
  • Em builds iguais ou superiores a 7.00.131227A - 13.2.3.35 e builds iguais ou superiores a 7.00.170117A - 17.3.0.3 (Lobo Guará), a fonte de dados que representa o identificador único do host foi modificado para os sistemas operacionais Linux e Mac OS, provocando uma string maior no retorno.
  • Para os Sistemas Operacionais Linux e Mac OS a composição da string de retorno segue a seguinte sequência:
  1. S
  2. ID de usuário real do processo (real user ID)
  3. ID de usuário efetivo (effective user ID)
  4. ID do grupo real do processo (real group ID)
  5. ID do grupo efetivo (effective group ID)
  6. Identificador único do host: Corresponde ao "machine-id" em Linux e ao "Hardware UUID" em Mac OS
  7. Os valores acima são separados por hífen. O identificador de host do Mac OS possui hifens em sua composição original.
  8. Falhas na obtenção de qualquer um desses valores podem indicar má configuração do Sistema Operacional e devem ser analisadas pelo administrador da estação.
  • Exemplo de ClassID
  1. Windows : "S-1-5-21-776561741-725345543-682003330-1003"
  2. Linux : "S-1000-1000-1000-1000-fde197e419c64c7ea3d5ce1307cd2999"
  3. Mac OS: "S-505-505-20-20-510FA5E1-5FF4-5D47-8D34-97A7ECB4D774"

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
User Function tstClassID()
  Local cCredential := NIL
  cCredential := GetCredential()
    
  if valtype(cCredential) == 'C'
    conout("Ok")
    conout(cCredential)
  else
    conout("Try Again!!!")
  endif
return

Abrangência

Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server