Bem-vindo à Interface Web do PKIGuardian! Este guia irá ajudá-lo a começar a usar a interface web.

Índice

• Acessando a Interface Web
• Primeiro Acesso
• Visão Geral do Dashboard
• Navegação
• Tarefas Comuns
• Atalhos de Teclado
• Acessibilidade
• Personalização
• Solução de Problemas

Acessando a Interface Web

A Interface Web do PKIGuardian é acessível pelo seu navegador em:

https://sua-instancia-pkiguardian.com

Para desenvolvimento local:

https://localhost:5001

Requisitos do Navegador

• Navegadores Recomendados: Chrome 120+, Firefox 120+, Edge 120+, Safari 17+
• JavaScript: Deve estar habilitado
• WebSocket: Necessário para atualizações em tempo real

Primeiro Acesso

1. Acesse a URL do PKIGuardian
2. Insira suas credenciais:
   • Usuário: Seu nome de usuário atribuído
   • Senha: Sua senha
3. (Opcional) Marque Lembrar-me para sessões persistentes
4. Clique em Entrar

Credenciais Padrão do Administrador

Para novas instalações:

• Usuário: admin
• Senha: Admin123! (altere imediatamente após o primeiro acesso)

Autenticação Multifator (MFA)

Se a MFA estiver habilitada para sua conta:

1. Após inserir sua senha, será solicitado um código de verificação
2. Abra seu aplicativo autenticador (Google Authenticator, Microsoft Authenticator, etc.)
3. Insira o código de 6 dígitos
4. Clique em Verificar

Visão Geral do Dashboard

Após o login, você verá o dashboard principal com:

Cards de Métricas Principais

• Total de Certificados — Certificados ativos no sistema
• Expirando em Breve — Certificados que expiram em 30 dias (alerta vermelho se crítico)
• Aprovações Pendentes — Solicitações de certificado aguardando aprovação
• Dispositivos Ativos — Dispositivos IoT com certificados válidos

Ações Rápidas

• Nova Solicitação de Certificado — Iniciar uma nova solicitação
• Cadastro de Dispositivo — Cadastrar um novo dispositivo IoT
• Ver Aprovações — Revisar solicitações de aprovação pendentes
• Executar Descoberta — Varrer sua infraestrutura em busca de certificados

Gráficos e Visualizações

• Status dos Certificados — Gráfico de pizza com distribuição por status
• Próximas Renovações — Linha do tempo de certificados que precisam ser renovados
• Feed de Atividades — Ações e eventos recentes

Navegação

Menu Principal (Barra Lateral Esquerda)

A aplicação está organizada nas seguintes seções:

🏠 Dashboard

• Página inicial com métricas-chave e ações rápidas

📜 Certificados

• Lista de Certificados — Visualize e gerencie todos os certificados
• Solicitações — Solicitações de certificado e aprovações
• Modelos — Modelos de certificado para padronização
• Políticas — Políticas e regras de certificado

🤖 IoT e Dispositivos

• Dashboard de Dispositivos — Visão geral dos dispositivos IoT
• Provisionamento Zero-Touch — Cadastro por QR code
• Dispositivos LoRaWAN — Gerenciamento de dispositivos LoRaWAN
• Dispositivos CoAP — Gerenciamento de dispositivos CoAP
• Atestação TPM — Resultados de atestação de hardware
• Grupos de Dispositivos — Gerenciamento de políticas por grupo

📊 Análises

• Previsões ML — Previsões de falha baseadas em IA
• Otimização de Custos — Recomendações de economia
• Planejamento de Capacidade — Previsão de infraestrutura
• Análise de Uso — Padrões de uso de certificados
• Calculadora TCO — Análise de custo total de propriedade

🔍 Descoberta e Segurança

• Descoberta de Endpoints — Certificados descobertos
• Varredura de Segredos — Resultados de varredura de código-fonte
• Exposição Externa — Monitoramento de exposição pública
• Detecção de Não Autorizados — Alertas de certificados não autorizados
• Análise de Cifras — Avaliação de segurança SSL/TLS

🔐 Protocolos Avançados

• SPIFFE/SPIRE — Gerenciamento de identidade de workload
• Certificados SSH — Gerenciamento de AC SSH
• S/MIME — Gerenciamento de certificados de e-mail
• Assinatura de Documentos — Fluxos de assinatura digital
• Assinatura de Código — Pipeline de assinatura de software

🛠️ DevOps

• Certificado-como-Código — Editor GitOps
• Configuração ChatOps — Integração com Slack/Teams
• Certs de Desenvolvimento Local — Certificados de desenvolvimento
• Plugin Studio — Gerenciamento de plugins
• Downloads de SDK — Downloads de SDKs cliente

📋 Relatórios

