From 5e9023f0bf4498d857fa03678887d214d025734d Mon Sep 17 00:00:00 2001 From: Giuseppe Lo Presti Date: Thu, 13 Jun 2024 17:36:47 +0200 Subject: [PATCH 1/4] Prepare to tag v1.2.0 --- CHANGELOG.md | 10 ++++++++++ README.md | 1 + 2 files changed, 11 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6760cd91..49798852 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,15 @@ # Changelog +## [1.2.0] - 2024-07-18 - Giuseppe Lo Presti + +* Added a `/.well-known` endpoint for discovery, to replace + the legacy `/ocm-provider` endpoint in a future release. +* Added support for Multi-Factor Authentication. +* Clarified access methods to remote shares: bearer token + authorization is the preferred mechanism, basic auth or + no auth are deprecated. +* Extended and improved the `/notifications` endpoint. + ## [1.1.0] - 2023-05-15 - Giuseppe Lo Presti * Added a new `/invite-accepted` endpoint to support an invitation diff --git a/README.md b/README.md index 99f24526..047513f8 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,7 @@ This repository contains the text of the Open Cloud Mesh IETF Draft, as well as The documents are available as follows: * Current version under development: [RFC-formatted Draft](IETF-RFC.md) | [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=develop&repo=OCM-API&user=cs3org) +* Version 1.2: [RFC-formatted 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: [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) * Version 1.0: [API spec](https://cs3org.github.io/OCM-API/docs.html?branch=v1.0.0&repo=OCM-API&user=cs3org) From ecb43fef9840891187a7d3341666370506f41c0a Mon Sep 17 00:00:00 2001 From: Giuseppe Lo Presti Date: Mon, 9 Sep 2024 11:09:10 +0200 Subject: [PATCH 2/4] Some updates following recent developments --- CHANGELOG.md | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 49798852..8b6c9542 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,14 +1,24 @@ # Changelog -## [1.2.0] - 2024-07-18 - Giuseppe Lo Presti +## [1.2.0] - 2024-11-20 - Michiel B. De Jong +* Rephrased and improved the whole protocol description text + in order to conform to the IETF Internet Draft style. +* Updated the API specification to OpenAPI 3.0. * Added a `/.well-known` endpoint for discovery, to replace - the legacy `/ocm-provider` endpoint in a future release. -* Added support for Multi-Factor Authentication. -* Clarified access methods to remote shares: bearer token - authorization is the preferred mechanism, basic auth or - no auth are deprecated. -* Extended and improved the `/notifications` endpoint. + the legacy `/ocm-provider` endpoint in a future release, and + extended the properties and capabilities each implementation + can expose. +* Introduced a concept of `requirements` in new shares, which indicate + that a recipient of a share MUST fulfill some capabilities in order + to access the share. +* Introduced several mechanisms to improve security: + * Support for Multi-Factor Authentication. + * Support for signing requests. + * Support for OAuth-style exchanges, via a new `/token` endpoint. + * Clarified access methods to remote shares, and deprecated + less secure ones. +* Extended the `/notifications` endpoint. ## [1.1.0] - 2023-05-15 - Giuseppe Lo Presti From 7447b1cd63e546972b22ee3bc70e01e01a425d7d Mon Sep 17 00:00:00 2001 From: Giuseppe Lo Presti Date: Thu, 14 Nov 2024 17:32:30 +0100 Subject: [PATCH 3/4] Move spec to version 1.2.0 --- spec.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/spec.yaml b/spec.yaml index 8b9f7088..4aa54442 100644 --- a/spec.yaml +++ b/spec.yaml @@ -9,7 +9,7 @@ x-origin: info: title: Open Cloud Mesh API description: Open Cloud Mesh Open API Specification. - version: 1.1.0 + version: 1.2.0 x-logo: url: logo.png paths: @@ -335,7 +335,7 @@ components: apiVersion: type: string description: The OCM API version this endpoint supports - example: 1.1.0 + example: 1.2.0 endPoint: type: string description: The URI of the OCM API available at this endpoint From 5121f9bc5ca9faf50300d9460aa93cc6d5e80ca4 Mon Sep 17 00:00:00 2001 From: Giuseppe Lo Presti Date: Fri, 15 Nov 2024 14:41:55 +0100 Subject: [PATCH 4/4] Update CHANGELOG.md Co-authored-by: Michiel de Jong --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8b6c9542..bf2723a7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -## [1.2.0] - 2024-11-20 - Michiel B. De Jong +## [1.2.0] - 2024-11-20 - Michiel B. de Jong * Rephrased and improved the whole protocol description text in order to conform to the IETF Internet Draft style.