Cisco Ise 13 User Guide

							Customize Greetings Based on User Device Type
Youcancustomizethegreetingsthatyousendtoyourusers(guest,sponsor,oremployee)aftertheyloginto
anyoftheCiscoISEend-userwebportals(Guest,SponsorandDevice),basedontheirclientdevicetype
(mobileordesktop).
UsetheToggleFullScreenbuttontoincreaseanddecreasethesizeofthetextboxesasyouworkinthem.
Procedure
Step 1Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit>PortalPage
Customization.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>PortalPage
Customization.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization.
Step 2UnderPages,choosethepagethatyouwanttoupdate.
Step 3UnderPageCustomizations,usethemini-editorprovidedwiththeOptionalContent1textboxtoenter
andviewHTMLsourcecode.
Step 4ClicktheToggleHTMLSourcebutton.
Step 5Enteryoursourcecode.
Forexample,toincludeadevicetype-basedgreetingontheAUPpage,enterthiscodeintheOptionalContent
1textboxontheAUPpage:

.custom-greeting{
display:none;
}
.cisco-ise-desktop.custom-desktop-greeting{
display:block;
}
.cisco-ise-mobile.custom-mobile-greeting{
display:block;
}


TryourNewDarkFrenchRoast!PerfectontheGo!


WebroughbackourTripleChocolateMuffin!
Grabaseatanddigin!

UserswillseeadifferentgreetingontheAUPpagedependingonthetypeofdevicetheyusedtogainaccess
tothenetworkorportal.
Cisco Identity Services Engine Administrator Guide, Release 1.3    
385
Advanced Customization of Portals 
						

							Modify the Portal Page Layout
Youcanmanipulatetheoveralllayoutofthepages;forexample,youcanaddasidebartoanAUPpagethat
providesadditionalinformationorlinkstoinformation.
Procedure
Step 1AddthefollowingCSScodetothebottomofthecustomtheme.cssfilethatyoucreateandplantoapplyto
yourportal.ThischangestheAUPpagelayoutsothattheOptionalContent1textboxappearsas:
•Asidebarinthedesktopdevicemode
•Asidebarinthemobiledevicemode
#page-aup.cisco-ise-optional-content-1{
margin-bottom:5px;
}
@mediaalland(min-width:60em){
#page-aup.cisco-ise-optional-content-1{
float:left;
margin-right:5px;
width:150px;
}
#page-aup.cisco-ise-main-content{
float:left;
width:800px;
}
#page-aup.cisco-ise-main-contenth1,
#page-aup.cisco-ise-main-contentp{
margin-right:auto;
margin-left:-200px;
}
}
YoucanthenaddlinksusingHTMLcodeintheOptionalContent1textboxfortheAUPpageforthat
portal.
Step 2Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit>PortalPage
Customization.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>PortalPage
Customization.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization.
Step 3UnderPages,choosethepageforwhichyouwanttoincludeasidebar.
Step 4UnderPageCustomizations,usethemini-editorprovidedwiththeOptionalContent1textboxtoenter
andviewsourcecode.
Step 5ClicktheToggleHTMLSourcebutton.
Step 6Enteryoursourcecode.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
386
Advanced Customization of Portals 
						

							Forexample,toincludeasidebarfortheAUPpage,enterthiscodeintheOptionalContent1textboxon
theAUPpage:

RentaCar
Top10Hotels
FreeMassage
Cisco Identity Services Engine Administrator Guide, Release 1.3    
387
Advanced Customization of Portals 
						

							ZumbaClasses

Figure 26: View of a Side Bar on a Sample AUP Page (on a Desktop Device)
Figure 27: View of a Side Bar on a Sample AUP Page (on a Mobile Device)
Step 7ClickSave.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
388
Advanced Customization of Portals 
						

							What to Do Next
