❓ Dúvida

Como configurar o TOTVS Protheus para que usuários inativos sejam automaticamente desconectados após um período de tempo, considerando corretamente as regras de prevalência entre AppServer, Usuário e Grupo?

🧩 Ambiente

• Produto: TOTVS Backoffice — Linha Protheus

• Módulo: Configurador

• Framework: MP-FRAME

• Versão: A partir da versão 11

✅ Visão geral da solução

O Inactive TimeOut é o mecanismo do Protheus responsável por encerrar sessões de usuários que permanecem inativos, contribuindo para:

• Segurança do ambiente

• Liberação de licenças

• Redução de consumo de recursos do AppServer

A configuração pode ser feita em três níveis, que obedecem a regras claras de prevalência:

1. Arquivo appserver.ini (global)

2. Usuário

3. Grupo de Usuários

⚠️ O comportamento final não é soma de tempos, mas sim hierarquia de prioridade, definida também pela Regra de Acesso por Grupo.

⚙️ Configuração no arquivo appserver.ini (nível global)

Aplica-se a todos os usuários que não possuam configuração específica no Usuário ou no Grupo.

Passo a passo

1. Acesse o servidor de aplicação do Protheus

2. Abra o arquivo appserver.ini

3. Localize a seção do ambiente (ex.: [P12])

4. Inclua a chave InactiveTimeOut com valor em segundos

Exemplo

[P12]
SourcePath=C:\TOTVS 12\Microsiga\protheus\apo\
RootPath=C:\TOTVS 12\Microsiga\protheus_data
CtreeRootPath=C:\TOTVS 12\Microsiga\protheus_data
StartPath=\system\
RpoDb=top
RpoLanguage=Portuguese
RpoVersion=120
LocalFiles=CTREE
HELPSERVER=localhost:8079
FWTraceLOG=1
TOPMEMOMEGA=1
InactiveTimeOut=300

➡️ Nesse exemplo, usuários sem regra específica serão desconectados após 5 minutos de inatividade.

📌 Alterações no appserver.ini exigem reinicialização do AppServer.

👤 Configuração no Usuário

Permite definir um timeout individual, desde que o Grupo não esteja priorizando suas próprias regras.

Passo a passo

1. Acesse Configurador > Usuário > Senhas > Usuários

2. Selecione o usuário e clique em Alterar

3. Aba Restrições de acesso

4. Informe Timeout da estação (em minutos)

5. Clique em Confirmar

📌 Valor 0 (zero) significa sem timeout.

👥 Configuração no Grupo

Utilizada quando se deseja aplicar uma regra comum a todos os usuários de um grupo.

Passo a passo

1. Acesse Configurador > Usuário > Senhas > Grupos

2. Selecione o grupo e clique em Alterar

3. Aba Grupo › seção Parâmetros

4. Informe Timeout da estação (em minutos)

5. Clique em Confirmar

🧠 Regras corretas de prevalência (revisadas)

A aplicação do timeout final depende da existência de grupo e da Regra de Acesso por Grupo.

1️⃣ Usuário sem grupo

• Sempre prevalece o Timeout do Usuário

• O appserver.ini só é usado se o Usuário não tiver timeout

2️⃣ Regra de acesso por grupo = Desconsiderar

• O Grupo é ignorado

• Vale sempre o Timeout do Usuário

• Se Usuário = 0 → vale o AppServer

3️⃣ Regra de acesso por grupo = Somar ou Priorizar

(Na prática, funcionam de forma equivalente)

A hierarquia é:

1. Grupo, se > 0

2. Usuário, se Grupo = 0

3. AppServer, se Grupo = 0 e Usuário = 0

4. Sem timeout, se todos forem 0 ou inexistentes

📌 Não existe soma real de tempos.

📋 Tabela de comportamento consolidado

🎯 Cenários práticos

🔹 Cenário 1 — Timeout exclusivo para um usuário em grupo

✔️ Configure:

• Regra de acesso por grupo = Desconsiderar

• Timeout definido no Usuário

🔹 Cenário 2 — Timeout definido no Usuário e no Grupo

✔️ Resultado:

• Grupo prevalece

• Exceto se a regra estiver como Desconsiderar

🚨 Erros comuns

• Achar que Somar soma tempos (não soma)

• Definir timeout no Usuário sem ajustar a Regra de acesso por grupo

• Informar 0 achando que representa tempo ilimitado configurável

• Esquecer de reiniciar o AppServer após alteração no appserver.ini

📎 Recomendações da Mastersiga

• Use timeout por grupo como padrão organizacional

• Reserve timeout por usuário apenas para exceções

• Evite tempos muito curtos para não impactar produtividade

• Documente a política de timeout adotada no ambiente

📚 Referências

• Framework MP — TOTVS Protheus

• Configurador › Usuários e Grupos

✍️ Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS
Mastersiga Consultoria

Mastersiga Consultoria — Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.