• Relatórios de Conformidade — Conformidade regulatória
• Logs de Auditoria — Trilha de auditoria de segurança
• Relatórios Personalizados — Crie seus próprios relatórios
• Relatórios Agendados — Entrega automatizada de relatórios

⚙️ Configurações

• Perfil do Usuário — Configurações da sua conta
• Acessibilidade — Preferências de acessibilidade
• Notificações — Preferências de notificação
• Chaves de API — Gerenciar chaves de API

Menu do Usuário (Canto Superior Direito)

• Perfil — Visualize e edite seu perfil
• Configurações — Configurações do aplicativo
• Tema — Alternar entre modo claro/escuro
• Ajuda — Documentação e suporte
• Sair — Encerrar a sessão

Tarefas Comuns

Criar uma Solicitação de Certificado

1. Clique em Nova Solicitação de Certificado no dashboard ou acesse Certificados > Solicitações
2. Clique em + Nova Solicitação
3. Preencha o formulário:
   • Tipo de Certificado: Servidor Web, Assinatura de Código, E-mail, etc.
   • DN do Sujeito: Nome Comum, Organização, etc.
   • SANs: Nomes Alternativos do Sujeito (DNS, IP, E-mail)
   • Algoritmo de Chave: RSA 2048, RSA 4096, ECDSA P-256, etc.
   • Período de Validade: Dias/meses/anos
4. Selecione um Modelo de Certificado (opcional, preenche automaticamente configurações comuns)
5. Adicione Comentários ou justificativa
6. Clique em Enviar Solicitação

Aprovar Solicitações de Certificado

1. Acesse Certificados > Solicitações ou clique em Aprovações Pendentes no dashboard
2. Filtre por status Pendente
3. Clique em uma solicitação para ver os detalhes
4. Revise:
   • Informações do solicitante
   • Detalhes do certificado
   • Finalidade e justificativa
5. Clique em Aprovar ou Rejeitar
6. Adicione comentários de aprovação/rejeição
7. Clique em Confirmar

Visualizar Detalhes de um Certificado

1. Acesse Certificados > Lista de Certificados
2. Use os filtros para encontrar o certificado:
   • Pesquise por Sujeito, Número de Série ou SANs
   • Filtre por Status, Ambiente ou Tipo
3. Clique na linha do certificado
4. Visualize os detalhes:
   • Informações do certificado (Emissor, Validade, Tamanho da Chave)
   • Sujeito e SANs
   • Cadeia de certificados
   • Histórico de uso
   • Dispositivos/aplicações relacionados

Renovar um Certificado

1. Encontre o certificado em Certificados > Lista de Certificados
2. Clique no certificado para abrir os detalhes
3. Clique em Renovar no painel de ações
4. Opções:
   • Renovação Automática: Manter os mesmos parâmetros
   • Personalizada: Modificar parâmetros antes da renovação
5. Confirme a renovação
6. O novo certificado será gerado (sujeito a aprovação se necessário)

Revogar um Certificado

1. Encontre o certificado em Certificados > Lista de Certificados
2. Clique no certificado para abrir os detalhes
3. Clique em Revogar (botão vermelho) no painel de ações
4. Selecione o motivo da revogação:
   • Comprometimento de Chave
   • Comprometimento da AC
   • Mudança de Afiliação
   • Substituição
   • Encerramento de Operação
5. Adicione comentários explicando a revogação
6. Clique em Confirmar Revogação
7. O certificado será revogado imediatamente e adicionado à CRL

Cadastrar um Dispositivo IoT

1. Acesse IoT e Dispositivos > Provisionamento Zero-Touch
2. Clique em + Cadastrar Dispositivo
3. Insira as informações do dispositivo:
   • Tipo de Dispositivo: LoRaWAN, CoAP, TPM, Genérico
   • ID do Dispositivo: Identificador único
   • Grupo: Grupo de dispositivos para herança de política
4. Gere as credenciais de cadastro:
   • QR Code: Para cadastro por câmera
   • Tag NFC: Para cadastro por NFC
   • Manual: Exibir credenciais para entrada manual
5. Salve a solicitação de cadastro
6. Leia o QR code com o dispositivo ou o aplicativo MAUI
7. Aprove a solicitação de cadastro (se aprovação manual for necessária)

Executar Análises

1. Acesse Análises > Previsões ML
2. Visualize as falhas previstas de certificados
3. Filtre por:
   • Intervalo de Tempo: Próximos 7, 30, 90 dias
   • Pontuação de Risco: Alta (>0,8), Média (0,5–0,8), Baixa (<0,5)
   • Ambiente: Produção, Homologação, Desenvolvimento
4. Clique em uma previsão para ver detalhes e análise de causa raiz
5. Tome uma ação:
   • Renovar Antecipadamente: Renovar proativamente o certificado
   • Investigar: Marcar para investigação
   • Suprimir: Suprimir falsos positivos

