UkNuke Facebook Connect Authentication For DotNetNuke 5
UKNuke Facebook Connect Authentication for DotNetNuke 5.0.0
This document describes the simple steps to enable Facebook Connect Authentication for your
DotNetNuke installation using the UKNuke.FacebookConnect extension.
The UKNuke Facebook Connect extension has been tested against DNN5.0.0 running on .NET 2.0 and
Whilst the main focus of this development has been for DNN5, this authentication extension has also
been tested to work on the 4.9.1 version of DotNetNuke.
This module is available from www.uknuke.com (a part of www.cirrious.com) for a token fee of $10. This
is only to cover the cost of initial development and of initial support. In the next few months, UkNuke
hopes to include this functionality within the core DNN build.
The functionality currently is:
• Existing users can login to your DNN portal using their facebook account.
• New users can register for your DNN portal using their facebook account.
There are many possible extensions to this base functionality – please keep checking with
www.uknuke.come for any updates. All users will get any updates for 6 months included in their initial
To see this authentication system in live deployment, please come to www.uknuke.com
(www.cirrious.com), login using facebook connect, then please come and say hello on the forum there.
The steps described below are:
• Set up DNN 5.0.0
• Set up your Facebook Connect application
• Install the UKNuke.FacebookConnect Authentication Provider
• Test it works!
From start to end a complete installation, including DNN setup and facebook account registration can be
completed within 30 minutes.
Please pay careful attention to the “VERY IMPORTANT NOTES” on the following page.
! VERY IMPORTANT NOTES !
VERY IMPORTANT NOTE 1 - if you are installing on an existing DNN website, please backup your site
before you start, and please test the install on a copy of the site first. If you do not, then you may not be
able to recover your site if something goes wrong!
VERY IMPORTANT NOTE 2 – for Facebook Connect to work, your site skin must specify a doc type of at
least “XHTML 1.0 Transitional” or you must set up your site to use at least “XHTML 1.0 Transitional” as
the fallback Doctype on the “Host -> Host Settings” tab. Facebook Connect cannot work with “HTML 4.0
(legacy)” Doctype skins.
Notes for DNN 4.9.1
The installation process for 5.0.0 is described in detail below.
For DNN 4.9.1, the installation process is similar, except:
• The authentication system is installed within “Host Settings”, not as an extension - use “Host->
Host Settings -> Advanced Settings -> Authentication Settings”, then choose “Install New
• The authentication system is configured using “Admin -> Authentication” – it is not shown
within “Admin -> Extensions”
A – Set up DNN
1. Set up your new DotNetNuke website…. See http://www.mitchelsellers.com/default.aspx for
B – Set up Facebook Connect
2. Go to Facebook – developer page – http://apps.facebook.com/developer
3. Choose “Set Up New Application”
4. Enter a new application name, choose “Agree” then choose “Save Changes”
5. Take a note of the “API Key” and “Secret Key” on the next page. Note – you must keep the
secret key a secret – although you can create a new key if your initial key is stolen or
6. In the CallbackUrl, enter the root url of your website.
Note – later, if you later choose to enable other facebook features, then you may wish to
change this url – if you do so then please note that the path
r.htm must be inside the path of your CallbackUrl. If this causes you a problem, then please
contact the UKNuke/cirrious support forum for help and assistance.
7. Upload an icon and image – also fill in a description.
Warning – when changing icons, Facebook seems to like opening new windows and this seems
to lose some of the settings you have already entered!
8. Click on the “Connect” settings – on the left hand side.
9. On the “Connect” settings, specify a Connect Logo
10. Choose “Save Changes”
11. Back on “My Applications” you can change other settings if you would like to – e.g. you can
submit your application to the facebook directory and you can set up your About page to attract
users . However, none of these things are required before using facebook connect so I do not
cover this here. For more help on advanced options, talk to us at http://www.uknuke.com or
C – Install the UKNuke.FacebookConnect Authentication Provider
• In your DNN 5.0.0 portal, login as “Host” and then choose “Host -> Extensions”
NOTE – if you are in DNN 4.9.1, the authentication system is installed within “Host Settings”, not
as an extension - use “Host-> Host Settings -> Advanced Settings -> Authentication Settings”,
then choose “Install New Authentication System”.
12. At the bottom of the page, choose “Install Extension Wizard”
13. Step through the wizard, uploading the package UKNuke.FacebookConnect_Install.zip
14. Note that you must accept the license terms on the license page.
15. At the end of the install you will hopefully see the “Package Installation Report” showing the
16. Within DNN 5.0 go to the “Admin -> Extensions” tab, and choose the “Edit” pencil option next to
“UK Nuke – Facebook Connect”.
For DNN4.9.1, the authentication system is configured using “Admin -> Authentication”
17. In the edit settings, enable the facebook connect authentication, choose whether or not to
include help, then enter your Application Key (API Key) and your Secret Key, then choose
“Update Authentication Settings”.
D – Test it works!
18. IMPORTANT – Do not logout of your Host account – if you logout and your login system is
broken then you may never be able to login again!
19. Use a new browser instance (e.g. IE instead of Firefox) or a separate machine to browse to your
20. Choose “login” – you should now have a Facebook option:
21. Choose the Facebook option.
22. If you see the error “An error has occurred – please check the LogViewer for details. ”, then
the most likely cause is that your site does not support XHTML – in which case you need to use
your Host account (which you are still logged into on the other computer or browser) to change
the Host Setting for “Fallback Skin DocType” to at “least XHTML 1.0 Transitional”
23. If you still see an error message, then you should use “Site -> Extensions” to disable the
Facebook Connect auth module and contact www.uknuke.com for help.
24. By this stage you should hopefully now see a Facebook login panel:
26. In the popup dialog enter your facebook name and password, then hit “Connect”
Note – if at this stage you see an error, then it is probably due to the facebook application
settings – you’ll need to go back to the facebook developer settings and check the urls supplied.
27. When you hit “Connect”, you will come back to your application and the user will be asked to
register on your site as well – or to link with an existing site account.
28. That’s it!
29. For further information or advice, please check http://www.uknuke.com
• Users should be aware that when they logoff from your portal they will still remain logged in to
their facebook account - this may be an issue on shared-use computers.