Not a developer? Go to

Plugin and Theme Directory

Convio SSO Authentication v1.0b

By Byrne Reese
Posted December 8, 2010, in Web Services.


This plugin provides an "dual-mode" authentication driver for for Melody and Movable Type v4.x which works with Convio's Single Signon Open API to provide authentication services for both locally-created and Convio-created user accounts.

When this plugin is installed and configured:

  • Users will be able to log in with either Melody/MT or Convio credentials seamlessly and without having to think

  • Each locally-created user can associate their account with a Convio account and, in most cases, this is done automatically

  • Each Convio-created user will have, upon logging in, a local user record automatically created for them[1] and automatically associated with their Convio account.

  • Any profile information available in Convio will be used to provision or update the local user profile ensuring that your user's email addresses and other important data is always kept up to date.

[1] - Regardless of the canonical authentication source, Melody/MT mandate that all authenticated users be represented by at least a "skeleton" local author record to act as a target for the granting of local permissions, association with the user's created content and proper auditing of their actions throughout application.


This plugin has a few important prerequisites:

  • Melody (any version) or Movable Type 4.x
  • The Net::Convio perl module (included in distribution)
  • The REST::Client perl module (included in distribution)
  • Movable Type installations will also need the Melody Compatibility Layer plugin
  • A Convio API Administrator account and associated credentials


Convio Open APIs offer a large number of ways for developers to programmatically interact with the Convio service as detailed in their bulging 350-page Convio Open API Reference, excerpted below:

  • Address Book API

    The Address Book API provides access and management functions for TeamRaiser Address Books.

  • Advocacy API

    The Advocacy API provides methods to query and report on Advocacy alerts and user interactions.

  • Calendar Events API

    The Calendar Events API provides query access to Convio Calendar Events (TeamRaiser events are exposed separately through the TeamRaiser API).

  • Constituent Management API

    The Constituent Management API supports multiple methods to create, update, and query user data in the Convio Constituent360 database.

  • Donation Processing API

    The Donation Processing API allows you to extend and customize the online giving and payment processing capabilities of the Convio system.

  • Single Sign-On API

    The Single Sign-On API provides methods to authenticate users and securely establish a logged-in session with the Convio server using API calls. These API methods support both Convio-as-master and Convio-as-client implementations allowing you to use either Convio or an external system as the master authentication service.

  • TeamRaiser API

    The TeamRaiser API gives you the means to customize and extend the TeamRaiser application, the Participant Center and the web pages for TeamRaiser teams, companies, and participants. This API includes methods to:

    • record, query, manage, and search TeamRaiser Events,
    • manage TeamRaiser Teams,
    • manage Team, Company, and Personal web pages,
    • record, query and manage Gifts,
    • query and update Surveys,
    • create, send, query, and manage messages to TeamRaiser Participants and Contacts.

This plugin only utilizes the Single Sign-On API and Constituent Management API to do its work.


To install this plugin follow the instructions found on this page EXCEPT that the ConvioSSOAuth.pack directory must be installed into the addons directory and not the plugins directory.

If you do not have an addons directory, you can simply create one in the root of your Melody/MT directory ($MT_HOME/addons).


This plugin has a number of configuration directives that must be set correctly in config.cgi/mt-config.cgi in order to operate. All of these are REQUIRED:

  • AuthenticationModule

    Specifies the authentication module in use by Melody/MT. This normally defaults to MT. However, to enable this plugin, it must be set to ConvioSSO.

  • ConvioSSOCustomDomainURL

    The URL to your organization's official, custom (i.e. non-Convio) domain. This is the URL that provides the /site/CRConsAPI endpoint of the Convio API

  • ConvioSSOAuthHost

    The domain name of the Convio authentication server specified for use by the organization's account. This is usually either or

  • ConvioSSOClientID

    Your organization's Convio Client ID which can be found in your Convio control panel. This is usually a two-letter identifier which is often seen in the Convio authentication URLs, for example,

  • ConvioSSOAdminUsername

    The username of any Convio account in your organization that has API administrator permissions. Note that no such account exists by default. The API administrator permission is a special permission that must be granted. Please see Convio documentation for details on setting up such an account.

  • ConvioSSOAdminPassword

    The corresponding password of the API Administrator account

  • ConvioSSOAPIKey

    Your organization's public Convio API key which you can find in your Convio control panel.

  • ConvioSSOSecretAPIKey

    Your organization's secret Convio API key which you can also find in your Convio control panel if you are logged in as an administrator.

