Prepare version 1.5

Author: glpatcern

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [1.5.0] - 2026-08-31 - Giuseppe Lo Presti <lopresti@cern.ch>
+
+* Improved usage of HTTP Message Signature, discovery of JWKS keys,
+  and related examples.
+* Refactored the `/notifications` endpoint and the corresponding
+  IANA Registry entries. The `/request-share` endpoint has been
+  absorbed as a new notification, and all accepted notification
+  types have been fully specified.
+* Introduced an optional `encryption` object in the `/shares`
+  payload, and defined related encryption schemes.
+
 ## [1.4.0] - 2026-06-23 - Giuseppe Lo Presti <lopresti@cern.ch>
 
 * Introduced a `/request-share` endpoint to request a user of an

IETF-OCM-MLS.md

@@ -391,7 +391,7 @@ its OCM discovery document at `/.well-known/ocm`:
 ~~~ json
 {
   "enabled": true,
-  "apiVersion": "1.4.0",
+  "apiVersion": "1.5.0",
   "endPoint": "https://cloud.example.org/ocm",
   "provider": "Example Cloud",
   "resourceTypes": [
@@ -2059,6 +2059,11 @@ version in the IETF datatracker.  It is meant to ease the review
 process and it shall be removed when going to RFC last call.
 The complete changelog is updated in the OCM-API GitHub repository.
 
+## Version 02
+* Following the introduction of an `encryption` object for Shares in
+  Version 07 of [OCM] and a corresponding IANA Registry, this document
+  has been adapted and corresponding registry entries have been added.
+
 ## Version 01
 * Following the introduction of IANA Registries in Version 06 of [OCM],
   all registry entries related to the `federation` share type have been

IETF-OCM.md

@@ -627,7 +627,7 @@ contain the following information about its OCM API:
 * REQUIRED: enabled (boolean) - Whether the OCM service is enabled at
   this endpoint
 * REQUIRED: apiVersion (string) - The OCM API version this endpoint
-  supports.  Example: `"1.4.0"`
+  supports.  Example: `"1.5.0"`
 * REQUIRED: endPoint (string) - The URI of the OCM API available at
   this endpoint.  Example: `"https://cloud.example.org/ocm"`
 * OPTIONAL: provider (string) - A friendly branding name of this
@@ -2888,9 +2888,9 @@ The complete changelog is updated in the OCM-API GitHub repository.
 * Clarified that `created` bounds the lifetime of a captured
   signature but does not by itself detect replay within that window
   (see Section 7.2.2 of [RFC9421]).
-* `jwksUri` and `{tokenEndPoint}` transport: https remains mandatory,
+* `jwksUri` and `{tokenEndPoint}` transport: HTTPS remains mandatory,
   with the same HTTP fallback allowance for testing setups that the
-  Discovery Process has; dropped the https-only schema pattern from
+  Discovery Process has; dropped the HTTPS-only schema pattern from
   spec.yaml accordingly.
 * Appendix B now defers the missing-`jwksUri` case to [Decision to
   Discard](#decision-to-discard) instead of stating a stronger
@@ -2907,6 +2907,9 @@ The complete changelog is updated in the OCM-API GitHub repository.
   Notification") endpoint and payload, and adaptation of the IANA
   registries.  The core notifications have now been fully spelled
   out, clarifying their scope.
+* Introduced an `encryption` optional object in the Share Creation
+  Notification payload, and defined a corresponding Encryption Schemes
+  OCM IANA Registry.
 
 ## Version 06
 * Introduced IANA Registries for resource types, protocols, share

README.md

@@ -11,7 +11,7 @@ This repository contains the text of the [Open Cloud Mesh IETF Drafts](https://d
 
 The documents are available as follows:
 
-* **Latest official version, 1.4.0**: [Main RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.4.0/IETF-OCM.md) | [Integration Protocol RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.4.0/IETF-OCM-IP.md) | [MLS RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.4.0/IETF-OCM-MLS.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.4.0&repo=OCM-API&user=cs3org)
+* **Latest official version, 1.5.0**: [Main RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.5.0/IETF-OCM.md) | [Integration Protocol RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.5.0/IETF-OCM-IP.md) | [MLS RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.5.0/IETF-OCM-MLS.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.5.0&repo=OCM-API&user=cs3org)
 * Development branch: [Main RFC Draft](IETF-OCM.md) | [Integration Protocol RFC Draft](IETF-OCM-IP.md) | [MLS RFC Draft](IETF-OCM-MLS.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=develop&repo=OCM-API&user=cs3org)
 
 For a navigable, AI-generated overview of this repository, see
@@ -39,6 +39,7 @@ The history of the Open Cloud Mesh project is [available here](HISTORY.md), incl
 
 Previously released versions ([changelog](CHANGELOG.md)):
 
+* Version 1.4.0: [Main RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.4.0/IETF-OCM.md) | [Integration Protocol RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.4.0/IETF-OCM-IP.md) | [MLS RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.4.0/IETF-OCM-MLS.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.4.0&repo=OCM-API&user=cs3org)
 * Version 1.3.0: [RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.3.0/IETF-RFC.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.3.0&repo=OCM-API&user=cs3org)
 * Version 1.2.0: [RFC Draft](https://github.com/cs3org/OCM-API/blob/v1.2.0/IETF-RFC.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.2.0&repo=OCM-API&user=cs3org)
 * Version 1.1.0: [README](https://github.com/cs3org/OCM-API/blob/v1.1.0/README.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.1.0&repo=OCM-API&user=cs3org)

spec.yaml

@@ -5,7 +5,7 @@ info:
     Open Cloud Mesh OpenAPI Specification.
     The semantic of the Protocol Specification is detailed in the OCM Internet-Draft document
     published at the [IETF Datatracker](https://datatracker.ietf.org/doc/draft-ietf-ocm-open-cloud-mesh).
-  version: 1.4.0
+  version: 1.5.0
   x-logo:
     url: logo.png
 servers:
@@ -304,7 +304,7 @@ components:
         apiVersion:
           type: string
           description: The OCM API version this endpoint supports
-          example: 1.4.0
+          example: 1.5.0
         endPoint:
           type: string
           description: The URI of the OCM API available at this endpoint