Servio de Auditoria do TOPConnect 4 (Audit Trail)

Ambiente Arquivos envolvidos Tabelas utilizadas Verses Pas Data da reviso : TOPConnect 4 : AuditTrail4.exe : Tabelas que sero auditadas, AUDIT_TRAIL : TOPConnect 4 : Todos : 08/01/07

O servio de Audit Trail do TOPConnect tem o objetivo de auditar todas as atividades realizadas pelos usurios do Protheus, no banco de dados. Esse programa pode ser configurado atravs de nveis de auditoria, em que so registradas todas as operaes de insero, alterao e excluso de dados da base. Esse documento tem como propsito orientar as melhores prticas de instalao e configurao do servio de Audit Trail a fim de obter melhor performance do ambiente como um todo. importante destacar que a leitura completa desse documento de extrema importncia para o entendimento do servio e sucesso em sua instalao e configurao.

Importante: Para usurios do Audit Trail que utilizam TOPConnect 4 com verses anteriores ao build 20050610 e que utilizam a funcionalidade de consulta do Protheus, necessrio que seja excluda a tabela AUDIT_TRAIL do banco de AUDITORIA para que ela seja criada com as colunas e ndices necessrios consulta.

Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)- 1

Infra-estrutura
Para obter melhor performance, extremamente recomendvel que o servio do Audi Trail seja instalado em uma mquina diferente do ambiente de produo, para que esse servio no concorra com o consumo de recursos dessa mquina. A figura a seguir mostra como o servio pode ser instalado para obter a melhor performance.

2 Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)

Instalao
O arquivo de instalao do Audit Trail 4 est disponvel na rea de FTP da Microsiga (ftp://ftp.microsiga.com.br/protheus/TOPConnect4/) . Deve-se fazer o download da verso do Audit Trail correspondente ao sistema operacional da mquina em que ser instalado. Aps instalar o Audit Trail 4, atravs da execuo do arquivo AuditTrail4.exe, necessrio verificar se o seu servio est iniciado, conforme demonstra a figura a seguir.

Tambm necessrio que ambos os servidores, de produo e de auditoria, tenham o servio do TOPConnect 4 instalados. O arquivo de instalao do TOPConnect 4 encontra-se disponvel na rea de FTP da Microsiga (ftp://ftp.microsiga.com.br/protheus/TOPConnect4/). necessrio fazer o download da verso do TOPConnect 4 para o sistema operacional da mquina em que ser instalado.

Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)- 3

Configurao
Para configurar o servio do Audit Trail, necessrio que os servidores de auditoria e de produo estejam configurados, conforme a orientao a seguir. Servidor de Auditoria Aps os servios Audit Trail 4 e TOPConnect estarem instalados e iniciados, necessrio configurar o Audit Trail com as informaes do servio do TOPConnect que ser responsvel pela gravao dos dados de auditoria. O Audit Monitor a ferramenta utilizada para configurar e gerenciar o servio. Observe a figura abaixo; ela demonstra como configurar esse servio.

Endereo IP do servidor TOPConnect responsvel pela gravao, no caso o servidor AUDITORIA

Porta do Servidor TOPConnect de gravao Ambiente configurado no servidor TOPConnect de gravao (AUDITORIA)

Para um melhor acompanhamento dos processos de auditoria, possvel, atravs da pasta Estatsticas, visualizar o nmero de conexes que esto sendo monitoradas pelo servio de Audit Trail, o nmero de operaes armazenadas para gravao, o nmero de operaes que esto sendo executadas por segundo e o total de operaes j auditadas desde a inicializao do servio. A pasta Mensagens tambm apresenta informaes importantes para o gerenciamento desse servio.

4 Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)

A figura a seguir descreve as opes contidas na pasta de estatsticas.

Nmero de conexes que esto sendo auditadas. Nmero de operaes que aguardam na fila.

Nmero de operaces, realizadas por segundo.

Total de operaes j auditadas

Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)- 5

Servidor de Produo
No servidor de produo necessrio configurar o TOPConnect para utilizar o servio de auditoria. Essa configurao feita atravs do TOPMonitor do servidor de produo. A figura abaixo demonstra como proceder. Nome ou IP do Servidor em que se encontra o servio do Audit Trail (AUDITORIA)

Porta utilizada pelo Audit Trail no servidor (AUDITORIA) em que est instalado este servio.

Nvel de Auditoria que ser utilizado Opes: 1, 2 ou 3 Auditar todas as tabelas gerenciadas pelo TOPConnect

Atravs desta opo possvel selecionar qual(is) tabela(s) gerenciadas pelo TOPConnect que sero auditadas

Niveis de Auditoria

O servio de Audit Trail utiliza trs nveis de auditoria que devem ser escolhidos de acordo com a necessidade de informaes a serem geradas. O nvel de auditoria configurado no servidor de produo. Segue a lista dos itens auditorados em cada um dos nveis.

6 Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)

Nvel 1

Insero de registros Alterao de registros Delete e recall

Nvel 2

Insero de registros Alterao de registros, salvando o contedo anterior de cada coluna alterada Delete e recall Execuo de statements SQL, executados pela aplicao atravs do comando TCSQLExec()

Nvel 3

Insero de registros Alterao de registros, salvando o contedo anterior de cada coluna alterada Delete e recall Execuo de statements SQL executados pela aplicao atravs do comando TCSQLExec() Auditar transaes (begin transaction, commit e rollback)

Tabelas e Colunas

Atravs dessa opo, possivel selecionar as tabelas gerenciadas pelo TOPConnect que sero auditadas. Se a opo selecionada for a escolha de uma ou mais tabelas, ento ser necessrio informar o nome do ambiente do TOPConnect que contm essa(s) tabela(s) e escolher qual(is) tabela(s) sero auditada(s).

Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)- 7

Nome do Environment do servidor TOPConnect de Produo

8 Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)

Selecionar as tabelas que sero auditadas

Todas as tabelas do Environment

Boletim Tcnico Servio de Auditoria do TOPConnect 4 (Audi Trail)- 9