Histórico da Página

1. Sistema operacional Microsoft Windows Server 2012 64 bits ou superior OU sistema operacional Linux 64 bits (kernel 6.x ou superior);
2. 100MB de espaço em disco;
3. Servidor web Apache Server 2.4.x para ambientes 64 bits;
4. REDIS 5.0.14 ou superior para ambientes 64 bits.

Nota: Tanto o servidor web Apache quanto o servidor de banco de dados REDIS devem ser instalados previamente. Para mais informações sobre como instalar cada um destes requisitos em ambientes Microsoft Windows, consulte a seção Demais Informações deste documento.

Para a instalação da solução, basta copiar o módulo mod_totvs_access_control_v1.so para o diretório modules do Apache¹. A configuração do servidor para uso do módulo varia conforme o sistema operacional e abaixo são mostradas as configurações para ambientes Windows e ambientes Linux baseados no padrão LSB.

LoadModule totvs_access_control_module_v1 modules/mod_totvs_access_control_v1.so

<IfModule totvs_access_control_module_v1>
  <Location /api/tlra/accesscontrol/v1>
    SetHandler mod_totvs_access_control_v1-handler
  </Location>
</IfModule>

LoadModule totvs_access_control_module_v1 modules/mod_totvs_access_control_v1.so

<IfModule totvs_access_control_module_v1>
  <Location /api/tlra/accesscontrol/v1>
    SetHandler mod_totvs_access_control_v1-handler
  </Location>
</IfModule>

NOTAS:

1. O diretório de módulos do servidor apache pode variar conforme sua instalação em ambientes Windows. Em ambientes Linux, o padrão é o diretório /usr/lib/apache2/modules.

O caminho para o arquivo de configuração do módulo varia conforme o sistema operacional escolhido¹. Abaixo, seguem os caminhos indicados para cada sistema operacional.

• Windows: C:\TOTVS\etc\accesscontrol\accesscontrol.conf
• Linux: /etc/accesscontrol/accesscontrol.conf

O formato do arquivo é texto é apresentado conforme abaixo:

Hostname SERVIDOR\INSTANCIA
DriverID MSSQL
Database sara_db
Username sa
Password TOTVS@123456
Port 1433
CharSet SQL_Latin1_General_CP1_CI_AS

As configurações seguem a determinação descrita na tabela a seguir.

NOTAS:

1. O diretório de configurações, assim como seu arquivo, devem ser previamente configurados, sob risco da geração de exceções durante o processo de inicialização do servidor Apache.
2. Não é recomendada a alteração do valor parametrizado no arquivo.

Após a criação/alteração dos arquivos de configuração, tanto do servidor Apache quanto do módulo, basta executar a (re)inicialização do servidor web para que o módulo seja carregado e possa ser utilizado. Para ambientes Linux, recomenda-se a execução, via terminal, do comando abaixo, o qual habilita o módulo para uso e reinicia o servidor Apache.

$ sudo a2enmod totvs_access_control_v1 & sudo service apache2 restart