Référence Développeur

Recette d'évaluation des menaces Documentation de l'API

Recette d'évaluation des menaces Documentation de l'API: Analyse complète des menaces de typosquattage et de marque pour les équipes de sécurité.

Recette d'évaluation des menaces

Analyse complète des menaces de typosquattage et de marque pour les équipes de sécurité.

GET /v1/recipes/threat-assessment

Paramètres de Requête

Paramètre	Type	Description
domain requis	string	Domaine de marque pour lequel évaluer les menaces

La réponse inclut

Détection des domaines de typosquattage
Détection des attaques homoglyphes
Identification des menaces actives
Évaluation et priorisation des risques
Recommandations de correction

Champs de Réponse

Champ	Type
`success`	boolean
`data`	object
`data.domain`	string
`data.summary`	object
`data.summary.risk_level`	string
`data.summary.overall_score`	number
`data.summary.total_variants_generated`	number
`data.summary.variants_registered`	number
`data.summary.active_threats`	number
`data.summary.suspicious_activity`	number
`data.protection_score`	object
`data.protection_score.score`	number
`data.protection_score.grade`	string
`data.protection_score.vulnerabilities[]`	object[]
`data.protection_score.vulnerabilities[]`	object
`data.protection_score.vulnerabilities[].category`	string
`data.protection_score.vulnerabilities[].count`	number
`data.protection_score.vulnerabilities[].risk`	string
`data.protection_score.vulnerabilities[].description`	string
`data.threats[]`	object[]
`data.threats[]`	object
`data.threats[].domain`	string
`data.threats[].threat_type`	string
`data.threats[].risk_level`	string
`data.threats[].registered`	boolean
`data.threats[].registration`	object
`data.threats[].registration.registrar`	string
`data.threats[].registration.created_date`	string
`data.threats[].registration.privacy_protected`	boolean
`data.threats[].infrastructure`	object
`data.threats[].infrastructure.ip`	string
`data.threats[].infrastructure.hosting_provider`	string
`data.threats[].infrastructure.country`	string
`data.threats[].indicators`	object
`data.threats[].indicators.has_mx_records`	boolean
`data.threats[].indicators.has_website`	boolean
`data.threats[].indicators.ssl_valid`	boolean
`data.threats[].indicators.reputation_flags[]`	string[]
`data.threats[].recommendation`	string
`data.recommendations[]`	string[]
`data.action_items[]`	object[]
`data.action_items[]`	object
`data.action_items[].priority`	string
`data.action_items[].category`	string
`data.action_items[].action`	string
`data.action_items[].details`	string
`data.action_items[].estimated_impact`	string
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

Exemple de Réponse

{
  "success": true,
  "data": {
    "domain": "brand.com",
    "summary": {
      "risk_level": "high",
      "overall_score": 61,
      "total_variants_generated": 120,
      "variants_registered": 14,
      "active_threats": 3,
      "suspicious_activity": 2
    },
    "protection_score": {
      "score": 73,
      "grade": "B",
      "vulnerabilities": [
        {
          "category": "homoglyph",
          "count": 3,
          "risk": "high",
          "description": "Lookalike Unicode variants are registered."
        }
      ]
    },
    "threats": [
      {
        "domain": "brancd.com",
        "threat_type": "typosquatting",
        "risk_level": "high",
        "registered": true,
        "registration": {
          "registrar": "Example Registrar",
          "created_date": "2026-01-10",
          "privacy_protected": true
        },
        "infrastructure": {
          "ip": "198.51.100.21",
          "hosting_provider": "Example Hosting",
          "country": "US"
        },
        "indicators": {
          "has_mx_records": true,
          "has_website": true,
          "ssl_valid": false,
          "reputation_flags": [
            "recent_registration",
            "parked"
          ]
        },
        "recommendation": "Investigate hosting and submit abuse report."
      }
    ],
    "recommendations": [
      "Monitor newly registered typo variants.",
      "Escalate active lookalike websites to brand protection."
    ],
    "action_items": [
      {
        "priority": "critical",
        "category": "brand-protection",
        "action": "Investigate high-risk typo domains",
        "details": "Three active websites are impersonating the brand.",
        "estimated_impact": "Reduce phishing exposure"
      }
    ]
  },
  "meta": {
    "recipe_name": "threat-assessment",
    "credits_used": 15,
    "credits_saved": 25,
    "duration_ms": 934,
    "components_called": [
      "typosquatting",
      "availability",
      "whois",
      "health",
      "reputation"
    ],
    "cached_components": [
      "availability"
    ],
    "timestamp": "2026-04-15T10:02:00Z"
  },
  "errors": []
}