""" Контракт защиты персональных данных по 152-ФЗ и Приказу ФСТЭК России № 117. Детерминированное выявление и блокировка передачи ПДн (СНИЛС, ИНН, карты МИР, паспорта РФ). Не использует внешние нейросетевые модели; валидация выполняется по математическим контрольным суммам (<0.1 мс). """ import re from typing import Any, Dict, List, Optional, Tuple from .base import BaseSecurityContract, ContractVerdict def is_valid_snils(snils_str: str) -> bool: """ Валидация СНИЛС по официальному алгоритму ПФР/СФР. 11 цифр: 9 цифр номера + 2 цифры контрольного числа. """ digits = [int(c) for c in snils_str if c.isdigit()] if len(digits) != 11: return False # Все одинаковые цифры недопустимы по стандарту if len(set(digits)) == 1: return False num = int("".join(str(d) for d in digits[:9])) if num <= 1001998: return False check_sum = sum(digits[i] * (9 - i) for i in range(9)) if check_sum < 100: expected = check_sum elif check_sum in (100, 101): expected = 0 else: rem = check_sum % 101 expected = 0 if rem in (100, 101) else rem actual = digits[9] * 10 + digits[10] return expected == actual def is_valid_inn_10(inn_str: str) -> bool: """Валидация 10-значного ИНН юридического лица по контрольной сумме.""" digits = [int(c) for c in inn_str if c.isdigit()] if len(digits) != 10: return False weights = [2, 4, 10, 3, 5, 9, 4, 6, 8] check = sum(digits[i] * weights[i] for i in range(9)) % 11 % 10 return check == digits[9] def is_valid_inn_12(inn_str: str) -> bool: """Валидация 12-значного ИНН физического лица / ИП по двум контрольным суммам.""" digits = [int(c) for c in inn_str if c.isdigit()] if len(digits) != 12: return False w11 = [7, 2, 4, 10, 3, 5, 9, 4, 6, 8] check11 = sum(digits[i] * w11[i] for i in range(10)) % 11 % 10 w12 = [3, 7, 2, 4, 10, 3, 5, 9, 4, 6, 8] check12 = sum(digits[i] * w12[i] for i in range(11)) % 11 % 10 return check11 == digits[10] and check12 == digits[11] def is_valid_luhn(card_str: str) -> bool: """Проверка номера банковской карты по алгоритму Луна.""" digits = [int(c) for c in card_str if c.isdigit()] if len(digits) not in (16, 18, 19): return False checksum = 0 reverse_digits = digits[::-1] for i, d in enumerate(reverse_digits): if i % 2 == 1: doubled = d * 2 checksum += (doubled - 9) if doubled > 9 else doubled else: checksum += d return checksum % 10 == 0 def is_valid_passport_rf(series: str, number: str) -> bool: """ Валидация серии и номера паспорта гражданина РФ. Серия: 4 цифры (2 цифры региона ОКАТО 01..99 + 2 цифры года выдачи 97..26). Номер: 6 цифр. """ s_digits = [c for c in series if c.isdigit()] n_digits = [c for c in number if c.isdigit()] if len(s_digits) != 4 or len(n_digits) != 6: return False region = int("".join(s_digits[:2])) year = int("".join(s_digits[2:])) if not (1 <= region <= 99): return False # Год выдачи паспорта РФ современного стандарта: с 1997 по 2026 (97..99 или 00..26) if not ((97 <= year <= 99) or (0 <= year <= 26)): return False return True # Регулярные выражения для первичного извлечения кандидатов RE_SNILS = re.compile(r"\b(\d{3})[-\s]?(\d{3})[-\s]?(\d{3})[-\s]?(\d{2})\b") RE_INN = re.compile(r"\b(\d{10}|\d{12})\b") RE_CARD = re.compile(r"\b(\d{4})[-\s]?(\d{4})[-\s]?(\d{4})[-\s]?(\d{4})\b") RE_PASSPORT = re.compile(r"(?i)\b(?:серия\s*)?(\d{2}\s*\d{2})\s*(?:номер\s*|№\s*|,\s*|;\s*|\s+)?(\d{6})\b") class PersonalDataContract(BaseSecurityContract): """ Детерминированный контракт защиты персональных данных (152-ФЗ). Блокирует передачу клиентских ПДн через аргументы инструментов и ответы. """ name = "personal_data_filter" rule_id = "SEC-PDN-152" def __init__( self, block_snils: bool = True, block_inn: bool = True, block_cards: bool = True, block_passport: bool = True, ): self.block_snils = block_snils self.block_inn = block_inn self.block_cards = block_cards self.block_passport = block_passport def _scan_text(self, text: str) -> Optional[Tuple[str, str, str]]: """ Сканирует текст на наличие валидных ПДн. Возвращает (pdn_type, masked_value, description) или None. """ if not text or not isinstance(text, str): return None # 1. Проверка СНИЛС if self.block_snils: for match in RE_SNILS.finditer(text): full_val = "".join(match.groups()) if is_valid_snils(full_val): masked = f"{full_val[:3]}-***-*** {full_val[-2:]}" return ("SNILS", masked, f"Обнаружен СНИЛС с валидной контрольной суммой ({masked})") # 2. Проверка банковских карт (МИР / Visa / MasterCard) if self.block_cards: for match in RE_CARD.finditer(text): raw = "".join(match.groups()) if is_valid_luhn(raw): system = "МИР" if raw.startswith("2") else ("Visa" if raw.startswith("4") else "Mastercard/Other") masked = f"{raw[:4]} **** **** {raw[-4:]}" return ("BANK_CARD", masked, f"Обнаружена банковская карта {system} с валидным Luhn ({masked})") # 3. Проверка ИНН (10 или 12 цифр) if self.block_inn: for match in RE_INN.finditer(text): val = match.group(1) if len(val) == 10 and is_valid_inn_10(val): masked = f"{val[:4]}****{val[-2:]}" return ("INN_LEGAL", masked, f"Обнаружен валидный ИНН юрлица ({masked})") elif len(val) == 12 and is_valid_inn_12(val): masked = f"{val[:4]}******{val[-2:]}" return ("INN_PERSONAL", masked, f"Обнаружен валидный ИНН физлица/ИП ({masked})") # 4. Проверка паспорта РФ if self.block_passport: for match in RE_PASSPORT.finditer(text): series = match.group(1).replace(" ", "") number = match.group(2) # Требуем либо явный контекст "паспорт", либо валидную связку серии региона/года if is_valid_passport_rf(series, number): # Дополнительный фильтр: исключаем ложные совпадения случайных чисел без слова паспорт, # если число не сопровождается маркерами документа has_marker = bool(re.search(r"(?i)(паспорт|документ|выдан|серия|номер|рф)", text)) if has_marker: masked = f"{series[:2]}** {number[:2]}****" return ("PASSPORT_RF", masked, f"Обнаружены реквизиты паспорта РФ ({masked})") return None def _inspect_data(self, data: Any) -> Optional[Tuple[str, str, str]]: """Рекурсивный поиск ПДн в строках, словарях и списках.""" if isinstance(data, str): return self._scan_text(data) elif isinstance(data, dict): for k, v in data.items(): res = self._inspect_data(k) if res: return res res = self._inspect_data(v) if res: return res elif isinstance(data, (list, tuple, set)): for item in data: res = self._inspect_data(item) if res: return res return None def check_tool_call(self, tool_name: str, arguments: Dict[str, Any]) -> ContractVerdict: finding = self._inspect_data(arguments) if finding: pdn_type, masked, desc = finding return ContractVerdict( allowed=False, reason=f"152-ФЗ: {desc}. Передача персональных данных во внешние инструменты запрещена.", rule_id=self.rule_id, details={"pdn_type": pdn_type, "masked": masked} ) return ContractVerdict(allowed=True, reason="Pass", rule_id=self.rule_id) def check_tool_result(self, tool_name: str, result_content: str) -> ContractVerdict: finding = self._scan_text(result_content) if finding: pdn_type, masked, desc = finding return ContractVerdict( allowed=False, reason=f"152-ФЗ: {desc}. Утечка персональных данных в исходящем потоке заблокирована.", rule_id=self.rule_id, details={"pdn_type": pdn_type, "masked": masked} ) return ContractVerdict(allowed=True, reason="Pass", rule_id=self.rule_id)