Dynamic Login 4.1. User Guide. Copyright 2011 Data Springs Inc. All rights reserved.

Transcription

1 Dynamic Lgin 4.1 User Guide Cpyright 2011 Data Springs Inc. All rights reserved.

2 Table f cntents: 1 INTRODUCTION 1.1 What s new in INSTALLATION PROCEDURE 3 ADDING DYNAMIC LOGIN MODULE TO A PAGE 4 MAKING YOUR DYNAMIC LOGIN MODULE/PAGE THE MAIN LOGIN PAGE OF THE SITE 5 DYNAMIC LOGIN MAIN MENU 5.1 Entering the prduct license and registering the mdule 5.2 Initial layut and suggested sequence f setting the Dynamic Lgin 6 USING THE CONTROL PANEL 7 MANAGING THE TEMPLATE 8 MANAGING ROLE RULES 8.1 Adding a new Rule Rle Managing existing links 8.2 Editing an existing rle rule 9 MANAGING SECURITY ROLE GROUP RULES 9.1 Adding a New Rle Grup Rule 10 MANAGING USER NOTIFICATIONS 11 RESTRICTING BY IP/SQL VALIDATION 11.1 Restricting Lgin by IP access Blcking an IP address 11.2 Restricting Lgin by SQL validatin 12 MANAGING SINGLE SIGN ON 13 MANAGING MODULE CONFIGURATION 13.1 Managing the General Settings 13.2 Setting the Buttn Type 13.3 Frcing Prfile Change/Passwrd Update Pages 13.4 Managing the Lgin Template Stylesheet 13.5 Executing an SQL Query 13.6 Facebk Cnnect Integratin Managing General Facebk Cnnect Settings Managing Facebk Wall Pst Settings Facebk Cnnect frm yur Users Perspective 13.7 Setting up the Twitter Cnnect Integratin 13.8 Setting up the Linked in Cnnect Integratin 14 AUTO SIGN-IN FEATURE 14.1 Instructins fr setting up Aut Sign in 15 DROPDOWN LOGIN INTEGRATION SKIN OBJECT 15.1 Instructins n implementing this feature 16 DELETING DYNAMIC LOGIN MODULE List f figures: Figure 1: Installatin prcedure (step 1/9)... 6 Figure 2: Installatin prcedure (step 2/9)... 6 Figure 3: Installatin prcedure (step 3/9)... 6 Figure 4: Installatin prcedure (step 4/9)... 7 Figure 5: Installatin prcedure (step 5/9)... 7 Figure 6: Installatin prcedure (step 6/9)... 8 Figure 7: Installatin prcedure (step 7/9)... 8 Figure 8: Installatin prcedure (step 8/9)... 8 Figure 9: Installatin prcedure (step 9/9)... 9 Figure 10: Adding a mdule t a page Figure 11: Dynamic Lgin mdule added t the page Figure 12: Making the Dynamic Lgin the main site lgin page (step 1/) Figure 13: Making the Dynamic Lgin the main site lgin page (step 2/) Figure 14: Setting the page security t "Administratrs nly Figure 15: Opening the main menu Figure 16: Entering the prduct license and registering the mdule (step 1/2) Figure 17: Entering the prduct license and registering the mdule (step 2/2)... 16

3 Figure 18: Initial layut and setup Figure 19: Using the cntrl panel (step 1/2) Figure 20: Using the cntrl panel (step 2/2) Figure 21: Managing the lgin template Figure 22: Verificatin label and textbx Figure 23: Demnstratin f the frm parameters Figure 24: Demnstratin f the frm parameters Figure 25: Demnstratin f the Facebk Cnnect buttn Figure 26: Chsing ptin "Security rle rules" Figure 27: Optins available inside the edit rle rules screen Figure 28: Message displayed t the user after signing in Figure 29: Adding a new Security Rle Figure 30: Chsing ptin "Select an Existing URL" Figure 31: Managing existing links Figure 32: Editing an existing rle Figure 33: Chsing the "Security Rle Grup Rules" ptin Figure 34: Managing Rle Grup Rules Figure 35: Adding a new grup rule Figure 36: Example f the rle grups Figure 37: Managing the user ntificatins Figure 38: Managing the user ntificatins Figure 39: User successfully added t the list Figure 40: Restricting by IP/SQL validatin Figure 41: Restricting by IP and SQL validatin Figure 42: Blcking an IP address Figure 43: Restricting Lgin by SQL validatin Figure 44: Managing Single Sign On Figure 45: Chsing ptin "Mdule Cnfiguratin" Figure 46: Chsing ptin "Dynamic Lgin Settings" Figure 47: Managing the general settings Figure 48: Setting the buttn type Figure 49: Frcing Prfile Change/Passwrd Update Pages Figure 50: Managing the Lgin Template Stylesheet Figure 51: Executing an SQL Query Figure 52: Available Facebk Cnnect ptins Figure 53: Managing General Facebk Cnnect Settings Figure 54: Managing Facebk Wall Pst Settings Figure 55: Facebk Cnnect as Seen by Yur Users (1/4) Figure 56: Facebk Cnnect as Seen by Yur Users (2/4) Figure 57: Facebk Cnnect as Seen by Yur Users (3/4) Figure 58: Facebk Cnnect as Seen by Yur Users (4/4) Figure 59: The way the wall pst has been setup Figure 60: Setting up the Twitter Cnnect Integratin Figure 61: Setting up the Linked in Cnnect Integratin Figure 62: Example Figure 63: Example Figure 64: Deleting Dynamic Lgin (step 1/2) Figure 65: Deleting Dynamic Lgin (step 2/2)... 54

