Skip to content

Updates algortithm table in DNSSEC05 specification#1183

Merged
matsduf merged 3 commits into
zonemaster:developfrom
matsduf:update-dnssec05
Dec 4, 2023
Merged

Updates algortithm table in DNSSEC05 specification#1183
matsduf merged 3 commits into
zonemaster:developfrom
matsduf:update-dnssec05

Conversation

@matsduf

@matsduf matsduf commented Jul 25, 2023

Copy link
Copy Markdown
Contributor

Purpose

Zonemaster needs DNSKEY algorithm mnemonic for all possible algorithms. The IANA table has no mnemonic for resevered or unassigned algorithms. The purpose of this PR is to let this test case defined such mnemonics for the use in Zonemaster implementation of any test case needing it.

This PR does not update any other parts of the specification even though it does not fully match the current test case specification template. That is for another PR.

Context

See #1179 (comment) and the responses on that.

This PR makes this specification authoritative of the table above, which means that Argument list must be updated (to-do).

Changes

This PR does not change any logic and requires not updates to the implementation of the test case.

How to test this PR

Review the changes.

@matsduf matsduf added A-TestCase Area: Test case specification or implementation of test case A-Documentation Area: Documentation only. labels Jul 25, 2023
@matsduf matsduf added this to the v2023.2 milestone Jul 25, 2023
@matsduf matsduf requested a review from marc-vanderwal July 25, 2023 14:30
tgreenx
tgreenx previously approved these changes Jul 25, 2023
marc-vanderwal
marc-vanderwal previously approved these changes Aug 16, 2023
@matsduf

matsduf commented Aug 16, 2023

Copy link
Copy Markdown
Contributor Author

@tgreenx and @marc-vanderwal, the Zonemaster defined mnemonics in this PR are lower case, while the IANA defined are in upper case. Should I change to upper case?

@marc-vanderwal

Copy link
Copy Markdown
Contributor

@tgreenx and @marc-vanderwal, the Zonemaster defined mnemonics in this PR are lower case, while the IANA defined are in upper case. Should I change to upper case?

If “reserved” and the other mnemonics are kept as lowercase, DS10_ALGO_NOT_SUPPORTED_BY_ZM would be rendered as:

DNSKEY with tag 51966 uses unsupported algorithm 123 (reserved) by this installation of Zonemaster. Fetched from the nameservers with IP addresses "ns.example/2001:db8:8::53".

If switching to uppercase, that would be:

DNSKEY with tag 51966 uses unsupported algorithm 123 (Reserved) by this installation of Zonemaster. Fetched from the nameservers with IP addresses "ns.example/2001:db8:8::53".

I think the lowercase form looks best.

@matsduf

matsduf commented Aug 22, 2023

Copy link
Copy Markdown
Contributor Author

@marc-vanderwal, what I meant was all uppercase, e.g.

DNSKEY with tag 51966 uses unsupported algorithm 123 (RESERVED) by this installation of Zonemaster. Fetched from the nameservers with IP addresses "ns.example/2001:db8:8::53".

The IANA defined mnemonics are in all uppercase. Let us say that Gost is not supported, then the same message will be today:

DNSKEY with tag 51966 uses unsupported algorithm 12 (ECC-GOST) by this installation of Zonemaster. Fetched from the nameservers with IP addresses "ns.example/2001:db8:8::53".

I think that the Zonemaster defined mnemonics should follow the same pattern as the IANA defined mnemonics, i.e. be in all uppercase.

@marc-vanderwal

Copy link
Copy Markdown
Contributor

You’re right, the all-uppercase versions actually look better. I’m fine with this change.

@matsduf matsduf dismissed stale reviews from marc-vanderwal and tgreenx via 1982f70 August 22, 2023 12:31
marc-vanderwal
marc-vanderwal previously approved these changes Aug 22, 2023
Comment thread docs/public/specifications/tests/DNSSEC-TP/dnssec05.md Outdated
Co-authored-by: tgreenx <96772376+tgreenx@users.noreply.github.com>
@matsduf

matsduf commented Nov 22, 2023

Copy link
Copy Markdown
Contributor Author

@marc-vanderwal and @tgreenx, please re-review.

@matsduf matsduf merged commit d40c08c into zonemaster:develop Dec 4, 2023
@matsduf matsduf deleted the update-dnssec05 branch December 4, 2023 11:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Documentation Area: Documentation only. A-TestCase Area: Test case specification or implementation of test case

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants