summaryrefslogtreecommitdiffstats
path: root/bin/tests/system/doth/README.curl
diff options
context:
space:
mode:
Diffstat (limited to 'bin/tests/system/doth/README.curl')
-rw-r--r--bin/tests/system/doth/README.curl38
1 files changed, 38 insertions, 0 deletions
diff --git a/bin/tests/system/doth/README.curl b/bin/tests/system/doth/README.curl
new file mode 100644
index 0000000..475f20f
--- /dev/null
+++ b/bin/tests/system/doth/README.curl
@@ -0,0 +1,38 @@
+<!--
+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.
+-->
+
+DoH query values that can be passed on the command line for testing
+with curl can be obtained by encoding binary DNS messages into
+base64url, with trailing '='s removed.
+
+For example:
+
+$ perl bin/tests/system/fromhex.pl << EOF | base64url
+ # Transaction ID
+ 0001
+ # Standard query
+ 0000
+ # Questions: 1, Additional: 0
+ 0001 0000 0000 0000
+ # QNAME: example
+ 07 6578616d706c65 00
+ # Type: SOA
+ 0006
+ Class: IN
+ 0001
+EOF
+
+This produces the string "AAEAAAABAAAAAAAAB2V4YW1wbGUAAAbFrMonAAE=". With
+the trailing '=' removed, this can then be passed to curl:
+
+curl "https://<server>/dns-query?dns=AAEAAAABAAAAAAAAB2V4YW1wbGUAAAbFrMonAAE"