web-sign-in: Difference between revisions
Jump to navigation
Jump to search
m (fmt) |
(→user interface: note preferably to https, similar to IndieAuth spec guidance) |
||
| (11 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:Web sign-in}} | |||
Use the (Web sign-in) button on a site to sign-in with your personal web address. | Use the (Web sign-in) button on a site to sign-in with your personal web address. | ||
| Line 5: | Line 5: | ||
When you click a (Web sign-in) button, the site will ask you for your web address, e.g.: | When you click a (Web sign-in) button, the site will ask you for your web address, e.g.: | ||
<blockquote style="border:1px solid gray; float:left; padding:1em"> | <blockquote style="border:1px solid gray; float:left; clear; left; padding:1em"> | ||
Web address: [........................] (Sign-in) | |||
</blockquote> | |||
<div style="clear:both">or:</div> | |||
<blockquote style="border:1px solid gray; float:left; clear; left; padding:1em"> | |||
Web address: <br/> | Web address: <br/> | ||
[........................] <br/> | [........................] <br/> | ||
| Line 19: | Line 24: | ||
# Link from your personal site to your other profiles. Add <code>rel="me"</code> to those hyperlinks. E.g.: <blockquote style="white-space:nowrap"><code><a <strong>rel="me"</strong> <nowiki>href="http://twitter.com/your_twitter_alias">...</nowiki></code></blockquote> | # Link from your personal site to your other profiles. Add <code>rel="me"</code> to those hyperlinks. E.g.: <blockquote style="white-space:nowrap"><code><a <strong>rel="me"</strong> <nowiki>href="http://twitter.com/your_twitter_alias">...</nowiki></code></blockquote> | ||
# Edit your other profiles, e.g. your [https://twitter.com/settings/profile Twitter profile settings], and set "Web" ("homepage", "Website/Blog") field to your personal site. E.g. <blockquote style="white-space:nowrap">Web <span style="border:1px solid silver; padding:5px; margin-left:1em"><nowiki>http://yoursite.example.com/</nowiki></span></blockquote> | # Edit your other profiles, e.g. your [https://twitter.com/settings/profile Twitter profile settings], and set the "Web" ("homepage", "Website/Blog") field to your personal site. E.g. <blockquote style="white-space:nowrap">Web <span style="border:1px solid silver; padding:5px; margin-left:1em"><nowiki>http://yoursite.example.com/</nowiki></span></blockquote> | ||
# When you use your personal site with web sign-in the first time, your browser will redirect you to to your online profile, e.g. Twitter, and ask you to: | # When you use your personal site with web sign-in the first time[[#subsequent|*]], your browser will redirect you to to your online profile, e.g. Twitter, and ask you to: | ||
#* Sign-in with your account on that profile (e.g. sign in to Twitter) if you're not already signed-in. | #* Sign-in with your account on that profile (e.g. sign in to Twitter) if you're not already signed-in. | ||
#* Authorize the site to use your account, e.g. your Twitter account: <blockquote><p>Authorize Site to use your account?</p><p>This application will be able to:</p><ul><li>Read Tweets from your timeline.</li><li>See who you follow.</li></ul><p>( Sign In )</p></blockquote> Click the <b>( Sign In )</b> button and you should be all set. | #* Authorize the site to use your account, e.g. your Twitter account: <blockquote><p>Authorize Site to use your account?</p><p>This application will be able to:</p><ul><li>Read Tweets from your timeline.</li><li>See who you follow.</li></ul><p>( Sign In )</p></blockquote> Click the <b>( Sign In )</b> button and you should be all set. | ||
<nowiki>*</nowiki> <span id="subsequent">Subsequent</span> sign-ins to the same web sign-in form should be pre-filled with your domain name (e.g. via a cookie from the site) so all you have to do is click (Sign-in). In addition, if the site is properly using HTML5 <code><input type=url></code>, browsers will help you auto-complete your personal web address for you across all sites that do web sign-in. | |||
== developers == | == developers == | ||
=== user interface === | |||
For the Web sign-in UI, see the text mockups at the top of this page as a design starting point. | |||
Important details: | |||
* The web address input "[........................]" MUST accept | |||
** a "plain domain" e.g. tantek.com and canonicalize that to http://tantek.com/ or preferably to https://tantek.com/ | |||
** an http(s) domain without a path e.g. http://sixtwothree.org or https://sixtwothree.org and canonicalize http://sixtwothree.org/ or https://sixtwothree.org/ respectively | |||
=== protocol === | |||
See the [[RelMeAuth]] page for documentation on how to support Web sign-in protocol on your site. | |||
=== example implementations === | |||
* [http://tantek.com/relmeauth/ RelMeAuth prototype] demonstrates Web sign-in for both read-only/read-write permissions, and provides a simple interface for Tweeting when read-write permissions are provided. | |||
* [http://indieauth.com IndieAuth] not only uses Web sign-in but also provides a web sign-in authentication API! | |||
** IndieWebCamp: Try out IndieAuth by signing-in to [http://IndieWebCamp.com IndieWebCamp.com]. | |||
See | == why == | ||
See [http://indiewebcamp.com/Why_web_sign-in Why web sign-in] on the IndieWebCamp site. | |||
Latest revision as of 21:55, 26 August 2021
Use the (Web sign-in) button on a site to sign-in with your personal web address.
When you click a (Web sign-in) button, the site will ask you for your web address, e.g.:
Web address: [........................] (Sign-in)
or:
Web address:
[........................]
(Sign-in)
Enter your personal web address and press return / click (Sign-in).
set up
Your personal site must be set up for web sign-in.
- Link from your personal site to your other profiles. Add
rel="me"to those hyperlinks. E.g.:<a rel="me" href="http://twitter.com/your_twitter_alias">... - Edit your other profiles, e.g. your Twitter profile settings, and set the "Web" ("homepage", "Website/Blog") field to your personal site. E.g.
Web http://yoursite.example.com/
- When you use your personal site with web sign-in the first time*, your browser will redirect you to to your online profile, e.g. Twitter, and ask you to:
- Sign-in with your account on that profile (e.g. sign in to Twitter) if you're not already signed-in.
- Authorize the site to use your account, e.g. your Twitter account:
Click the ( Sign In ) button and you should be all set.Authorize Site to use your account?
This application will be able to:
- Read Tweets from your timeline.
- See who you follow.
( Sign In )
* Subsequent sign-ins to the same web sign-in form should be pre-filled with your domain name (e.g. via a cookie from the site) so all you have to do is click (Sign-in). In addition, if the site is properly using HTML5 <input type=url>, browsers will help you auto-complete your personal web address for you across all sites that do web sign-in.
developers
user interface
For the Web sign-in UI, see the text mockups at the top of this page as a design starting point.
Important details:
- The web address input "[........................]" MUST accept
- a "plain domain" e.g. tantek.com and canonicalize that to http://tantek.com/ or preferably to https://tantek.com/
- an http(s) domain without a path e.g. http://sixtwothree.org or https://sixtwothree.org and canonicalize http://sixtwothree.org/ or https://sixtwothree.org/ respectively
protocol
See the RelMeAuth page for documentation on how to support Web sign-in protocol on your site.
example implementations
- RelMeAuth prototype demonstrates Web sign-in for both read-only/read-write permissions, and provides a simple interface for Tweeting when read-write permissions are provided.
- IndieAuth not only uses Web sign-in but also provides a web sign-in authentication API!
- IndieWebCamp: Try out IndieAuth by signing-in to IndieWebCamp.com.
why
See Why web sign-in on the IndieWebCamp site.