Upnetix Labs · protocolo de experimento
Protocolo: Qual o impacto da quantidade de usuários simultâneos na latência média de autenticação do Keycloak via OpenID Connect?
Este protocolo responde como a latência média de autenticação do Keycloak varia conforme o número de usuários simultâneos. O participante irá medir o tempo de resposta das requisições de login em diferentes cargas.
Como a latência média de autenticação do Keycloak se comporta ao variar a quantidade de usuários simultâneos em um cenário de autenticação OpenID Connect?
Hipótese
A latência média de autenticação do Keycloak aumenta conforme cresce o número de usuários simultâneos.
Variáveis
| Independentes (o que varia) | Quantidade de usuários simultâneos (threads de teste) |
|---|---|
| Dependentes (o que se mede) | Latência média de autenticação (ms); Taxa de erro (%) |
| Controladas (o que fica fixo) | Configuração do Keycloak (versão, recursos); Hardware do servidor; Rede (isolada, sem outros tráfegos); Cenário de autenticação (mesma aplicação cliente, fluxo Authorization Code) |
Ambiente
Servidor Keycloak em ambiente limpo, versão conforme documentação oficial, configurado para autenticação OpenID Connect padrão. Ferramenta k6 (https://k6.io, licença AGPLv3) para simular usuários e medir latência. Rede local dedicada, sem interferências externas. Configuração mínima: 2 vCPU, 4GB RAM, banco de dados PostgreSQL local.
Procedimento
- Preparação
Instale e configure o Keycloak conforme a documentação oficial. Crie um realm, um usuário de teste e um cliente configurado para fluxo Authorization Code.
- Configuração do k6
Prepare um script k6 para simular o login via OpenID Connect, usando o endpoint de autorização do Keycloak.
- Execução dos testes
Execute o teste variando a quantidade de usuários simultâneos (por exemplo: 10, 50, 100, 200, 500). Cada carga deve ser testada separadamente.
k6 run --vus <N> --duration 1m script.js - Coleta dos dados
Registre a latência média de autenticação e a taxa de erro reportadas pelo k6 para cada carga.
- Repetição
Repita cada teste 5 vezes para cada carga, reiniciando o Keycloak entre as execuções para garantir condições iniciais semelhantes.
Planilha de coleta
| usuarios_simultaneos (usuarios) | latencia_media_ms (ms) | taxa_erro_percentual (%) |
|---|---|---|
| EXEMPLO: 100, 320, 0.5 | ||
Repetições recomendadas: 5. Baixe a planilha vazia em CSV: colunas prontas.
Análise
Calcule a média, mediana e desvio padrão da latência média e taxa de erro para cada carga testada. Compare os resultados entre as cargas para identificar o ponto de degradação acentuada. Analise se o aumento de latência é linear, exponencial ou apresenta thresholds.
Critérios de decisão
- Latência média aceitável definida conforme política interna ou documentação.
- Taxa de erro deve permanecer abaixo de 1% para ser considerada estável.
- Resultados consistentes entre repetições (variação inferior a 10% entre execuções).
Fontes de erro e mitigação
- Variações de carga no hardware ou rede podem afetar os resultados; mitigue isolando o ambiente.
- Cache do Keycloak pode influenciar a latência; reinicie o serviço entre execuções.
- Apenas um fluxo de autenticação testado; outros fluxos podem apresentar resultados diferentes.
Referências
- fonte oficial · Openid (openid.net)
- Publicado
- 09/09/2026
- Última revisão
- 09/09/2026
- Versão do conteúdo
- 1.0
- Referências
- 1 oficiais
- Revisão técnica
- redação e revisão por IA, URLs conferidas na publicação
- Status
- Atual
