LDAP é um protocolo amplamente utilizado para gerenciamento e autenticação de usuários em redes corporativas. Ele permite que aplicações se conectem a um diretório centralizado com o ACtive Directory, para validar as credenciais e obter informações sobre os usuários.

Na versão **9.12**, o Scriptcase passa a contar com a biblioteca **LdapRecord**, trazendo melhorias significativas na integração com servidores LDAP. Esta nova biblioteca amplia as possibilidades de controle de acesso, permitindo uma gestão mais completa dos usuários e grupos dentro do Scriptcase.

Confira abaixo um comparativo dos recursos da adLDAP com a **LdapRecord,** que passa a ser disponibilizada na ferramenta:

|  |  |  |
| --- | --- | --- |
| **Aspecto** | **adLDAP - Antiga** | **LdapRecord - Nova Biblioteca** |
| Arquitetura | Implementação mais antiga e menos flexível. | Framework moderno com suporte a Active Directory, OpenLDAP e 389 Directory Server. |
| Recuperação de Dados | Limitações na obtenção de todos os atributos de usuários e grupos. | Permite recuperar todos os dados dos usuários e informações detalhadas dos grupos diretamente do diretório LDAP. |
| Integração com Frameworks | Integração limitada com frameworks modernos. | Inclui integração robusta com frameworks como modernos, facilitando o desenvolvimento de aplicações PHP com autenticação LDAP. |
| Manutenção e Atualizações | Menos ativa em termos de atualizações e suporte. | Ativamente mantida, oferecendo melhorias contínuas e suporte atualizado. |

## Habilitando a biblioteca LdapRecord no Projeto

![Info](https://static.zohocdn.com/zoho-desk-editor/static/images/info.png/)

Esta etapa é necessário apenas para projetos antigos. Para projetos novos (em instalações com upgrade ativo) a biblioteca LdapRecord já vem habilitada.

Em projetos já existentes do Scriptcase, criados em releases anteriores da ferramenta, será necessário definir o uso da biblioteca nas propriedades do projeto.

Siga os passos abaixo:

**1.** Acesse o projeto que deseja atualizar o módulo de segurança LDAP:

**![](https://help.scriptcase.net/galleryDocuments/edbsn930c686cc27625cda7c53ac1d26935cf9f833c54b01451b5808f6b758fb4bfa5e3a2edcb7abf0fe1fafd5e9878357d8e?inline=true)**

**2.** Dentro do projeto acesse **Projeto****→****Propriedades**

![](https://help.scriptcase.net/galleryDocuments/edbsn0dc992a8361258c997f68c3798ff432517d8dbb1e20f8121cae0ff0cfedc7d7c1e38acb9809700afe40c064b01de654b?inline=true)

3. Nas propriedades do projeto selecione a biblioteca **LdapRecord** e Salve.

![](https://help.scriptcase.net/galleryDocuments/edbsn3f9d0f5e7824e8c9291d7cdbf2deb014cacff7d1e1c79e1b3208614d84190b4ad390c519b370f670d026fb71833aaa8e?inline=true)

## **Criando o Módulo de Segurança com LDAP**

1. Vá até "Módulos → Segurança":

![](https://help.scriptcase.net/galleryDocuments/edbsn2131ca80b0f26898db02ca0832a048818938b7a6816ca32dfafccab74b28a193f1b9a95be608c8cf8626c947503cdcea?inline=true)

2. Escolha o tipo de segurança LDAP que será utilizada:

![](https://help.scriptcase.net/galleryDocuments/edbsn8af448b19e9179f4df571e47bc74effd5e462cc1bb4f789fd1275cd45780c9ca22d066b9378042b56ba97c2f5b0f3eff?inline=true)

3. Selecione a conexão que você utilizou no LDAP antigo e clique em prosseguir:

![](https://help.scriptcase.net/galleryDocuments/edbsn2ee058d61f5b80c88c777215e1613bc8803f5e28b73e38c95ae7b93bcaff3be6ec9417e9e037b595483f0ea48e49be5f?inline=true)

4. Em "Geral", defina um prefixo para as aplicações do novo módulo:

![](https://help.scriptcase.net/galleryDocuments/edbsna51acce66207fe48014806347f8169381324fd6204222a38d7fd1e6f24a3b1ffc8d601405f8ded2960801ba7d5747ed7?inline=true)

5. Em "LDAP", ponha as informações do seu servidor:

![](https://help.scriptcase.net/galleryDocuments/edbsn6d100e9e8030321a324498734b2943c378e3bb37faeefbbad893bafc01847f129458ac4a9a32b89200a256ca1cc97a6d?inline=true)

6. Em "Cadastrar primeiro registro", ponha as informações de login e clique em "Teste de conexão". Recebendo a tela de sucesso, clique em "Gerar segurança":

![](https://help.scriptcase.net/galleryDocuments/edbsna1a1d29ec1780cc9e976682856dc3f979b1d3130afad1f827f5454586c7a1b16ac0a6605832b441dee944e074bd5d805?inline=true)

7. A aba de salvar perfil é opcional. Clique em "Ok":

![](https://help.scriptcase.net/galleryDocuments/edbsn34f8cb3fce99f0152f949358aa55630087b29eee3185e1b5bdd336aee48c87f79588b5992eca1bf4541b50e0786e91fa?inline=true)

## **Conclusão**

Com a versão **9.12**, o Scriptcase introduziu o suporte à biblioteca **LdapRecord** como um novo recurso para integração com servidores LDAP. Essa implementação oferece maior compatibilidade, melhor desempenho e a possibilidade de recuperar **todos os dados dos usuários e grupos**, proporcionando um controle mais completo da autenticação.

A biblioteca **adLDAP** continua disponível para usuários que não possuem upgrade ativo, garantindo compatibilidade com implementações anteriores. Caso tenha direito a uso, para aproveitar os benefícios da **LdapRecord**, é necessário definir o uso da nova biblioteca, que pode ser habilitada globalmente em **Administração > Opções** ou de forma específica para projetos já existentes em **Propriedades do Projeto**.

Com essa atualização, a autenticação via LDAP no Scriptcase se torna mais robusta, segura e preparada para ambientes corporativos que exigem maior flexibilidade na gestão de acessos.