YoucancustomizeotherpagesbyenteringdifferenttextorHTMLcodeintheOptionalContenttextboxes.
Import the Custom Portal Theme CSS File
Youcanuploadanycustomtheme.cssfilethatyouhavecreatedandapplyittoanyofyourend-userportals.
Thesechangesapplytotheentireportalthatyouarecustomizing.
Anytimeyoueditacustomtheme.cssfileandimportitbackintoCiscoISE,remembertousethesametheme
nameyouoriginallyusedforit.Youcannotusetwodifferentthemenamesforthesametheme.cssfile.
Procedure
Step 1Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>GuestPortals>Edit>PortalPageCustomization.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>PortalPage
Customization.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization.
Step 2FromtheAdvancedCustomizationdrop-downlist,chooseExport/ImportThemes.
Step 3IntheCustomThemingdialogbox,clickBrowsetofindyournewtheme.cssfile.
Step 4EnteraThemeNameforthenewfile.
Step 5ClickSave.
What to Do Next
Youcanapplythiscustomportalthemetotheportalthatyouwanttocustomize.
1ChoosetheupdatedthemefromthePortalThemesdrop-downlisttoapplytotheentireportal.
2ClickSave.
Delete a Custom Portal Theme
YoucandeleteanycustomportalthemethatyouhaveimportedintoCiscoISE,unlessitisbeingusedbyone
ofyourportals.YoucannotdeleteanyofthedefaultthemesprovidedbyCiscoISE.
Before You Begin
Theportalthemethatyouwanttodeleteshouldnotbeusedbyanyoftheportals.
Procedure
Step 1Navigatetotheseportals:
Cisco Identity Services Engine Administrator Guide, Release 1.3    
389
Advanced Customization of Portals 
						

							•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit>PortalPage
Customization.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>PortalPage
Customization.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization.
Step 2FromtheAdvancedCustomizationdrop-downlist,chooseDeleteThemes.
Step 3SelecttheportalthemethatyouwanttodeletefromtheThemeNamedrop-downlist.
Step 4ClickDeleteandthenSave.
View Your Customization
Youcanviewhowyourcustomizationwilldisplaytotheportalusers(guests,sponsors,oremployees).
•ClickPortaltestURLtoviewyourchanges.
ThetestportaldoesnotsupportRadiussessions,soyouwon'tseetheentireportalflowforallportals.
BYODandClientProvisioningareexamplesofportalsthatdependonRadiussessions.
Note
•ClickPreviewtodynamicallyviewhowyourchangesappearonvariousdevices:
◦Mobiledevices––ViewyourchangesunderPreview.
◦Desktopdevices—ClickPreviewandthenDesktopPreview.Anewtabopens,andallthechanges
thatyoumakearedisplayedonthistab.
Ifthechangesarenotdisplayed,clickRefreshPreview.Theportaldisplayedisonlymeantforviewing
yourchanges;youcannotclickbuttonsorenterdata.
Portal Language Customization
TheGuest,Sponsor,MyDevices,andClientProvisioningportalsarelocalizedintoallsupportedlanguages
andlocales.Thisincludestext,labels,messages,fieldnames,andbuttonlabels.Iftheclientbrowserrequests
alocalethatisnotmappedtoatemplateinCiscoISE,theportalsdisplaycontentusingtheEnglishtemplate.
UsingtheAdminportal,youcanmodifythefieldsusedfortheGuest,Sponsor,andMyDevicesportalsfor
eachlanguageindividually,andyoucanaddmorelanguages.Currently,youcannotcustomizethesefields
fortheClientProvisioningportal.
Bydefault,eachtypeofportalsupports15languages.Youselectwhichlanguageaportaluses,andoptionally
updatepagecontentforthatlanguage,onthePortalPageCustomizationpage.Note,ifyouchangefontsand
contentonthepageforonelanguage,thosechangestonotcarryoverintotheotherlanguages.Thechanges
youmakeonthePortalPageCustomizationscreenareincludedwhenyouexporttheLanaguageFile.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
390
Portal Language Customization 
						

							NACandMACagentinstallersandWebAgentpagesarenotlocalized.Note
