Files
gh-christianlouis-dmarq/backend/app/utils/domain_validator.py
T

99 lines
3.9 KiB
Python

import re
import socket
from typing import Dict, Tuple, Union, Optional
def validate_domain(domain_name: str, check_dns: bool = True) -> Tuple[bool, Optional[str]]:
"""
Validates a domain name for format and optionally resolvability.
Args:
domain_name: The domain name to validate
check_dns: Whether to perform DNS resolution check (default: True)
Returns:
Tuple containing (is_valid, error_message)
- is_valid: Boolean indicating if domain is valid
- error_message: String with error message if not valid, None if valid
"""
# Security: Check for empty or None domain
if not domain_name:
return False, "Domain name cannot be empty"
# Security: Check maximum length (DNS standard is 253 characters)
if len(domain_name) > 253:
return False, "Domain name too long (max 253 characters)"
# Security: Check for whitespace
if ' ' in domain_name or '\t' in domain_name or '\n' in domain_name:
return False, "Domain name cannot contain whitespace"
# Security: Check for suspicious characters
if any(char in domain_name for char in ['<', '>', '"', "'", '\\', '|', ';', '&', '$', '`']):
return False, "Domain name contains invalid characters"
# Check domain format with regex
# This regex allows domain names with alphanumeric characters, hyphens,
# and periods as separators. It enforces proper domain structure.
# Updated to be more strict and prevent potential attacks
domain_pattern = r'^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$'
if not re.match(domain_pattern, domain_name.lower()):
return False, "Invalid domain format"
# Security: Check each label length (max 63 characters per label)
labels = domain_name.split('.')
for label in labels:
if len(label) > 63:
return False, f"Domain label too long: '{label}' (max 63 characters per label)"
if label.startswith('-') or label.endswith('-'):
return False, f"Domain label cannot start or end with hyphen: '{label}'"
# Check if domain exists by attempting to resolve DNS (optional)
if check_dns:
try:
socket.gethostbyname(domain_name)
return True, None
except socket.gaierror:
# We could consider this valid if we don't require DNS resolution,
# but since DMARC requires valid DNS, we'll mark it as warning
return False, "Domain could not be resolved (DNS lookup failed)"
return True, None
def validate_domain_config(domain_data: Dict) -> Dict[str, Union[bool, str]]:
"""
Validates domain configuration data for creating or updating domains.
Args:
domain_data: Dictionary with domain configuration
Returns:
Dictionary with validation results containing:
- valid: Boolean indicating if configuration is valid
- errors: Dict of field-specific errors
"""
errors = {}
# Validate domain name
if "name" in domain_data:
# Don't check DNS for domain config validation
is_valid, error_msg = validate_domain(domain_data["name"], check_dns=False)
if not is_valid:
errors["name"] = error_msg
else:
errors["name"] = "Domain name is required"
# Validate description (optional but with max length)
if "description" in domain_data and domain_data["description"]:
if len(domain_data["description"]) > 500:
errors["description"] = "Description is too long (max 500 characters)"
# Security: Check for suspicious content in description
if any(char in domain_data["description"] for char in ['<script', '<iframe', 'javascript:']):
errors["description"] = "Description contains potentially unsafe content"
# Return validation results
return {
"valid": len(errors) == 0,
"errors": errors
}