Skip to content

Arch Assertion Categories#2149

Merged
egekorkan merged 3 commits intomainfrom
egekorkan-patch-4
Oct 1, 2025
Merged

Arch Assertion Categories#2149
egekorkan merged 3 commits intomainfrom
egekorkan-patch-4

Conversation

@egekorkan
Copy link
Contributor

Description of Changes

This contains the categories for my and @mjkoster assertions. @relu91 and @danielpeintner there are some assertions related to "WoT Runtime", which is not necessarily the Scripting API. Feel free to comment on those.

Related Issue

part of #2126

Type of Change

@egekorkan egekorkan requested a review from k-toumura September 30, 2025 11:56
@egekorkan egekorkan added Editorial Issues with no technical impact on implementations document synchronisation topics on how to better synchronize between other WoT documents labels Sep 30, 2025
Copy link
Contributor

@k-toumura k-toumura left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Regarding assertion 48: Since QUIC can be used as a secure transport over UDP, we might need to rephrase this assertion.

Copy link
Contributor

@danielpeintner danielpeintner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

I have 2 questions:

  • shall we really state various "secure" versions while they might get out of date?
  • what does it mean if we tick or not tick the checkboxes?

- D (can also be B and in Scripting API but this is not limited to scripting api implementations)

- [ ] 35. A WoT Runtime implementation SHOULD provide a hardware abstraction layer for accessing the low-level device hardware interfaces. ([arch-security-consideration-use-hal](https://www.w3.org/TR/wot-architecture11/#arch-security-consideration-use-hal))
- D (can also be B and in Scripting API but this is not limited to scripting api implementations)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Categorization is fine.

BTW, I don't really see any difference to 34 🤷‍♂️

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would say that 35 is what you should do to avoid 34. 35 is more of a guideline so we should keep that.

Note: Technically by not exposing anything device-related, one would achieve 34. Like adding two numbers that happen purely in software.


- [ ] 47. If TLS 1.3 cannot be used for compatibility reasons but secure transport over TCP is appropriate, TLS 1.2 [RFC5246] MAY be used. ([arch-security-consideration-tls-1-2](https://www.w3.org/TR/wot-architecture11/#arch-security-consideration-tls-1-2))

- A3: This should be a generic assertion to all bindings that can support TCP. The implementation enforcement can only happen in the binding, which is informative. However, we should recommend all implementers to do that. In the binding documents, there should be informative notes about this that can point back to TD.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe it is just me, but I think we should state that the most secure transport should be used unless not possible. Specifying 1.3 while it might be possible that in the near future 1.4 is released does not make sense to me.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree. We can put an informative note after the assertion saying something like "At the time of writing, this is TLS and DTLS 1.3, but please check the most recent version"

@egekorkan egekorkan merged commit f4d0dff into main Oct 1, 2025
2 checks passed
@egekorkan egekorkan deleted the egekorkan-patch-4 branch October 1, 2025 14:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

document synchronisation topics on how to better synchronize between other WoT documents Editorial Issues with no technical impact on implementations

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants