Replaces LICENSE (GPLv3 -> AGPLv3) and prepends `SPDX-License-Identifier: AGPL-3.0-or-later` to every source file across decnet/, decnet_web/, tests/, scripts/, and tools/. Rationale: closes the GPLv3 ASP loophole so any party operating a modified DECNET as a network service must offer their modified source. Personal copyright (Samuel Paschuan) + inbound=outbound contributions make a future unilateral relicense infeasible. - LICENSE: full AGPL-3.0 text (gnu.org/licenses/agpl-3.0.txt) - COPYRIGHT: project copyright notice - tools/add_spdx_headers.py: idempotent header injector (shebang- and PEP 263-aware) Touches 1565 source files (.py, .ts, .tsx, .js, .jsx, .css, .sh). No behavior change; comments only.
40 lines
1.1 KiB
Python
40 lines
1.1 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""RPKI validator protocol.
|
|
|
|
Concrete validators (:mod:`decnet.rpki.ripestat`, future offline providers)
|
|
implement this. Callers must go through
|
|
:func:`~decnet.rpki.factory.get_validator`; never import a concrete
|
|
validator class directly.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from abc import ABC, abstractmethod
|
|
from dataclasses import dataclass
|
|
from datetime import datetime
|
|
from typing import Literal, Optional
|
|
|
|
RpkiStatus = Literal["valid", "invalid", "not-found", "unknown"]
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class RpkiResult:
|
|
"""Outcome of a single RPKI validity check."""
|
|
|
|
status: RpkiStatus
|
|
prefix: Optional[str] = None # announced prefix the validator resolved for this IP
|
|
validated_at: Optional[datetime] = None
|
|
|
|
|
|
class Validator(ABC):
|
|
"""Abstract RPKI validator."""
|
|
|
|
#: Short tag written to ``Attacker.rpki_source`` (e.g. ``'ripestat'``).
|
|
name: str
|
|
|
|
@abstractmethod
|
|
def validate(self, ip: str, asn: int) -> RpkiResult:
|
|
"""Return RPKI validity for (ip, asn). Never raises."""
|
|
|
|
def refresh(self) -> None:
|
|
"""No-op for online validators; offline providers may override."""
|