Bem-vindo ao PKIGuardian MAUI! Este guia irá ajudá-lo a instalar e usar o aplicativo móvel para iOS e Android.

Índice

• Instalação
• Primeiro Acesso
• Funcionalidades Principais
• Modo Offline
• Tarefas Comuns
• Configurações
• Acessibilidade
• Solução de Problemas

Instalação

iOS

Requisitos: iOS 15.0 ou superior

1. Abra a App Store no seu dispositivo iOS
2. Pesquise por “PKIGuardian”
3. Toque em Obter ou Instalar
4. Autentique com Face ID, Touch ID ou sua senha do Apple ID
5. Aguarde o download e a instalação do aplicativo

TestFlight (Beta):

1. Instale o TestFlight da App Store
2. Abra o link de convite enviado pelo seu administrador
3. Toque em Instalar no TestFlight

Android

Requisitos: Android 8.0 (API 26) ou superior

1. Abra a Google Play Store no seu dispositivo Android
2. Pesquise por “PKIGuardian”
3. Toque em Instalar
4. Aceite as permissões necessárias
5. Aguarde o download e a instalação do aplicativo

Instalação via APK:

# Habilite "Instalar de Fontes Desconhecidas" em Configurações > Segurança
# Baixe o APK da página de releases
adb install PKIGuardian.apk

Primeiro Acesso

Configuração Inicial

1. Abrir o aplicativo — Toque no ícone do PKIGuardian
2. Aceitar permissões:
   • Câmera (para leitura de QR code)
   • Armazenamento (para exportação de certificados)
   • Biometria (opcional, para login seguro)
3. Configurar conexão com a API:
   • URL da API: Insira o endpoint da API do PKIGuardian
   • Verificar: Toque em Testar Conexão
4. Fazer login:
   • Insira seu nome de usuário e senha
   • (Opcional) Habilite o Login Biométrico para acessos futuros
   • Toque em Entrar

Configuração de Autenticação Biométrica

Após o primeiro login, você será solicitado a habilitar a autenticação biométrica:

iOS:

• Face ID ou Touch ID
• Toque em Habilitar e autentique uma vez para armazenar as credenciais com segurança no Keychain

Android:

• Impressão Digital ou Reconhecimento Facial
• Toque em Habilitar e autentique uma vez para armazenar as credenciais com segurança no Android Keystore

Funcionalidades Principais

Tela Inicial

A tela inicial exibe:

• Card de Estatísticas Rápidas:
  • Total de certificados gerenciados
  • Quantidade expirando em breve
  • Dispositivos IoT ativos
• Ações Rápidas:
  • Escanear QR Code
  • Nova Solicitação de Certificado
  • Ver Aprovações
  • Sincronizar Agora
• Atividade Recente: Ações recentes de certificados e dispositivos
• Status de Sincronização: Última sincronização e operações pendentes

Navegação

Barra de Abas (Parte Inferior):

• 🏠 Início — Dashboard e ações rápidas
• 📜 Certificados — Lista e detalhes de certificados
• 🤖 Dispositivos — Gerenciamento de dispositivos IoT
• 📊 Análises — Métricas-chave e insights
• ⚙️ Configurações — Configurações do aplicativo e perfil

Gestos de Deslize:

• Deslize para a direita — Abrir menu de navegação
• Deslize para a esquerda em itens da lista — Ações rápidas (renovar, revogar, etc.)
• Puxar para baixo para atualizar — Sincronizar com o servidor

Modo Offline

O PKIGuardian MAUI suporta operações no modo offline:

Como Funciona

1. Sincronização de Dados: Sincroniza automaticamente quando online
2. Fila Offline: As ações são enfileiradas quando sem conexão
3. Upload Automático: A fila é processada quando a conexão é restaurada
4. Resolução de Conflitos: Última gravação prevalece com rastreamento de metadados

Capacidades Offline

Visualizar Dados:

• ✅ Visualizar certificados (em cache)
• ✅ Visualizar detalhes de dispositivos (em cache)
• ✅ Visualizar análises (dados em cache)
• ❌ Dados em tempo real (requer conexão)

Criar/Modificar:

• ✅ Criar solicitações de certificado (enfileiradas)
• ✅ Cadastrar dispositivos (enfileiradas)
• ✅ Adicionar notas/comentários (enfileiradas)
• ❌ Aprovar solicitações (requer conexão por segurança)
• ❌ Revogar certificados (requer conexão por segurança)

Gerenciar a Fila Offline

1. Acesse Configurações > Fila Offline
2. Visualize as operações pendentes
3. Opções disponíveis:
   • Tentar Novamente: Reprocessar operações com falha manualmente
   • Remover: Excluir uma operação enfileirada
   • Limpar Tudo: Limpar toda a fila (use com cautela)

Configurações de Sincronização

Configure o comportamento de sincronização em Configurações > Sincronização:

• Sincronização Automática: Habilitar/desabilitar sincronização automática
• Frequência de Sincronização: A cada 5 min, 15 min, 30 min, 1 hora
• Apenas Wi-Fi: Sincronizar somente em Wi-Fi (economiza dados móveis)
• Sincronizar ao Iniciar: Sincronizar ao abrir o aplicativo
• Sincronização em Segundo Plano: Habilitar sincronização em background

Tarefas Comuns

Escanear QR Codes para Cadastro de Dispositivos

1. Acesse a aba Dispositivos
2. Toque no botão Escanear QR (ícone de câmera)
3. Aponte a câmera para o QR code de cadastro
4. O aplicativo detectará e decodificará o QR code automaticamente
5. Revise as informações do dispositivo
6. Toque em Cadastrar Dispositivo
7. Confirmação:
   • Se online: O dispositivo é cadastrado imediatamente
   • Se offline: O cadastro é enfileirado para depois

Visualizar Detalhes de um Certificado

1. Acesse a aba Certificados
2. Use a busca ou role para encontrar o certificado
3. Toque no card do certificado
4. Visualize os detalhes:
   • Informações do certificado
   • Datas de validade
   • Sujeito e SANs
   • Cadeia de certificados
   • Dispositivos relacionados

Ações Rápidas em Certificados

Deslize para a esquerda em qualquer certificado na lista:

• Renovar (verde) — Iniciar renovação
• Visualizar (azul) — Abrir detalhes
• Exportar (cinza) — Exportar certificado
• Revogar (vermelho) — Revogar certificado (apenas online)

Solicitar um Novo Certificado

1. Acesse a aba Certificados
2. Toque no botão + (mais)
3. Preencha o formulário:
   • Tipo de certificado
   • Nome comum
   • SANs (Nomes Alternativos do Sujeito)
   • Algoritmo de chave
   • Período de validade
4. Toque em Enviar Solicitação
5. Se offline, a solicitação é enfileirada

Verificar Análises

1. Acesse a aba Análises
2. Visualize métricas-chave:
   • Pontuação de saúde dos certificados
   • Gráfico de certificados expirando
   • Tendências de cadastro de dispositivos
   • Principais tipos de certificado
3. Toque em qualquer gráfico para ver detalhes
4. Filtre por período usando o seletor de datas

Gerenciar Dispositivos IoT

1. Acesse a aba Dispositivos
2. Visualize a lista de dispositivos com indicadores de status
3. Toque em um dispositivo para ver detalhes:
   • Tipo e ID do dispositivo
   • Status do certificado
   • Última vez visto
   • Resultados de atestação (para dispositivos TPM)
4. Ações disponíveis:
   • Renovar Certificado
   • Visualizar Certificado
   • Re-Atestar (para dispositivos TPM)

Cadastro em Campo (Offline)

Para operações de campo sem conectividade:

1. Acesse Dispositivos > Cadastro em Campo
2. Preencha as informações do dispositivo manualmente:
   • ID do dispositivo
   • Tipo de dispositivo
   • Atribuição de grupo
3. Opcionalmente, capture a atestação TPM (Android com TPM)
4. Toque em Cadastrar
5. O cadastro é enfileirado e será processado quando online

Configurações

Acesse a aba Configurações para configurar:

Configurações de Conta

• Perfil: Visualize e edite seu perfil
• Senha: Altere sua senha
• Chaves de API: Gerencie chaves de API
• Sair: Encerrar a sessão do aplicativo

Configurações do Aplicativo

• Tema: Claro, Escuro ou Padrão do Sistema
• Idioma: Selecione o idioma preferido
• Notificações: Configure notificações push
• Login Biométrico: Habilitar/desabilitar autenticação biométrica

Configurações de Sincronização

• Sincronização Automática: Habilitar/desabilitar
• Frequência de Sincronização: Escolher intervalo
• Apenas Wi-Fi: Restringir ao Wi-Fi
• Última Sincronização: Ver hora da última sincronização
• Sincronizar Agora: Sincronização manual

Dados e Armazenamento

• Tamanho do Cache: Ver tamanho atual do cache
• Limpar Cache: Limpar dados em cache
• Fila Offline: Gerenciar operações pendentes
• Exportar Dados: Exportar dados do aplicativo para backup

Segurança

• Login Biométrico: Habilitar Face ID/Touch ID/Impressão Digital
• Bloqueio Automático: Bloquear após inatividade (1, 5 ou 15 minutos)
• Exigir PIN: Exigir PIN ao iniciar
• Captura de Tela: Permitir/bloquear capturas de tela (Android)

Avançado

• URL da API: Alterar o endpoint da API
• Validação de Certificado: Habilitar/desabilitar validação SSL (apenas para desenvolvimento)
• Modo de Depuração: Habilitar logs para solução de problemas
• Sobre: Versão e informações de build do aplicativo

Acessibilidade

O PKIGuardian MAUI suporta os recursos de acessibilidade da plataforma:

iOS:

• Suporte ao VoiceOver
• Dynamic Type (escala de texto)
• Reduzir Movimento
• Aumentar Contraste

Android:

• Suporte ao TalkBack
• Escala de tamanho de fonte
• Tamanho de exibição
• Texto de alto contraste

Para habilitar:

1. Use as configurações do sistema (iOS: Ajustes > Acessibilidade ou Android: Configurações > Acessibilidade)
2. O PKIGuardian se adapta automaticamente às suas preferências

Solução de Problemas

Não Consigo Conectar à API

1. Verificar URL da API: Configurações > Avançado > URL da API
2. Testar Conexão: Toque em Testar Conexão
3. Rede: Verifique se há conectividade com a internet
4. Firewall: Verifique se o firewall está bloqueando o aplicativo
5. SSL: Se estiver usando certificados autoassinados, desative a validação SSL (apenas para desenvolvimento)

Login Biométrico Não Funciona

iOS:

1. Ajustes > Face ID e Código — Certifique-se de que o PKIGuardian tem permissão
2. Reativar: Configurações PKIGuardian > Segurança > Login Biométrico (desative e reative)

Android:

1. Configurações > Segurança > Impressão Digital — Certifique-se de que a impressão digital está cadastrada
2. Reativar: Configurações PKIGuardian > Segurança > Login Biométrico (desative e reative)

Sincronização com Falha

1. Verificar conexão: Certifique-se de que está online
2. Sincronização manual: Configurações > Sincronização > Sincronizar Agora
3. Limpar fila: Se a fila estiver corrompida, Configurações > Dados e Armazenamento > Fila Offline > Limpar Tudo
4. Refazer login: Sair e fazer login novamente

Leitura de QR Code Não Funciona

1. Permissão de câmera: Configurações > Privacidade > Câmera — Habilitar para PKIGuardian
2. Foco: Certifique-se de que o QR code está em foco e bem iluminado
3. Distância: Aproxime ou afaste a câmera
4. Entrada manual: Use o cadastro manual se a leitura do QR falhar

Aplicativo Trava ou Congela

1. Forçar fechamento: Deslize o app para cima e reabra
2. Limpar cache: Configurações > Dados e Armazenamento > Limpar Cache
3. Reinstalar: Desinstale e reinstale o aplicativo (os dados serão sincronizados do servidor)
4. Reportar: Configurações > Avançado > Sobre > Reportar Problema

Fila Offline Não Sincroniza

1. Verificar rede: Certifique-se de que está online
2. Tentar novamente: Configurações > Fila Offline > Tentar Novamente Tudo
3. Remover falhas: Remova itens permanentemente com falha
4. Forçar sincronização: Configurações > Sincronização > Sincronizar Agora

Boas Práticas

Para Operações em Campo

1. Pré-sincronização: Sincronize todos os dados antes de ir a campo
2. Bateria: Certifique-se de que o dispositivo está totalmente carregado
3. Backup: Exporte dados regularmente
4. Monitoramento da fila: Verifique a fila offline ao retornar com conexão

Segurança

1. Habilitar biometria: Use Face ID/Touch ID/Impressão Digital
2. Bloqueio automático: Habilite o bloqueio automático após inatividade
3. Não compartilhar o dispositivo: Não permita que outros usem seu dispositivo com sessão ativa
4. Sair ao terminar: Encerre a sessão em dispositivos compartilhados

Desempenho

1. Sincronização regular: Sincronize regularmente para evitar acúmulo grande na fila
2. Limpar cache: Limpe o cache periodicamente se o armazenamento estiver limitado
3. Sincronização via Wi-Fi: Use Wi-Fi para sincronizações grandes para economizar dados móveis
4. Fechar apps em segundo plano: Feche outros aplicativos para melhor desempenho

Próximos Passos

• Interface Web — Primeiros Passos — Usar a interface web
• CLI — Primeiros Passos — Usar a ferramenta de linha de comando
• Guia de Gerenciamento IoT — Fluxos detalhados de IoT
• Solução de Problemas — Solução abrangente de problemas

Suporte

• Ajuda no Aplicativo: Configurações > Ajuda
• Documentação: docs.pkiguardian.com
• GitHub Issues: Reportar bugs

---

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