fergalmoran/DnsServer
1
0
Fork 0
mirror of https://github.com/fergalmoran/DnsServer.git synced 2025-12-22 09:29:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

IDnsRequestBlockingHandler: added DNS app request blocking interface to allow same level of blocking support as that of the DNS server's built-in blocking feature.

Browse Source
This commit is contained in:
Shreyas Zare
2023-10-29 18:46:56 +05:30
parent d4352680b3
commit 6c8e37e4cc
1 changed files with 47 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
DnsServerCore.ApplicationCommon/IDnsRequestBlockingHandler.cs Normal file
View File

@@ -0,0 +1,47 @@
/*
Technitium DNS Server
Copyright (C) 2023 Shreyas Zare (shreyas@technitium.com)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
using System.Net;
using System.Threading.Tasks;
using TechnitiumLibrary.Net.Dns;
namespace DnsServerCore.ApplicationCommon
{
/// <summary>
/// Lets DNS Apps provide DNS level domain name blocking feature.
/// </summary>
public interface IDnsRequestBlockingHandler
{
/// <summary>
/// Specifies if the query domain name in the incoming DNS request is allowed to bypass any configured block lists (including for DNS server's built-in blocking feature).
/// </summary>
/// <param name="request">The incoming DNS request to be processed.</param>
/// <param name="remoteEP">The end point (IP address and port) of the client making the request.</param>
/// <returns>Returns <c>true</c> if the query domain name in the incoming DNS request is allowed to bypass blocking.</returns>
Task<bool> IsAllowedAsync(DnsDatagram request, IPEndPoint remoteEP);
/// <summary>
/// Specifies if the query domain name in the incoming DNS request is blocked based on the app's own configured block lists.
/// </summary>
/// <param name="request">The incoming DNS request to be processed.</param>
/// <param name="remoteEP">The end point (IP address and port) of the client making the request.</param>
/// <returns>The blocked DNS response for the DNS request or <c>null</c> to let the DNS server core process the request as usual.</returns>
Task<DnsDatagram> ProcessRequestAsync(DnsDatagram request, IPEndPoint remoteEP);
}
}