Cisco Ise 13 User Guide

							What to Do Next
Makesurethatyouupdateanychangesmadeintheselectedlanguagewhilecustomizingtheportalpageinto
allthesupportedlanguagepropertiesfiles.
Change the Portal Icons, Images, and Logos
Ifyouwanttouseuniquecorporatelogos,icons,andbannerimages,youcansimplyreplacetheexisting
imagesbyuploadingyourcustomimages.Supportedimageformatsinclude.gif,.jpg,.jpeg,and.png.These
changesapplytotheentireportalthatyouarecustomizing.
Before You Begin
Toincludeimagesinthefooteroftheportal,forinstanceinanadvertisement,youshouldbeabletoaccess
anexternalserverthathastheseimages.
Procedure
Step 1Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit>PortalPage
Customization.
•ForSponsorportals,chooseGuestAccess>SponsorPortals>Edit>PortalPageCustomization.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization.
Step 2UnderImages,clickanyofthelogos,icons,andimagebuttonsanduploadyourcustomimages.
Step 3ClickSave.
Update the Portal Banner and Footer Elements
Youcancustomizetheinformationthatappearsinthebannerandfootersectionsofeverypageintheportal.
Thesechangesapplytotheentireportalthatyouarecustomizing.
Procedure
Step 1Navigatetotheseportals:
•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit>PortalPage
Customization.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>PortalPage
Customization.
Cisco Identity Services Engine Administrator Guide, Release 1.3    
365
Basic Customization of Portals 
						

							•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization.
Step 2ChangetheBannertitlethatappearsoneveryportalpage.
Step 3Includetheselinksfortheguestswhouseyourportals:
•Help—Onlinehelp(providedforonlytheSponsorandMyDevicesportals).
•Contact—Technicalsupport(setuptheSupportInformationpagetoenablethis).
Step 4AddadisclaimeroracopyrightnoticeintheFooterElementstoappearonthebottomofeveryportalpage.
Step 5ClickSave.
Change the Titles, Instructions, Buttons, and Label Text
Youcanupdateallthetextthatisdisplayedintheportal.EachUIelementonthepagethatyouarecustomizing
hasaminimumandmaximumrangeforthenumberofcharactersthatyoucanenter.Whenavailableinsome
ofthetextblocks,youcanuseamini-editortoapplyvisualstylingtothetext.Thesechangesapplyonlyto
thespecificportalpageyouarecustomizing.Thesepageelementsaredifferentforemail,SMS,andprint
notifications.
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,choosethepagethatyouwanttochange.
Step 3UnderPageCustomizations,updateanyofthedisplayedUIelements.AllpagescontainBrowserPage
Title,ContentTitle,InstructionalText,Content,andtwoOptionalContenttextblocks.Thefieldsinthe
Contentareaarespecifictoeachpage.
Format and Style Text Box Content
Usethemini-editorthatisavailableintheInstructionalText,OptionalContent1,andOptionalContent
2textboxestodobasicformattingofthetext.Thesechangesapplyonlytothespecificportalpagesthatyou
arecustomizing.
UsetheToggleFullScreenbuttontoincreaseanddecreasethesizeofthetextboxesasyouworkinthem.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
366
Basic Customization of Portals 
						

							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,choosethepagethatyouwanttochange.
Step 3UnderPageCustomizations,intheInstructionalTextandOptionalContenttextblocks,youcan:
•Changethefont,size,andcolorofthetext.
•Stylethetextasbold,italics,orunderlined.
•Createbulletedandnumberedlists.
YoucanalsousetheToggleHTMLSourcebuttontoviewtheHTMLtagsthatwereappliedtothetextthat
youformattedusingthemini-editor.
Variables for Portal Pages Customization
Thenavigationpathsfortheseportalpagetextboxesare:
•ForGuestportals,chooseGuestAccess>Configure>GuestPortals>Edit>PortalPage
Customization>Pages.
•ForSponsorportals,chooseGuestAccess>Configure>SponsorPortals>Edit>PortalPage
Customization>Pages.
•ForDeviceportals,chooseAdministration>DevicePortalManagement>(anyPortals)>Edit
>PortalPageCustomization>Pages.
Usethesevariableswhencreatingtemplatesforportalcontentandguestnotificationstoenableconsistency
intheinformationpresentedtotheportalusers(guests,sponsors,andemployees).Substitutetextwiththe
variablenameslistedhereforeachoftheportalsintheInstructionalText,OptionalContent1,andOptional
Content2textboxes.
Table 18: List of Variables for Guest Portals
Substitute with Variable NameDisplay Name
ui_access_codeAccesscode
Usetoprovideanaccesscodetoguestsusingeither
email,textorprintnotifications.
Cisco Identity Services Engine Administrator Guide, Release 1.3    
367
Basic Customization of Portals 
						

							Substitute with Variable NameDisplay Name
