Olyx

Une application Android moderne pour l'analyse complète de la sécurité des URL, combinant plusieurs API de détection de menaces avec une détection avancée de l'usurpation de domaine afin de protéger les utilisateurs contre les sites web malveillants.

Captures d'écran

Fonctionnalités

Analyse de sécurité multi-API

• AbuseIPDB : Analyse la réputation des adresses IP pour détecter des activités malveillantes signalées
• VirusTotal : Vérifie les URL auprès de plus de 70 moteurs antivirus
• URLScan.io : Effectue une analyse comportementale approfondie des sites web
• Résultats en temps réel : Chargement progressif avec résultats partiels immédiats

Détection d'usurpation de domaine

• 200+ domaines protégés : Base de données préchargée de sites web légitimes (Google, PayPal, banques, etc.)
• Détection de substitution de caractères : Identifie les attaques homographes (g00gle.com, paypa1.com)
• Analyse de distance de Levenshtein : Repère les tentatives de typosquatting
• Variations de TLD : Détecte les extensions de domaine suspectes
• Filtrage intelligent : Distingue les variantes régionales légitimes (.com vs .fr)

Système de notation intelligent

• Détection des faux positifs : Identifie les réponses API aberrantes grâce à une analyse statistique
• Pénalité d'usurpation : Réduit automatiquement les scores pour les domaines suspects (jusqu'à -50 points)
• Agrégation pondérée : Combine les résultats de plusieurs API pour une évaluation précise des risques
• Niveaux de confiance dynamiques : Sûr, Probablement sûr, Modéré, Risqué, Malveillant

Expérience utilisateur

• Material Design 3 : Interface moderne au thème sombre
• Disposition adaptative : Optimisée pour les orientations portrait et paysage
• Historique des recherches : Stockage local persistant avec suppression par glissement
• Animations de fondu : Transitions fluides et retour visuel
• En-têtes repliables : Navigation économique en espace
• Partage d'URL : Intégration directe avec le menu de partage Android

Indicateurs visuels

• Scores colorés : Dégradé du rouge au vert selon le niveau de sécurité
• Chargement animé : Vague violette dégradée pour les appels API en cours
• Avertissements de faux positifs : Étiquettes orange pour les résultats aberrants suspects
• Alertes d'usurpation : Cartes dédiées avec pourcentage de suspicion
• Indicateurs de défilement : Indices de dégradé radial pour le contenu supplémentaire

Pour commencer

Prérequis

• Android Studio : Ladybug ou plus récent
• Android SDK : API 29+ (Android 10+)
• Gradle : 8.0+
• JDK : 11+

Clés API requises

Créez un fichier secrets.properties dans le répertoire racine :

ABUSEIPDB_API_KEY=your_abuseipdb_key
VIRUSTOTAL_API_KEY=your_virustotal_key
URLSCAN_API_KEY=your_urlscan_key

Important : En utilisant cette application, vous devez respecter les conditions d'utilisation de chaque fournisseur d'API :

• Conditions d'AbuseIPDB
• Conditions de VirusTotal
• Conditions d'URLScan.io

Installation

1. Cloner le dépôt

   root@kitploit:~

   git clone <repository-url>
   cd olyx
   

2. Configurer les clés API

   root@kitploit:~

   cp secrets.properties.example secrets.properties
   # Modifiez secrets.properties avec vos clés API
   

3. Compiler et exécuter

   root@kitploit:~

   ./gradlew assembleDebug
   ./gradlew installDebug
   

Structure du projet

