""" Copyright (C) Internet Systems Consortium, Inc. ("ISC") SPDX-License-Identifier: MPL-2.0 This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one at https://mozilla.org/MPL/2.0/. See the COPYRIGHT file distributed with this work for additional information regarding copyright ownership. """ from collections.abc import AsyncGenerator, Collection import abc import dns.rcode import dns.rdataclass import dns.rdatatype import dns.rrset from isctest.asyncserver import ( AxfrHandler, ControllableAsyncDnsServer, DnsResponseSend, QueryContext, ResponseHandler, SwitchControlCommand, ) def rrset(owner: str, rdtype: dns.rdatatype.RdataType, rdata: str) -> dns.rrset.RRset: return dns.rrset.from_text( owner, 300, dns.rdataclass.IN, rdtype, rdata, ) def soa(serial: int, *, owner: str = "nil.") -> dns.rrset.RRset: return rrset( owner, dns.rdatatype.SOA, f"ns.nil. root.nil. {serial} 300 300 604800 300", ) def ns() -> dns.rrset.RRset: return rrset( "nil.", dns.rdatatype.NS, "ns.nil.", ) def a(address: str, *, owner: str) -> dns.rrset.RRset: return rrset( owner, dns.rdatatype.A, address, ) def txt(data: str, *, owner: str = "nil.") -> dns.rrset.RRset: return rrset( owner, dns.rdatatype.TXT, f'"{data}"', ) class SoaHandler(ResponseHandler): def __init__(self, serial: int): self._serial = serial def match(self, qctx: QueryContext) -> bool: return qctx.qtype == dns.rdatatype.SOA async def get_responses( self, qctx: QueryContext ) -> AsyncGenerator[DnsResponseSend, None]: qctx.response.answer.append(soa(self._serial)) yield DnsResponseSend(qctx.response) class IxfrHandler(ResponseHandler): @property @abc.abstractmethod def answer(self) -> Collection[dns.rrset.RRset]: """ Answer section of a response packet sent in response to IXFR queries. """ raise NotImplementedError def match(self, qctx: QueryContext) -> bool: return qctx.qtype == dns.rdatatype.IXFR async def get_responses( self, qctx: QueryContext ) -> AsyncGenerator[DnsResponseSend, None]: for rrset_ in self.answer: qctx.response.answer.append(rrset_) yield DnsResponseSend(qctx.response) class InitialAfxrHandler(AxfrHandler): initial_soa = soa(1) zone_contents = ( ns(), txt("initial AXFR"), a("10.0.0.61", owner="a.nil."), a("10.0.0.62", owner="b.nil."), ) final_soa = soa(1) class SuccessfulIfxrHandler(IxfrHandler): answer = ( soa(3), soa(1), a("10.0.0.61", owner="a.nil."), txt("initial AXFR"), soa(2), txt("successful IXFR"), a("10.0.1.61", owner="a.nil."), soa(2), soa(3), soa(3), ) class NotExactIxfrHandler(IxfrHandler): answer = ( soa(4), soa(3), txt("delete-nonexistent-txt-record"), soa(4), txt("this-txt-record-would-be-added"), soa(4), ) class FallbackNotExactAxfrHandler(AxfrHandler): initial_soa = soa(3) zone_contents = ( ns(), txt("fallback AXFR"), ) final_soa = soa(3) class TooManyRecordsIxfrHandler(IxfrHandler): answer = ( soa(4), soa(3), soa(4), txt("text 1"), txt("text 2"), txt("text 3"), txt("text 4"), txt("text 5"), txt("text 6: causing too many records"), soa(4), ) class FallbackTooManyRecordsAxfrHandler(AxfrHandler): initial_soa = soa(3) zone_contents = ( ns(), txt("fallback AXFR on too many records"), ) final_soa = soa(3) class BadSoaOwnerIxfrHandler(IxfrHandler): answer = ( soa(4), soa(3), soa(4, owner="bad-owner."), txt("serial 4, malformed IXFR", owner="test.nil."), soa(4), ) class FallbackBadSoaOwnerAxfrHandler(AxfrHandler): initial_soa = soa(4) zone_contents = ( ns(), txt("serial 4, fallback AXFR", owner="test.nil."), ) final_soa = soa(4) def main() -> None: server = ControllableAsyncDnsServer( default_aa=True, default_rcode=dns.rcode.NOERROR ) switch_command = SwitchControlCommand( { "initial_axfr": ( SoaHandler(1), InitialAfxrHandler(), ), "successful_ixfr": ( SoaHandler(3), SuccessfulIfxrHandler(), ), "not_exact": ( SoaHandler(4), NotExactIxfrHandler(), FallbackNotExactAxfrHandler(), ), "too_many_records": ( SoaHandler(4), TooManyRecordsIxfrHandler(), FallbackTooManyRecordsAxfrHandler(), ), "bad_soa_owner": ( SoaHandler(4), BadSoaOwnerIxfrHandler(), FallbackBadSoaOwnerAxfrHandler(), ), } ) server.install_control_command(switch_command) server.run() if __name__ == "__main__": main()