Optional Configuration Directives

There are two configuration directives that are either optional or not currently required:

  • ConvioSSOAuthDebug

    This directive enables a special debug mode useful for properly configuring the plugin with the correct Convio account data. This should not be left on in production as the data it produces could aid a malicious user in attacking your site and/or Convio account.

  • ConvioSSOAPIVersion

    This directive specifies the Convio API version for all transactions. Currently, the only valid value is 1.0 but this is provided for forward-compatiblilty.


Since Convio-created users will be added to the installation upon first login, it's important to set the "newly created users" permissions properly. Otherwise, you will see the following error:

Our apologies, but you do not have permission to access any blogs within this installation. If you feel you have reached this message in error, please contact your Movable Type system administrator.

To do this, go to System Overview > Users > Permissions and click the link titled "Grant permission to a user". On the subsequent screen, select the "(newly created user)" option and grant that user at least one non-commenter role on at least one blog.


A paramount design goal of this plugin was to provide a working authentication solution that was also universally effortless to use for both system administrators and completely non-technical end users. For that reason, certain assumptions were made and constraints implemented to simplify matters. These are areas for possible future development should they be desired.

  • Though it is believed that we fixed this issue, Convio sessions may time out. If that occurs, please let us know and we will see about adding a bug (<img src="http://customconviodomain/site/PixelServer">) to all pages to deal with the issue once and for all

  • There is not currently a mechanism for Convio-created users to recover or reset a Convio password through MT, although they can still use the facilities Convio provides for such functions.

  • There is no logging (to our knowledge) on the Convio side for activity in Movable Type. This can be done through Convio's API (logInteraction) if it's required.

  • The only way to prevent the association between a Convio account and a locally-created account is to log into Melody/MT with local credentials without an active Convio session

  • There is no facility for logging out of only Melody/MT and not Convio

  • Profile data is force synchronized from Convio to Melody/MT and there is no facility for configuring otherwise


Full details can be found in the commit logs but briefly:

  • 2010/12/01 - Initial public release of v1.0-beta


If you are having problems installing or using the plugin, please check out our general knowledge base and help ticket system at


Movable Type versions: 4.3






inter on December 24, 2016, 6:08 a.m. Reply

nice plugin this is very usefull to my site ts inter 1st year results manabadi

Adan Preston Luna

Adan Preston Luna on May 25, 2017, 4:26 p.m. Reply

I love that I can authenticate across platforms with this using Covio, I decided to move Baby Hippo Nursery and I couldn’t be happier with the choice.


diherbalselalu on March 22, 2017, 1:37 a.m. Reply

Your publish had provided me with another point of view on this topic. I had simply no concept that things could work in this ways as well. Thank you for sharing your perspective.

I need to appreciate your properly written content their useful and your writing concept helped me to the idea with absolutely no difficulty. Thanks alot : )

I found useful information on this topic as I am implementing an enterprise project. Many thanks posting relative information and it’s now becoming easier to finish this project

I will be actively working on an assignment and I have been exploring your website for several hours. I’m appreciate your it proved worthwhile for me.

I most likely appreciating every single of the idea. is an incredible and decent impart. I must much obliged. Great employment! You all an incredible blog, and also have some extraordinary substance.


diherbalselalu on March 22, 2017, 1:38 a.m. Reply

I have been very encouraged to track down this website. I desired to thanks with this special study. I certainly savored every that and I’ve you bookmarked to look at brand new things you publish.

The world will be altering fast. people are also getting by day we are becoming more dependant on degital make me think of this really.You have a nice method of sharing your thoughts.

This is definitely really a brilliant article, many gratitude for telling Good luck I found out about this specific blog.

I really enjoy simply reading through all your weblogs. Simply wanted to inform you that you have people like me who appreciate your work. Certainly a great post. The information you have provided is very valuable.

Just keep write what you are excited about, and the visitors will visit your post.


diherbalselalu on March 22, 2017, 1:39 a.m. Reply

Very nice article. I just stumbled upon your blog and want to says that I have truly enjoyed searching your weblog posts. Thanks

This article gives the light in which we can easily observe the reality. This can be very nice one and gives indepth information. Many thanks for this great article.

Within a college thesis for research I must search sites with relevant information on given topic and provide them to teacher our opinion and the article. Your blog helped me a lot.

