Configuring ScrewTurn Wiki for Sueetie

Modified on 2009/03/05 17:32 by daveburke Categorized as Site Setup, Wiki
Tags: no tags for this item
<div class="WikiTop">
Here we will provide step-by-step instructions on setting up ScrewTurn Wiki to add to a Sueetie Online Community Site.
</div>

==ScrewTurn Wiki and Sueetie Configuration Overview==

The ScrewTurn Wiki is unlike most other applications used on a Sueetie Community Site in that all user and application data storage is located on the file system and not in the database.  One of the reasons is because ScrewTurn does not have cleanly delineated SQL object names.  Another reason is because ScrewTurn, unlike all other applications used in Sueetie, has no support for ASPNET Membership.  This can be added through [http://www.screwturn.eu/UsersPlugins.ashx|ScrewTurn's plug-in framework,] so this may be added to Sueetie over time.  For now, user accounts are stored in the wiki/public/users.cs file.  The Sueetie Membership Register page creates a new account in wiki/public/users.cs with an AddUser() method in a referenced Sueetie.Wiki class project.

===Get ScrewTurn Wiki 2.0.35 Source===

Obtain the ScrewTurn Wiki 2.0.35 Source located on [http://www.screwturn.eu/Download.ashx|the ScrewTurn Wiki Downloads page.]

===Create your Sueetie Wiki Visual Studio Solution===

The Sueetie VS2008 Solution contains the Sueetie.Web root project, /members and /admin website projects, and Sueetie.Wiki class library project.

[image|Sueetie Wiki Solution|http://sueetie.org/x/site/2009/wiki.sln.0304.jpg]

===Obtain the Sueetie.Wiki class project===

The Sueetie.Wiki project contains the AddUser() method which is called in the Membership Register page.  The Sueetie.Wiki project is available on the [http://www.codeplex.com/sueetie|Sueetie CodePlex Site], both Releases page and Versioned Source.

===Obtain the WIKI-DIFFs from CodePlex and copy over /screwturnwiki web and core project contents===

Obtain the WIKI-DIFFs ZIP from the [http://www.codeplex.com/sueetie/Release/ProjectReleases.aspx?ReleaseId=21060|CodePlex Releases Page] and copy over the /screwturnwiki web area.  There is also a modified /screwturn/Core project file: Users.cs, where a slight modification was made to force a reload of all Wiki users when a new Sueetie user is created to avoid an error message when that user visits the wiki for the first time.

After applying the DIFFs and compiling the solution:

*Update "SueetieServer" connection string in wiki/web.config
*Confirm that the wiki/public folder is read-writeable from ASPNET/Network Service account

==Membership Configuration Overview==

Because the ScrewTurn Wiki is unique in not supporting ASPNET Membership out of the box, it stores user account information in its own file.  Sueetie leverages ASPNET Membership in conjunction with Wiki application membership as we will discuss later.  All Wiki accounts share a common password (known only to site admins) and are created with by the Sueetie.Wiki AddUser() process.  They are stored as hashed strings in public/users.cs.

===Establishing and Syncing the Master Shared Sueetie Wiki Password===

The ScrewTurn Wiki file you want to become familiar with is /wiki/public/users.cs.  This file contains Wiki User Accounts with account passwords encrypted.  All user accounts will have the same encrypted passwords which will be used independently of the user's site-wide account password.  The WIKI-DIFF ZIP includes a /public/users.cs which supports the "admin" and "testguy" site accounts with default password of "sueetie12345".

Note that the admin "MasterPassword" element in the wiki web.config is updated in the DIFFs.  The admin account is not stored in the wiki/public/users.cs file.

The wiki public/users.cs file contains an active user account for user "testguy" with the default password "sueetie12345" encrypted.  It looks like the following:

testguy|85AC41D61800BE31A1F9975F11D2258A|testguy@yourdomain.com|ACTIVE|2008/12/29 18:53:17|USER

Two notes about the users.cs format.

Note that the ScrewTurn Wiki in the current 2.x release contains two roles: ADMIN and USER.  To enable user editing, change "USER" to "ADMIN" accordingly.  Don't worry about the user having access to Wiki Administration functions, as this is managed in Sueetie through ASPNET Membership.  Only members of the WikiAdministration Role have access to Wiki Administration functions.

===Changing the default wiki password===

You can continue to use the default "sueetie12345" password on your community site, as safeguards are in place to prevent logging directly into the wiki application even when the password is known.  You may wish to change it if you feel the need for additional security.  We realize this is not the tightest security by any means, but it works very well and is secure enough for 99% of all Sueetie community deployments.  

To change the default password you will want to login locally to ScrewTurn Wiki to create a new account with your preferred password. To do so, go directly to /wiki/login.aspx and login with the "admin" account.  (Comment out the Redirect to PageLoad() /membership/login.aspx statement so you can login to the Wiki.)  You can then create a new user with your preferred default password.  Afterward, replace "sueetie12345" with the new password in /membership/register.aspx.  You will also need to replace the MasterPassword element in the wiki web.config for the ASPNET "admin."



===Test Wiki Account Setup===

Test the Wiki Account setup by logging into the site with the "admin" and "testguy" accounts.  "Hello, <nowiki>[</nowiki>username<nowiki>]</nowiki>!" should appear in the header and "Edit this page" for the admin user should be enabled.  All non-wiki admins can "view this page" only.  

[image|Admin "Edit this Page" enabled|http://sueetie.org/x/site/2009/wiki.admin.0101a.jpg]


===Administrative Access===

Based on Sueetie's ASPNET Membership, users with membership in the "WikiAdministration" role will see links to the wiki administrative area as shown below.  Attempts to directly access wiki adminstration by non-admins is prevented through ASPNET Forms security.


[image|Sueetie Wiki Administrative Header Links|http://sueetie.org/x/site/2009/wiki.admin.0101b.jpg]