Commit 882b2d91 authored by Yong Tang's avatar Yong Tang Committed by GitHub

Update ACL plugin's README to capture the edge case (#5311)

* Update ACL plugin's README to capture the edge case

This PR adds a note in ACL plugin's README to capture the edge case
where source ip of the client may be different from the source ip
observed by coredns server (in situations such as Source NAT).
Signed-off-by: default avatarYong Tang <yong.tang.github@outlook.com>

* Update plugin/acl/README.md
Co-authored-by: default avatarChris O'Haver <cohaver@infoblox.com>
Signed-off-by: default avatarYong Tang <yong.tang.github@outlook.com>

* Update plugin/acl/README.md
Co-authored-by: default avatarChris O'Haver <cohaver@infoblox.com>
Signed-off-by: default avatarYong Tang <yong.tang.github@outlook.com>
Co-authored-by: default avatarChris O'Haver <cohaver@infoblox.com>
parent 275c014c
...@@ -6,7 +6,13 @@ ...@@ -6,7 +6,13 @@
## Description ## Description
With `acl` enabled, users are able to block or filter suspicious DNS queries by configuring IP filter rule sets, i.e. allowing authorized queries to recurse or blocking unauthorized queries. With `acl` enabled, users are able to block or filter suspicious DNS queries by configuring IP filter rule sets, i.e. allowing authorized queries or blocking unauthorized queries.
When evaluating the rule sets, _acl_ uses the source IP of the TCP/UDP headers of the DNS query received by CoreDNS.
This source IP will be different than the IP of the client originating the request in cases where the source IP of the request is changed in transit. For example:
* if the request passes though an intermediate forwarding DNS server or recursive DNS server before reaching CoreDNS
* if the request traverses a Source NAT before reaching CoreDNS
This plugin can be used multiple times per Server Block. This plugin can be used multiple times per Server Block.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment