manifesto.md

ConventionRepo Conventions

Well-Known Uniform Resource Identifiers (/.well-known/)

A reserved path prefix, /.well-known/, under which registered site-wide metadata such as security.txt lives, so applications can discover information about an origin, defined by RFC 8615.

Canonical text: https://www.rfc-editor.org/rfc/rfc8615.html. In use on this site: manifesto.md/.well-known/security.txt.

The rules

  1. Some applications on the Web require the discovery of information about an origin, sometimes called "site-wide metadata", before making a request.
  2. This memo reserves a path prefix in HTTP, HTTPS, WebSocket (WS), and Secure WebSocket (WSS) URIs for these "well-known locations", "/.well-known/".
  3. A well-known URI is a URI whose path component begins with the characters "/.well-known/", and whose scheme is "HTTP", "HTTPS", or another scheme that has explicitly been specified to use well-known URIs.
  4. Well-known URIs can also be used with other URI schemes, but only when those schemes' definitions explicitly allow it.
  5. Applications that wish to mint new well-known URIs MUST register them, following the procedures in Section 5.1.
  6. Registered names MUST conform to the "segment-nz" production in RFC 3986; this means they cannot contain the "/" character.
  7. At a minimum, a registration will reference a specification that defines the format and associated media type(s).
  8. Well-known URIs are rooted in the top of the path's hierarchy; they are not well-known by definition in other parts of the path.
  9. Clients should not expect a resource to exist at "/.well-known/" itself.
  10. Registration requests consist of at least the following information: URI suffix, change controller, specification document(s), status and related information.
  11. Because well-known locations effectively represent the entire origin, server operators should appropriately control the ability to write to them.

Facts

Maintainer
IETF; author Mark Nottingham
Licence of the text
IETF Trust Legal Provisions (BCP 78)
First published
2019-05
Status of the text
stable
Listing
listed, not yet claimed

Read with

Badge

manifesto.md: listed

[![manifesto.md](https://img.shields.io/endpoint?url=https://manifesto.md/badge/well-known-uris.json)](https://manifesto.md/well-known-uris/)

Maintainers claim a listing with a pull request setting listing: claimed, or a yes on the listing issue.