ui_byod_success_ios_ssidBYODIOSSSID
Usetospecifythenetworkthatadeviceshould
connecttoafteron-boardinginadualSSIDflow.
ui_client_provision_agent_typeClientProvisioningAgentType
Usetospecifythecurrentlyconfiguredagentinthe
clientprovisioningpolicy,suchastheAnyConnect
agentortheNACagent.
ui_client_provision_agent_urlClientProvisioningAgentURL
UsetospecifythedownloadURLfortheposture
agent.
ui_client_provision_install_agent_minsClientProvisioningagentinstallminutes
Usetonotifygueststheamountoftime(setbythe
remediationtimer)inwhichtheymustcompletethe
installationinstructionsontheClientProvisioning
page.Ifguestsdonotcompletetheinstallation
instructionsbeforethetimerexpires,theymustrefresh
thebrowserpageandgothroughtheloginprocess
again.
ui_companyCompany
ui_email_addressEmailaddress
ui_end_date_timeEnddateandtime
ui_first_nameFirstname
ui_last_nameLastname
ui_location_nameLocationname
ui_max_reg_devicesMaximumregistereddevices
ui_max_siml_loginMaximumsimultaneouslogins
ui_passwordPassword
ui_person_visitedPersonbeingvisited(email)
ui_phone_numberPhonenumber
ui_reason_visitReasonforvisit
ui_sms_providerSMSProvider
   Cisco Identity Services Engine Administrator Guide, Release 1.3
368
Basic Customization of Portals 
						

							Substitute with Variable NameDisplay Name
ui_ssidSSID
Usetospecifythewirelessnetworkthataguestcan
usetoconnecttothenetwork.
ui_start_date_timeStartdateandtime
ui_time_leftTimeleft
ui_user_nameUsername
Table 19: List of Variables for Sponsor Portals
Substitute with Variable NameDisplay Name
ui_guest_companyGuest-Company
ui_guest_email_addressGuest-Emailaddress
ui_guest_end_date_timeGuest-Enddateandtime
ui_guest_first_nameGuest-Firstname
ui_guest_last_nameGuest-Lastname
ui_guest_location_nameGuest-Locationname
ui_guest_max_reg_devicesGuest-Maximumregistereddevices
ui_guest_max_siml_loginGuest-Maximumsimultaneouslogins
ui_guest_passwordGuest-Password
ui_guest_person_visitedGuest-Personbeingvisited(email)
ui_guest_phone_numberGuest-Phonenumber
ui_guest_reason_visitGuest-Reasonforvisit
ui_guest_sms_providerGuest-SMSProvider
ui_guest_ssidGuest-SSID
Usetospecifythewirelessnetworkthataguestcan
usetoconnecttothenetwork.
ui_guest_start_date_timeGuest-Startdateandtime
Cisco Identity Services Engine Administrator Guide, Release 1.3    
369
Basic Customization of Portals 
						

							Substitute with Variable NameDisplay Name
