Skip to content

Proposal for the OCM Address format #268

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
glpatcern merged 6 commits into from
Sep 9, 2025
Merged

Proposal for the OCM Address format #268

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
f104d19
Specify the OCM Address format
Aug 22, 2025
00d807c
Note explicitly there might be multiple @ signs in an OCM Address
Aug 22, 2025
87ad6c5
Fix to upper case UTF-8
KrausMatthias Aug 22, 2025
f38d6af
Add Opt-In http discovery as fallback for testing setups
Aug 25, 2025
2729d73
Drop mention of omitting default ports in favor of mention in Discove…
KrausMatthias Aug 28, 2025
97e7c4d
Drop suggestion to allow http fallback only as Opt-In
KrausMatthias Aug 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 32 additions & 8 deletions IETF-RFC.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,14 +139,31 @@ related concepts from OAuth [RFC6749] and elsewhere:
OCM API Discovery.
* __Discoverable Server__ - A server that tries to supply information in
OCM API Discovery.
* __OCM Address__ - A string of the form
`<Receiving Party's identifier>@<fqdn>` which can be used to uniquely
identify a user or group "at" an OCM Server and MAY be referred to as
Federated Cloud ID.
`<Receiving Party's identifier>` is an opaque string, unique at the
server. `<fqdn>` is the Fully Qualified Domain Name by which the
server is identified. This MUST be the domain at which the
`/.well-known/ocm` endpoint of that server is hosted.
* __OCM Address__ - identifies a user or group "at" an OCM Server.
The OCM Address contains a server specific Party identifier, a host
locating the OCM Server and an optional port. The OCM Address is not a
URI as it does not have scheme and the identifier may contain reserved
characters.

ocm-address = identifier "@" host [ ":" port]

The identifier is an opaque, case-sensitive utf-8 string. It is
Comment thread
KrausMatthias marked this conversation as resolved.
Outdated
separated from the host by the last "@" in the OCM Address.
Comment thread
glpatcern marked this conversation as resolved.
Outdated
host is an IP literal encapsulated within square brackets, an IPv4
Comment thread
glpatcern marked this conversation as resolved.
address in dotted decimal form, or a registered name as described in
[RFC3986].

host = IP-literal / IPv4address / reg-name

The optional port subcomponent can be used to specify a port to use
for discovery. Implementers SHOULD omit the port component and its
":" delimiter if its value would be the same as the default ports
"443" or "80" of HTTPS or HTTP.
Comment thread
KrausMatthias marked this conversation as resolved.
Outdated

The OCM Server MUST be discoverable at the given host and optional
port via the Well-Known [RFC8615] path `/.well-known/ocm`. The OCM
Address MUST NOT contain a path.

* __OCM Notification__ - A message from the Receiving Server to the
Sending Server or vice versa, using the OCM Notifications endpoint.
* __Invite Message__ - Out-of-band message used to establish contact
Expand Down Expand Up @@ -1001,6 +1018,13 @@ Key Words](https://datatracker.ietf.org/html/rfc8174)", May 2017.
[RFC9421] Backman, A., Richer, J. and Sporny, M. "[HTTP Message
Signatures](https://tools.ietf.org/html/rfc9421)", February 2024.

[RFC3986] Berners-Lee, T., Fielding, R. and Masinter, L.
"[Uniform Resource Identifier (URI): Generic Syntax
](https://datatracker.ietf.org/doc/html/rfc3986)", January 2005

[RFC8615] Nottingham, M. "[Well-Known Uniform Resource Identifiers
(URIs)](https://datatracker.ietf.org/doc/html/rfc8615)", May 2019


## Informative References

Expand Down
Loading