metadata

title: Audit Api
emoji: 🌍
colorFrom: yellow
colorTo: blue
sdk: docker
pinned: false
license: mit
short_description: 'AfricTivistes Digital Security Audit '

API d'Analyse d'Audit de Sécurité

API Flask permettant d'analyser automatiquement les réponses à un audit de sécurité et de générer des recommandations via l'intelligence artificielle.

Présentation

Cette API utilise l'intelligence artificielle pour analyser les réponses fournies lors d'un audit de sécurité informatique. Elle identifie automatiquement le type d'audit, évalue le niveau de sécurité global, détecte les points forts et les vulnérabilités, puis génère des recommandations personnalisées.

Fonctionnalités

Détection automatique du type d'audit (complet ou spécifique à un domaine)
Analyse des réponses par IA spécialisée en cybersécurité
Évaluation du niveau de sécurité avec score sur 10
Identification des points forts et leur importance
Détection des vulnérabilités et classification par niveau de risque
Génération de recommandations détaillées pour remédier aux failles
Production d'un résumé de la situation et des étapes prioritaires

Prérequis

Python 3.7+
Bibliothèques: Flask, Requests
Clé API OpenRouter (ou autre fournisseur de modèles LLM)

Installation

Clonez le dépôt:

git clone https://github.com/AfricTivistes/adisa.git
cd adisa

Installez les dépendances:

pip install -r requirements.txt

Configurez votre clé API dans app.py ou via une variable d'environnement.

Utilisation

Démarrer l'API

python app.py

L'API sera accessible par défaut sur http://localhost:5000.

Endpoints

1. Analyse d'audit

Endpoint: POST /api/analyze

Description: Analyse les réponses d'un audit de sécurité et génère une évaluation complète.

Format de requête:

{
  "Question 1": "Réponse 1",
  "Question 2": "Réponse 2",
  "Comment gérez-vous les mots de passe?": "Nous utilisons un gestionnaire de mots de passe d'entreprise",
  ...
}

Format de réponse:

{
  "status": "success",
  "audit_type": "Audit spécifique: Politique de mots de passe",
  "evaluation": {
    "score": 7,
    "level": "Bon"
  },
  "strengths": [
    {
      "text": "Utilisation d'un gestionnaire de mots de passe centralisé",
      "rating": "Fort"
    },
    ...
  ],
  "weaknesses": [
    {
      "text": "Absence de politique de changement régulier des mots de passe",
      "rating": "Moyen"
    },
    ...
  ],
  "recommendations": [
    "Mettre en place une authentification à deux facteurs pour tous les services critiques",
    "Automatiser la détection des mots de passe faibles",
    ...
  ],
  "summary": "La gestion des mots de passe présente un bon niveau général mais nécessite des améliorations..."
}

2. Vérification de santé

Endpoint: GET /api/health

Description: Vérifie que l'API est opérationnelle.

Format de réponse:

{
  "status": "ok",
  "message": "API d'analyse d'audit de sécurité opérationnelle"
}

Personnalisation

Modification du modèle d'IA

Vous pouvez modifier le modèle utilisé en changeant les paramètres dans le constructeur de la classe SecurityAuditAnalyzer:

security_analyzer = SecurityAuditAnalyzer(
    api_key="votre-clé-api",
    model="autre-modèle"
)

Types d'audits supportés

L'API détecte automatiquement plusieurs domaines de la cybersécurité:

Politique de mots de passe
Sécurité des réseaux
Gestion des accès
Protection des données
Sécurité physique
Formation et sensibilisation
Gestion des incidents
Conformité réglementaire

Architecture du code

app.py : Point d'entrée de l'application Flask et définition des routes
SecurityAuditAnalyzer : Classe principale pour l'analyse des audits
- analyze_responses() : Méthode principale d'analyse
- _build_prompt() : Construction du prompt pour l'IA
- _detect_audit_type() : Détection automatique du type d'audit
- _parse_analysis() : Extraction des données structurées

Sécurité

⚠️ Attention: Ne stockez jamais votre clé API directement dans le code en production. Utilisez plutôt des variables d'environnement ou un fichier de configuration sécurisé.

Exemple d'utilisation avec cURL

curl -X POST http://localhost:5000/api/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "Avez-vous une politique de mots de passe?": "Oui, nous exigeons des mots de passe d'au moins 8 caractères",
    "Utilisez-vous l'authentification à deux facteurs?": "Seulement pour les comptes administrateurs",
    "À quelle fréquence les mots de passe sont-ils changés?": "Il n'y a pas d'obligation de changement"
  }'