ui_guest_time_leftGuest-Timeleft
ui_guest_user_nameGuest-Username
ui_sponsor_user_nameUsername
Usetospecifytheusernameoftheuserloggedinto
theportal.
Table 20: List of Variables for MDM Portals
Substitute with Variable NameDisplay Name
ui_mdm_vendor_nameMDM-VendorName
Table 21: List of Variables for My Devices Portals
Substitute with Variable NameDisplay Name
$user_login_failure_rate_limit$MyDevices-LoginFailureRateLimit
ui_max_register_devicesMyDevices-MaxDevicestoRegister
$session_username$MyDevices-UserName
Usetospecifytheusernameoftheuserloggedinto
theportal.
View Your Customization
Youcanviewhowyourcustomizationwilldisplaytotheportalusers(guests,sponsors,oremployees).
•ClickPortaltestURLtoviewyourchanges.
ThetestportaldoesnotsupportRadiussessions,soyouwon'tseetheentireportalflowforallportals.
BYODandClientProvisioningareexamplesofportalsthatdependonRadiussessions.
Note
•ClickPreviewtodynamicallyviewhowyourchangesappearonvariousdevices:
◦Mobiledevices––ViewyourchangesunderPreview.
◦Desktopdevices—ClickPreviewandthenDesktopPreview.Anewtabopens,andallthechanges
thatyoumakearedisplayedonthistab.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
370
Basic Customization of Portals 
						

							Ifthechangesarenotdisplayed,clickRefreshPreview.Theportaldisplayedisonlymeantforviewing
yourchanges;youcannotclickbuttonsorenterdata.
Advanced Customization of Portals
IfyoudonotwanttouseoneofthedefaultportalthemesprovidedbyCiscoISE,youcancustomizetheportal
tosuityourneeds.Todoso,youshouldhaveexperienceworkingwithCSSandJavascriptfilesandthejQuery
MobileThemeRollerapplication.
Youarenotallowedtoalterthedefaultportalthemes,butyoucan:
•ExportaPortal’sDefaultThemeCSSFile,onpage376,anduseitasabaseforcreatingacustomportal
theme.
•CreateaCustomPortalThemeCSSFile,onpage377,byeditingthedefaultportalthemeandsavingit
asanewfile.
•ImporttheCustomPortalThemeCSSFile,onpage389,andapplyittotheportal.
Basedontheextentofyourexpertiseandrequirements,youcanperformvarioustypesofadvanced
customization,suchasusepredefinedvariablestoenableconsistencyindisplayedinformation,add
advertisementstoyourportalpages,useHTML,CSSandJavascriptcodetocustomizeyourcontent,and
modifytheportalpagelayout.
Configure Portal Customization
CiscoISEoffersyoutheabilitytocustomizethecontentthatdisplaysonyourend-userportalsusingHTML
andJavascriptcodeinthetextboxesonthedifferentpageslistedunderPortalPageCustomization.
Procedure
Step 1ChooseAdministration>System>AdminAccess>Settings>PortalCustomization.
Step 2VerifythatEnableportalcustomizationwithHTMLischeckedbydefault.Thissettingenablesyouto
includeHTMLtagsintheInstructionalText,OptionalContent1andOptionalContent2textboxes.
Step 3CheckEnableportalcustomizationwithHTMLandJavascriptifyouwanttodoadvancedJavaScript
customizationbyincludingtagsintheInstructionalText,OptionalContent1andOptional
Content2textboxes.
What to Do Next
YoucanthenaccessthevariousportalsandenterHTMLandJavascriptcodeinthetextboxesbasedonthe
optionyouenabledhere.
Portal Theme and Structure CSS Files
IfyouhaveexperiencewithworkingwithCSSfiles,youcancustomizethedefaultportalthemeCSSfilesto
altertheportalpresentationandmanipulateelementssuchasthepagelayout,colors,andfonts.Customizing
theCSSfilesprovidesyouwithflexibilityandcontrolinspecifyingthepresentationcharacteristics,itenables
Cisco Identity Services Engine Administrator Guide, Release 1.3    
371
Advanced Customization of Portals 
						

							youtoshareformattingacrossmultiplepages,anditreducesthecomplexityandrepetitioninthestructural
content.
CiscoISEend-userportalsusetwodistincttypesofCSSfiles:structure.cssandtheme.css.Everyportaltheme
hasitsowntheme.cssfile,butthereisonlyonestructure.cssfileperportaltype;forexampleguest.structure.css
forGuestportals,sponsor.structure.cssforSponsorPortals,andmydevices.structure.cssforMyDevices
portals.
Thestructure.cssprovidesthestylingforthepagelayoutandstructure.Itdefinesthepositioningofelements
oneachpageandalsoincludesjQueryMobilestructurestyles.Youcanonlyviewthestructure.cssfile,but
youcannoteditit.However,whenyouchangethepagelayoutwithintheme.cssfiles,importthesefilesinto
theportal,andapplythem,themostrecentchangestakepriorityoverthestructure.cssstyles.
Thetheme.cssfilesspecifystylessuchasfonts,buttoncolors,andheaderbackground.Youcanexportthe
theme.cssfiles,changethethemesettings,andimportthemtouseascustomthemesforyourportal.Anypage
layoutstylechangesmadetothetheme.cssfilestakepriorityoverthestylesthataredefinedinthestructure.css
file.
YoucannotalteranyoftheCiscoprovideddefaultportaltheme.cssfiles.However,youcaneditthesettings
inthefilesandsavethemtoanewcustomtheme.csstheme.cssfile.Youcanmakefurthereditstothecustom
theme.cssfile,butwhenyouimportitbackintoCiscoISE,remembertousethesamethemenameyou
originallyusedforit.Youcannotusetwodifferentthemenamesforthesametheme.cssfile.
Forexample,youcanuseadefaultgreentheme.cssfiletocreateanewcustombluetheme.cssfileandname
itasBlue.Youcantheneditthebluetheme.cssfile,butwhenyouimportitagain,youmustreusethesame
Bluethemename.YoucannotcallitRed,sinceCiscoISEchecksfortherelationshipbetweenafilenameand
itsnameandtheuniquenessofthetheme’sname.Youcanhowevereditthebluetheme.cssfile,saveitasred
theme.css,importthenewfile,andnameitasRed.
About Changing Theme Colors with jQuery Mobile
ThecolorschemeofCisco'send-userportalsiscompatiblewithjQueryThemeRoller.Youcaneasilyeditthe
colorsforanentireportalusingtheThemeRollerwebsite.
ThemeRollercolor“swatches”eachcontainauniquecolorscheme,whichdefinesthecolors,textures,and
fontsettingsfortheprimaryUIelements,suchastoolbars,contentblocks,buttons,listitems,andfont
text-shadow.Acolorschemealsodefinesthesettingsforvariousinteractionstatesofthebuttons:normal,
hover,andpressed.
Ciscousesthreeswatches:
•SwatchA—Thedefaultswatch.
•SwatchB—Definesemphasizedelements,suchasanAcceptbutton.
•SwatchC—Definescriticalelementssuchasalerts,errormessages,invalidinputfields,anddelete
buttons.
Youcannotapplyadditionalswatches,unlessyouaddHTMLcode(totheOptionalContent,forexample)
withelementsthatusethenewlyaddedswatches.
ToeditthedefaultCisco-providedCSSfilesorcreatenewfilesbasedontheCSSclassesandstructures
definedinthedefaultthemes,usetherequiredversionofjQueryMobileThemeRoller(Release1.3.2).
ForadditionalinformationonswatchesandthemesinjQueryMobileThemeRoller,see"ThemingOverview"
inCreatingaCustomThemewithThemeRoller.UsetheonlinehelpinjQueryMobileThemeRollertolearn
howtodownload,import,andshareyourcustomthemes.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
372
Advanced Customization of Portals 
						

							FortutorialsonhowtouseHTML,CSS,andJavascriptcodetocustomizethetextandcontentthatappears
onyourportalpages,visitCodeAcademy.
Example of a Theme That Shows Cisco Swatches
Todemonstratehowswatchesareused,thedefaultthemefortheGuestPortalwaseditedinThemeRollerto
showthedifferencesincolor.
Thefollowingscreenshowsaguestportallogonerror(swatchC)alongwithabuttonthattakesanaction
fromtheuser(swatchB),andtherestofthescreenisSwatchA.
Cisco Identity Services Engine Administrator Guide, Release 1.3    
373
Advanced Customization of Portals 
						

							Change Theme Colors with jQuery Mobile
Before You Begin
Makesureyouareusingversion1.3.2ofjQueryMobileThemeRoller.Theversionyouareusingisdisplayed
inthetop-leftcornerofthescreen,asshownbelow.
   Cisco Identity Services Engine Administrator Guide, Release 1.3
374
Advanced Customization of Portals