Skip to content

Commit 12b4808

Browse files
committed
docs: clarify TLS encryption on well-known
Signed-off-by: Pavel Shukhman <[email protected]>
1 parent 332f5aa commit 12b4808

File tree

1 file changed

+3
-10
lines changed

1 file changed

+3
-10
lines changed

discovery/readme.md

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -241,19 +241,12 @@ TODO: Handle Auth errors (401, 403) and corresponding messages.
241241
Servers MUST NOT locate the actual TEA service endpoint at the
242242
`.well-known` URI as per Section 1.1 of [RFC5785].
243243

244-
### Overview: Finding the Index using DNS result
244+
### TLS Encryption
245245

246-
Append the product part of the TEI to the URI found
246+
The .well-known endpoint must only be available via HTTPS. Using unencrypted HTTP is not valid.
247247

248248
- TEI: `urn:tei:uuid:products.example.com:d4d9f54a-abcf-11ee-ac79-1a52914d44b1`
249-
- DNS record: `products.example.com`
250-
- URL: `https://products.example.com/.well-known/tea/d4d9f54a-abcf-11ee-ac79-1a52914d44b1/`
251-
- HTTP 302 redirect to `https://teapot02.consumer.example.com/tea/v2/product/d4d9f54a-abcf-11ee-ac79-1a52914d44b1`
252-
253-
Always prefix with the https:// scheme. http (unencrypted) is not valid.
254-
255-
- TEI: `urn:tei:uuid:products.example.com:d4d9f54a-abcf-11ee-ac79-1a52914d44b1`
256-
- URL: `https://products.example.com/.well-known/tea/d4d9f54a-abcf-11ee-ac79-1a52914d44b1/`
249+
- URL: `https://products.example.com/.well-known/tea`
257250

258251
**NOTE:** The `/.well-known/tea` names space needs to be registred.
259252

0 commit comments

Comments
 (0)