That is my first time check out here. From the tons of comments on your articles, I suppose I am not just one having all the enjoyment right here!

I just couldn’t leave your website before telling you that I truly enjoyed the best quality data you present to your visitors? Will be back again frequently to check up on brand new posts.


Wanda on April 3, 2018, 8:48 a.m. Reply

Positive site, where did u come up with the information on this posting? I’m pleased I discovered it though, ill be checking back soon to find out what additional posts you include


Jiiva on June 14, 2018, 4:07 a.m. Reply

If you’re a marketer, you’ve likely heard of Durai Jeeva. Her list of credentials is lengthy, and if she really wanted to, she could go on and on and on about her starts with the excerpt in the footer of her personal website. Give it a quick read, paying close attention to the opening and closing lines:  All Premium Tricks

muneer ahmed

muneer ahmed on December 6, 2018, 3:46 p.m. Reply

Many homework on the continual hunt along with offstage on the road to winning. Definitely not attached, simple to-fall as a result of wayside; And not investigation, afterward into a path travel toward the black. How to unlock my Gmail account


alex on December 23, 2018, 9:57 a.m. Reply

Really amazing blog, I’d love to discover some extra information. Check out mini arcade games.

Jason Daniel

Jason Daniel on April 8, 2019, 10:57 a.m. Reply

Your Post is very informative and useful plugins. You gave very good tips regarding tools. Keep sharing and congrats to you. I have seen the best essay writing service provider in the uk.

Jabe Win

Jabe Win on July 25, 2019, 9:14 a.m. Reply

I need to appreciate your properly post plugin their useful and your writing concept helped me to the idea with absolutely no difficulty. Thanks Pakistani Dresses


zindara on July 31, 2019, 2:02 a.m. Reply

This is an inspirational article. It really gives me useful information! Thanks for your donations! happy wheels


zindara on July 31, 2019, 2:02 a.m. Reply

This is an inspirational article. It really gives me useful information! Thanks for your donations! happy wheels

michigan insulation

michigan insulation on August 4, 2019, 11:18 p.m. Reply

Nice plugin. Thanks for sharing. insulation contractor grand rapids

Mikey Nixon

Mikey Nixon on August 9, 2019, 6:28 p.m. Reply

This plugin is very good I am using it on my website.

Live Cricket Streaming

Live Cricket Streaming on August 10, 2019, 10:28 a.m. Reply

That’s great tbh but teach me how to reduce pdf size manually


annajohnsn on August 17, 2019, 7:36 a.m. Reply

I read this discussion on Convio SSO Authentication and I found it really informative. I’m a Best Personal Injury Attorney Near Me CS student. This section is very advantageous for me. I liked the work very much, everything is explained very neatly and efficiently.

Thomas Koons

Thomas Koons on August 29, 2019, 9:23 p.m. Reply

Your site is always solving my issue if you are looking for Thanksgiving wishes then visit Happy Thanksgiving Wishes


Abdul on September 3, 2019, 3:06 a.m. Reply

Very usefull plugin. Keep the good work. You can check . some usefull post as well

Techno Brigade

Techno Brigade on September 21, 2019, 5:41 a.m. Reply

Your site is always solving my issue. Keep up the good work.

Regards UI design company


rajuldholakia on September 24, 2019, 5:27 a.m. Reply

Keep up the good work.

Regards nri banking services surat


rajuldholakia on September 24, 2019, 5:29 a.m. Reply

Keep up the good work.

nri banking services surat

kevin john

kevin john on September 24, 2019, 4:20 p.m. Reply

Thanks, for sharing your suggestions.

Ahmad Alfajri

Ahmad Alfajri on October 14, 2019, 1:40 p.m. Reply

I really like the plugin. Thanks. Best regards

Ahmad Alfajri

Ahmad Alfajri on October 14, 2019, 1:44 p.m. Reply

I really like the plugin. Thanks. Best regards

Leave a Comment

Byrne Reese

Byrne Reese was previously the Product Manager of Movable Type at Six Apart, where he had also held positions as the Manager of Platform Technology and Product Manager for TypePad. Byrne is a huge supporter of the Movable Type user and developer community. He dedicates much of his time to promoting and educating people about Movable Type as well as building the tools and plugins for Movable Type that are showcased on Majordojo. He contributes regularly to open source; and he is an advocate for open protocols and standards like Atom and OpenID.