OpenID - Revision history

FaceAnkh at 19:03, 21 February 2010

2010-02-21T19:03:58Z

FaceAnkh Bastet at 16:46, 20 February 2010

2010-02-20T16:46:35Z

FaceAnkh Bastet: notes on shard login changes

2010-02-20T16:33:15Z

notes on shard login changes

FaceAnkh: update for new wiki login method

2009-02-08T18:04:32Z

update for new wiki login method

FaceAnkh: Instructions on using the atitd.org openid server

2009-02-08T15:10:18Z

Instructions on using the atitd.org openid server

FaceAnkh at 01:29, 4 February 2009

2009-02-04T01:29:43Z

FaceAnkh at 23:36, 20 January 2009

2009-01-20T23:36:35Z

FaceAnkh at 23:35, 20 January 2009

2009-01-20T23:35:59Z

FaceAnkh: language link

2008-12-31T21:03:42Z

language link

FaceAnkh at 13:46, 31 December 2008

2008-12-31T13:46:30Z

@@ Line 27: / Line 27: @@
 === To log in to the forums ===
 * Go to the login page (click the "Login" on the upper right side of the page)
-* In the OpenID box, enter your username as in game and add "_Bastet" if you're from the Bastet shard
+* In the OpenID box, enter your username as in game and select your shard
-** this should look like one of:
+** (you can also use '''atitd.org/openid/''YourName_ShardName''''' but the short form is easier)
 * Click submit
 ** This will take you to the atitd.org openid server, where you have to enter the password you set in the webpass command above
@@ Line 54: / Line 51: @@
 Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site.  The process is fairly straightforward and example PHP code is available (implementations in many other languages too).  You do not need to ask permission or arrange for access - the server is open.
-If you have problems, contact FaceAnkh.
+If you have problems, contact FaceAnkh (IRC is best).
 === Brief instructions ===

@@ Line 46: / Line 46: @@
 Second, ensure you aren't blocking cookies for atitd.org (use this [http://atitd.org/account/cookietest.php cookie tester]).