Atalhos de Teclado

Pressione ? para ver todos os atalhos. Atalhos mais comuns:

Atalho	Ação
?	Mostrar atalhos de teclado
/ ou Ctrl+K	Focar na busca global
G depois D	Ir para Dashboard
G depois C	Ir para Certificados
G depois I	Ir para Dispositivos IoT
G depois A	Ir para Análises
N	Nova solicitação de certificado (nas páginas de certificados)
Esc	Fechar diálogos/modais
Ctrl+Enter	Enviar formulários

Navegação por Teclado

Todos os elementos interativos são totalmente acessíveis pelo teclado:

• Tab — Mover para o próximo elemento
• Shift+Tab — Mover para o elemento anterior
• Enter ou Espaço — Ativar botões/links
• Teclas de seta — Navegar em listas e menus
• Esc — Fechar dropdowns e diálogos

Acessibilidade

A Interface Web do PKIGuardian está em conformidade com WCAG 2.1 AA. Configure as preferências de acessibilidade:

1. Acesse Configurações > Acessibilidade
2. Opções disponíveis:
   • Modo Alto Contraste — Maior contraste para melhor visibilidade
   • Otimizações para Leitor de Tela — Labels ARIA aprimorados
   • Atalhos de Teclado — Habilitar/desabilitar e personalizar
   • Movimento Reduzido — Minimizar animações
   • Tamanho do Texto — Ajustar tamanho (100%, 125%, 150%, 200%)

Personalização

Personalizar o Dashboard

1. Clique em Personalizar no dashboard
2. Adicione/remova widgets:
   • Arraste widgets da biblioteca para o dashboard
   • Remova widgets clicando no ícone X
   • Reordene widgets arrastando-os
3. Configure as opções dos widgets:
   • Clique no ícone de engrenagem em cada widget
   • Ajuste filtros, intervalos de tempo e opções de exibição
4. Salve o layout:
   • Clique em Salvar Layout
   • Os layouts são salvos por usuário

Seleção de Tema

Alterne entre os temas claro e escuro:

• Clique no ícone de tema (sol/lua) no canto superior direito
• Ou acesse Configurações > Aparência

Personalização de Colunas (Tabelas)

Em qualquer visualização de tabela (certificados, dispositivos, etc.):

1. Clique no ícone de colunas na barra de ferramentas
2. Marque/desmarque colunas para mostrar/ocultar
3. Arraste colunas para reordenar
4. Clique em Redefinir para restaurar os padrões

Solução de Problemas

Não Consigo Fazer Login

• Verificar credenciais: Certifique-se de que o usuário e a senha estão corretos
• Verificar Caps Lock: A senha diferencia maiúsculas de minúsculas
• Conta bloqueada: Entre em contato com o administrador se a conta for bloqueada após múltiplas tentativas incorretas
• Cache do navegador: Limpe o cache e os cookies do navegador e tente novamente

Atualizações em Tempo Real Não Funcionam

• Conexão WebSocket: Verifique erros de WebSocket no console do navegador
• Firewall: Certifique-se de que conexões WebSocket não estão bloqueadas
• Atualizar: Recarregue a página forçando limpeza de cache (Ctrl+Shift+R ou Cmd+Shift+R)

Problemas de Desempenho

• Conjuntos de dados grandes: Use filtros para reduzir o volume de dados
• Extensões do navegador: Desative bloqueadores de anúncios ou extensões de privacidade temporariamente
• Cache do navegador: Limpe o cache se as páginas carregam lentamente
• Rede: Verifique a conectividade e a latência de rede

Solicitação de Certificado Presa em Pendente

• Fluxo de aprovação: Verifique se a solicitação precisa de aprovação
• Disponibilidade da AC: Verifique se a Autoridade Certificadora está acessível
• Notificações: Verifique se há notificações de solicitação de aprovação
• Contatar admin: Entre em contato se a situação persistir por longo período

Página Não Encontrada (404)

• Permissões: Você pode não ter acesso a esse recurso
• Erro de digitação na URL: Verifique se a URL está correta
• Sessão expirada: Saia e faça login novamente

Próximos Passos

• CLI — Primeiros Passos — Aprenda a usar a CLI
• MAUI — Primeiros Passos — Instale o aplicativo móvel
• Guia de Gerenciamento IoT — Gerenciamento detalhado de dispositivos IoT
• Guia de Análises — Análises avançadas e relatórios
• Solução de Problemas — Guia completo de solução de problemas

Suporte

Precisa de ajuda?

• Ajuda no aplicativo: Clique no ícone ? no canto superior direito
• Documentação: docs.pkiguardian.com
• Suporte: support@pkiguardian.com

---

Última Atualização: Maio de 2026 | Versão: Phase 12