Difference between revisions of "Talk:Main Page"

From WeBWorK_wiki
Jump to navigation Jump to search
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
  +
== new front page comments ==
  +
* use icosahedron logo for hosting
  +
* keep WW icon for introduction -- but this is really more overview for everyone not an introduction for Instructors -- move this up to document section?
  +
* replace "introduction" in instructor section with "quick start" and point and/or create a quick start page in Category:Instructors
  +
* get person photo for Category: instructors? -- something with color -- other ideas
  +
*
  +
 
== Complete set of docs ==
 
== Complete set of docs ==
   
 
''Found on the TWiki:''
 
''Found on the TWiki:''
   
<blockquote>
 
 
As far as I can tell, the "complete" set of documentation for WeBWorK should consist of the following:
 
As far as I can tell, the "complete" set of documentation for WeBWorK should consist of the following:
   
Line 32: Line 38:
   
 
-- Main.SamHathaway - 10 Nov 2003
 
-- Main.SamHathaway - 10 Nov 2003
 
</blockquote>
 
   
 
== Docs on webhost that are still valuable ==
 
== Docs on webhost that are still valuable ==
Line 39: Line 43:
 
''Found on the TWiki:''
 
''Found on the TWiki:''
   
<blockquote>
 
 
There is quite a bit of [http://webhost.math.rochester.edu/webworkdocs/docs/ documentation written for WebWorK 1.x]. Some of it is still applicable to WeBWorK 2, including:
 
There is quite a bit of [http://webhost.math.rochester.edu/webworkdocs/docs/ documentation written for WebWorK 1.x]. Some of it is still applicable to WeBWorK 2, including:
   
Line 50: Line 53:
   
 
-- Main.SamHathaway - 24 Aug 2004
 
-- Main.SamHathaway - 24 Aug 2004
</blockquote>
 
  +
  +
== Community links ==
  +
link to old google map [http://webwork.rochester.edu/googlemap.html Google map of WeBWorK server sites]
  +
  +
old table of server sites [[WeBWorK server sites]]
  +
  +
form for adding a site:
  +
  +
http://wwrk.maa.org/wiki/WeBWorK_Sites_Form
  +
  +
== Fixing authentication ==
  +
  +
=== Right now ===
  +
  +
* Moodle database is used, a bunch of boondoggle to connect it to MediaWiki (<code>sso</code> in Moodle and <code>AuthMoodle.php</code> (which sucks) in MW.
  +
* MediaWiki '''fails!''' when trying to create MW user record on first login.
  +
  +
=== I want ===
  +
  +
* Primary user database is on MediaWiki (with passwords in MW <code>usesalt</code> format)
  +
* Moodle creates user record from MW data
  +
** Can I get Moodle to require the additional required fields that it doesn't get from MW?
  +
* Moodle authenticates against MW password
  +
** any issue with <code>usesalt</code>?
  +
* Do this with Moodle's built-in "external database authentication"
  +
  +
{{--}} [[User:Sam|Sam]] 15:08, 6 March 2008 (EST)
  +
  +
=== Notes ===
  +
  +
* External database authentication ALMOST supports this
  +
* <code>passtype</code> is used to transform the password string before checking it against the DB.
  +
* Could add a type for <code>usesalt</code> MD5, but it would have to be a change to the <code>EXECUTE</code> line, since it needs to grab the MW <code>user_id</code> field to use in the hashing.
  +
* Moodle internal password checking accepts:
  +
** <code>md5($password.$CFG->passwordsaltmain)</code> (<code>passwordsaltmain</code> is empty by default)
  +
** <code>md5($password)</code>
  +
* Also looks at 20 "alternative salts" (whatever they are) but then updates the hashed password to use the current main salt. i assume the alternate salts are previous values for the main salt.
  +
* See <code>moodle/auth/db/</code>.
  +
* Bigger problem: transitioning passwords from Moodle to MediaWiki. I think we're OK as long as Moodle's "main salt" is empty and we turn off <code>$wgPasswordSalt</code> in MW.
  +
  +
=== Testing ===
  +
  +
* Wrote script to import password data to mediawiki (and update realname/email).
  +
* Imported password data for accounts 'sam' (wiki user name 'Sam') and 'samtest0' (wiki user name 'Samtest0').
  +
* Enabled "External database" auth. in Moodle and disabled "Email-based self-registration".
  +
* Set "Username field" to "LOWER(user_name)"
  +
* Need to switch each Moodle user from auth='email' to auth='db' (leave 'admin', 'guest', ... as 'manual')
  +
  +
=== Transition ===
  +
  +
# MOODLE: disable "email-based self reg"
  +
# MOODLE: set password for "admin" account to known value
  +
# MOODLE: set auth type for all accounts except "admin" and "guest" to "db"
  +
# MW: Disable AuthenMoodle and friends
  +
# MW: Turn off $wgPasswordSalt
  +
# MW: Add/modify accounts from Moodle
  +
# MW: test local login using added and modified accounts
  +
# MOODLE: enable "external database" authentication
  +
# MOODLE: configure it -- remember LOWER(user_name) for username field
  +
# MOODLE: test login
  +
# MW: create a new account
  +
# MOODLE: test login of that new account

Latest revision as of 14:10, 23 January 2011

new front page comments

  • use icosahedron logo for hosting
  • keep WW icon for introduction -- but this is really more overview for everyone not an introduction for Instructors -- move this up to document section?
  • replace "introduction" in instructor section with "quick start" and point and/or create a quick start page in Category:Instructors
  • get person photo for Category: instructors? -- something with color -- other ideas

Complete set of docs

Found on the TWiki:

As far as I can tell, the "complete" set of documentation for WeBWorK should consist of the following:

  • a description of webwork for the student, professor, and administrator
  • system requirements (in the installation manual)
  • installation instructions (installation manual)
  • configuration instructions
    • basic configuration is in installation manual
    • a comprehensive list of course environment variables is now in the comments of global.conf and database.conf, but needs to be made accessible. convert to POD?
    • Constants.pm has POD docs, but they have to get put on the wiki
    • the NETPBM stuff is in the installation manual (but really should go away!!!)
  • task-oriented usage instructions
    • admin tasks (like course creation)
      • course admin tasks
    • instructor tasks
    • student tasks
  • command line script documentation
  • library reference (this is/will be POD)
  • pg language reference
    • basics
    • cookbook techniques
    • standard macro packages and modules (some of this exists in POD form on Frontier site)
    • extending pg
  • how to get support
  • contributing to the webwork project (patches, donations, etc)

(this list originally from Message-ID: <20031001034004.A92569@gate.math.rochester.edu>)

-- Main.SamHathaway - 10 Nov 2003

Docs on webhost that are still valuable

Found on the TWiki:

There is quite a bit of documentation written for WebWorK 1.x. Some of it is still applicable to WeBWorK 2, including:

-- Main.SamHathaway - 24 Aug 2004

Community links

link to old google map Google map of WeBWorK server sites

old table of server sites WeBWorK server sites

form for adding a site:

http://wwrk.maa.org/wiki/WeBWorK_Sites_Form

Fixing authentication

Right now

  • Moodle database is used, a bunch of boondoggle to connect it to MediaWiki (sso in Moodle and AuthMoodle.php (which sucks) in MW.
  • MediaWiki fails! when trying to create MW user record on first login.

I want

  • Primary user database is on MediaWiki (with passwords in MW usesalt format)
  • Moodle creates user record from MW data
    • Can I get Moodle to require the additional required fields that it doesn't get from MW?
  • Moodle authenticates against MW password
    • any issue with usesalt?
  • Do this with Moodle's built-in "external database authentication"

Sam 15:08, 6 March 2008 (EST)

Notes

  • External database authentication ALMOST supports this
  • passtype is used to transform the password string before checking it against the DB.
  • Could add a type for usesalt MD5, but it would have to be a change to the EXECUTE line, since it needs to grab the MW user_id field to use in the hashing.
  • Moodle internal password checking accepts:
    • md5($password.$CFG->passwordsaltmain) (passwordsaltmain is empty by default)
    • md5($password)
  • Also looks at 20 "alternative salts" (whatever they are) but then updates the hashed password to use the current main salt. i assume the alternate salts are previous values for the main salt.
  • See moodle/auth/db/.
  • Bigger problem: transitioning passwords from Moodle to MediaWiki. I think we're OK as long as Moodle's "main salt" is empty and we turn off $wgPasswordSalt in MW.

Testing

  • Wrote script to import password data to mediawiki (and update realname/email).
  • Imported password data for accounts 'sam' (wiki user name 'Sam') and 'samtest0' (wiki user name 'Samtest0').
  • Enabled "External database" auth. in Moodle and disabled "Email-based self-registration".
  • Set "Username field" to "LOWER(user_name)"
  • Need to switch each Moodle user from auth='email' to auth='db' (leave 'admin', 'guest', ... as 'manual')

Transition

  1. MOODLE: disable "email-based self reg"
  2. MOODLE: set password for "admin" account to known value
  3. MOODLE: set auth type for all accounts except "admin" and "guest" to "db"
  4. MW: Disable AuthenMoodle and friends
  5. MW: Turn off $wgPasswordSalt
  6. MW: Add/modify accounts from Moodle
  7. MW: test local login using added and modified accounts
  8. MOODLE: enable "external database" authentication
  9. MOODLE: configure it -- remember LOWER(user_name) for username field
  10. MOODLE: test login
  11. MW: create a new account
  12. MOODLE: test login of that new account