-If neither of those solves the problem, post to [http://atitd.org/forum/viewforum.php?f=34 this forum] or contact FaceAnkh or JulianJaynes ingame.
+If neither of those solves the problem, post to [http://atitd.org/forum/viewforum.php?f=34 this forum], come to #atitd-wiki in [http://atitd.org/irc/ IRC] or contact FaceAnkh ingame.
 -----------

@@ Line 7: / Line 7: @@
 ** (meaning you replace '''''password''''' with a password of your choice - but not your game or bank one!).
 * Wait till you see the notification in game that your account data has been uploaded.
-* Your OpenID URL is '''atitd.org/openid/''YourName'''''
+* Your OpenID URL is '''atitd.org/openid/''YourName''''' or, for people not on the original shard, '''atitd.org/openid/''YourName_SHARDNAME'''''
-** (where '''''YourName''''' is your game user name, e.g. atitd.org/openid/Sami).
+** (where '''''YourName''''' is your game user name and SHARDNAME is the name of a shard, e.g. Bastet)
 This OpenID URL can be used with any site that accepts OpenID - including the atitd.org wiki and forums, but potentially any other third party site.
@@ Line 14: / Line 15: @@
 === To log in to the wiki ===
 * Go to the OpenID login page (click the "login with openid" link at the top right)
-* In the OpenID URL box, enter your game user name (e.g. "Sami")
+* In the OpenID URL box, enter your game user name (e.g. "Sami") and add "_Bastet" if you're from the Bastet shard
 ** (optionally, you can enter the full OpenID URL, atitd.org/openid/''YourName'', but why bother?)
 * Click submit
@@ Line 23: / Line 27: @@
 === To log in to the forums ===
 * Go to the login page (click the "Login" on the upper right side of the page)
-* In the OpenID box, enter your username as in game
+* In the OpenID box, enter your username as in game and add "_Bastet" if you're from the Bastet shard
 ** (you can also use '''atitd.org/openid/''YourName''''' but the short form is easier)
 * Click submit

@@ Line 7: / Line 7: @@
 ** (meaning you replace '''''password''''' with a password of your choice - but not your game or bank one!).
 * Wait till you see the notification in game that your account data has been uploaded.
-* Your open id is '''atitd.org/openid/''YourName'''''
+* Your OpenID URL is '''atitd.org/openid/''YourName'''''
 ** (where '''''YourName''''' is your game user name, e.g. atitd.org/openid/Sami).
 === To log in to the wiki ===
 * Go to the OpenID login page (click the "login with openid" link at the top right)
-* In the OpenID URL box, enter '''atitd.org/openid/''YourName'''''
+* In the OpenID URL box, enter your game user name (e.g. "Sami")
-** (where '''''YourName''''' is your game user name, e.g. atitd.org/openid/Sami)
+** (optionally, you can enter the full OpenID URL, atitd.org/openid/''YourName'', but why bother?)
 * Click submit
 ** This will take you to the atitd.org openid server, where you have to enter the password you set in the webpass command above
@@ Line 21: / Line 23: @@
 === To log in to the forums ===
 * Go to the login page (click the "Login" on the upper right side of the page)
-* In the OpenID box, enter your username as in game (you can also use '''atitd.org/openid/''YourName''''' but the short form is easier)
+* In the OpenID box, enter your username as in game
 * Click submit
 ** This will take you to the atitd.org openid server, where you have to enter the password you set in the webpass command above
@@ Line 28: / Line 31: @@
 ** On first login, it will prompt you to create a forum account to bind to this OpenID account - we'd recommend you use your game name
-Once you're logged in to the forums, you may wish to set a local password (go to your user control panel->profile->account settings) and you can then use the forum login method (login page below the OpenID stuff) instead - this seems to persist logins for longer (being worked on..).
+Once you're logged in to the forums, you may wish to set a local password (go to your user control panel->profile->account settings) so you can then use the forum login method (login page below the OpenID stuff) instead.  This is only required for moderators/admins.
 == Difficulties logging in ==
@@ Line 37: / Line 40: @@
 If neither of those solves the problem, post to [http://atitd.org/forum/viewforum.php?f=34 this forum] or contact FaceAnkh or JulianJaynes ingame.
 == Third party sites ==
-Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site.  The process is fairly straightforward and example PHP code is available (implementations in many other languages too).  If you're interested in doing this, contact FaceAnkh.
+Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site.  The process is fairly straightforward and example PHP code is available (implementations in many other languages too).  You do not need to ask permission or arrange for access - the server is open.
 === Brief instructions ===
@@ Line 62: / Line 69: @@
 A common problem is if your trust root (openid.realm in the GET URL) doesn't match the return_to URL (openid.return_to), the JainRain server tends to go boom (white page @ atitd.org/account).  It seems to be fussy about funny characters (particularly URL encoded ones) in the trust root.  An example of this is if you come from a default mediawiki with openid extension, it sets the realm to "http://.../mywiki?title=" which makes the atitd.org server blow up.  Force your realm/trust root to a lower subpart of the URL, e.g. "http://.../mywiki".
 {{Languages}}

← Older revision		Revision as of 15:10, 8 February 2009
Line 41:		Line 41:

	Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site. The process is fairly straightforward and example PHP code is available (implementations in many other languages too). If you're interested in doing this, contact FaceAnkh.		Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site. The process is fairly straightforward and example PHP code is available (implementations in many other languages too). If you're interested in doing this, contact FaceAnkh.
		+
		+	=== Brief instructions ===
		+
		+	See the example OpenID consumer at http://faceankh.atitd.org/consumer/ (download code from http://faceankh.atitd.org/openid_consumer.tar.gz).
		+
		+	I've taken the basic [http://openidenabled.com/ JainRain PHP OpenID consumer], added some notes, restricted it to accept only atitd.org OpenIDs (easy to revert if you wish) and added a snippet of code that auto prepends atitd.org/openid (if unspecified) so you can just use USERNAME for the login.
		+
		+	Notes on the basic code flow: index.php is the main HTML frontend. When you submit the form from there, info goes to try_auth.php, which checks various things (including the atitd.org restriction) and redirects the user to the openid server. The openid server will return the user to finish_auth.php with a yes/no.
		+
		+	You'll need to edit the $store_path variable in common.php to something unique (see notes there) - this specifies where temporary session files are kept.
		+
		+	You'll possibly want to throw away index.php or just recode it into your style.
		+
		+	You'll want to add your user session variable/cookie to the "yes" part of finish_auth.php and send the user on from there to your main pages.
		+
		+	I'd suggest you dump all the PAPE stuff (allows one to request the server uses particular means of authentication) - we don't support it :/
		+
		+	=== Troubleshooting ===
		+
		+	A common problem is if your trust root (openid.realm in the GET URL) doesn't match the return_to URL (openid.return_to), the JainRain server tends to go boom (white page @ atitd.org/account). It seems to be fussy about funny characters (particularly URL encoded ones) in the trust root. An example of this is if you come from a default mediawiki with openid extension, it sets the realm to "http://.../mywiki?title=" which makes the atitd.org server blow up. Force your realm/trust root to a lower subpart of the URL, e.g. "http://.../mywiki".
		+

	{{Languages}}		{{Languages}}

@@ Line 4: / Line 4: @@
 Before you can log in you must set your webpass in game:
-* Log into the game and type <tt>/webpass atitd.org <password></tt>
+* Log into the game and type '''/webpass atitd.org ''password'''''
-** (meaning you replace <password> with a password of your choice - but not your game or bank one!).
+** (meaning you replace '''''password''''' with a password of your choice - but not your game or bank one!).
 * Wait till you see the notification in game that your account data has been uploaded.
-* Your open id is '''atitd.org/openid/<Name>'''
+* Your open id is '''atitd.org/openid/''YourName'''''
-** (where <Name> is your game user name, e.g. atitd.org/openid/Sami).
+** (where '''''YourName''''' is your game user name, e.g. atitd.org/openid/Sami).
 == Difficulties logging in ==

← Older revision		Revision as of 21:03, 31 December 2008
Line 21:		Line 21:

	Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site. The process is fairly straightforward and example PHP code is available (implementations in many other languages too). If you're interested in doing this, contact FaceAnkh.		Third party sites can also use the atitd.org openid server to confirm the identity of users, meaning they won't need to reregister for each site. The process is fairly straightforward and example PHP code is available (implementations in many other languages too). If you're interested in doing this, contact FaceAnkh.
		+
		+	{{Languages}}