diff --git a/index.html b/index.html index 048f243..44ee42d 100644 --- a/index.html +++ b/index.html @@ -643,12 +643,15 @@

Security

- Conformant Consumers MUST support all of these security schemes. + Conformant Consumers MUST support at least all of these security schemes.

A Thing MAY implement multiple security schemes.

+

+ A Thing MUST support at least one of the above security schemes. +

Conformant Consumers MUST support security bootstrapping for all @@ -901,7 +904,7 @@

Media Types for Link Targets

-

Errors

+

Errors

If any of the operations defined in the protocol bindings of HTTP @@ -920,6 +923,7 @@

Errors

  • 403 Forbidden
  • 404 Not Found
  • 500 Internal Server Error
  • +
  • 503 Service Unavailable
  • @@ -956,6 +960,56 @@

    Default Language

    (e.g., en, de-AT, gsw-CH, zh-Hans, zh-Hant-HK, sl-nedis).
    +
    +

    Identifiers

    +

    + Web resources are identified by uniform resource identifiers (URIs). + The Thing Description defines the field +

    + In deployments of multiple devices in the same application context, things must be distinguished by the consumer. + In these cases, these identifiers must be unique. + Use cases with worldwide deployments typically require globally unique identifiers. +

    +
    +

    Format

    +

    + A common and well defined format for these identifiers enables easy implementation + and simplifies handling across manufacturers through the use of libraries. + It also ensures that there are no name clashes of devices from different manufacturers. + The [[UUID]] format has been developed to satisfy these requirements. +

    +

    + + It is RECOMMENDED to use Universally Unique IDentifier (UUID) [[RFC4122]] as common format for identifers. + +

    + + It is RECOMMENDED to use [[UUIDv4]] as common format for unique identifers, where random identifiers are required. + +

    +
    +
    +

    Mutable and Immutable Identifiers

    +

    + Many use cases require that identifiers do not change during the lifecycle of the thing in the application context. + However there are cases, where the IDs must change due to legal or privacy obligations. + IDs should be changed when a device is offboarded and onboarded on a new system (e.g. for change + of ownership). + In these cases, or when a device is moved to a new usage context, identifiers usually must change. +

    + +

    + In certain use cases where privacy is a factor or legal obligations mandate changing identifiers, + the use of a mutable UUID is RECOMMENDED. +

    + +

    + If possible and allowed by law, required immutable IDs SHOULD be made available through a + property rather than used as the id for the TD itself. +

    +
    @@ -1667,7 +1721,18 @@
    Asynchronous Action Response
    "timeRequested": "2021-11-10T11:43:19.135Z" } - +
    +

    + In resource constrained environments, the ActionStatus objects of older completed/failed actions MAY be deleted to make room for newly invoked actions. +

    +
    +
    +

    + A Web Thing SHOULD return a 503 error response if the invocation cannot be accepted because the action is unavailable, + e.g. because the Thing is overloaded. +

    +
    +
    queryaction