Olyx

Um aplicativo Android moderno para análise abrangente de segurança de URLs, combinando múltiplas APIs de detecção de ameaças com detecção avançada de falsificação de domínio para proteger os utilizadores de sites maliciosos.

Capturas de ecrã

Funcionalidades

Análise de Segurança Multi-API

• AbuseIPDB: Verifica a reputação de IP por atividade maliciosa reportada
• VirusTotal: Verifica URLs em mais de 70 motores antivírus
• URLScan.io: Realiza análise comportamental profunda de sites
• Resultados em Tempo Real: Carregamento progressivo com resultados parciais imediatos

Deteção de Falsificação de Domínio

• Mais de 200 Domínios Protegidos: Base de dados pré-carregada de sites legítimos (Google, PayPal, bancos, etc.)
• Deteção de Substituição de Caracteres: Identifica ataques homógrafos (g00gle.com, paypa1.com)
• Análise de Distância Levenshtein: Detecta tentativas de typosquatting
• Variações de TLD: Detecta extensões de domínio suspeitas
• Filtragem Inteligente: Distingue variantes regionais legítimas (.com vs .fr)

Sistema de Pontuação Inteligente

• Deteção de Falsos Positivos: Identifica respostas de API discrepantes usando análise estatística
• Penalidade por Falsificação: Reduz automaticamente pontuações para domínios suspeitos (até -50 pontos)
• Agregação Ponderada: Combina múltiplos resultados de API para uma avaliação precisa de risco
• Níveis de Confiança Dinâmicos: Seguro, Provavelmente Seguro, Moderado, Arriscado, Malicioso

Experiência do Utilizador

• Material Design 3: Interface moderna e polida com tema escuro
• Layout Adaptativo: Otimizado para orientações retrato e paisagem
• Histórico de Pesquisa: Armazenamento local persistente com arrastar para eliminar
• Animações de Transição: Transições suaves e feedback visual
• Cabeçalhos Recolhíveis: Navegação eficiente em termos de espaço
• Partilha de URLs: Integração direta com o menu de partilha do Android

Indicadores Visuais

• Pontuações Codificadas por Cores: Gradiente vermelho para verde com base no nível de segurança
• Carregamento Animado: Onda gradiente roxa para chamadas API em andamento
• Avisos de Falso Positivo: Etiquetas laranja para resultados discrepantes suspeitos
• Alertas de Falsificação: Cartões dedicados com percentagem de nível de suspeita
• Indicadores de Deslocamento: Dicas de gradiente radial para conteúdo adicional

Primeiros Passos

Pré-requisitos

• Android Studio: Ladybug ou mais recente
• Android SDK: API 29+ (Android 10+)
• Gradle: 8.0+
• JDK: 11+

Chaves de API Necessárias

Crie um ficheiro secrets.properties no diretório raiz:

ABUSEIPDB_API_KEY=sua_chave_abuseipdb
VIRUSTOTAL_API_KEY=sua_chave_virustotal
URLSCAN_API_KEY=sua_chave_urlscan

Importante: Ao utilizar esta aplicação, deve cumprir os Termos de Serviço de cada fornecedor de API:

• Termos AbuseIPDB
• Termos VirusTotal
• Termos URLScan.io

Instalação

1. Clone o repositório

   git clone <repository-url>
   cd olyx
   

2. Configure as chaves de API

   cp secrets.properties.example secrets.properties
   # Edite secrets.properties com as suas chaves de API
   

3. Compile e execute

   ./gradlew assembleDebug
   ./gradlew installDebug
   

Estrutura do Projeto

olyx/
├── app/
│   ├── src/main/
│   │   ├── java/com/olyx/
│   │   │   ├── data/
│   │   │   │   ├── Models.kt              # ApiResult, HistoryEntry
│   │   │   │   ├── HistoryManager.kt      # Lógica de persistência
│   │   │   │   └── SpoofingDetector.kt    # Motor de análise de domínio
│   │   │   ├── network/
│   │   │   │   └── ApiService.kt          # Integrações de API
│   │   │   ├── ui/
│   │   │   │   ├── components/
│   │   │   │   │   ├── ApiScoreCard.kt    # Resultados individuais de API
│   │   │   │   │   └── GlobalScoreCard.kt # Exibição da pontuação agregada
│   │   │   │   ├── screens/
│   │   │   │   │   ├── HomeScreen.kt      # Inserção de URL
│   │   │   │   │   ├── AnalysisScreen.kt  # Exibição de resultados
│   │   │   │   │   ├── HistoryScreen.kt   # Histórico de pesquisa
│   │   │   │   │   └── AboutScreen.kt     # Informações da aplicação
│   │   │   │   ├── theme/
│   │   │   │   │   ├── Color.kt           # Paleta do tema escuro
│   │   │   │   │   ├── Theme.kt           # Configuração Material3
│   │   │   │   │   └── Type.kt            # Tipografia
│   │   │   │   └── utils/
│   │   │   │       └── ScoreUtils.kt      # Algoritmos de pontuação
│   │   │   ├── utils/
│   │   │   │   └── Constants.kt           # Constantes da aplicação
│   │   │   └── MainActivity.kt            # Ponto de entrada
│   │   └── res/
│   │       ├── raw/
│   │       │   └── legitimate_domains.txt # Lista de domínios protegidos
│   │       └── font/
│   │           ├── gemunulibre_regular.ttf
│   │           └── redhatdisplay_regular.ttf
├── screens/                                # Capturas de ecrã
├── build.gradle.kts
└── secrets.properties                      # Chaves de API (não no repositório)

Personalização

Adicionar Domínios Protegidos

Edite app/src/main/res/raw/legitimate_domains.txt:

oseubanco.com
oseubanco.fr
oseunegocio.com

Ajustar Sensibilidade da Deteção

Modifique os limites em SpoofingDetector.kt:

private fun calculateSuspicion(...): Int {
    if (distance == 1) return 90  // Muito semelhante → Risco alto
    if (distance == 2) return 70  // Algo semelhante → Risco médio
    if (distance == 3) return 50  // Menos semelhante → Risco médio-baixo
}

Alterar Penalidades de Pontuação

Atualize o impacto da falsificação em ScoreUtils.kt:

val penalty = (spoofingResult.suspicionLevel * 0.5).toInt()  // 50% do nível de suspeita

Construído Com