Confirmed users
591
edits
Thunderbird:Autoconfiguration:ConfigFileFormat: Difference between revisions
Thunderbird:Autoconfiguration:ConfigFileFormat (view source)
Revision as of 17:16, 14 February 2014
, 14 February 2014→XML: Add spec for webmail URLs
(→XML: rename instruction to documentation, because that's what we actually use in the ISPDB) |
(→XML: Add spec for webmail URLs) |
||
| Line 140: | Line 140: | ||
</emailProvider> | </emailProvider> | ||
<!-- This allows to access the webmail service of the provider. | |||
The URLs are loaded into a standard webbrowser for the user. --> | |||
<webMail> | |||
<!-- Webpage where the user has to log in manually by entering username | |||
and password himself. --> | |||
<loginPage url="http://mail.example.com/login/" /> | |||
<!-- Direct URL where to send username or email address and password | |||
to trigger a log in. Use this to allow a login without the user | |||
having to re-enter the password every single time. | |||
This can help e.g. mailcheck extensions that, after showing | |||
that there is new mail, want to allow to quickly see the mail. | |||
Only HTTPS is valid here. The client must ignore HTTP urls and | |||
ensure that the browser verifies the SSL certificate. | |||
When adding the URL, remember to escape the ampersand between | |||
params to & --> | |||
<loginAutomaticURL url="https://mail.example.com/loginScript?email=%EMAILADDRESS%&password=%PASSWORD%" /> | |||
<!-- Same as loginAutomaticDOM, but the website makes checks that | |||
the user comes from the login page. So, open the login page | |||
in the browser, get the page's DOM, fill out name and password | |||
fields for the user, and trigger the login button. | |||
The *ID attributes give the DOM ID, | |||
while *Selector attributes give CSS selectors. | |||
Before using them, don't treat this file content as trusted, | |||
but verify the format, esp. if you use powerful functions like jQuery. --> | |||
<loginAutomaticDOM | |||
url="https://mail.example.com/login/" | |||
usernameForm="%EMAILADDRESS%" | |||
usernameFieldID="email" | |||
passwordFieldID="password" | |||
loginButtonID="submit" | |||
/> | |||
</webMail> | |||
<clientConfigUpdate url="https://www.example.com/config/mozilla.xml" /> | <clientConfigUpdate url="https://www.example.com/config/mozilla.xml" /> | ||