Mirrors/coredns
1
0
Fork 0
mirror of https://github.com/coredns/coredns.git synced 2025-10-27 08:14:18 -04:00
Code Issues Packages Projects Releases Wiki Activity
Files
b984aa45595dc95253b91191afe7d3ee29e71b48
coredns/middleware/whoami/README.md

45 lines
1.1 KiB
Markdown
Raw Normal View History

middleware/whoami: add (#264) Add a new middleware that tells you who you are; IP, port and transport is echoed back. Also some various cleanup and documentation improvements while at it: * ResponseWriter: improve the documentation of these helper functions. * And add an NextHandler for use in tests. Make chaos_test.go and * whoam_test.go use it.
2016-09-17 17:09:05 +01:00
# whoami
mw/whoami: update docs (#1054) * mw/whoami: update docs Parse the corefile in the readme_test.go and other tweaks to the docs. Fixes #1049 * trailing * remove the 53 port
2017-09-10 20:46:25 +01:00
*whoami* returns your resolver's local IP address, port and transport. Your IP address is returned
in the additional section as either an A or AAAA record.
middleware/whoami: add (#264) Add a new middleware that tells you who you are; IP, port and transport is echoed back. Also some various cleanup and documentation improvements while at it: * ResponseWriter: improve the documentation of these helper functions. * And add an NextHandler for use in tests. Make chaos_test.go and * whoam_test.go use it.
2016-09-17 17:09:05 +01:00
mw/whoami: update docs (#1054) * mw/whoami: update docs Parse the corefile in the readme_test.go and other tweaks to the docs. Fixes #1049 * trailing * remove the 53 port
2017-09-10 20:46:25 +01:00
The reply always has an empty answer section. The port and transport are included in the additional
section as a SRV record, transport can be "tcp" or "udp".
middleware/whoami: add (#264) Add a new middleware that tells you who you are; IP, port and transport is echoed back. Also some various cleanup and documentation improvements while at it: * ResponseWriter: improve the documentation of these helper functions. * And add an NextHandler for use in tests. Make chaos_test.go and * whoam_test.go use it.
2016-09-17 17:09:05 +01:00
~~~ txt
._<transport>.qname. 0 IN SRV 0 0 <port> .
~~~
mw/whoami: update docs (#1054) * mw/whoami: update docs Parse the corefile in the readme_test.go and other tweaks to the docs. Fixes #1049 * trailing * remove the 53 port
2017-09-10 20:46:25 +01:00
If CoreDNS can't find a Corefile on startup this is the *default* middleware that gets loaded. As
such it can be used to check that CoreDNS is responding to queries. Other than that this middleware
is of limited use in production.
middleware/whoami: add (#264) Add a new middleware that tells you who you are; IP, port and transport is echoed back. Also some various cleanup and documentation improvements while at it: * ResponseWriter: improve the documentation of these helper functions. * And add an NextHandler for use in tests. Make chaos_test.go and * whoam_test.go use it.
2016-09-17 17:09:05 +01:00
The *whoami* middleware will respond to every A or AAAA query, regardless of the query name.
## Syntax
~~~ txt
whoami
~~~
## Examples
mw/whoami: update docs (#1054) * mw/whoami: update docs Parse the corefile in the readme_test.go and other tweaks to the docs. Fixes #1049 * trailing * remove the 53 port
2017-09-10 20:46:25 +01:00
Start a server on the default port and load the *whoami* middleware.
~~~ corefile
. {
middleware/whoami: add (#264) Add a new middleware that tells you who you are; IP, port and transport is echoed back. Also some various cleanup and documentation improvements while at it: * ResponseWriter: improve the documentation of these helper functions. * And add an NextHandler for use in tests. Make chaos_test.go and * whoam_test.go use it.
2016-09-17 17:09:05 +01:00
whoami
}
~~~
When queried for "example.org A", CoreDNS will respond with:
~~~ txt
;; QUESTION SECTION:
;example.org. IN A
;; ADDITIONAL SECTION:
example.org. 0 IN A 10.240.0.1
_udp.example.org. 0 IN SRV 0 0 40212
~~~
Reference in New Issue Copy Permalink