A Backdrop CMS module which provides
some well-known
services.
The following well-known services are available:
-
change-password
: A service which can be used by password managers
to find a website’s change password page. Read the draft W3C
specification: A Well-Known URL for Changing
Passwords. -
autoconfig/mail
: Autoconfiguration service for email clients like
Thunderbird, Evolution, etc. Read more about Thunderbird
autoconfiguration
and the associated configuration file format.
Requirements
If you are using backdrop version 1.22.0 or later then there are no
special requirements.
However, if you are using backdrop version 1.21.4 or earlier then you
must replace your .htaccess
file with the one provided by this
module at htaccess/modified.htaccess
. This is because the original
.htaccess
file does not allow backdrop to serve pages starting with
the .well-known
path, see issue
5583.
Note: htaccess/original.htaccess
is a copy of the default
.htaccess
file from backdrop version 1.21.4 which
modified.htaccess
is based on, it is only present for comparison
purposes.
Installation
-
Install this module in the usual way, see the contributed
modules
of the user guide for details. -
If you are using backdrop version 1.21.4 or earlier then you must
replace your.htaccess
file with the one provided by this module
athtaccess/modified.htaccess
, e.g.cp PATH_TO_CONTRIB_MODULES/well_known/htaccess/modified.htaccess PATH_TO_DOCUMENT_ROOT/.htacess
. -
Visit the configuration page under Administration > Configuration > System >
Well-known URIs (admin/config/system/well-known
) and
configure the services you require.
Issues
Bugs and feature requests should be reported in the Issue
Queue.
Current Maintainers
Credits
- Originally written for Backdrop CMS by Daniel J. R. May.
License
This project is GPL v2 software. See the LICENSE.txt file in this
directory for complete text.
Further Reading
- Wikipedia has a good
list of the various well-known services. - The draft change-password
specification. - The thunderbird autoconfig/mail project
page and
associated configuration file format
specification.