4 1 INTRODUCTION The Dynamic Lgin mdule allws administratrs t custmize their prtal and ffer additinal features and enhancements during the lgin prcess such as: Add Dynamic Rle Rules t redirect the user t different pages n yur site based n their rles in the prtal Setup default frwarding t default users t a particular page that s nt just the hme page Add ntificatins t the administratr if a particular user signs in Add message ntificatins t users/rles, nce they sign in the message can be displayed t the user/rle Several extended and ptinal features t enhance the verall prtal lgin prcess N changes t DNN Cre, simple add mdule t a new page and change the lgin page under 'Site Settings', 'Lgin Page'. Cmplete layut cntrl - Nw yu can setup a custm template fr yur lgin page. This means that if yu dn't want t include the register link at all, r maybe the 'Remember Me' r 'Send Passwrd Reminder' links yu culd simply remve them frm the template. Or yu culd easily change the labels, r lk f the fields. Fr example lets say yu want put bth the username textbx and passwrd textbx n the same rw? Each different implementatin is different but the key here is that yu have a full cntrl f the lgin template using lgin [Tkens] that are then replaced at run time with specialized cntrls With new lgin tkens yu can als chse t use Lgin Image Buttns instead f links buttns fr yur lgin page New feature t allw the user t be able t sign in with their address New feature t allw the user t be able t sign in with their UserID (the number, separate frm the username) New feature t autmatically bypass the rle and user redirectin rules and redirect the user t the previus URL. New Single Sign On (SSO) functinality. This new enhancement allws fr ther prtals within the DNN installatin t be able t access the prtal if the SSO feature is turned n and the user enters the lgin credentials crrectly fr the 'Master Prtal'

5 1.1 What s new in 4.1 New Scial Media Cnnect Integratin New Twitter Cnnect Integratin Nw allw users t lgin via their Twitter accunt. Optinally pst a message t their Twitter accunt prfile whenever they sign in via the Twitter Cnnect integratin feature! New LinkedIn Cnnectin Integratin Nw allw users t lgin via their LinkedIn Accunt. Optinally pst a message t their LinkedIn accunt prfile whenever they sign in via the LinkedIn integratin feature! Updated Facebk Cnnect New features that fix new requirements fr OAUTH 2.0 w/ Facebk Updated Facebk Cnnect New features t stre the Facebk Authenticatin Tken within a sessin variable (and ptin t then use it/stre it within a user prfile field)

6 2 INSTALLATION PROCEDURE In rder t install yur Dynamic Lgin 4.1 mdule, lgin with an accunt t yur DNN site as a hst r administratr accunt. Once yu have lgged in, chse Extensins frm the Hst menu. Figure 1: Installatin prcedure (step 1/9) The fllwing page will be displayed. Figure 2: Installatin prcedure (step 2/9) Click Install Extensin Wizard t cntinue installing Interactive User Imprt and the fllwing page will be displayed. Figure 3: Installatin prcedure (step 3/9)

7 Click Chse File t lcate the installatin file n yur PC. Figure 4: Installatin prcedure (step 4/9) Lcate the installatin file and click Open. The fllwing page will be displayed. Figure 5: Installatin prcedure (step 5/9) Click Next and the Package Infrmatin will be displayed.

8 Figure 6: Installatin prcedure (step 6/9) Click Next and the Release Ntes page will be displayed. Figure 7: Installatin prcedure (step 7/9) Click Next and the Review License page will be displayed. Figure 8: Installatin prcedure (step 8/9)

9 Select the Accept License t indicate that yu accept the license and click Next. The installatin will begin and after a cuple f mments yu will see the cnfirmatin message in the bttm f the page. Figure 9: Installatin prcedure (step 9/9) Nte: please keep track f any errrs that appear during the installatin. These errrs can be helpful if yur mdule has prblems.

10 3 ADDING DYNAMIC LOGIN MODULE TO A PAGE In rder t add Interactive User Imprt mdule t a desired page fllw these steps: 1. Select Add New Mdule 2. Chse Interactive User Imprt frm the Mdule pull dwn menu 3. Click Add Mdule Figure 10: Adding a mdule t a page The Dynamic Lgin mdule will be added t the page.

11 Figure 11: Dynamic Lgin mdule added t the page

12 4 MAKING YOUR DYNAMIC LOGIN MODULE/PAGE THE MAIN LOGIN PAGE OF THE SITE IMPORTANT NOTE: Befre making Dynamic Lgin yur primary lgin page, test it first t make sure that it is wrking prperly. If yu cannt sign int Dynamic Lgin and have nt cnfigured the mdule prperly, then when yu setup yur lgin page t be the Dynamic Lgin page yu will have lcked yurself ut f the site. If this des happen please cntact supprt fr assistance in updating yur prtals table t reflect a null value fr the lgin page. In der t make yur Dynamic Lgin mdule/page the main lgin page f yur site, yu first need t chse the lgin page. In rder t d s, click Admin and chse Site Settings. Figure 12: Making the Dynamic Lgin the main site lgin page (step 1/) Within the Settings page, lk under Advanced Settings -> Page Management and yu will see the Lgin Page parameter. Figure 13: Making the Dynamic Lgin the main site lgin page (step 2/) Chse the lgin page frm the Lgin Page pull dwn menu.

13 Nte: There is a feature that must be implemented starting in DNN 5.x. DNN included sme cde t frce the standard accunt lgin mdule n the page and they did this because if yur lgin isn t setup and wrking crrectly yu can never sign in. S, in rder fr us t get arund this DNN left a dr pen fr mdules such as Dynamic Lgin. Simply include an Accunt Lgin mdule n the page where the Dynamic Lgin mdule is specified and check the security t be Admin Only. S, first chse the Settings ptin frm the main menu. Within the Settings page, select Administratrs nly. Figure 14: Setting the page security t "Administratrs nly This way DNN can still recgnize the Dynamic Lgin page as the main lgin page.

14 5 DYNAMIC LOGIN MAIN MENU In rder t start using the main menu, place yur muse ver the Dynamic Lgin label and the Manage ptin will appear. Click Manage t pen the menu. Figure 15: Opening the main menu The fllwing ptins are available inside this screen: Cntrl Panel the cntrl panel with all majr applicatin ptins (see sectin 6) Dynamic Lgin User Guide this guide Dynamic Lgin License the ptin fr registering the mdule (see sectin 5.1) Settings ptin fr managing settings (see sectin 13) Delete ptin fr deleting a mdule (see sectin 14) Initial applicatin layut see sectin 5.1

