transparency-exchange-api icon indicating copy to clipboard operation
transparency-exchange-api copied to clipboard

Define logic to find port in well-known discovery

Open taleodor opened this issue 2 months ago • 2 comments

Currently, the port number is not part of the TEI but it is needed to connect to the API. The current assumption is that the client connects on the default https port (443). At this time, it is recommended that experimental clients add an optional port parameter, which allows to override the default port.

A port number cannot be added to the TEI URN spec as it breaks the location independence requirement of URN.

Possible solutions to this issue (there may be others not listed below):

  1. Make a convention that the port number for the ./well-known/tea is always 443. Exceptions possible via explicit client setting for non-production environments only.
  2. Use SRV or HTTPS DNS records to resolve the ./well-known/tea URL with the port number.

taleodor avatar Oct 22 '25 10:10 taleodor

According to RFC 8615 the default port for the https scheme is the one .well-known URIs implicitly use:

Typically, applications will use the default port for the given scheme; if an alternative port is used, it MUST be explicitly specified by the application in question.

I don't see a reason why an alternative port should be used, except for tests.

ppkarwasz avatar Nov 07 '25 16:11 ppkarwasz

I don't see a reason why an alternative port should be used, except for tests.

Thank you, this sounds reasonable. I think we just need to formally agree on this approach on the next meeting, unless there are other opinions.

taleodor avatar Nov 07 '25 18:11 taleodor