Utilização com token CLOUDRM

As senhas das rotas de API que utilizam token CLOUDRM podem ser geradas através do software disponibilizado pela framework RmApiKeyGenerator. Para mais informações de como utilizar esse software acesse a documentação: APIs CLOUD. Este recurso esta disponível a partir da versão 12.1.2402.


Este documento tem como objetivo explicar como utilizar as API's do TOTVS Audit.

Observação

Em ambientes que possuem a definição de SubDomainMask, a base de dados será recuperada automaticamente a partir da URL, como é o caso do ambiente Multi Tenancy.

Mais detalhes sobre esse carregamento do alias podem ser encontrados em: https://tdn.totvs.com/x/9XwcEQ

Em ambientes que não possuem a definição de SubDomainMask, é necessário configurar a tag DefaultDB no arquivo de configuração do serviço.

Routes:

/api/totvs-audit/v1/totvs-audit-config/alias

Get

Retorna o nome do alias que será utilizado pelo TOTVS Audit

Autenticação


Basic Auth: Login e Password do Banco

Resposta


Response
"alias"

Paramêtros

Não possui parâmetros

/api/totvs-audit/v1/totvs-audit-config

Get

Retorna as Configurações do Totvs Audit

Autenticação


Basic Auth: Login e Password do Banco
ou usar /api/totvs-audit/v1/totvs-audit-config/token-auth para Configuração por token:

Type Api Key:

Key: CLOUDRM

Resposta


Response
{
    "Schema": "SchemaConfigurado", 
    "Enabled": <boolean>,
    "EnabledLogLGPD": <boolean>
}

Paramêtros

"Schema": Nome do Schema utilizado pelo TOTVS Audit

"Enabled": Status do TOTVS Audit

"EnabledLogLGPD": Status do TOTVS Audit para tabelas LGPD

Post

Aplica configuração pendentes do TOTVS Audit.

Ao executar outras rotas do TOTVS Audit as configurações vão ficar marcadas como pendentes, a responsabilidade desta rota é aplicar estas configurações

Autenticação

Basic Auth: Login e Password do Banco

ou

usar /api/totvs-audit/v1/totvs-audit-config/token-auth para Configuração por token:

Type Api Key:

Key: CLOUDRM

Requisição

Request
{
  "Enabled": <boolean>,
  "EnabledLogLGPD": <boolean>,
  "NoUseRequirements": <boolean>
}


Paramêtros

"Enabled": Status do TOTVS Audit

"EnabledLogLGPD": Status do TOTVS Audit para tabelas LGPD

"NoUseRequirements":  Define se irá ignorar os pré requisitos de execução do totvs audit


Versão 12.1.2402

As rotas abaixo estão dísponiveis a partir da versão 12.1.2402.

/api/totvs-audit/v1/totvs-audit-config/audit-tables

Get

Retorna tabelas ativas no totvs audit

Autenticação


Basic Auth: Login e Password do Banco

ou

usar /api/totvs-audit/v1/totvs-audit-config/audit-tables/token-auth para Configuração por token:

Type Api Key:

Key: CLOUDRM

Resposta


Response
{
    "auditTables": [  #Lista de Tabelas
        {
            "name": "TableName",
            "delete": <boolean>,
            "update": <boolean>,
            "insert": <boolean>
        }, 
	],
    "lgpdAuditTables": [   #Lista de tabelas
         {
            "name": "TableName",
            "delete": <boolean>,
            "update": <boolean>,
            "insert": <boolean>
         },  
	 ]
}


Paramêtros

"auditTables": Tabelas que estão configuradas manualmente para serem auditadas

"lgpdAuditTables": Tabelas que estâo configuradas automaticamente pela LGPD para serem auditadas

"name":  Nome da Tabela

"delete": Status da auditoria de Deletes da tabela

"update": Status da auditoria de Updates da tabela

"insert": Status da auditoria de Insert da tabela


Post

Configura as tabelas solicitadas para serem ativadas no Totvs Audit e recebe como parâmetros a lista de tabelas que deseja alterar as configurações de auditoria, Sendo obrigatório informar os parâmetros Update, Insert e Delete de cada tablela.

Caso deseje que uma tabela não seja auditada definir todos os parâmetros da mesma como false.

Autenticação


Basic Auth: Login e Password do Banco

ou

usar /api/totvs-audit/v1/totvs-audit-config/audit-tables/token-auth para Configuração por token:

Type Api Key:

Key CLOUDRM


Requisição

Request
{
  "auditTables": [ #Lista de Tabelas
    {
      "Name": "TableName",
      "delete": <boolean>,
      "insert": <boolean>,
      "update": <boolean>
    }
  ]
}


Paramêtros

"auditTables": Tabelas que serão configuradas  para serem auditadas

"name":  Nome da Tabela

"delete": Status da auditoria de Deletes da tabela

"update": Status da auditoria de Updates da tabela

"insert": Status da auditoria de Insert da tabela