Uk Nuke Facebook Connect Authentication For Dot Net Nuke
- 1. UKNuke Facebook Connect Authentication for DotNetNuke 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 .NET 3.5. 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. 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. Instructions 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 10 minutes. Please pay careful attention to the “VERY IMPORTANT NOTES” on the following page.
- 2. ! 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.
- 3. Notes for DNN 4.9.x The installation process for 5.0.0 is described in detail below. For DNN 4.9.x, 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 Authentication System” • 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 instructions. 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”
- 4. 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 compromised. 6. 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!
- 5. 7. Click on the “Connect” settings – on the left hand side. 8. On the “Connect” settings, specify a Connect Logo 9. On the “Connect” settings, enter the root url of your website as the Connect URL.
- 6. 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 see http://developers.facebook.com.
- 7. C – Install the UKNuke.FacebookConnect Authentication Provider
- 8. • 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 success message.
- 9. 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”
- 10. 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”. 18. If your site use secure HTTPS for its site login page, then you may also wish to: • Choose the “Use Secure Connections?” option. • And to change the “xd_receiver.htm location” from “DesktopModules/AuthenticationServices/UKNuke.FacebookConnect/Connect/xd_receiver .htm” to “DesktopModules/AuthenticationServices/UKNuke.FacebookConnect/Connect/xd_receiver _ssl.htm” D – Test it works! 19. 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! 20. Use a new browser instance (e.g. IE instead of Firefox) or a separate machine to browse to your site. 21. Choose “login” – you should now have a Facebook option:
- 11. 22. Choose the Facebook option. 23. 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”
- 12. 24. 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. 25. By this stage you should hopefully now see a Facebook login panel:
- 13. 26. Hit the “F-Connect” button.
- 14. 27. 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. 28. 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.
- 15. 29. That’s it! 30. For further information or advice, please check http://www.uknuke.com
- 16. Known Issues • 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.