To Edit the Language Used by a Portal
1Opentheportalyouwanttoedit.
2OnthePortalPageCustomizationtab,andnearthetopofthepage,selectthelanguageyouwanttoedit
intheviewindrop-down.
3Changecontent,headings,andfontsasdesired.
4Savethatportalconfiguration,andrepeatthisflowforthenextlanguagesyouwanttoupdate.
To Edit the Language File
EachPortalPageCustomizationpagealsoprovidesaLanguageFile.TheLanguageFileisaZIPofattribute
filesthatyoucanusetocustomizeheadingsandtextthatarepartoftheportalflow,butisnotavailableto
customizeonthePortalPageCustomizationpage.
TheLanguageFilealsocontainsthemappingtotheparticularbrowserlocalesetting(forexample,forFrench:
fr,fr-fr,fr-ca)alongwithallofthestringsettingsfortheentireportalinthatlanguage.Ifyouchangethe
browserlocalesettingforonelanguage,thechangeisappliedtoalltheotherend-userwebportals.For
example,ifyouchangetheFrench.propertiesbrowserlocalefromfr,fr-fr,fr-catofr,fr-frintheHotspotGuest
portal,thechangeisappliedtotheMyDevicesportalalso.
Youcanexportthezippedlanguagefileandmakeupdatestoit,includingaddingnewlanguagesordeleting
existingonesyoudonotneed.
ForinstructionsabouthowtoupdatetheLanguageFile,see:
•ExporttheLanguageFile,onpage391
•AddorDeleteLanguagesfromtheLanguageFile,onpage392
•ImporttheUpdatedLanguageFile,onpage393
Export the Language File
Youcanexportthelanguagefileavailableforeachportaltypetoeditandcustomizetheexistingvalues
specifiedinit,andaddordeletealanguage.
OnlysomeofthedictionarykeysinthelanguagepropertiesfilessupportHTMLintheirvalues(text).Note
Procedure
Step 1Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>Configure>Edit
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit
Cisco Identity Services Engine Administrator Guide, Release 1.3    
391
Portal Language Customization 
						

							•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
Step 2ClickLanguageFileandchooseExportfromthedrop-downlist.
Step 3Savethezippedlanguagefiletoyourdesktop,forexample:Hotspot.zip,Self-Registered.zip,andsoon.
Add or Delete Languages from the Language File
Ifalanguageyouwanttouseforyourportaltypeismissingfromthelanguagefile,youcancreateanew
languagepropertiesfileandaddittothezippedlanguagefile.Iftherearelanguagesyoudonotneed,youcan
deletetheirlanguagepropertiesfiles.
Before You Begin
Exportthezippedlanguagefileavailablewitheachportaltypeinordertoaddordeletelanguageproperties
files.
Procedure
Step 1UseanyeditorthatdisplaysUTF-8(suchasNotepad++)toopenthepredefinedlanguagefilefortheportal
typetowhichyouwanttoaddordeletelanguages.
Ifyouwanttoaddordeletelanguagesformorethanoneportaltype,usealltheappropriateportalproperties
files.
Step 2Toaddanewlanguage,saveanexistinglanguagepropertiesfileasthenewlanguagepropertiesfileusing
thesamenamingconventionoftheotherfilesinthezippedlanguagefile.Forexample,tocreateanewJapanese
languagepropertiesfile,savethefileasJapanese.properties(LanguageName.properties).
Step 3Associatethenewlanguagewithitsbrowserlocalebyspecifyingthebrowserlocalvalueinthefirstlineof
thenewlanguagepropertiesfile.Forexample,LocaleKeys=ja,ja-jp(LocaleKeys=browserlocalevalue)
shouldbethefirstlineintheJapanese.propertiesfile.
Step 4Updateallthevalues(text)ofthedictionarykeysinthenewlanguagepropertiesfile.
Youcannotchangethedictionarykeys;justtheirvalues.
OnlysomeofthedictionarykeyssupportHTMLintheirvalues
(text).
Note
What to Do Next
1Zipallthepropertiesfiles(newandexisting)andcreateanewzippedlanguagefile.Donotincludeany
foldersordirectories.
2Useanewnameoritsoriginalnameforthezippedlanguagefile.
3Importthezippedlanguagefileintothespecificportalyouexporteditfrom.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
392
Portal Language Customization 
						

							Import the Updated Language File