15 5.1 Entering the prduct license and registering the mdule In rder t register the mdule, yu need t enter the mdule license, i.e. Invice ID. Chse ptin Dynamic lgin License frm the main menu. Figure 16: Entering the prduct license and registering the mdule (step 1/2) The fllwing page will be displayed.

16 Figure 17: Entering the prduct license and registering the mdule (step 2/2) Enter the license (received in an after purchasing the prduct) under Invice ID and click Register/Submit License. The mdule will be registered.

17 5.2 Initial layut and suggested sequence f setting the Dynamic Lgin Initially the Dynamic Lgin interface cntains additinal ptins which are actually shrtcuts t the ptins frm the menu. The purpse f placing these ptins/shrtcuts here is t suggest the ptimal sequence f actins yu need t perfrm in rder t setup yur Dynamic Lgin applicatin successfully. Figure 18: Initial layut and setup The fllwing ptins are available: Setup Initial Settings see sectin 5.1 Setup Template see sectin 7 Setup Rle Redirectin Rules see sectin 8 Setup User Specific Redirectin Rules see sectin 6 Once yu cmplete the task successfully, this icn the successful cmpletin. will be displayed next t the ptin denting

18 6 USING THE CONTROL PANEL In rder t start using the cntrl panel, chse that ptin frm the main menu. Figure 19: Using the cntrl panel (step 1/2) The fllwing page will be displayed. Figure 20: Using the cntrl panel (step 2/2) The fllwing ptins and parameters are available: Manage Template see sectin 7 Mdule Cnfiguratin see sectin13 Security Rle Rules see sectin 8 Security Rle Grup Rules see sectin 9 User Ntificatins see sectin 10 Restrict by IP/SQL Validatin see sectin 11 Single Sign On see sectin 10

19 7 MANAGING THE TEMPLATE The Dynamic Lgin mdule allws yu t custmize the layut f the lgin frm. In rder t start mdifying the template, access the cntrl panel ( Cntrl Panel ptin in the main menu) and the first page, displayed by default, is the page fr managing the template. Yu can access the page at any time while in cntrl panel, by clicking the Manage Template ptin. Figure 21: Managing the lgin template The fllwing parameters and ptins are available inside this screen: Basic Text Bx use this ptin nly if yu wish t have a very simple frm Rich Text Editr select if yu want t use text frmatting ptins Text area this area is used fr creating the template by using ptins inside the rich editr as well as the frm parameters: [DNN_LABEL_USERNAME] use this parameter t determine the lcatin f the User name label (see Figure 23) [DNN_TEXT_USERNAME] use this parameter t determine the lcatin f the user name input field (see Figure 23) [DNN_LABEL_PASSWORD] use this parameter t determine the lcatin f the Passwrd label (see Figure 23) [DNN_TEXT_PASSWORD] use this parameter t determine the lcatin f the passwrd input field (see Figure 23) [DNN_LABEL_VERIFICATION] use this parameter t determine the lcatin f the verificatin label. This label is displayed in case yur registratin is set t Verified and the user is nt verified (nte: t turn verificatin n within DtNetNuke g t Admin, Site Settings, Advanced Settings, and under Security Settings check the Verified radi buttn). The verificatin will typically include

20 a verificatin cde and/r a verificatin link t the lgin page which will pass alng infrmatin t display the verificatin prmpt. This screensht belw demnstrates the label and textbx fr verificatin when a user has nt been verified and is attempting t sign in (r navigates t the verificatin link). Figure 22: Verificatin label and textbx [DNN_TEXT_VERIFICATION] the parameter fr displaying the verificatin in put field input (see figure abve) [DNN_CHECKBOX_REMEMBER_ME] use this parameter t determine the lcatin f the Remember me checkbx which will help yur users lgin withut the need fr entering username and passwrd each time (see Figure 24) [DNN_LOGIN_BUTTON] - use this parameter t determine the lcatin f the Lgin buttn (see Figure 24) [DNN_REGISTER_BUTTON] - use this parameter t determine the lcatin f the Register buttn (see Figure 24) [DNN_SEND_PASSWORD_BUTTON] - use this parameter t determine the lcatin f the Send passwrd buttn (see Figure 24) [DNN_FACEBOOK] use this tken t display the Facebk Cnnect buttn (see Figure 25)

