authentication4Add my vote for this tag integration2Add my vote for this tag ldap2Add my vote for this tag redirect1Add my vote for this tag create new tag
, view all tags


Force externally authenticated users to register in case they do not have a TWiki account


This plugin will redirect a user to the TWikiRegistration topic if their login name is not a WikiWord, or optionally, if the user's profile page does not exist.

Use this if you have setup single sign-on (SSO) and want to force externally authenticated users to register to get their profile page before accessing any wiki content.

Syntax Rules

  • None, just install and configure it.


  • None. It just works.

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.

  • Download the ZIP file from the plugin web (see below)
  • Unzip RequireRegistrationPlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/RequireRegistrationPlugin.txt Plugin topic
    lib/TWiki/Plugins/RequireRegistrationPlugin.pm Plugin Perl module
    lib/TWiki/Plugins/RequireRegistrationPlugin/Config.spec Spec file for configure
  • Configure the Plugin:
    • Run the configure script
    • Enable the plugin in the Plugins section
    • Find the RequireRegistrationPlugin in the Extensions section and change these settings as needed:
      • {Plugins}{RequireRegistrationPlugin}{Actions} - comma-separated list of actions that this plugin should work on. Default actions: attach, edit, viewfile.
      • {Plugins}{RequireRegistrationPlugin}{RequireProfileTopic} - set to 1 if to check for existence of the user profile topic
      • {Plugins}{RequireRegistrationPlugin}{Refresh} - refresh time in seconds to do a meta refresh redirect to the registration page. Specify -1 to use an immediate redirect CGI query.
  • Test if the installation was successful:
    • Log in as a user without a WikiName and edit a page - it should redirect to the registration topic.
    • You can add a conditional message in the registration topic to let users know what is happening. Use an IF statement to test for parameter note=requireregistration.

Plugin Info

  • One line description, shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Force externally authenticated users to register in case they do not have a TWiki account

Plugin Author: TWiki:Main.ByronIgoe
Copyright: © 2007 TWiki:Main.ByronIgoe
© 2012 TWiki:Main.WillemEngen
© 2009-2013 TWiki:Main.PeterThoeny
© 2008-2013 TWiki:Main.TWikiContributors
License: GPL (GNU General Public License)
Sponsor: Carbon Design Systems
Plugin Version: 2013-07-09 (v1.5)
2013-07-09: TWikibug:Item7291: New flag to check for existence of user profile topic -- TWiki:Main.PeterThoeny
2012-09-03: TWikibug:Item6915: Move settings to configure; add {Plugins}{$pluginName}{Actions} setting -- TWiki:Main.WillemEngen
2011-08-02: TWikibug:Item6725: Change global package variables from "use vars" to "our" -- TWiki:Main.PeterThoeny
2010-10-29: Doc fixes -- TWiki:Main.PeterThoeny
2008-03-04: Fix bug in addToHEAD, made redirect method and refresh time configurable -- TWiki:Main.PeterThoeny
2007-08-27: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.1
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
Benchmarks: GoodStyle nn%, FormattedSearch nn%, RequireRegistrationPlugin nn%
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/RequireRegistrationPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/RequireRegistrationPluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/RequireRegistrationPluginAppraisal

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 RequireRegistrationPlugin.md5 r6 r5 r4 r3 r2 manage 0.2 K 2013-07-09 - 23:31 PeterThoeny  
Compressed Zip archivetgz RequireRegistrationPlugin.tgz r6 r5 r4 r3 r2 manage 5.1 K 2013-07-09 - 23:31 PeterThoeny  
Compressed Zip archivezip RequireRegistrationPlugin.zip r7 r6 r5 r4 r3 manage 7.5 K 2013-07-09 - 23:31 PeterThoeny  
Unknown file formatEXT RequireRegistrationPlugin_installer r2 r1 manage 3.5 K 2013-07-09 - 23:31 PeterThoeny  
Edit | Attach | Watch | Print version | History: r10 < r9 < r8 < r7 < r6 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r10 - 2013-10-16 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.