S-Works - How to "Configuração ActiveDirectory - Versão 2.0+"

S-Works - How to "Configuração ActiveDirectory - Versão 2.0+"


Objetivo


Descrever o passo a passo para configurar a autenticação de usuários no sistema S-Works através de Actine Directory ou LDAP compatível.
A partir da versão 2.0 do sistema, migrada para do .NET Framework para .NET Core, as configurações devem ser feitas no arquivo “appsettings.json” ao invés do arquivo “web.config”.

Passo a passo
  1. Abra o configuração “appsettings.json”, localizado na pasta raiz do módulo“SWorks.WebApp”. 
  2. Em caso de ambiente clusterizado, certifique-se que a imagem utilizada em todos os servidores contenha as mesmas configurações.


Fonte: Documento anexo a este artigo.
  1. Cada chave de configuração deverá ser adicionar na propriedade “AppSettings”, localizada dentro do arquivo conforme imagem de exemplo abaixo.


Fonte: Documento anexo a este artigo.



Exemplo


Fonte: Documento anexo a este artigo.


  1. CustomAuth: preencher com valor “AppUserManagerLDAP”
  2. CustomAuthCodigoEmpresa: preencher com o código da empresa onde os usuários serão criados automaticamente em caso de login com sucesso.
  3. LDAP_CONFIG: conjunto de configurações chave/valor, separados por ponto-e-vírgula: o Servidor: IP ou nome do servidor do Domain Controller.

o Usuário: em caso de AD sem acesso anônimo, informar o nome de usuário com permissão de leitura ao AD.

o  Senha: informar a senha do usuário.

o ContextOptions: chave de configuração opcional, informada apenas em caso o AD se comunique utilizando o protocolo de segurança LDAPS.                                                                                       Caso seja necessário, informar os valores “Negotiate|SecureSocketLayer”.

  1. LDAP_GRUPOS: conjunto de configurações chave/valor que indica quais grupos de AD representam os perfis de usuários no sistema. A cada login com sucesso, os perfis de usuários são sincronizados de acordo com os grupos de AD informados.


OBSERVAÇÕES

  1. Se o usuário não estiver em algum grupo de acesso, ele poderá realizar o login no S-Works, porém não terá nenhuma permissão. E os que se encontram no grupo do AD, terão perfil de administrador.
  2. Os usuários são criados na empresa número 1, caso seja necessário trocar o código da empresa, altere o X do campo “value” na tag <add key="CustomAuthCodigoEmpresa" value="X"/>.
  3. Para adicionar outros grupos de AD, Você deve incluir "ponto e vírgula" depois do grupo na tag <ass key= "LDAP_GRUPOS" value="Admin=GrupoAD;Analista=GrupoAD2;Oper ador=GrupoAD3"/>.
  4. O usuário que irá acessar o sistema deverá ter as seguintes informações preenchidas no AD: Nome, sobrenome, e-mail e usuário.
  5. Pode ocorrer erro devido a caracteres não decodificados pelo .NET, tais como, ‘&’, ‘%’ e outros. Caso a autenticação não funcione, verifique este erro rodando a aplicação (S-Works) dentro do próprio servidor, exemplo: http://localhost:8085/ para visualizar o erro real.



    • Related Articles

    • Autenticação LDAP

      Autenticação LDAP - Service Portable A autenticação LDAP pode ser utilizada de 2 formas:     Utilizando o serviço PORTABLE (compatibilidade com Linux chave true)     Sem utilizar o serviço PORTABLE (chave false) Chave de configuração e autenticação ...

    • Novidades da versão S-Works 2 4

      1. Verificar qualidade do arquivo de imagem CÓDIGO: 92966 Novo método na API Core com objetivo validar a qualidade da imagem. Essa parametrização tem como característica garantir que a imagem que está sendo importada para S-Works possui a quantidade ...

    • S-Works - Manual de Instalação da Versão 2.0 - v2 2 1

      Versionamento Versão Data Comentários 1.0 23/09/2020 Versão inicial do documento. Atualização do manual para conter etapas de instalação 2.0 20/01/2021 manual do sistema e seus módulos, assim como configuração dos mesmos. 2.1 21/01/2021 Revisão, ...

    • S-Works - Manual de Instalação da Versão 2.2

        Versionamento   Versão  Data  Comentários    1.0  23/09/2020  Versão inicial do documento.   2.0  20/01/2021  Atualização do manual para conter etapas de instalação manual do sistema e seus módulos, assim como configuração dos mesmos.   2.1  ...

    • Breaking Change Versão 2.4.5 - Integração com AD

      Breaking Change: Integração com AD Realizamos uma alteração na forma de se integrar no AD (via LDAP), na versão 2.4.5 do S-Works. O código anterior, que utilizava bibliotecas nativas da Microsoft, não era portável, ou seja, não executava em ambiente ...