Skip to content

Commit dc4e90f

Browse files
committed
Add reference section
I have added Normative References and Informational References Normative References are also hyperlinked in the text to the respective RFC:s whereas Informational References are not.
1 parent d185cce commit dc4e90f

1 file changed

Lines changed: 24 additions & 9 deletions

File tree

IETF-RFC.md

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ transfers.
5353
Open Cloud Mesh handles interactions only up to the point where the
5454
Receiving Party is informed of their access to the Resource. Actual
5555
Resource access is subsequently managed by other protocols, such as
56-
WebDAV.
56+
[WebDAV](https://datatracker.ietf.org/doc/rfc4918/).
5757

5858
--- middle
5959
# Introduction
@@ -118,7 +118,7 @@ that a Share has been created.
118118
* actively or passively notifies the receiving user or group of any
119119
incoming Share Creation Notification,
120120
* acts as an API client, allowing the receiving user to access the
121-
Resource through an API (e.g., WebDAV) of the sending server.
121+
Resource through an API (e.g., [WebDAV](https://datatracker.ietf.org/doc/rfc4918/)) of the sending server.
122122
* __Sending Gesture__ - A user interface interaction from the Sending
123123
Party to the Sending Server, conveying the intention to create a Share.
124124
* __Share Creation__ - The addition of a Share to the database state of
@@ -519,10 +519,11 @@ itself be an object containing the following fields:
519519
}
520520
```
521521
Fields:
522-
* webdav (string) - The top-level WebDAV path at this endpoint. In
523-
order to access a Remote Resource,
524-
implementations MAY use this path as a prefix, or
525-
as the full path (see sharing examples).
522+
* webdav (string) - The top-level
523+
[WebDAV](https://datatracker.ietf.org/doc/rfc4918/)
524+
path at this endpoint. In order to access a Remote
525+
Resource, implementations MAY use this path as a
526+
prefix, or as the full path (see sharing examples).
526527
* webapp (string) - The top-level path for web apps at this
527528
endpoint. This value is provided for documentation
528529
purposes, and it SHOULD NOT be intended as a prefix
@@ -531,7 +532,9 @@ itself be an object containing the following fields:
531532
This value is provided for documentation purposes,
532533
and it SHOULD NOT be intended as a prefix. In
533534
addition, implementations are expected to execute
534-
the transfer using WebDAV as the wire protocol.
535+
the transfer using
536+
[WebDAV](https://datatracker.ietf.org/doc/rfc4918/)
537+
as the wire protocol.
535538
* Any additional protocol supported for this Resource type MAY be
536539
advertised here, where the value MAY correspond to
537540
a top-level URI to be used for that protocol.
@@ -546,8 +549,9 @@ supported by this OCM Server.
546549
* `"enforce-mfa"` - to indicate that this OCM Server can apply a
547550
Sending Server's MFA requirements for a Share on their behalf.
548551
* `"webdav-uri"` - to indicate that this OCM Server can append a
549-
relative URI to the path listed for WebDAV in the appropriate
550-
`resourceTypes` entry
552+
relative URI to the path listed for
553+
[WebDAV](https://datatracker.ietf.org/doc/rfc4918/) in the
554+
appropriate `resourceTypes` entry
551555
* `"protocol-object"` - to indicate that this OCM Server can
552556
receive a Share Creation Notification whose `protocol` object
553557
contains one property per supported protocol instead of containing
@@ -962,6 +966,17 @@ The legacy format of an OCM Share Notification with shared secrets is
962966
only provided for backwards compatibility with existing implementations.
963967
Implementers SHOULD NOT use it and prefer short-lived tokens instead.
964968

969+
# References
970+
971+
## Normative references
972+
973+
[1] Backman, A., Richer, J. and Sporny, M. "HTTP Message Signatures", [RFC 9421](https://tools.ietf.org/html/rfc9421), February 2024.
974+
[2] Dusseault, L. M. "HTTP Extensions for Web Distributed Authoring and Versioning", [RFC 4918](https://datatracker.ietf.org/html/rfc4918/), June 2007.
975+
976+
## Informative references
977+
978+
[1] Hardt, D. (ed), "The OAuth 2.0 Authorization Framework", [RFC 6749](https://datatracker.ietf.org/html/rfc6749), October 2012.
979+
965980

966981
# Appendix A: Multi-factor Authentication
967982
If a Receiving Server exposes the capability `enforce-mfa`, it

0 commit comments

Comments
 (0)