Instruções de Instalação Local

Introdução

Este guia cobre a instalação local baseada em Docker do Axe Auditor, versão 2.25.0.

Mídia

Você pode encontrar a mídia no servidor SFTP.

• Arquivo do Instalador: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
• Certificados SSL: Devem estar no formato PEM.

Backup

Antes de prosseguir, faça um snapshot completo do servidor. Este backup pode ser usado para restaurar o sistema caso ocorram problemas durante ou após a instalação.

Nota: Recomendamos fortemente que você só continue após completar um backup completo do servidor.

Pré-requisitos

Certifique-se de que os itens a seguir estejam disponíveis e configurados:

• Docker Engine
• Docker Compose / Podman Compose
• psql cliente
• CreateSSOCustomers.py script deve ter sido executado
• Usuários do banco de dados assure e assure_owner devem existir
• O banco de dados de destino deve ser criado

Configuração da Mídia

1. Baixar axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. Navegue até o diretório de downloads
3. Extraia o arquivo:

tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

Certificados SSL

1. Certifique-se de que o diretório SSL exista:

ls axeauditor-docker/volumes/nginx/

2. Se não existir, crie-o:

mkdir -p axeauditor-docker/volumes/nginx/ssl

3. Copie seus certificados para:

axeauditor-docker/volumes/nginx/ssl

4. Renomeie os arquivos dos seus certificados para:

• nginx.crt
• nginx.key

Instância Keycloak

Este instalador requer uma configuração Keycloak externa. Certifique-se de ter as seguintes informações:

• URL: por exemplo, https://auth.deque.com
• Realm: por exemplo, axe
• ID do Cliente
• ID do Grupo
• Segredo do Cliente

Instalação

Configuração do Axe Report

Edite o .env arquivo:

vi axeauditor-docker/.env

Migração do Banco de Dados

1. Navegue até a pasta DB
2. Edite auditor_db_deploy.sh para definir as variáveis corretas
   (Nota: O usuário do BD deve ser um superusuário)
3. Execute o script:

./auditor_db_deploy.sh

Carregar Imagens do Docker

docker load -i resources/axeauditor-2.25.0-ironbank-images.tar

Iniciar Contêineres do Docker

cd axeauditor-docker/
docker compose up -d

Verificar Logs

docker logs -ft axeauditor-docker-axeauditor-1

Procure pela linha:

Starting axe Auditor…

Assim que visível, você pode prosseguir com as etapas restantes.

Token OIDC

1. Visite a URL de autenticação: por exemplo, https://auth.deque.com
2. Navegue até **Clientes** → procure e selecione seu cliente
3. Vá para a **Instalação** aba
4. Selecione **Keycloak OIDC JSON**
5. Copie e salve o valor para uso posterior

Configurar um Novo Cliente Auditor

1. Visite a URL de configuração do cliente do sistema:
   por exemplo, docker-fi-215.dequeindiadev.com/system/client
2. Cole o Keycloak OIDC JSON do passo anterior
3. Insira as credenciais do administrador do domínio

Ativar Configuração de Compartilhamento de Execução de Teste

• Vá para as **Configurações de Administração** página
• Certifique-se de que **Ativar Compartilhamento de Execução de Teste** esteja **desmarcado por padrão**
  (a menos que especificado pelo cliente)

Atualizar Versão do axe Core & Padrão de Acessibilidade

• Atualize a **versão do axe-core** para a **mais recomendada**
• Defina o **Padrão de Acessibilidade Padrão** para **WCAG 2.1 Nível AA**
• Selecione **todos os Padrões de Acessibilidade**

Mostrar Cartão de Pontuação de Acessibilidade

• Deve estar **marcado** ou **conforme preferência do cliente**

Atualizar Configurações do axe Reports

Se **Relatórios do axe** foi ativado durante a instalação:

• Defina **Atualizar Relatórios do axe** opção para:
  System Administrator only

Verificação de Sanidade por QA e Especialistas

1. Acesse o URL do servidor Axe Auditor
2. Verifique o rodapé da aplicação para a versão: 2.25.0
3. Realize uma verificação básica da interface do usuário
4. Solicite à equipe de QA que faça uma verificação de sanidade

Excluir a Pasta do Instalador (Recomendação)

Após a instalação, é recomendado excluir o arquivo do instalador e os arquivos extraídos:

rm -f axeauditor-docker-on-prem-installer-2.25.0.tar.gz