Youcanimportaneditedlanguagefilethatyouhavecustomizedbyaddingordeletinglanguageproperties
filesorbyupdatingtextinexistingpropertiesfiles.
Procedure
Step 1Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit.
Step 2ClickLanguageFileandchooseImportfromthedrop-downlist.
Step 3Browsetofindthenewzippedlanguagefileonyourdesktop.
Step 4Importitbackfortheportaltypefromwhereyouexportedit.
What to Do Next
Todisplaythechangedtextorthenewlanguageyouadded,selectthespecificlanguagefromtheViewIn
drop-downlist.
Customization of Guest Notifications, Approvals, and Error Messages
Withinineachportal,youcancustomizehowguestsreceivenotificationsviaemail,SMStextmessages,and
print.Usethesenotificationstoemail,text,orprintthelogincredentials:
•WhenguestsusetheSelf-RegistrationGuestportalandsuccessfullyregisterthemselves.
•Whensponsorscreateguestaccountsandwanttoprovidethedetailstoguests.Whenyoucreatesponsor
groups,youcandeterminewhethertoauthorizesponsorstouseSMSnotifications.Theycanalways
useemailandprintnotifications,ifthesefacilitiesareavailable.
Youcanalsocustomizeemailnotificationstosponsorsrequestingthattheyapproveaself-registeringguest
tryingtogainaccesstothenetwork.Additionally,youcancustomizethedefaulterrormessagesthatdisplay
toguestsandsponsors.
Customize Email Notifications
Youcancustomizetheinformationthatissentviaemailtoguests.
Before You Begin
•ConfiguretheSMTPservertoenableemailnotifications.ChooseAdministration>System>Settings
>SMTPServer.
Cisco Identity Services Engine Administrator Guide, Release 1.3    
393
Customization of Guest Notifications, Approvals, and Error Messages 
						

							•Configuresupportforemailnotificationstoguests.ChooseGuestAccess>Settings>GuestEmail
Settings.CheckEnableemailnotificationstoguests.
•EnsurethatEnableportalcustomizationwithHTMLisenabledbydefaultinAdministration>
System>AdminAccess>Settings>PortalCustomization.
Procedure
Step 1ForSelf-RegisteredSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>
PortalPageCustomization>NotifyGuests>EmailNotification.
Step 2YoucanchangethedefaultLogo(Email)thatwasspecifiedunderGlobalPageCustomizations.
Step 3SpecifytheSubjectandEmailbody.Usepredefinedvariablestospecifytheguestaccountinformationto
beincludedintheemailmessage.Usethemini-editorandHTMLtagstocustomizethetext.
Step 4UnderSettings,youcan:
•Sendusernameandpasswordseparatelyindifferentemails.Ifyouselectthisoption,twoseparate
tabsappearinPageCustomizationsforcustomizingtheUsernameEmailandPasswordEmail
notifications.
•SendTestEmailtoyouremailaddresstopreviewyourcustomizationonalldevicestoensurethatthe
informationappearsasitshould.
Step 5ClickSaveandthenClose.
Customize SMS Text Message Notifications
YoucancustomizetheinformationthatissentviaSMStextmessagestoguests.
Before You Begin
•ConfiguretheSMTPserver,whichisusedtosendemailstotheSMSgatewaytodelivertheSMStext
message.ChooseAdministration>System>Settings>SMTPServer.
•ConfigurethesponsorgroupstosupporttheSMStextnotification.
•Setupanaccountwithathird-partySMSgateway.ChooseAdministration>Systems>Settings>
SMSGateway.CiscoISEsendsthetextmessagesasemailmessagestothegateway,whichforwards
themessagesviatheSMSprovidertothespecifieduser.
•EnsurethatEnableportalcustomizationwithHTMLisenabledbydefaultinAdministration>
System>AdminAccess>Settings>PortalCustomization.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
394
Customization of Guest Notifications, Approvals, and Error Messages