Configuração do Axe
Para criar configurações consistentes em toda a sua organização para múltiplos produtos da Deque, a Configuração do Axe permite que usuários e administradores controlem todas as suas configurações em um único lugar! Para administradores, é possível definir padrões para toda a organização e até mesmo bloquear configurações específicas em valores específicos. Para todos os usuários, configurar essas opções em um único lugar permite a consistência entre produtos, plataformas, navegadores e dispositivos.
A Configuração do Axe é atualmente compatível com a Extensão Axe DevTools, o Axe Developer Hub e o Servidor Axe MCP. Outros produtos da Deque estão trabalhando para adicionar suporte para a Configuração do Axe no futuro. Leia mais sobre como as mudanças de configuração serão refletidas nesses produtos.
Este recurso já está disponível em instâncias locais e em nuvens privadas!
Como Funciona
A página de Configuração do Axe pode ser encontrada em axe.deque.com/configuration. Uma vez lá, os usuários terão acesso a um painel de configuração "Global", bem como a links para configurar outros produtos da Deque aos quais tenham acesso.
Administradores de empresas, usuários empresariais, assim como titulares de licenças individuais têm acesso à Configuração do Axe. As capacidades de cada tipo de usuário variam ligeiramente. Essas diferenças são descritas abaixo.
Para configurações que estão ajustadas tanto na Configuração do Axe e configuradas via política, o valor definido na Configuração do Axe será utilizado em vez do valor da política.
Administradores Empresariais
As configurações de administrador são divididas em 2 casos de uso principais:
- definir padrões específicos
- "bloquear" configurações específicas e impedir que os usuários em sua organização as alterem
Definindo Padrões
Quando um administrador define um valor padrão para uma configuração, os usuários em sua empresa podem esperar ver suas configurações refletirem esse padrão. No entanto, se os usuários escolherem, eles podem substituir o padrão, a menos que o administrador tenha optado explicitamente por impedir que os usuários alterem a configuração fornecida (veja abaixo).
Permitir que os Usuários Alterem Configurações
Por padrão, todas as configurações da Configuração do Axe podem ser alteradas pelos usuários da empresa. No entanto, se um administrador optar por, ele pode desmarcar a caixa de seleção "Permitir que os usuários mudem", impedindo que qualquer usuário sobrescreva o valor padrão escolhido.
Usuários Empresariais
Os usuários empresariais podem visualizar as configurações configuradas por seu administrador. No entanto, eles não terão a capacidade de alterar nenhuma configuração. Eles serão informados disso com um banner não descartável que diz "Essas configurações são geridas pelo seu administrador".
Titulares de Licença Individual
Os titulares de licença individual podem definir seus próprios valores padrão. Ao contrário dos administradores empresariais, eles não terão controles de "Permitir que os usuários alterem".
Configurações Globais Disponíveis
| Nome | Descrição | Valor Padrão |
|---|---|---|
| Padrão de Acessibilidade Padrão | O padrão de teste de acessibilidade a ser utilizado (padrões WCAG/Trusted Tester estão disponíveis) | WCAG 2.1 AA |
| Versão Padrão do Axe Core | A versão do axe-core a ser utilizada para varreduras automatizadas | Última |
| Padrão Precisa de Revisão | Como questões incomplete / "precisam de revisão" devem ser tratadas (podem ser desativadas, ativadas mas excluídas do total de questões, ou ativadas e incluídas no total de questões) |
Desativado |
| Padrão Melhores Práticas | Se as melhores práticas devem ser desativadas ou não | Desativar |
| Padrão Regras Experimentais | Se as regras experimentais devem ser desativadas | Desativar |
| Regras Avançadas Padrão | O limite de confiança regras avançadas usado ao decidir se deve relatar um resultado | Equilibrado (confiança de 70%+) |
| Padrão de Captura de Capturas de Tela de Problemas | Se as capturas de tela de problemas devem ser capturadas em produtos que as suportam | Ativar |
| Aprendizado de Máquina Padrão (obsoleto no Portal de Contas Axe v4.161.0) | Se as melhorias de Aprendizado de Máquina (ML) devem ser ativadas | Ativar |
| Padrão de Recursos Alimentados por IA | Se os recursos de IA devem ser ativados por padrão | Ativar |
| Padrão de Compartilhamento de Dados de IA | Se seus dados podem ser usados para treinar e melhorar nossos modelos de IA | Ativar |
| Controle de Acesso do Relatório Compartilhado | Controla quem pode acessar relatórios compartilhados, como Problemas Compartilhados e Registros de Testes Salvos Compartilhados. | Para empresas: „Qualquer usuário corporativo logado“; para não-empresas: „Qualquer pessoa com o link“ |
| Serviço de Uso | Se os dados de uso serão rastreados no "URL" do Serviço de Uso fornecido | Ativar |
| Serviço de Uso "URL" | O URL do servidor para onde os dados de uso são enviados | https://usage.deque.com |
| Serviço de Uso "Organização" | O nome da sua organização a ser adicionado como metadado à sua análise de uso | |
| Serviço de Uso "Departamento" | O nome do seu departamento a ser adicionado como metadado à sua análise de uso | |
| Serviço de Uso "Aplicação" | O nome da sua aplicação a ser adicionado como metadado à sua análise de uso |
A configuração Configuração Padrão de Aprendizado de Máquina foi descontinuada a partir do Portal de Contas Axe v4.161.0. No futuro, use as configurações Recursos Alimentados por IA e Compartilhamento de Dados de IA para um controle mais granular sobre a funcionalidade de IA e a privacidade de dados em sua organização.
Orientação sobre migração:
- A configuração anterior Configuração Padrão de Aprendizado de Máquina controlava se os aprimoramentos de aprendizado de máquina estavam habilitados.
- Para manter a funcionalidade equivalente, ative tanto Recursos Alimentados por IA quanto Compartilhamento de Dados de IA.
- Se você deseja restringir recursos de IA ou compartilhamento de dados, agora pode configurar essas configurações de forma independente para um controle mais refinado.
Configuração Específica do Produto
Regras Avançadas Padrão
Regras Avançadas são testes automatizados que utilizam capturas de tela, visão computacional e modelos de linguagem avançada para encontrar problemas de acessibilidade que o axe-core padrão não consegue. Como as regras que usam IA relatam uma pontuação de confiança em vez de um resultado definitivo de aprovação ou reprovação, esta configuração escolhe o limite a partir do qual uma descoberta é relatada como uma violação.
Esta configuração se aplica ao Extensão do Navegador Axe DevTools e ao Servidor Axe MCP.
Opções disponíveis
| Opção | Relata descobertas com confiança de… | Compromisso |
|---|---|---|
| Preciso (confiança de 90%+) | 90% ou mais | Menos falsos positivos, mas perde mais problemas reais |
| Equilibrado (confiança de 70%+) | 70% ou mais | Um meio termo entre precisão e cobertura |
| Completo (confiança de 50%+) | 50% ou mais | Encontra mais problemas, mas relata a maioria de falsos positivos |
| Desativado | — | Regras avançadas não são executadas; apenas o conjunto de regras padrão do axe-core é usado |
O padrão é Equilibrado (confiança de 70%+).
Reduzir o limite revela mais problemas ao custo de mais falsos positivos; aumentar significa que as conclusões que você obtém são mais propensas a serem genuínas, mas mais problemas reais não são relatados. Qual configuração é correta depende se sua equipe prefere lidar com mais ruído ou correr o risco de perder problemas.
Permitir que os usuários alterem
Assim como outras configurações globais, Regras Avançadas Padrão tem uma caixa de seleção "Permitir que os usuários alterem na Extensão Axe DevTools, Servidor Axe MCP":
- Marcado (o padrão) — o valor acima é um ponto de partida, e os usuários podem escolher um limite diferente em cada produto.
- Desmarcado — o limite é fixado no valor escolhido. Os usuários não podem sobrescrevê-lo em nenhum dos produtos.
Como cada produto o aplica
- Extensão do Navegador Axe DevTools — os usuários mudam o limite nas configurações da extensão, quando permitido. Veja Regras Avançadas.
- Servidor Axe MCP — o servidor lê esta configuração em cada varredura, portanto, uma alteração aqui entra em vigor na próxima varredura sem reinicialização. Quando os usuários têm permissão para alterá-la, eles podem sobrescrever o limite por servidor com a variável de ambiente
AXE_ADVANCED_RULESou por varredura com o argumento de ferramentaadvancedRules. Quando a configuração está bloqueada, ambas as substituições são ignoradas e o resultado do varredura relata"source": "org_policy_locked"para que o usuário veja o porquê. Veja Regras Avançadas na documentação do Servidor Axe MCP.
Regras avançadas que utilizam grandes modelos de linguagem consomem Créditos de IA, e adicionam tempo a uma varredura. Configurá-las para Desativado as desativa completamente para ambos os produtos — nenhuma regra avançada é executada, e nenhum crédito é consumido.
As Regras Avançadas também dependem da configuração Padrão de Recursos Alimentados por IA. Desativar recursos alimentados por IA para sua organização desativa as regras avançadas, independentemente do limite escolhido aqui. Veja o Guia de Disponibilidade de Recursos de IA.
Controle de Acesso do Relatório Compartilhado
A configuração de Controle de Acesso do Relatório Compartilhado determina quem pode acessar quaisquer relatórios compartilhados. As seguintes opções estão disponíveis:
- Qualquer pessoa com o link: permite que qualquer pessoa com o link acesse relatórios compartilhados (não é necessário autenticação)
- Qualquer usuário logado: permite que qualquer usuário que esteja logado no Portal da Conta Axe acesse relatórios compartilhados
- Qualquer usuário empresarial logado: permite que qualquer usuário que esteja logado na empresa acesse relatórios compartilhados
O valor padrão para empresas é „Qualquer usuário empresarial logado“ e para não-empresas é „Qualquer pessoa com o link“.
Quando essa configuração é alterada, o novo nível de controle de acesso é aplicado retroativamente a todos os relatórios existentes, além de quaisquer futuros. Testes salvos anteriormente e relatórios compartilhados refletirão imediatamente as permissões de compartilhamento atualizadas sem exigir atualizações manuais. Por exemplo, se um administrador alterar a configuração de "Qualquer pessoa com o link" para "Qualquer usuário logado na empresa", todos os relatórios compartilhados anteriormente — incluindo registros de testes históricos — exigirão imediatamente autenticação corporativa para acesso.
Como as Mudanças de Configuração Serão Refletidas nos Produtos Deque?
Uma vez que uma mudança é feita na Configuração Axe, cada produto tem suas próprias maneiras de incorporar essas mudanças. Atualmente, a Extensão Axe DevTools, o Axe Developer Hub e o Servidor Axe MCP suportam a Configuração Axe; no entanto, todos os produtos Deque eventualmente a suportarão.
A Extensão para Navegador Axe DevTools v4.62 e superior suporta a Configuração Axe. Se você estiver em uma versão mais antiga, deve atualizar para desbloquear essa funcionalidade.
Extensão Axe DevTools
Para a Extensão Axe DevTools, as alterações na Configuração Axe serão refletidas na próxima vez que o usuário abrir a extensão, fizer login ou navegar até a página de configurações dentro da extensão.
Para forçar que as alterações de configuração apareçam, instrua seus usuários a abrir uma nova instância da extensão. Se já tiverem ela aberta, podem simplesmente fechar e reabrir.
Devido à natureza "offline" do recurso Modo Offline, a única maneira de controlar configurações em toda a organização é usando configuração via política.
Servidor Axe MCP
O Servidor Axe MCP busca a Configuração Axe a cada toda varredura, então as mudanças entram em vigor na próxima varredura do usuário — sem necessidade de reiniciar o servidor ou cliente. Os resultados de varreduras anteriores não são afetados.
Hub do Desenvolvedor Axe
Para o Hub do Desenvolvedor Axe, as mudanças na Configuração Axe terão efeito em qualquer execução de teste futura e serão refletidas nos relatórios. Quaisquer execuções de teste anteriores e relatórios não serão impactados pelas mudanças de Configuração Axe.
Para mais informações sobre o uso da Configuração Axe com o Hub do Desenvolvedor Axe, veja Configuração Global na documentação do Axe Watcher.