21 [DNN_LABEL_USERNAME] [DNN_TEXT_USERNAME] [DNN_TEXT_USERNAME] [DNN_LABEL_PASSWORD] [DNN_TEXT_USERNAME] [DNN_TEXT_PASSWORD] [DNN_TEXT_USERNAME] fff [DNN_TEXT_USERNAME] Figure 23: Demnstratin f the frm parameters [DNN_CHECKBOX_REMEMBER_ME [DNN_LOGIN_BUTTON] [DNN_TEXT_USERNAME] [DNN_REGISTER_BUTTON] [DNN_SEND_PASSWORD_BUTTON] Figure 24: Demnstratin f the frm parameters [DNN_TEXT_USERNAME] [DNN_FACEBOOK] Figure 25: Demnstratin f the Facebk Cnnect buttn After setting the desired parameters, click n the "Save link in rder t save the changes.

22 8 MANAGING ROLE RULES In rder t start managing lgin rules based n user rle in the system chse ptin Security Rle Rules frm the main menu. Figure 26: Chsing ptin "Security rle rules" The fllwing screen will be displayed. Figure 27: Optins available inside the edit rle rules screen The fllwing infrmatin and ptins are available inside this screen: Rle Name field displaying the name f the existing rle URL this is the page that the user will be directed t after they lgin, yu might want users with a rle f administratr t be sent t a different page then users wh are assigned a different rle in the system

23 Pririty the pririty is used t determine which page the user shuld be sent t. The higher pririty will determine if a user shuld be distributed t ne URL versus anther Fr example if a user has bth the Administratr Rle and the Mdule Training rle sme pririty needs t be defined as t which page the user shuld be directed t. If yu set the pririty higher n the Administratr rle ptin, the user will be navigated t that URL instead f the Mdule Training rle. It Is pssible t have as many rle/url redirectin rules setup as yu wuld like, and set the pririty fr each ne (nte: pririty nly makes a difference when the user has mre then ne rle. Additinal Message message displayed t the user after signing in (see Figure 28) - ptin fr editing a rle rule (see sectin 8.2) Adding a new Rule Rle - ptin fr adding a new rle rule (see sectin 8.1) Figure 28: Message displayed t the user after signing in

24 8.1 Adding a new Rule Rle The purpse f the rule rle ptin is t allw yu t define lgin rules based n the rle the user has been assigned t. In rder t add a new rule, chse ptin Security Rle Rules frm the Cntrl Panel. The lwer part f that page cntains ptins fr adding a new rle. Figure 29: Adding a new Security Rle The fllwing parameters are available inside this screen: Rle chse the desired rle this rule will be applied t URL set the rule fr the URL user will visit after lgging in URL (A Link T an External Resurce) select this radi buttn if yu want the user t visit external resurce after lgging in (nte: the actual URL is entered inside the Lcatin field) Page (A Page n Yur Site) select this radi buttn if yu want the user t visit a page n yur website after lgging in (nte: the actual URL is entered inside the Lcatin field) File (A File n Yur Site) select this radi buttn if yu want the user t dwnlad r visit a file n yur site Lcatin: (Enter the Address f the Link) input field fr entering the URL (

25 Select an existing link ptin fr selecting and managing existing links (see sectin 8.1.1) Pririty same as abve fr rules but it applies t users Additinal Message (ptinal) text area fr entering any additinal message yu want t display t users wh are assigned t specific rle After setting these parameters click n the Update buttn in rder t save the changes and cmplete the prcedure f adding a new rule Managing existing links In rder t select and manage existing URL, click n the Select an Existing URL link. Figure 30: Chsing ptin "Select an Existing URL" The fllwing screen will be displayed. Figure 31: Managing existing links The fllwing ptins are available inside this screen: Lcatin pull dwn menu cntaining existing links yu can chse frm Delete Selected URL Frm the List use this ptin after chsing the desired link in rder t delete it frm the list Add a New URL use this ptin in rder t add a new URL t the list (pull dwn menu)

26 8.2 Editing an existing rle rule In rder t edit an existing rle click n this icn next t the desired rle name. Figure 32: Editing an existing rle The screen with the parameters set fr this rule will be displayed where yu can change the desired infrmatin. Click n the Update buttn t save the changes. Nte: see sectin 8.1 fr further infrmatin abut the available parameters.

27 9 MANAGING SECURITY ROLE GROUP RULES The Security Rle Grup Rules are very similar t Rle rules. The Rle Grup is used fr gruping i.e. rganizing individual rles. In rder t start setting up the grups, chse ptin Security Rle Grup Rules in the Cntrl Panel. Figure 33: Chsing the "Security Rle Grup Rules" ptin The fllwing screen will be displayed. Figure 34: Managing Rle Grup Rules The fllwing parameters and ptins are available inside this screen: - ptin fr editing the existing rule - the ptin fr deleting the rule The rest f the ptins are fr adding the new grup see sectin 9.1

28 9.1 Adding a New Rle Grup Rule In rder t start adding a new grup rule, chse ptin Security Rle Grup Rules frm the Cntrl Panel. The fllwing page will be displayed. Figure 35: Adding a new grup rule The fllwing ptins and parameters are available: Rle Grup chse the desired rle grup frm this pull dwn menu Nte: T add rles t rle grups yu shuld g t Admin, Security Rles, and clicking Edit within a security rle. Yu will see that yu can then set the rle grup. Fr example yu might want t put the security rle Califrnia and the security rle Nevada int the security rle grup West Cast but yu might want t put the security rle Missuri and the security rle Kansas int the Midwest Security Rle Grup. URL set the rule fr the URL user will visit after lgging in URL (A Link T an External Resurce) select this radi buttn if yu want the user t visit external resurce after lgging in (nte: the actual URL is entered inside the Lcatin field) Page (A Page n Yur Site) select this radi buttn if yu want the user t visit a page n yur website after lgging in (nte: the actual URL is entered inside the Lcatin field)

29 File (A File n Yur Site) select this radi buttn if yu want the user t dwnlad r visit a file n yur site Lcatin: (Enter the Address f the Link) input field fr entering the URL ( Select an existing link ptin fr selecting and managing existing links (see sectin 8.1.1) Pririty same as abve fr rules but it applies t users Additinal Message (ptinal) text area fr entering any additinal message yu want t display t users wh are assigned t specific rle Figure 36: Example f the rle grups

30 10 MANAGING USER NOTIFICATIONS The Dynamic Lgin mdule allws yu t setup ntificatins which will be sent t yu in case the specified user(s) lgin. In rder t start managing the user ntificatins, chse User Ntificatins frm the cntrl panel. Figure 37: Managing the user ntificatins The fllwing page will be displayed. Figure 38: Managing the user ntificatins The fllwing ptins and parameters are available: Filter Criteria use this ptin t filter the user list based n the desired criteria (e.g. enter Jhn t display all users with the first name Jhn )

31 User enter the user name f the user yu wish t add, e.g. jhnsmith (nte: yu must prvide a crrect username in rder fr the ntificatin t wrk prperly) Additinal Message use this field t display a message t the user nce they sign in. Send Admin Ntificatin select this checkbx t enable the admin ntificatin feature the template fr this message can be setup within the mdule cnfiguratin sectin under Admin Ntificatin Template (see sectin 13.4) Once yu add the desired user and ptinally enter the additinal message click Update and the user will be added i.e. yu will start receiving ntificatins each time the specified user lgs t the system. Nte: The additinal message is the message the user will receive upn successfully signing int the system. The admin ntificatin is a separate that will ntify the admin when a user has signed in. Figure 39: User successfully added t the list

32 11 RESTRICTING BY IP/SQL VALIDATION In rder t start using the ptins fr restricting users based n IP and SQL validatin, chse the Restrict by IP/SQL Validatin ptin frm the cntrl panel. Figure 40: Restricting by IP/SQL validatin The fllwing page will be displayed. Figure 41: Restricting by IP and SQL validatin The fllwing ptins and parameters are available: Restrict Lgin by IP access see sectin 11.1 Restrict Lgin by SQL validatin see sectin 11.2

33 11.1 Restricting Lgin by IP access The Dynamic Lgin mdule allws yu t restrict access t the prtal by blcking specific IP addresses. In rder t start using this ptin click + next t the Restrict Lgin by IP Access label. Restricting Lgin by IP access The fllwing ptins and parameters are available: IP Address displays the restricted IP addresses Descriptin displays the reasn fr the restrictin Affects All Mdule Instances displays infrmatin n whether this restrictin shuld affect all mdule instances - the ptin fr deleting the IP address frm the list f blcked IP addresses, there fre allwing access t that IP address - the ptin fr editing the desired entry - the ptin fr blcking an IP address (see sectin ) Blcking an IP address The IP addresses are blcked by adding them t the list f restricted addresses. Figure 42: Blcking an IP address In rder t blck an IP address enter the desired IP address int the IP Address field and click this icn. The IP address will be blcked. Nte: yu can chse t restrict the IP address frm all mdule instances by clicking the checkbx.

34 11.2 Restricting Lgin by SQL validatin The Dynamic Lgin feature allws yu t restrict lgin via SQL validatin. Yu can blck ut specific users by enabling this feature and returning a query with ne rw/ne clumn called IsValid. If the clumn returns '0' r 'False' then the user will nt be allwed t lg in and will be presented with the errr message. Any ther value will be cnsidered valid and will allw the user t sign in. In rder t start using this ptin, click + next t the Restrict Lgin by SQL Validatin label. Figure 43: Restricting Lgin by SQL validatin The fllwing ptins and parameters are available: Enable SQL Validatin - select the this checkbx t enable the SQL Validatin fr this mdule instance SQL Valicatin Query (shuld return ne clumn called IsValid) - Enter the query fr this validatin. Parameters fr the query can include the fllwing tkens: $(UserID) $(PrtalID) $(IPAddress) Validatin Errr Message - enter the validatin errr message which will be displayed t the restricted user After setting the desired parameters, click Save t save the changes.

35 12 MANAGING SINGLE SIGN ON The Single Sign On (SSO) functinality allws users t lgin with the same lgin credentials within ther prtals n the DNN installatin, as lng as that users credentials exist in the parent prtal. This will allw users t register n a single prtal and have access t any ther prtals within the DNN installatin. Additinally, nce the user is authenticated within ne prtal their authenticatin will be autmatically authenticated when they navigate between prtals. This will allw yu t enable yu users t nly lgin nce and then cntinue brwsing thrugh a different prtal as well withut the need t lgin each time. The functinality wrks as a system f master and slave prtals and wrks in bth directins. In ther wrds, yu can either replicate the user credentials frm a master prtal t a slave prtal r the ther way arund, i.e. if the user lgs int slave prtal he will als be able t lgin t the master prtal. The ability t use Reverse SSO frm the slave t master prtals is an ptinal feature within the Single Sign On setup. The system will als check the security rles fr the user in 'Master Prtal A' and add them t any matching security rles per name in 'Slave Prtal B'. Fr example: lets say that a user attempts t lgin n Prtal B which already exists within Prtal A with the security rles, 'Registered Users', 'Subscribers', and 'West Cast'. If these same security rles exist (by security rle name) within Prtal B they will autmatically be added t these security rles within Prtal B. In rder t start setting up the Single Sign On functinality, chse the Single Sign n frm the cntrl panel. Figure 44: Managing Single Sign On The fllwing parameters and ptins are available: Enable Single Sign On select this checkbx t enable the Single Sign On Master prtal select the master prtal frm this pull dwn menu. The master prtal is the prtal the system will attempt t authenticated the user against if they d nt exist in the current prtal. If their authenticatin is valid within the master prtal, the system will autmatically add them as a valid user fr the current prtal If their authenticatin is valid within the master prtal the user will als be added t any security rles that they have t the new prtal. The rles they are added t, are based n the Rle Name. Fr example, if they have a rle called West Cast within the master prtal (and the user is part f this rle) and a rle called West Cast within the current prtal. The user will be added t the West Cast rle within the child prtal. Add user t parent prtal if user lgs in and is nt part f parent prtal (Reverse SSO) select this checkbx if yu wish t add the lgged user t the parent prtal if they d nt exist within the parent prtal and they lgin in successfully within the current prtal.

36 Sync User Rles frm Parent Prtal fr each Lgin? - select this ptin if yu wuld like the user security rles t always be synced with the master prtal. If this feature is nt enabled then the rles will nly initially be added fr the user n the child prtal fr the very first lgin. When this feature is enabled the rles will be synced frm the master prtal fr each and every lgin. After setting the desired parameters, click n the Save link t save the changes.

37 13 MANAGING MODULE CONFIGURATION In rder t start managing the mdule settings, chse ptin Settings frm the main menu. Figure 45: Chsing ptin "Mdule Cnfiguratin" The fllwing screen will be displayed. Figure 46: Chsing ptin "Dynamic Lgin Settings" The fllwing ptins are available: General Settings see sectin 13.1 Buttn Type see sectin 13.2 Frce Prfile Change/Passwrd Update Pages see sectin 13.3 Lgin Template Stylesheet see sectin 13.4 Execute SQL Query see sectin 13.5 Facebk Cnnect Integratin see sectin 13.6 Twitter Cnnect Integratin see sectin 13.7 Linked in Cnnect Integratin see sectin 13.8

38 13.1 Managing the General Settings In rder t start managing the general mdule settings, click the plus sign next t the General Settings label. Figure 47: Managing the general settings The fllwing parameters are available inside the first part f the screen: Default Redirect Link set the desired ptin fr default redirect link URL (A Link T an External Resurce) select this radi buttn if yu want the user t visit external resurce after lgging in (nte: the actual URL is entered inside the Lcatin field) Page (A Page n Yur Site) select this radi buttn if yu want the user t visit a page n yur website after lgging in (nte: the actual URL is entered inside the Lcatin field) File (A File n Yur Site) select this radi buttn if yu want the user t dwnlad r visit a file n yur site Lcatin: (Enter the Address f the Link) input field fr entering the URL ( Select an existing link ptin fr selecting and managing existing links (see sectin 8.1.1) Admin Ntificatin Template this is the template fr the message that yu as an administratr will receive when a user signs in; this message is sent when the checkbx send ntificatin is selected (see sectin 6) Override user and rle redirectin rules and always redirect t previus URL select this ptin if yu wish t verride any user r rle redirectin rules which apply t the users and always redirect them t the previus URL

39 Enable first time lgin message - this setting will enable the message t the user the very first time they sign nt the system; this message will nly be displayed in case the user has never signed n befre First time lgin message enter the text fr the message the user will see the very first time they sign nt the system; yu can use the tkens %Date%, %FirstName%, and %LastName% t custmize the message per user Allw user t lgin with their address select this ptin if yu wish t allw yur users t use their address as a username during the lgin Allw user t lgin with their User ID (separate frm UserName) select this ptin if yu wish t allw yur users t use their ID as a username during the lgin Nte: the UserID field is an integer (aut number) that is generated when a username is created. Example: In sme implementatins yu might want t simply send the user their UserID t lgin instead f having t remember their username. Often these implementatins might be used in cnjunctin with anther mdule such as Dynamic Registratin t pssibly allw the user t submit their infrmatin and receive a Ticket ID r Claim ID t lgin with which is actually their UserID. Keep user n same page as Dynamic Lgin mdule - this setting will keep the user n the same page as the Dynamic Lgin mdule; this page is useful when yu want t include the lgin mdule n pages thrughut yur site frcing the user t click n the lgin link buttn Default Remember Me feature t true select if yu wuld like t enable the Remember Me checkbx t be defaulted t a value f true r initially checked when he user navigated t lgin page D nt set fcus t username field upn lad - If this setting is enabled the lgin frm will nt initially set the fcus t the username textbx when the mdule lads Shw backgrund image fr textbx fields - select this checkbx if yu wuld like a backgrund image t appear fr fields such as username, passwrd, and verificatin cde; this setting will simply use an alternate CSS class when rendering these cntrls Username Watermark enter the text which will be displayed within the username field befre the user enters any values Passwrd Watermark enter the text which will be displayed within the passwrd field befre the user enters any values Hide Quick Menu (Glbal Setting) - select this ptin if yu wuld like t hide the quick menu cntrl panel fr admin users n the user-facing page; this is a glbal setting which will hide the quick menu fr all mdule instances within the entire web site

40 13.2 Setting the Buttn Type In rder t start setting the desired buttn type, click the plus sign next t the Buttn Type label. The fllwing page will be displayed. Figure 48: Setting the buttn type The fllwing ptins and parameters are available: Input Buttn Type chse the desired buttn type fr this mdule instance; this can either be a link buttn, image buttn r standard HTML buttns Default Lgin Image Link use this ptin t select the desired image yu wish t use as a lgin link (see image belw); yu can either chse the file which has already been upladed frm the File Name pull dwn menu r use the Uplad New File ptin t uplad a new file frm yur PC Default Register Image Link - use this ptin t select the desired image yu wish t use as a Register link (see image belw); yu can either chse the file which has already been upladed frm the File Name pull dwn menu r use the Uplad New File ptin t uplad a new file frm yur PC Default Passwrd Reminder Image Link - use this ptin t select the desired image yu wish t use as a Reminder link (see image belw); yu can either chse the file which has already been upladed frm the File Name pull dwn menu r use the Uplad New File ptin t uplad a new file frm yur PC

41 13.3 Frcing Prfile Change/Passwrd Update Pages In rder t start managing this setting, click the plus sign next t the Frce Prfile Change/Passwrd Update Pages label. The fllwing page will be displayed. Figure 49: Frcing Prfile Change/Passwrd Update Pages The fllwing ptins are available: Redirect page fr invalid prfile (required fields missing) this setting will determine the page the user will be redirected t if their prfile is nt valid. In rder t enable this setting yu must als select t require a valid prfile within the DNN Cre System. Yu can cmplete this task under Admin, User Accunts, User Settings fr the setting t require a valid prfile fr lgin. This page shuld redirect t a page such as Dynamic Registratin that can allw the user t cmplete fields that are marked as required fr their prfile t be valid. Required fields fr their prfile are setup and defined under Admin, User Accunts, Manage Prfile Prperties. Redirect page fr passwrd change (if Admin has selected t frce the user t change their passwrd) - this setting will allw the user t lgin using their User ID. The UserID is a number assigned t each user created within the DNN prtal and is separate frm their UserName.

42 13.4 Managing the Lgin Template Stylesheet In rder t start managing the lgin template stylesheet, click the plus sign next t the Lgin Template Stylesheet label. The fllwing page will be displayed. Figure 50: Managing the Lgin Template Stylesheet Use this text area t mdify the stylesheet and click Save Settings t save the changes.

43 13.5 Executing an SQL Query In rder t start defining the custm SQL query, click the plus sign next t the Execute SQL Query label. The fllwing page will be displayed. Figure 51: Executing an SQL Query Use the SQL Query text area t specify the SQL query which shuld be executed at the time f lign. The fllwing tkens can be used: $(UserID) $(PrtalID) $(IPAddress 13.6 Facebk Cnnect Integratin In rder t setup the Facebk Cnnect Integratin click Mdule cnfiguratin within the Cntrl panel and then click + symbl under Facebk Cnnect Integratin. Figure 52: Available Facebk Cnnect ptins The fllwing ptins are available: Facebk General Settings see sectin Facebk Wall Pst see sectin

44 Managing General Facebk Cnnect Settings In rder t start managing the general Facebk Cnnect settings, click the + symbl next t that label and the page will display all available ptins. Figure 53: Managing General Facebk Cnnect Settings The fllwing ptins and parameters are available: Facebk APP ID - enter yur Facebk APP ID, which can be retrieved frm Facebk App Key - enter yur Facebk APP Key which can be retrieved frm Facebk APP Secret - enter yur Facebk APP Secret. This APP Secret can be retrieved frm Ntes: Please reference this exact page fr creating yur applicatin initially: Yu will need t click Set Up New App t start. During the wizard yu shuld enter the dmain name crrectly and nce yu click Save yu will receive yur AppID, App Key and App Secret. Yu can name the applicatin whatever yu want i.e. Yur-Cmpanyname Authenticatin Tl r similar; it des nt have t be called Dynamic Lgin Cnnect. This is setup and defined whenever yu create the initial applicatin at develpers.facebk.cm and yu define yur applicatin name and will be present when it psts t the user is prmpted fr lgin, and the applicatin psts t the users Facebk wall. User Creatin Type chse the methd fr creating Facebk authenticated users. Users can either be created based n their Facebk UserID r with their address as their username. Redirect / Thank yu page - enter the URL the user will be taken t if yu chse 'Nne' as the user registratin methd. Nte: the user will nly be taken t this page if Nne is selected and if the users credentials dn't match a valid lgin. In this case yu might cnsider using a

45 feature such as the Silent Pst t pst details t Dynamic Registratin t create the user instead f creating the user thrugh this integratin Username Prefix - enter a prefix in case yu wish t add it t each user created via Facebk Cnnect r OAuth integratin (nte: this can help yu differentiate these users frm all ther users in the system). Authenticate user accunt with matching address - select this ptin if yu wuld like t authenticate and match user s Facebk accunt with his DtNetNuke User Accunt based n their address Stre UserID in Alternate Field - select a DtNetNuke prfile field fr string the Facebk UserID Nte: this can be useful if yu are creating the username based n the address but wuld still like t have access t the Facebk UserID field fr the future Stre User Creatin Status in Alternate Field - select a DtNetNuke prfile field which fr string infrmatin n hw the user was created (i.e. Facebk Cnnect, r Facebk Auth). This feature can help yu identify users created via the Facebk Integratin Nte: when implemented this feature will stre a value f FacebkUser t the prfile field (in future versins this will als be a feature that can be used fr ther authenticatin systems such as Twitter etc) Extended Permissins - Initially the parameters requested are fr basic infrmatin including the users address. Yu can ptinally request additinal infrmatin by passing in additinal parameters in a cmma separated list withut spaces. The list f extended permissins is lcated at Example: user_abut_me,user_birthday,user_likes. Nte: This can be useful if yu are using this same applicatin ID within ther mdules that might shwcase these extended permissins. OAuth 2.0 Page Type - select the page type fr the OAuth 2.0 authenticatin integratin. This can include either a redirect page r a pp up page Alternate Image - please enter the name f an alternate image fr the Facebk cnnectin buttn. Imprtant nte: this image must be lcated in the /desktpmdules/dynamic lgin/images directry Several alternate images are already included within the Dynamic Lgin installatin these include facebk1.gif, facebk2.gif, facebk3.gif, facebk4.gif. Yu can dem what these lk like here: Default Image Facebk1.gif Facebk2.gif Facebk3.gif Facebk4.gif Add yur wn! Just cpy a file int the /images flder as nted abve and reference it within this prperty. Submit HTTP Pst - select the desired ptin fr submitting an HTTP pst amng the fllwing: Creating User Only chse this ptin t submit an HTTP pst nly in the case the user has been created Signing in User Only chse this ptin t submit an HTTP pst nly in the case the user has signed in

46 Creating User and Signing in User chse t submit an HTTP pst in case the user has been created and has signed in Nte: An HTTP Pst can be sent t any page/mdule but there are direct integratin ptins with Dynamic Frms and Dynamic Registratin Silent Pst (Dynamic Frms/ Registratin URL) - select the URL that yu wuld like t pst the Facebk accunt details t. This allws fr the integratin with Data Springs Dynamic Registratin r Dynamic Frms mdule which can accept a silent pst and prcess the registratin and/r cmpletin events there Silent Pst Details - select the URL that yu wuld like t pst the Facebk accunt details t. This allws fr the integratin with Data Springs Dynamic Registratin mdule which can accept registratin data via a silent pst and prcess the registratin there Nte: Please check ur site fr recent blg psts and frum psts related t examples f silent psts. Sn we will be psting blgs n hw t use the silent pst with Dynamic Registratin, Opt In , Dynamic Frms etc Yu can als read ur blg pst Receive Dynamic Frms / Dynamic Registratin Silent HTTP Psts

47 Managing Facebk Wall Pst Settings In rder t start managing the Facebk Wall Pst settings, click the + symbl next t that label and the page will display all available ptins. Figure 54: Managing Facebk Wall Pst Settings The fllwing ptins and parameters are available: Pst message t user s wall? select t enable psting t user s wall Wall Pst days delay check (0 fr always) - enter the desired time ut during which the mdule shuld ignre the fact that the user signed in i.e. nt pst infrmatin n their wall Fr example If yu put 30, the mdule will pst t the wall the first time and then wait fr 30 days befre psting the infrmatin again If yu enter 0 the mdule will pst t the wall each time the user is lgged Wall Pst Title - enter the title fr the wall pst; this will be the title f the Facebk wall pst when a user signs in thrugh Facebk Integratin Wall Pst Message - enter the message fr the wall pst; this will be the message f the Facebk wall pst when a user signs in thrugh the Facebk Integratin Wall Pst Link enter the URL r link fr the wall pst; this link shuld be the full path starting with The link wuld nrmally be the web site that the user is signing in frm Wall Pst Image - select if yu wuld like t pst an image t the user s wall; this image will render t their Facebk wall each time they sign int yur web site.

48 Facebk Cnnect frm yur Users Perspective This sectin will describe and illustrate using f Facebk Cnnect as seen by yur users. The first step fr yur users is clicking the Cnnect buttn/image. Figure 55: Facebk Cnnect as Seen by Yur Users (1/4) Nte: yu can specify an alternate image fr the cnnect buttn by using the Alternate Image parameter Once yu users click Cnnect, the permissin request windw will be displayed. Figure 56: Facebk Cnnect as Seen by Yur Users (2/4) The upper left crner displays the name f the mdule i.e. Dynamic Lgin Cnnect (nte: yu can set a custm name). After yur users click Allw, they will autmatically be lgged in int yur site.

49 Figure 57: Facebk Cnnect as Seen by Yur Users (3/4) Als, in case yu have enabled this feature, infrmatin abut this will be psted t their wall (see ). Figure 58: Facebk Cnnect as Seen by Yur Users (4/4) Belw is the screensht which illustrates hw the whle pst has been setup in the backend. Figure 59: The way the wall pst has been setup Ntes: The I just singed int text is specified using the Wall Pst Message parameter The bttm f the pst shws the name f the mdule used fr psting the infrmatin which is Dynamic Lgin Cnnect.

50 13.7 Setting up the Twitter Cnnect Integratin In rder t setup the Twitter Cnnect Integratin click Mdule cnfiguratin within the Cntrl panel and then click + symbl under Twitter Cnnect Integratin. Figure 60: Setting up the Twitter Cnnect Integratin The fllwing parameters are available: Twitter Cnsumer Key - please enter yur TwitterCnsumer Key. This Cnsumer Key can be retrieved frm Twitter Cnsumer Secret - please enter yur TwitterCnsumer Secret. This Cnsumer Secret can be retrieved frm Please review the dcumentatin n fr mre infrmatin. User Creatin Type - select hw yu wuld like Twitter authenticated users created. Users can either be created based n their Twitter UserID r they can be created with their screen name as their username. User Prefix - enter a prefix if yu want the username t include a prefix fr each user created via Twitter Cnnect r OAuth integratin. Stre UserID in Alternate Field - select a DtNetNuke prfile field that yu wuld like the Twitter UserID stred in. This can be useful if yu are creating the username based n the address but wuld still like t have access t the Twitter UserID field fr the future. Stre User Creatin Status in Alternate Field - select a DtNetNuke prfile field that yu wuld like t stre hw the user was created (i.e Twitter Cnnect, r Twitter Auth). This feature can help yu identify users created via the Twitter Integratin. OAuth 2.0 Page Type - select the page type fr the OAuth 2.0 authenticatin integratin. This can include either a redirect page r a pp up page. Pst Tweet message t user select if yu wish t pst a tweet t the user (enter the message in the field belw) Tweet Message please enter the message fr the tweet pst. This will be the message f the Twitter tweet pst when a user signs in thrugh the Twitter Integratin.

51 13.8 Setting up the Linked in Cnnect Integratin In rder t setup the Twitter Cnnect Integratin click Mdule cnfiguratin within the Cntrl panel and then click + symbl under Linked in Cnnect Integratin. Figure 61: Setting up the Linked in Cnnect Integratin The fllwing parameters are available: Linkedin API Key - please enter yur Linkedin API Key. This API Key can be retrieved frm Please review the dcumentatin n fr mre infrmatin. Linked Secret Key - please enter yur Linkedin Secret Key. ThisSecret Key can be retrieved frm Please review the dcumentatin n fr mre infrmatin. Username Prefix - enter a prefix if yu want the username t include a prefix fr each user created via Linkedin Cnnect r OAuth integratin. Stre UserID in Alternate Field - select a DtNetNuke prfile field that yu wuld like the Linkedin UserID stred in. This can be useful if yu are creating the username based n the address but wuld still like t have access t the Linkedin UserID field fr the future. Stre User Creatin Status in Alternate Field - select a DtNetNuke prfile field that yu wuld like t stre hw the user was created (i.e Linkedin Cnnect, r Linkedin Auth). This feature can help yu identify users created via the Linkedin Integratin. OAuth 2.0 Page Type - select the page type fr the OAuth 2.0 authenticatin integratin. This can include either a redirect page r a pp up page. Pst Status message t user select if yu wish t enable psting f the status message t the user Pst Message - please enter the message fr the user status pst. This will be the message f the Linkedin user status pst when a user signs in thrugh the Linkedin Integratin.

52 14 AUTO SIGN-IN FEATURE The Auth Sign In feature is a new feature which listens fr URL querystring parameters r a frm pst/http frm pst which will pass the user s infrmatin and direct them t a page f yur chice by als signing them in withut their knwledge Instructins fr setting up Aut Sign in Please fllw these steps t setup the aut sign-in: Pass the lgin page the querystring parameter autsignin with a value f True Optinally pass the lgin page the querystring parameter f signintype. This value shuld be Frm r Querystring and if left blank then the mdule will default t Querystring. Depending in f the sign in type if Frm r Querystring the users credentials shuld be passed via the frm r querystring variables as username and passwrd This feature allws yu t setup ther mdules that might be able t pass alng the sign in credentials t allw the user t be signed int the prtal, and/r als smething as simple as creating sign in link fr users where they can click n the link directly and sign int the prtal.

53 15 DROPDOWN LOGIN INTEGRATION SKIN OBJECT This simple jquery skin bject allws the ability fr the user t sign in withut being frced t anther lgin page, while als refreshing the current page the user is n after they are authenticated. This skin bject can be included in any skin and is cmpletely cntrlled via CSS. Check ut sme different and unique styles that yu culd setup t easily cntrl the lk f DrpDwn Lgin. Figure 62: Example 1 Figure 63: Example Instructins n implementing this feature Detailed instructins fr implementing this feature can be fund here n pages 3 and 4 f the Drp Dwn Lgin User Guide (PDF).