olyx/
├── app/
│   ├── src/main/
│   │   ├── java/com/olyx/
│   │   │   ├── data/
│   │   │   │   ├── Models.kt              # ApiResult, HistoryEntry
│   │   │   │   ├── HistoryManager.kt      # Logique de persistance
│   │   │   │   └── SpoofingDetector.kt    # Moteur d'analyse de domaine
│   │   │   ├── network/
│   │   │   │   └── ApiService.kt          # Intégrations API
│   │   │   ├── ui/
│   │   │   │   ├── components/
│   │   │   │   │   ├── ApiScoreCard.kt    # Résultats individuels des API
│   │   │   │   │   └── GlobalScoreCard.kt # Affichage du score agrégé
│   │   │   │   ├── screens/
│   │   │   │   │   ├── HomeScreen.kt      # Saisie d'URL
│   │   │   │   │   ├── AnalysisScreen.kt  # Affichage des résultats
│   │   │   │   │   ├── HistoryScreen.kt   # Historique des recherches
│   │   │   │   │   └── AboutScreen.kt     # Informations sur l'application
│   │   │   │   ├── theme/
│   │   │   │   │   ├── Color.kt           # Palette du thème sombre
│   │   │   │   │   ├── Theme.kt           # Configuration Material3
│   │   │   │   │   └── Type.kt            # Typographie
│   │   │   │   └── utils/
│   │   │   │       └── ScoreUtils.kt      # Algorithmes de notation
│   │   │   ├── utils/
│   │   │   │   └── Constants.kt           # Constantes de l'application
│   │   │   └── MainActivity.kt            # Point d'entrée
│   │   └── res/
│   │       ├── raw/
│   │       │   └── legitimate_domains.txt # Liste des domaines protégés
│   │       └── font/
│   │           ├── gemunulibre_regular.ttf
│   │           └── redhatdisplay_regular.ttf
├── screens/                                # Captures d'écran
├── build.gradle.kts
└── secrets.properties                      # Clés API (pas dans le dépôt)

Personnalisation

Ajouter des domaines protégés

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

votrebanque.com
votrebanque.fr
votreentreprise.com

Ajuster la sensibilité de la détection

Modifiez les seuils dans SpoofingDetector.kt :

private fun calculateSuspicion(...): Int {
    if (distance == 1) return 90  // Très similaire → Risque élevé
    if (distance == 2) return 70  // Assez similaire → Risque moyen
    if (distance == 3) return 50  // Moins similaire → Risque faible-moyen
}

Modifier les pénalités de score

Mettez à jour l'impact de l'usurpation dans ScoreUtils.kt :

val penalty = (spoofingResult.suspicionLevel * 0.5).toInt()  // 50 % du niveau de suspicion

Construit avec

• Kotlin - Langage de programmation moderne et concis
• Jetpack Compose - Framework d'interface utilisateur déclaratif
• Material Design 3 - Dernier système de design
• OkHttp - Client HTTP pour les appels API
• Kotlinx Serialization - Analyse JSON
• Android SharedPreferences - Persistance locale des données

Sécurité et confidentialité

• Pas de stockage cloud : Toutes les données restent sur l'appareil
• Pas de suivi utilisateur : Pas d'analytique ni de télémétrie
• Confidentialité des API : Seules les URL sont envoyées aux services tiers
• Extraction d'IP : Effectuée localement avant les appels API
• Autorisations minimales : Nécessite uniquement l'autorisation INTERNET

Tests

# Exécuter les tests unitaires
./gradlew test

# Exécuter les tests instrumentés
./gradlew connectedAndroidTest

# Générer le rapport de couverture
./gradlew jacocoTestReport

Algorithmes

Détection des faux positifs

Utilise l'analyse de déviation statistique :

• Calcule la moyenne de tous les scores API
• Signale les résultats s'écartant de plus de 40 points de la moyenne
• Nécessite au moins 2 résultats à moins de 20 points de la moyenne pour un consensus

Calcul du score d'usurpation

Score de base = Moyenne (scores API)
Pénalité = Niveau de suspicion × 0,5
Score final = max(0, Score de base - Pénalité)

Distance de Levenshtein

Calcule le nombre minimum d'opérations d'édition (insertion/suppression/substitution) entre deux chaînes pour détecter le typosquatting.

Auteurs

• Julian Melha - @Shacode
• Guillaume Honoré - @Guimee

Remerciements

• AbuseIPDB, VirusTotal et URLScan.io pour leurs API
• L'équipe Material Design pour le système de design
• L'équipe Jetpack Compose pour le framework d'interface utilisateur moderne

📄 Licence

Ce projet est sous licence GNU Affero General Public License v3.0. Voir LICENSE pour plus de détails.