Welcome

ThishelpmanualdocumentstheVanDykeSoftware®SecureCRT®,version7.1terminalemulationpackage.Ifyoudonotfindtheinformationyouneedhere,orifyouhaveanycommentsorsuggestions,pleasevisitthefollowingwebpage:

http://www.vandyke.com/feedback.php

ForthelatestinformationonSecureCRTandVanDykeSoftware,checkoutourhomepage:

http://www.vandyke.com

Makesureyoudon'tmissimportantsoftwarereleasesandupdates.SubscribetoourproductmailingliststoreceiveemailnotificationswhennewreleasesofVanDykeproductsareannounced.

https://secure.vandyke.com/cgi-bin/subscribe.php?PID=3

Forin-depthtips,callsfortesters,andoverviewsofthelatestbetaandofficialreleases,visittheVanDykeSoftwareWhat'sNewpage:

http://whatsnew.vandyke.com

Thankyou!TheSecureCRTProductTeam

Copyrightandtrademarknotices

NewinSecureCRT7.1

SecureCRT7.1bringstiledsessionstoMacandLinuxversions,addsanoptiontosetupdependentsessionsforconnectingwithjumphosts,andextendsfiletransferoptionswithKermitsupport.Productivityimprovementsincludetheabilitytosendabuttonbarcommandtoallsessionsandtooptimizedatatransferspeedwithanewsenddelayoption.HerearesomeofthenewfeaturesinSecureCRT7.1:TilingforMacandLinux

SessiontilingisnowavailableonWindows,Mac,andLinux.Sessionscanbetiledorcascadedtocomparethecontentsoftwoormoresessions;usethechatwindowtosendcommandstoallsessionsandseetheresultingoutput.

DependentsessionoptionLinkasessiontoanSSH2sessionthatitdependson,whichallowsconnectiontoajumphostbeforeconnectingtoothersessions.

KermitsupportSupportfortheKermitprotocolprovidesanadditionalwaytotransferfiles.

ButtonbarenhancementsPressSHIFT+<click>onabuttontosendabuttonbarcommandtoallconnectedtabbedortiledsessions.

NewcharactersenddelayoptionAcharactersenddelayoptiontowaitforatextpromptallowsdatatobesentasfastasthesystemcanhandle,ratherthanusingafixedtimedelay.

SupportforSHA1inRSAsignaturesSupportforSHA1inRSAsignatures,inadditiontoMD5,allowsX.509certificatestobeusedinFIPSmode.

IntegrationwithSecureFXforMacandLinuxWiththeavailabilityofSecureFXforMacandLinux,integrationbetweenSecureCRTandSecureFXonMacandLinuxisnow

possible.PleaseseeHistory.txtintheSecureCRTprogramgroupforadditionalinformationonotherchangesandbugfixes.

WhatisSecureCRT?

SecureCRTprotectsyourpasswords,useraccounts,anddata,combiningrock-solidterminalemulationwiththestrongencryption,broadauthenticationoptions,anddataintegrityoftheSecureShellprotocol.SecureCRTprovidesversatilesolutionsforabusiness,networkmanagement,informationsecurity,anddevelopmenttasks,fromaccessinghost-basedapplicationsandadministeringserverstosecurelyaccessingbehind-the-firewallnetworkresourceslikeemail,files,andprinters.SecureCRTsupportsSSH1,SSH2,Telnet,Telnet/SSL,RLogin,Serial,andTAPIprotocolsandauthenticationviapassword,publickey,X.509certificate,andKerberosv5viaGSSAPI.CiphersincludeAES,AES-CTR,Twofish,Blowfish,3DES,andRC4.ChoosefromawiderangeofterminalemulationsincludingVT100,VT102,VT220,ANSI,SCOANSI,Wyse50/60,Xterm,andLinuxconsole–allwithANSIcolor.Unicodesupportincludestheabilitytodisplaycharactersetsfrommultiplelanguages,supportforlanguageswithright-to-leftreadingorder,andacharacterencodinglistthatincludescommonly-usedencodingsaswellasallencodingssupportedbythelocalsystem.SecureCRTfeaturesamulti-sessiontabbedortiledinterfacewithextensivesessionmanagementandcustomizationfeatures.Customizationoptionsincludetoolbars,menus,keymaps,buttonbar,andloginscripts,aswellasfonts,cursors,andcolorschemes.Namedsessionsandfirewallsletyoucreateindividualconfigurationsthatcanbeusedonasession-specificbasis.Otherfeaturesincludeautologon,printing,Emacsmode,andSOCKSfirewallsupport.Powerfulscriptingcapabilities,includingActiveXscriptingsupportforVBScriptandotherscriptinglanguagesonWindowsandembeddedPythonsupport,saveyouvaluabletimebyautomatingroutineconfigurationtasks.SecurefiletransferscanbeperformedusingSFTPorbyusingZmodem,Xmodem,Ymodem,orKermitfromanSSH1orSSH2session.UploadfileseasilybydragginganddroppingthemontoanSFTPtaborsessionwindow.

SavestepswiththecloseintegrationofSecureCRTandtheSecureFX®filetransferclient,whichsharesessionsandsettingsthatletyourunSFTP,FTP,SCP,andFTP/SSLfiletransfersessionswithoutreenteringpasswords.ForalistofnewfeaturesinSecureCRT,seeNewinSecureCRT7.1.

SupportforSSH1andSSH2SecureShellprotocols•SSH2Protocolsupport:

•AES-128,AES-192,AES-256,AES-128-CTR,AES-192-CTR,AES-256-CTR,Twofish,Blowfish,3DES,andRC4ciphers.

•RSAandDSAhostkeysupport.•Multipleorderedauthenticationmethods,ciphersandMACs.•PublicKeyAssistantmakesiteasiertouploadpublickeys.•Localportforwarding,X11forwarding,remoteforwarding,and

dynamicforwarding.•OpenSSHAgentforwarding.•MD5,MD5-96,SHA1,andSHA1-96MACs.•RSA,DSA,public-key,X.509certificate,PKCS#11,PKCS#12,

Kerberosv5viaGSSAPI,andpasswordauthenticationmethods.•SFTPtabcreatesanSFTPsessiontoanexistingSSHsession.•Passphraseandpasswordcachingoptions.

•SSH1Protocolsupport:•Blowfish,DES,3DES,andRC4ciphers.•RSA,TIS,andpasswordauthentication.•Localportforwarding,X11forwarding.

SessionManagement•Namedsessionsstoredifferentpreferencesfordifferenthosts.•Tabbedsessionsallowmultiplesessionsinthesamewindow.•Tabbedsessionscanbemovedinandoutofwindows.•Launchmultipleselectedsessionsintabswithasingleclick.•Tilingallowsmultiplesessionstobeviewedatonce.•Asessioncanbeloggedtoafile,includingoptionsforlogging

customdataandanoptionforcreatinganewlogfileatmidnight.

•BuiltinSSHagentallowskeystobeexplicitlyaddedandremoved.

Configuration&Customization•EasyconfigurationofbasicSSH,portforwarding,remote

forwardingandothersettingsinSessionOptionsdialog.•Namedfirewalls.•Dependentsessionoption(jumphost).•Customizabletoolbarandmenus.•User-definednumberofsavelines(scrollback)upto128,000.•User-configurablenumberofrowsandcolumns.•User-definedforeground,background,andboldcolors.•User-definedkeymaps.•User-definedbuttonbar.•User-definedworddelimitercharactersfordouble-click.•EmacsmodemapsALT+<key>tosendESC+<key>.•Real-timekeywordhighlighting.

AdvancedTerminalEmulation•QualityVT100,VT102,VT220,Linuxconsole,SCOANSI,Wyse

50/60,Xterm,andANSIemulation:•VTlinedrawing.•Supportforbold,underline,andreverseattributes.•Double-widthanddouble-heightfonts.•80/132columnswitching.•VT100andVT220keyboardemulation.•OptionalANSIcolor.•256-colorXterm.•Xtermextensionsformousesupportandchangingtitlebar.•Multi-bytecharactersetsupportforJapanese,Korean,and

Chinese.•Unicodesupportincludestheabilitytodisplaycharactersets

frommultiplelanguages,supportformulti-bytecharactersets,right-to-leftreadingorderlanguages,andanextensivecharacterencodinglist.

OtherFeatures•FIPS140-2validatedcryptographiclibrarysupport.•Variablecompressionincreasesperformanceonslowconnections.•Simpleinterfaceforautomatinglogins.•SupportforTelnet,Telnet/SSL,andRLoginprotocols:

•TelnetsupportsNegotiateAboutWindowSize(NAWS).•TelnetsupportsLocalFlowcontrol(LFLOW).

•Serial(COM)devicesupport.•IntegrationwithSecureFX3.xorhigher.•ScriptinglanguagesupportforVBScript,JScript,andPerlscript.•Scriptrecorder.•EmbeddedsupportforPythonscripting.•Zmodem,Xmodem,Ymodem,andKermitfiletransfer(uploadand

download).•Built-inTFTPserver.•Drag-and-dropfiletransfer(upload).•Printing:autoprint,selection,screen,andpass-throughprinting.•Modemdialersupport-configureandsavemodem,countrycode,

phone,andredialsettingsforTAPIsessions.•SOCKSfirewallsupportwithpasswordauthentication.•UnauthenticatedandbasicHTTPproxysupport.•Genericproxyfirewallsupport.•Copyandpaste,includingan"autocopy"optionandpasteon

middleorrightmouseclick.•Chatwindowoptionprovidesaneditabletype-aheadbufferwith

historysupportandtheabilitytosendchattexttoalltabsortoalltiledsessions.

•Supportforusefromthecommandlineorwebbrowsers.•Supportforstandardinsertioncaretsothatitcanbetrackedby

screenaccesstechnologyfortheblind.

SystemRequirements

MinimumSystemRequirements·Windows®Server®2008R2·Windows7·WindowsServer2008·WindowsVista®·WindowsServer2003R2·WindowsServer2003·WindowsXP·InternetExplorer5.5orlater

Note:64-biteditionsoftheaboveplatformsaresupported.

LicenseAgreement

End-UserLicenseAgreementforSecureCRT7.1("Software")Copyright(c)1995-2013VanDykeSoftware,Inc.AllRightsReserved.AGREEMENT.Afterreadingthisagreementcarefully,ifyou("Customer")donotagreetoallofthetermsofthisagreement,youmaynotusethisSoftware.UnlessyouhaveadifferentlicenseagreementsignedbyVanDykeSoftware,Inc.thatcoversthiscopyoftheSoftware,youruseofthisSoftwareindicatesyouracceptanceofthislicenseagreementandwarranty.AllupdatestotheSoftwareshallbeconsideredpartoftheSoftwareandsubjecttothetermsofthisAgreement.ChangestothisAgreementmayaccompanyupdatestotheSoftware,inwhichcasebyinstallingsuchupdate,CustomeracceptsthetermsoftheAgreementaschanged.TheAgreementisnototherwisesubjecttoaddition,amendment,modification,orexceptionunlessinwritingsignedbyanofficerofbothCustomerandVanDykeSoftware,Inc.ThisSoftwareisownedbyVanDykeSoftware,Inc.andisprotectedbynationalcopyrightlawsandinternationalcopyrighttreaties.1.EXPORTLAW.ThisSoftwareissubjecttoexportcontrol.TheSoftwaremaybetransmitted,exported,orre-exportedonlyunderapplicableexportlawsandrestrictionsandregulationsoftheUnitedStatesBureauofIndustryandSecurityorforeignagenciesorauthorities.BydownloadingorusingtheSoftware,youareagreeingtocomplywithexportcontrols.TheSoftwaremaynotbedownloadedorotherwiseexportedorre-exportedtoanycountrysubjecttoU.S.tradesanctionsgoverningtheSoftware,sanctionedcountriesincludingCuba,Iran,NorthKorea,Sudan,andSyria,orbycitizensorresidentsofsuchcountriesexceptcitizenswhoarelawfulpermanentresidentsofcountriesnotsubjecttosuchsanctions,orbyanyoneontheU.S.TreasuryDepartment'slistofSpeciallyDesignatedNationalsandBlockedPersonsortheU.S.CommerceDepartment'sTableofDenialOrders.

2.GRANTOFLICENSEANDPROHIBITIONS.ThisSoftwareislicensedtoyou.YouarenotobtainingtitletotheSoftwareoranycopyrights.Youmaynotsublicense,rent,lease,convey,modify,translate,converttoanotherprogramminglanguage,decompile,ordisassembletheSoftwareforanypurpose.Thelicensemaybetransferredtoanotherindividual(notresold)ifyoukeepnocopiesoftheSoftware.PermissionmustbeobtainedbeforemirroringorredistributingtheevaluationcopiesoftheSoftware.3.USEANDEVALUATIONPERIOD.YoumayuseonecopyofthisSoftwareononeclientcomputer.AcopyofthisSoftwareisconsideredinusewhenloadedintotemporarymemory(i.e.,RAM)and/orinstalledonapermanentstoragedevice(i.e.,harddisk,CD-ROM,etc.).YoumayalsouseacopyoftheSoftwareonahomeorportablecomputer,providedonlyonecopyoftheSoftwareisinuseatatime.YoumayuseanevaluationcopyoftheSoftwareforonlythirty(30)daysinordertodeterminewhethertopurchasetheSoftware.4.MULTI-COMPUTERLICENSES.Ifthisisamulti-computerlicense,youmaymake,install,anduseadditionalcopiesofthisSoftwareuptothenumberofcopiesauthorizedinyourregistrationdocumentation.UnlessyouhaveaterminalserverlicenseagreementsignedbyVanDykeSoftware,Inc.,useofthisSoftwareisnotallowedinenvironmentsinwhichtheSoftwareislocatedonacentralserverandisaccessedbymultiplecomputers.Ifthisisaneducationallicense,useisrestrictedtonon-commercialusebystudents,faculty,andstaffusingcampusfacilities,andtooff-campusnon-commercialusebystudents,faculty,andstaffprimarilyforschoolbusiness.5.LIMITEDWARRANTY.THESOFTWAREISPROVIDEDASISANDVANDYKESOFTWAREDISCLAIMSALLWARRANTIESRELATINGTOTHISSOFTWARE,WHETHEREXPRESSEDORIMPLIED,INCLUDINGBUTNOTLIMITEDTOANYIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSE.6.LIMITATIONONDAMAGES.NEITHERVANDYKESOFTWARENORANYONEINVOLVEDINTHECREATION,PRODUCTION,ORDELIVERYOFTHISSOFTWARESHALLBELIABLEFORANYINDIRECT,CONSEQUENTIAL,ORINCIDENTALDAMAGESARISING

OUTOFTHEUSEORINABILITYTOUSESUCHSOFTWAREEVENIFVANDYKESOFTWAREHASBEENADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGESORCLAIMS.INNOEVENTSHALLVANDYKESOFTWARE'SLIABILITYFORANYDAMAGESEXCEEDTHEPRICEPAIDFORTHELICENSETOUSETHESOFTWARE,REGARDLESSOFTHEFORMOFCLAIM.THEPERSONUSINGTHESOFTWAREBEARSALLRISKASTOTHEQUALITYANDPERFORMANCEOFTHESOFTWARE.7.TERMINATION.ThisAgreementterminatesonthedateofthefirstoccurrenceofeitherofthefollowingevents:(1)Theexpirationofone(1)monthfromwrittennoticeofterminationfromCustomertoVanDykeSoftware,Inc.;or(2)OnepartymateriallybreachesanytermsofthisAgreementoranytermsofanyotheragreementbetweenCustomerandVanDykeSoftware,Inc.,thatareeitheruncorrectableorthatthebreachingpartyfailstocorrectwithinone(1)monthafterwrittennotificationbytheotherparty.8.GOVERNINGLAW.TheagreementshallbegovernedbythelawsoftheStateofNewMexico.AnyactionorproceedingbroughtbyeitherpartyagainsttheotherarisingoutoforrelatedtothisagreementshallbebroughtonlyinastateorfederalcourtofcompetentjurisdictionlocatedinBernalilloCounty,NewMexico.Thepartiesherebyconsenttothepersonaljurisdictionofsuchcourts.9.U.S.GOVERNMENTRESTRICTEDRIGHTS.ThisSoftwareisprovidedwithRESTRICTEDRIGHTS.Use,duplication,ordisclosurebytheGovernmentissubjecttorestrictionsassetforthinsubparagraph(a)oftheRightsinCommercialComputerSoftwareclauseatDFARS227.7202-3orsubparagraphs(c)(1)and(2)oftheCommercialComputerSoftware--RestrictedRightsclauseat48CFR52.227-19,asapplicable.Manufactureris:VanDykeSoftware,Inc.4848TramwayRidgeDr.NE,Suite101Albuquerque,NM87111USAInquiryform:http://www.vandyke.com/feedback.php

HowtoOrder

Thefollowinginformationisforindividuallicenses.Forinformationonquantitypricingandsitelicenses,pleasevisit:

http://www.vandyke.com/feedback.php

Uponreceiptofpayment,wewillsendyouonelicensekeyforeachcopyofSecureCRTpaidfor.Thelicensekey(s)willbesenttoyoubyemailorpostalmail.Allsoftwareandsoftwareupdatesareavailablefromwww.vandyke.com.BecausethesoftwareisobtainedbyInternetdownload,nodiskmediawillbemailed.Forcurrentpricinginformation,pleasevisitourwebsite:

http://www.vandyke.com/pricing/index.html

OrderingMethods

Orderonlinewithacreditcard.Toorderonlineusingasecurewebserver,goto:

http://www.vandyke.com/purchase/index.html

Orderbyphonewithacreditcard.Youcanorderbyphone,callVanDykeSoftwarebetween7:30a.m.and5:00p.m.U.S.MountainTime,MondaythroughFriday.

Phone: 505-332-5710

Toorderusingadifferentmethod,suchasfaxorcheck,pleasecontactusfororderinginstructions.

Email: sales@vandyke.com

Phone: 505-332-5710

Visa,MasterCard,AmericanExpress,andDiscoverareaccepted.Pleaseincludethecreditcardnumber,cardholdername,expirationdateand

billingaddress.OrderswillbeprocessedwithinonetotwobusinessdaysaftertheyarereceivedbyVanDykeSoftware.Anyquestionsaboutthestatusoftheshipmentoftheorder,refunds,registrationoptions,productdetails,technicalsupport,volumediscounts,dealerpricing,sitelicenses,ornon-creditcardorders,mustbedirectedtoVanDykeSoftware,Inc.,4848TramwayRidgeDr.NE,Suite101,Albuquerque,NM87111,USAorhttp://www.vandyke.com/feedback.phpIfyouarearegistereduserofCRT,pleasevisitourwebsiteforcurrentupgradepricing,orcall505-332-5700.

ProductAnnouncements

Ifyouwouldliketoreceiveemailnotificationofnewreleases,pleasegoto:

https://secure.vandyke.com/cgi-bin/subscribe.php?PID=3

Also,visitourwebpage:

http://www.vandyke.com

CopyrightandTrademarkNotices

SecureCRT®7.1DocumentationCopyright©1995-2013VanDykeSoftware®,Inc.AllRightsReserved.VanDykeSoftware,SecureCRT,SecureFX,andVShellaretrademarksorregisteredtrademarksofVanDykeSoftware,Inc.intheUnitedStatesand/orothercountries.Allotherproductsandservicesmentionedaretrademarksorregisteredtrademarksoftheirrespectivecompanies.SecureCRTincludestheVeriSignXCode(encode/decode)IDNLibrary.Copyright(c)2003,VeriSignInc.Allrightsreserved.Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthefollowingconditionsaremet:

1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowingdisclaimer.

2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthefollowingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution.

3.NeitherthenameoftheVeriSignInc.northenamesofitscontributorsmaybeusedtoendorseorpromoteproductsderivedfromthissoftwarewithoutspecificpriorwrittenpermission.

THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSORIMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNERORCONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOF

USE,DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE.ThissoftwareislicensedundertheBSDopensourcelicense.Formoreinformationvisitwww.opensource.org.

ReportingProblems

YoucansubmitanyproblemsyouarehavingwithSecureCRTatourwebsite:

http://www.vandyke.com/feedback.php

VanDykeSoftwarewilltrytorespondtoallbugreportswithinonetotwobusinessdays,andwilltrytoresolvetheproblemasquicklyaspossible.

FeatureRequestsandQuestions

Weareveryinterestedinhearingfromourusers.IfthereisafeaturethatyouwouldliketoseeaddedtoSecureCRT,orifyouhaveageneralquestionaboutSecureCRT,pleasegoto

http://www.vandyke.com/feedback.php

Ifyouwouldliketoreceiveemailnotificationofnewreleases,pleasegoto:

https://secure.vandyke.com/cgi-bin/subscribe.php?PID=3

SupportFAQ

TheSecureCRTFAQ(FrequentlyAskedQuestions)canbefoundonourwebsiteat:

http://www.vandyke.com/support

ConnectionOverview

Thissectionprovidescrucialinformationtothosewhoareinterestedingettingconnectedtoaremotemachineasquicklyaspossible,puttingasideanyenvironmentalcustomizationssuchasfontcolor,etc.WhenyoustartSecureCRT,youwillseetheQuickConnectdialogappearalongwiththemainSecureCRTwindow.Therearetwointerfacesyoucanusetoconnecttoaremotemachine:theQuickConnectdialogandtheConnectdialog.IfthisisyourfirsttimeusingSecureCRT,youmayprefertousetheQuickConnectdialog.IfyouareaseasoneduserofSecureCRTandhavealreadydefinedoneormoresessions,youmayprefertousetheConnectdialog.Regardlessoftheinterfaceyouchoose,youwillbeabletoestablishaconnectiontoaremotemachineusingtheSerial,Telnet,SSH1,SSH2,Telnet/SSL,andRLoginprotocols.Ifyouneedtoestablishaconnectiontoaremotemachine(suchasaBBS)bydialingitdirectlywithamodem,seethetopiconConnectingwiththeTAPIdialer.

CreatingaNewSessionwithQuickConnect

TheQuickConnectdialogisthefastestwaytocreateanewsessionandconnecttothemachineassociatedwithit.Bydefault,theQuickConnectdialog(seefigurebelow)isshownwhenSecureCRTisstarted.

SecureCRTQuickConnectDialog

ThedialogcanalsobeopenedbyclickingontheQuickConnecttoolbarbutton oneithertheSecureCRTsessionwindowortheConnectdialog,orbyopeningtheFilemenuandselectingtheQuickConnectmenuoption.IntheQuickConnectdialog,specifytheprotocolyouwillbeusing,thehostnameorIPaddress,andanyotherinformationnecessarytomaketheconnection.Whenyouarefinishedenteringthenecessarysettingsfortheconnection,clickontheConnectbuttonandyouwillbeconnectedtothespecifiedhost.IftheSavesessionoptionisselected(thisoptionisonbydefault),asessionwillbecreatedandstoredforfutureuseunderthenameofthehostorIPaddressyouspecified.

Note:YoucancustomizeSecureCRTtodisplaytheQuickConnectdialogonstartupratherthantheConnectdialogbyselectingthe

ShowquickconnectonstartupoptionlocatedintheQuickConnectdialog.

Onceyouhavecreatedasession,youmaywishtocustomizeitsbehavior.Formoreinformation,seethetopicsunderSessionOptions.

ConnectingwiththeConnectDialog

TheConnectdialogcanbeaccessedwiththeConnectbutton onthetoolbarorbyselectingtheConnectmenuitemfromtheFilemenu.InordertoconnecttoaremotemachineusingtheConnectdialog,youmustselectapreviouslycreatedsession.YoucanquicklycreateanewsessionbyclickingontheNewSessionbutton

,orbyright-clickingonanyfolderintheConnectdialogandselectingNewSessionfromthepop-upmenu.Ifyouwouldliketolearnmoreaboutcreatingnewsessions,seeCreatingaNewSessionwithConnect.Toconnectusingasessionyouhavealreadycreated,selectthesessionandclickontheConnectbutton.Youcanalsoconnecttoasessionbydouble-clickingonthesessionnameorbyright-clickingonthesessionnameandselectingConnectfromthepop-upmenu.TodisplaytheConnectdialogautomaticallyatstartup,selecttheShowdialogonstartupoptionfoundinthelowerleftcorneroftheConnectdialog.ToopentheselectedsessionasatabintheSecureCRTwindow,selecttheOpeninataboption.

ConnectDialog

ConnectingwiththeTAPIDialer

Toconnecttoaremotemachine(suchasaBBS)bydialingitdirectly,youwillneedtocreateanewsessionfortheconnection,orusetheQuickConnectdialogwithhefollowingsteps:1.SpecifyTAPIastheconnectionprotocol.2.IntheDialusingentrybox,specifythemodemyouwillusefor

dialingtheremotemachine.3.Ifnecessary,specifythecountryand/orareacodeforthenumberof

themachineyouwillbedialing.4.InthePhonenumberentrybox,enterthephonenumberofthe

machineyouwillbedialing.IftheremotemachineorBBSyouareattemptingtodialprovidesyouwithalternatenumbers,youcanspecifyanyalternatenumbersbyclickingontheTAPI/AdvancedcategoryintheSessionOptionsdialog.

5.ClickontheConnectbuttonandSecureCRTwillbegindialingtheremotecomputer.

StartingaSessionAutomatically

SecureCRTcanbeconfiguredtoautomaticallyconnecttoaspecificsessiononstartup.IfyouintendtouseoneparticularsessioneachtimeyourunSecureCRT,youmaywanttoenabletheUseautosessionoption.ToenableUseautosession:1.SelecttheGeneral/DefaultSessioncategoryintheGlobalOptionsdialog.2.IntheAutosessionsetupgroup,selecttheUseautosession

optionandspecifyasessionname.

CreatingaDesktopShortcuttoaSecureCRTSessionWithSecureCRT,youcaneasilycreateashortcutonthedesktopthatwillstartSecureCRTandautomaticallybeginconnectingwithacertainsession.TocreateadesktopshortcuttoaSecureCRTsession:1.IntheConnectdialog,right-clickonthespecificsessionthatyouwant

SecureCRTtobeginconnectingwithoncetheshortcutislaunchedfromthedesktop.

2.SelecttheCreateDesktopShortcutmenuitemfromthepop-upmenu.

ReconnectingAutomatically

SecureCRTcanbesetuptoautomaticallyreconnecttoaremotemachinewhenaconnectionisterminated.Toenablethisfeatureforallsessions:1.OpentheTerminalcategoryintheGlobalOptionsdialog.2.SelecttheAutoreconnectoption.Toenableordisablethisfeatureonaper-sessionbasis:1.IntheSessionOptionsdialog,opentheTerminalcategory.2.SelecttheAutoreconnectoption.

RunningSecureFXfromSecureCRT

The5.0(ornewer)releaseofSecureCRTsupportstheintegrationofitsconfigurationsettingswiththoseofVanDykeSoftware'ssecurefiletransferclientSecureFX®(version3.0ornewer).Thismakesitsimplertocreateandmaintainsessions;setyouroptionsonceandtheyareusedbybothprograms.TointegrateSecureCRTwithSecureFX,installbothapplicationsonthesamemachinethenstartSecureCRT.FromSecureCRT,youcanstartSecureFXinseveraldifferentways,includingthefollowing:

·ClickingontheSecureFXtoolbarbutton.·Right-clickingonatabandselectingtheStartSecureFXoption.·SelectingaSecureFXsessionfromtheConnectdialog.·Right-clickingontheActivatorsystemtrayiconandopeninga

SecureFXsession.YoucanalsostartSecureCRTfromSecureFXifyouprefer.IfyouopentheSecureCRTGlobalOptionsorSessionOptionsdialogs,youwillseeoptionsforbothSecureCRTandSecureFX.Fromhere,youcanconfiguresessionsforbothapplications.IfyouwanttoshareyourSecureCRTandSecureFXconfigurationsettingsandwanttoseeboththeterminalemulationandfiletransfersessionsinyourSecureCRTConnectdialog,right-clickontheConnectdialogandchecktheShowTransferSessionsoption.

Menus

SecureCRTapplicationwindowhasanumberofmenusthatprovideaccesstoprogramdialogs,controls,andfeatures.Themenusarelistedbelow:

·SystemMenu·FileMenu·EditMenu·ViewMenu·OptionsMenu·TransferMenu·ScriptMenu·ToolsMenu·WindowMenu

·HelpMenu

SystemMenu

ThistopicliststheoptionsavailableontheSystemmenu.TheSystemmenuisaccessedbyclickingonthesmallSecureCRTiconlocatedintheupperleft-handcorneroftheSecureCRTwindow.TheSystemmenucanalsobeaccessedbyright-clickingintheSecureCRTtitlebar.TheSystemmenuallowsyoutoaccomplishbasictaskssuchasminimizing,maximizing,moving,andresizingtheSecureCRTwindowonsystemsthatdonothaveamouseattached.ToaccesstheSystemmenuwithoutusingthemouse,usetheALT+SPACEkeycombination.ToselectamenuitemfoundintheSystemmenu,pressthekeyassociatedwiththeentryasdesignatedwithanunderline.

SecureCRTSystemMenu

RestoreRestoresthesessionwindowtoitsoriginalsize.

MoveChangesthemousepointerintoahandletomovethesessionwindow.

SizeChangesthemousepointerintoahandletoresizethesessionwindow.

MinimizeMinimizesthesessionwindowtothetaskbaror,ifyouareusingtheActivator,tothesystemtray.

MaximizeEnlargesthesessionwindowtofilltheentirescreen.

ToggleMenuBar

Togglesthemenubaronandoff.ThisoptionisalsoavailableontheViewmenu.

AlwaysonTopKeepsthesessionwindowinfrontor"ontop"ofotherwindowsonyourscreen.ThisoptionisalsoavailableontheViewmenu.

SaveSettingsNowSavesyourcurrentglobalandsessionoptionsettingstotheinitializationfile.ThesesettingswillbetheonesretrievedthenexttimeyoustartSecureCRT.ThisoptionisalsoavailableontheOptionsmenu.

CloseDisconnectsanysessionsinprogressandclosesthesessionwindow.

FileMenu

ThistopicliststheoptionsavailableontheFilemenuincludingconnection,printing,andloggingcommands.

Connect...OpenstheConnectdialogwhereyoucanconnecttooreditexistingsessions,orcreatenewsessions.Ifyouchoosetoopenanewsessionandthecurrenttaborwindowisdisconnected,SecureCRTwilldisplaythenewsessioninthecurrenttaborwindow.Ifthecurrenttaborwindowisconnected,anewwindowwillbeopened.

QuickConnect...OpenstheQuickConnectdialog.Thisisthequickestwaytodefineasessionandisoftenusedtomakeone-timeconnections.

ConnectinTab/Tile...OpenstheConnectinTab/Tiledialogwhereyoucanopenasessionasanewtaborasanewtiledsessionifyouareintiledmode.Ifyouchoosetoopenanewsessionandthecurrenttab/tiledsessionisdisconnected,SecureCRTwilldisplaythenewsessioninthecurrenttab/tiledsession.Ifthecurrenttab/tiledsessionisconnected,anewtab/tiledsessionwillbeopenedinthecurrentwindow.

ReconnectReconnectsyoutothesessionthatmostrecentlyhadfocus.

ReconnectAllRe-establishesaconnectiononallcurrentlydisconnectedsessions(honorstheConnecttomultiplesessionssequentiallyoptionsetting).

DisconnectDisconnectsyoufromthecurrentsession.

DisconnectAllDisconnectsyoufromallcurrentlyconnectedsessions.

CloneSessionCreatesanewsessionthatisidenticaltothecurrentsession.Formoreinformation,seetheSessionTabstopic.

ConnectSFTPSessionOpensanewtabortiledsessioncontaininganSFTPcommandline.

Lock/UnlockSessionLocksorunlocksthecurrentsession.

PrintAutoPrintTogglesonandofftheAutoPrintfeature.Whenon,thisfeaturedirectsterminaloutputtotheprinter;eachlineofoutputtotheterminalscreenissenttotheprinterassoonasaCR,LF,FF,orVTcharacterisreceived.

Note:ThisoutputwillbebufferedbytheWindowsspoolerunlessyouhaveenabledtheUserawmodeorDirectpass-throughprintingoptionineithertheSessionOptionsorGlobalOptionsdialog.

YoucanalsoturnthisfeatureonandoffbyclickingtheAutoPrintbutton locatedontheSecureCRTtoolbar.SelectingPrint/CancelfromtheFilemenu,alsoturnsofftheAutoPrintfeature.

Note:IfAutoPrintison,theAutoPrintbuttononthetoolbarwillappeardepressed .Ifautoprintisoff,theAutoPrintbuttonwillappearasnormal.

ScreenPrintsthecontentsdisplayedintheterminalscreen.YoucanalsoprintthecontentsoftheterminalscreenbyclickingonthePrintScreenbutton ontheSecureCRTtoolbar.

SelectionPrintsthetextselectedintheterminalscreentotheprinter.YoucanalsoprintthecurrentlyselectedtextbyclickingonthePrintSelectionbutton ontheSecureCRTtoolbar.

EjectPageSendsaformfeedcommandtotheprintingsystem.

CancelCancelsallpendingSecureCRTprintjobs.Thiswillnotaffectprint

jobsthatarealreadyintheprintbuffer.

PrintSetup...OpenstheWindowsPrintSetupdialog.

LogSessionRecordsthecurrentsessioninalogfile.Whenfirstloggingasession,theSaveAsdialogwillappear.EnterthedesiredlogfilenameandclickontheSavebutton.Also,seetheTerminal/LogFilecategoryoftheSessionOptionsdialog.Bydefault,loggingisoff.

RawLogSessionWriteseverycharacterreceivedbySecureCRT,includingterminalescapesequences,tothesessionlogfile.Bydefault,Rawlogisoff.

TraceOptionsDisplaysnormallyhiddenprotocolnegotiationinformationalongwithstandardinformationshownintheSecureCRTwindow.WhenSecureCRTattemptstoconnecttoatargetserver,agreatdealofinformationispassedbetweenthetwomachines.MostofthisinformationisvisibleintheSecureCRTwindowbutsomeofit(theunderlying"handshaking"commands)isgenerallyunimportanttotheuserandishiddenfromview.However,therearetimeswhenthishandshakinginformationisuseful,forexample,itcanbeveryvaluablewhentryingtosolveaconnectionproblem.Fortheseinstances,SecureCRTprovidestheTraceOptionsfeaturewhich,whenturnedon,displaysthehandshakinginformation.

RecentlyUsedSessionListDisplaysthenamesofthemostrecentlyusedsessionsusedtoconnecttoremotemachines.ThenumberofsessionshowncanbeconfiguredintheGlobalOptions/Generaldialog.

SecureCRTFileMenu

ExitClosestheSecureCRTapplication.

EditMenu

ThistopicliststheoptionsavailableontheEditmenu.

CopyCopiesselectedtextfromtheSecureCRTsessionwindowtotheWindowsClipboard.

PastePastesthecontentsoftheWindowsclipboardtothesessionwindowatthepointofthetextcursor

CopyandPasteCopiesselectedtextfromtheSecureCRTsessionwindowandpastesitatthelocationofthetextcursor.

PasteasQuotationPastestextfromtheWindowsClipboardprefacedbythequotationcharacter(usually">").

SelectAllSelectsallthetextintheactivesessionwindowincludingtextinthescrollbackbuffer.

Find...OpenstheFinddialogwhichletsyousearchthetextinasessionwindowandscrollbackbuffer.foraspecificcharacterstring.

PrintSelectionSendsthetextselectedinthesessionwindowtotheprinter.YoucanalsodothisbyclickingonthePrintSelectionbutton locatedontheSecureCRTtoolbar.

GotoSession/ChatWindowThismenuitemreadsGotoSessionWindowwhenthechatwindowisdisplayedandhasfocus.Whenselecteditcausesthefocustogotothesessionwindow.Whenthechatwindowisdisplayedandfocusisinthesessionwindow,thismenuitemreadsGotoChatWindowandselectingitcausesthe

focustogotothechatwindow.

ClearScrollbackClearsthescrollbackbuffer.

ClearScreenClearsthesessionwindow.

ClearScreenandScrollbackClearsboththesessionwindowandthescrollbackbuffer.YoucanalsoautomaticallyclearthesessionwindowwhenyoudisconnectfromaremotemachinebycheckingtheClearondisconnectoptionintheSessionOptions/Terminaldialog

SendBreakSendsaTelnetbreaktothesession.

ResetResetsSecureCRTtheterminalemulator.Thisoptionisusefulforclearingincidentaldisplayabnormalities(e.g.,accidentaldisplayofbinarydata).

ViewMenu

ThistopicliststheoptionsavailableontheViewmenu.

MenuBarTogglesthemenubaronandoff.ThemenubarcanalsobetoggledonandofffromtheSystemmenu.

ToolbarTogglesthetoolbaronandoff.

SessionTabsTogglesthesessiontabsonandoff.TabscanalsobeenabledusingtheShowsessiontabsoptionontheGlobalOptions/Terminal/Appearancedialog.

ChatWindowTogglesthechatwindowonandoff.TheSecureCRTchatwindowprovidesaninterfacetotheremotecommandlinethatisunaffectedbyconcurrentoutputtotheterminalscreen.Thechatwindowisagreatinterfacetousewhencommunicatingintheenvironmentofachatroom.Inaddition,thechatwindowisusefulforissuingsubsequentcommands.Whilewaitingfortheoutputofapreviouscommandtocomplete,youcanpreparethenextcommandbytypingitintothechatwindow.ThecontentsofthechatwindowaresenttothecommandlineassoonastheENTERkeyispressedinthechatwindow.YoucanpreparemultiplelinesinthechatwindowwithCTRL+ENTER.SecureCRTwillrememberthenumberofrecentlyusedchatwindowcommandsthatarespecifiedintheChatwindowhistoryoptionoftheGlobalOptions/Terminal/Appearancedialog.YoucancyclethroughthesecommandsusingyourUPandDOWNarrowkeys.Enteringa0fortheChatwindowhistorywillturnoffthisfeature.Ifyouwanttosendcommandstoallyouropentabbedsessionsatonce,right-clickinthechatwindowandselecttheSendChattoAllTabsoption.Commandswillbesenttoallyourtabbedsessionsaslongasthisoptionisenabled,

ConnectBarTogglestheconnectbaronandoff.

StatusBarTogglesthestatusbaronandoff.

ButtonBarTogglesthebuttonbaronandoff.

ThemesAllowsyoutoselectfromtheavailableWindowsdisplaythemes.

WindowTransparencyTogglestheactivewindowtransparencybetweenfullyopaqueandthetransparencyvaluesetintheTerminal/Appearance/AdvancedcategoryoftheGlobalOptionsdialog.

HorizontalScrollBarTogglesthehorizontalscrollbaronandoff.Turningoffthescrollbardoesnotturnoffscrolling.

VerticalScrollBarTogglestheverticalscrollbaronandoff.Turningoffthescrollbardoesnotturnoffscrolling.

AlwaysonTopKeepsthesessionwindowinfrontor"ontop"ofotherwindowsonyourscreen.

FullScreenEnlargesthesessionwindowtofullscreensize.TheALT+ENTERkeycombinationreturnsthewindowtoitsstandardsize.

OptionsMenu

ThistopicliststheoptionsavailableontheOptionsmenu.SessionOptions...OpenstheSessionOptionsdialog.GlobalOptionsOpenstheGlobalOptionsdialog.

WhenyoustartSecureCRT,theprogramretrievesyourglobalandsessionoptionsettingsfromaninitializationfile.WhileyouarerunningSecureCRT,youcanmakechangestoyoursettings,butthesechangeswillbelostwhenyoucloseSecureCRTunlessyousaveyourchangestotheinitializationfileusingtheSaveSettingsNowcommandand/ortheAutoSaveOptionscommand.AutoSaveOptionsAutomaticallysaveschangesthatyoumakeintheGlobalOptionsdialogorSessionOptionsdialogtotheinitializationfilewhenyouclickontheOKbuttononthedialog.Ifthisoptionisoff(unchecked),changesmadetoyourglobalorsessionoptionswillbelostwhenyoucloseSecureCRTunlessyouhavesavedthesettingsusingtheSaveSettingsNowcommand.

Note:WhentheAutoSaveOptionscommandisbeingusedbymorethanoneinstanceofSecureCRT,thesettingsofthelastinstancetobeclosedwillbethesettingssavedtotheinitializationfile.

SaveSettingsNowSavesyourcurrentglobalandsessionoptionsettingstotheinitializationfile.ThesesettingswillthenbetheonesretrievedthenexttimeyoustartSecureCRT.

TransferMenu

ThistopicliststheoptionsavailableontheTransfermenu.

SendASCII...OpenstheSelectFiletoSendasASCIIdialog.

ReceiveASCII...OpenstheSpecifyFilenametoReceiveasASCIIdialog.

SendBinary...OpenstheSelectFiletoSendasBinarydialog.

SendKermit...OpenstheSelectFiletoSendusingKermitdialog.

ReceivesKermit...Startsthetransferofthefile(s)fromthecurrentlyconnectedserver.

SendXmodem...OpenstheSelectFiletoSendusingXmodemdialog.FormoreinformationonXmodem,seeOverviewofXmodem.

ReceiveXmodem...OpenstheSpecifyFilenametoReceiveusingXmodemdialog.FormoreinformationonXmodem,seeOverviewofXmodem.

SendYmodem...OpenstheSelectFilestoSendusingYmodemdialog.FormoreinformationonYmodem,seeOverviewofYmodem.

ReceiveYmodem...Startsthetransferofthefile(s)fromthecurrentlyconnectedserver.FormoreinformationonYmodem,seeOverviewofYmodem.

ZmodemUploadList...OpenstheSelectFilestoSendusingZmodemdialog.FormoreinformationonZmodem,seeOverviewofZmodem.

StartZmodemUploadStartsthetransferofthefile(s)selectedintheSelectFilestoSendusingZmodem

dialogtothecurrentlyconnectedserver.FormoreinformationonZmodem,seeOverviewofZmodem.

ScriptMenu

ThistopicliststheoptionsavailableontheScriptmenu.

Run...OpenstheSelectScripttoRundialogwhereyoucanchooseandstartascript.Formoreinformationonscripts,seeCreatingActiveXScripts.

CancelCancelsthecurrentlyrunningscript.

StartRecordingScriptWhenthisoptionisselected,allkeystrokesandresponsesinthecurrentsessionwillberecordeduntiltheStopRecordingScriptorCancelRecordingScriptoptionisselected.Ifascriptisbeingrecordedandasessionisdisconnected,youwillbepromptedtosavethescript.

StopRecordingScript...StopstherecordinginprogressandpromptsyoutosavetherecordedscriptasaVisualBasic(.vbs)orPython(.py)scriptfile.Ifascriptisbeingrecordedandasessionisdisconnected,youwillalsobepromptedtosavethescript.

CancelRecordingScriptStopstherecordinginprogressandnothingissaved.

RecentScriptListsthemostrecentlyusedscripts.Formoreinformationonscripts,seeCreatingActiveXScriptsandCreatingPythonScripts.

ToolsMenu

ThistopicliststheoptionsavailableontheToolsmenu.

KeymapEditor...OpenstheKeymapEditor.

CreatePublicKey...OpenstheKeyGenerationwizard.

ConvertPrivateKeytoOpenSSHFormat...ConvertsaVanDykegeneratedprivatekeytoOpenSSHformatsothatitcanbeusedforauthenticationwithotherSSH2clients.Youwillbepromptedforthekeytoconvertandwheretosavetheconvertedkey.

ExportPublicKeyfromCertificate...ExportsthepublickeyfromanX.509certificate.Youwillbepromptedforthecertificatetouseandwheretosavethepublickey.Afterthepublickeyhasbeenexported,youwillneedtocompletetheseinstructionsinordertouseit.

Public-KeyAssistant...OpensthePublic-KeyAssistantdialog,allowingyoutomanageyourpublickeysonremoteservers.ThisoptionisonlyavailablewhenyouareusingtheSSH2protocol.Alsonotethatnotallremotesystemssupportthepublic-keyassistantsubsystem.

ManageAgentKeysOpenstheManageAgentKeysdialogwhichallowsyoutoaddkeystoandremovekeysfromthelistofacceptedagentkeys.

WindowMenu

ThistopicliststheoptionsavailableontheWindowmenu.Ofthefollowingfouroptions,onlyonecanbeselectedatatime.

TabsTogglesthetabbedinterfacedisplaysetting.

TileVerticallyResizesanddisplaysallopensessionwindowstobetheheightofthemainwindow,equal-sizedandhorizontallypositionedtofilltheentiremainwindow.

TileHorizontallyResizesanddisplaysallopensessionwindowstobethewidthofthemainwindow,equal-sizedandverticallypositionedtofilltheentiremainwindow.

CascadeResizesanddisplaysallopensessionwindowstobeslightlyoverlappedanddescendingfromtheupper-leftcornerofthemainwindow.Thespecifiedgeometrysettingsareused.

ActiveSessionListDisplaysthenamesofthecurrentlyactivesessions.

HelpMenu

ThistopicliststheoptionsavailableontheHelpmenu.

HelpTopicsOpenstheSecureCRTHelpsystem.

SecureCRTWebPage...OpensyourdefaultwebbrowsertotheSecureCRTproductwebpage.

OrderSecureCRT...OpensyourdefaultwebbrowsertotheSecureCRTorderwebpage.

CheckforUpdates...OpensyourdefaultwebbrowsertoaSecureCRTwebpagethatwillletyouknowifthereareanyversionsavailablethatarenewerthantheoneyouarecurrentlyrunning.

VanDykeSoftwareForum...OpensyourdefaultwebbrowsertotheVanDykeSoftwarewebforumwhereyoucanreadandparticipateindiscussionsaboutSecureCRTandotherVanDykeproducts.

EnterLicenseData...OpenstheLicenseWizardwhichwillstepyouthroughenteringyourlicensedata.

AboutSecureCRT...OpenstheAboutdialogwhichcontainsinformationaboutSecureCRT.

ConnectDialog

TheConnectdialog(shownbelow)allowsyoutoconnecttoadefinedsessionortocreateandconnecttoanewsession.

TheConnectdialogcanbeaccessedbyclickingonConnect...intheFilemenu,byclickingontheConnectbutton ontheSecureCRTtoolbar,orbyenteringthekeyboardshortcutALT+C.FromtheConnectdialog,youcanconnecttomultiplesessionsandfolders.Ifmultiplesessionsorafolderisselected,thesessionswillbeopenedintabs.YoucanalsoselectandeditmultiplesessionsfromtheConnectdialog;onlythechangedfieldswillbeappliedtotheselectedsessions,allowingspecificsettingstobechangedforagroupofsessions.Wheneditingmultiplesessions,SecureCRTwilldisplaythefirstsessionthatwasselected.ThetoolbarontheConnectdialogprovidesquickaccesstothefollowingactions:

Button Description

Connect(Connectdialog):Connectstoselectedsession.

QuickConnect:BringsuptheQuickConnectdialog.

NewSession(Connectdialog):OpenstheSessionOptionsdialogforanewsession.

Cut:Copiestheselectedsessionorfoldertotheclipboard.Whenitispasted,thesessionorfolderismovedtothenewlocation.

Copy:Copiestheselectedsessionorfoldertotheclipboard.

Paste:Pastesasessionorfolderthatwaspreviouslycutorcopiedintothespecifiedfolder.

Delete:Deletestheselectedsessionsand/orfolders.

Properties:OpenstheSessionOptionsdialogfortheselectedsession.

Find:Searchesthecontentsofthesessiontreeforagivenstring.TheacceleratorforthiscommandisCTRL+F,andpressingtheF3keywillresultina"findnext"operation.

NewFolder:Createsanewfolderinthefoldertreelist.

CreateShortcut:Createsadesktopshortcuttotheselectedsession.

Help:Invokestheonlinehelpmanual.

Organizedinafoldertreearrangement,thelistwindowoftheConnect

dialogliststhesessionsthathavebeendefined.TheConnectdialogalsocontainsthefollowingoptions:

ShowdialogonstartupCheckthisboxtohavetheConnectdialogdisplayedwheneverSecureCRTstarts.Openinatab(ifyouareintabmode)Openstheselectedsession(s)inatabintheSecureCRTwindow.Ifthisoptionischeckedandthereisasessionopen,theselecteditem(s)willbeopenedinthecurrentwindow.Ifthisoptionisuncheckedandthereisasessionopen,theselecteditem(s)willbeopenedastabsinanewwindow.Openinatiledwindow(ifyouareintiledmode)Openstheselectedsession(s)inatiledsessionintheSecureCRTwindow.Ifthisoptionischeckedandthereisasessionopen,theselecteditem(s)willbeopenedinthecurrentwindow.Ifthisoptionisuncheckedandthereisasessionopen,theselecteditem(s)willbeopenedastiledsessionsinanewwindow.ConnectPressthisbuttontoconnecttothesessionselectedinthesessionwindow.ClosePressthisbuttontoclosetheConnectdialog.

IfyouwanttoshareyourSecureCRTandSecureFXconfigurationsettingsandwanttoseeboththeterminalemulationandfiletransfersessionsinyourSecureCRTConnectdialog,right-clickontheConnectdialogandchecktheShowTransferSessionsoption.

QuickConnectDialog

TheQuickConnectdialog(shownbelow)allowsyoutoquicklydefineandconnecttoaremotehost.

TheQuickConnectdialogcanbeaccessedbyclickingonQuickConnect...intheFilemenu,byclickingontheQuickConnectbuttonontheSecureCRTtoolbar,orbyenteringthekeyboardshortcutALT+Q.TheQuickConnectdialogoptionsarebasedonthechoiceofProtocolInotherwords,ifSSH2isselectedastheprotocol,theoptionsdisplayedonthedialogwillbedifferentthanifTelnetisselected.BelowisalistoftheprotocolsandoptionsavailableinSecureCRT.

SSH2QuickConnectOptions

SSH1QuickConnectOptions

TelnetQuickConnectOptions

Telnet/SSLQuickConnectOptions

RLoginQuickConnectOptions

SerialQuickConnectOptions

TAPIQuickConnectOptions

RawQuickConnectOptions

TheQuickConnectdialogalsocontainsthefollowingoptions:

ShowquickconnectonstartupCheckthisboxtohavetheQuickConnectdialogdisplayedwheneverSecureCRTstarts.SavesessionCheckthisboxtosavethesessionsettingsthathavebeendefined.ThesessionwillbestoredforfutureuseunderthespecifiedhostnameorIPaddress.Tocustomizethebehaviorofasavedsession,seethetopicsinthe"CustomizingSessionBehavior"section.OpeninatabOpensthesessionasatabinthesessionwindow.ConnectPressthisbuttontoconnecttothespecifiedhost.IftheSavesessionoptionisselected,thesessionissavedatthistime.CancelPressthisbuttontoclosetheQuickConnectdialogwithoutsavingthespecifiedsettings.

GlobalOptionsDialog

TheGlobalOptionsdialogisaccessedbyopeningtheOptionsmenuandselectingGlobalOptions....Globaloptionsapplytoallsessionsunlesstheyarespecificallyoverriddenonapersessionbasis.Theavailablecategoriesandsubcategoriesareasfollows:

·General·DefaultSession

·Terminal·Appearance

·ANSIColor·Advanced

·Tabs/Tiling·Printing·WebBrowser

·Advanced·FileTransfer

·Options·Advanced

·View·FTP·SSL·Sound·FileTypes·Filters

·Firewall·SSH2·SSHHostKeys

General

TheGeneralcategoryoftheGlobalOptionsdialogallowsyoutoconfiguregeneralSecureCRToptions.

DialogsgroupThisgroupcontainoptionsthatcontrolthedisplayofoptionaldialogs.Thesedialogsaredisplayedbydefault.

ShowconnectioncloseddialogCheckthisoptiontodisplayaconnectionclosedmessagewhentheconnectionisclosed.ShowconfirmdisconnectdialogCheckthisoptiontodisplayamessageaskingforconfirmationbeforedisconnecting.ShowconnectdialogonstartupCheckthisoptiontodisplaytheConnectdialogonstartupofSecureCRT.SaveexpandedfolderstateinconnectdialogCheckthisoptiontohaveSecureCRTrememberthestate(expandedorcollapsed)offoldersintheConnectdialog.NewsessionuseswizardEnablingthisoptioncausestheNewSessiontoolbarbuttonintheConnectdialogtostarttheNewSessionwizard.DisablingthisoptioncausesthisbuttontoopentheSessionOptionsdialoginstead.Thisoptionisenabledbydefault.

ViewgroupThisgroupincludesoptionsthatallowyoutoshoworhidecomponentsoftheSecureCRTapplicationwindow.Toturnoffanyoftheseoptions,cleartheassociatedcheckbox.Theavailableoptionsareasfollows:

Showtoolbar

Showstatusbar

Showmenubar

ShowconnectbarSessionsgroup

ThisgroupincludesoptionsthatdealwithSecureCRTsessions.Theavailableoptionsareasfollows:

ConnectdialogsortorderSelectthemethodbywhichyouwanttosorttheentrieslistedinthesessiontreeoftheConnectdialog.Sessionscanbesortedalphabetically(i.e.,A1,A10,A2,B),logically(i.e.,A1,A2,A10,B),ormanually.ThisoptioncanalsobecontrolledfromtheConnectdialog'sArrangeTreecontextmenuoption.SeealsoArrangingEntriesintheConnectDialog.MinimizetoActivatorinthesystemtrayCheckthisoptiontoenabletheSecureCRTActivator,whichallowsyoutominimizespecificsessionsorallsessionstothesystemtrayinsteadofthetaskbar.ThiscanbeusefulifyouhaveanumberofsessionsrunningorifyouonlyuseSecureCRTtoportforwardyourconnectionstoanothermachine.SeeUsingtheActivatorformoreinformationaboutthisfeature.AlsoseeSwitchingBetweenMultipleSessions.RecentlyusedsessionslistThisoptionallowsyoutoconfigurethenumberofsessionslistedintheRecentlyUsedSessionssectionoftheFilemenu.TheRecentlyUsedSessionslistdisplaysalistofsessionsthathaverecentlybeenusedtoconnecttoaremotemachine.Thedefaultvalueis4.

Note:Enteringavalueof0(zero)intheRecentlyusedsessionslistentryboxwilldisablethelistintheFilemenuandclearthelistofallentries.

ConfigurationfolderThisentryboxdisplaysandallowsyoutochangetheSecureCRTconfigurationfolder.ThisfolderiswheretheSecureCRTconfigurationfilesarestored.SecureCRTwilllookfortheconfigurationsettingsintheapplicationdirectorybeforeusingthefolderspecifiedinthisentrybox.Foldersspecifiedusingthecommand-lineoption/Fwilltakeprecedenceoverboththeselocations.

Note:Tochangeyourconfigurationinformation,youmusthavewriteprivilegestothisfolder.

General/DefaultSession

TheGeneral/DefaultSessioncategoryoftheGlobalOptionsdialogallowsyoutoconfigureSecureCRTtoautomaticallyconnecttoasessiononstartupanditalsoallowsyoutoconfiguretheSecureCRTdefaultsessionwhichisusedasthetemplateforallnewsessions.

AutosessionsetupgroupThisgroupcontainsconfigurationoptionsforautomaticallyconnectingtosessionsonstartup.

DonotconnectautomaticallyonstartupCheckthisoptiontoinstructSecureCRTnottoautomaticallyconnectwhentheapplicationstarts.RememberandconnecttosessionsfromlastuseCheckthisoptiontoinstructSecureCRTtorememberthesessionsusedduringthelasttimeSecureCRTwasusedandtoconnecttothosesessionsthenexttimetheapplicationisused.UseautosessionCheckthisoptiontoautomaticallyconnecttooneormoresessionswhenSecureCRTstarts.Thewindowbelowthisoptiondisplaysthesessionsconfiguredtoconnectonstartup.YoucanaddordeletesessionsusingtheAdd...andDeletebuttons.

EditdefaultsettingsgroupSecureCRTmaintainsaninternalsessionthatisusedwheneveranewsessionisbeingcreatedorwhenasessionhasnotbeenspecifiedforaconnection.Thisinternalsessionisknownasthe"Default"session.Forexample,whenusingQuickConnectorwhenstartingSecureCRTfromthecommandlinewithnosessionargument,SecureCRTusesthesettingsspecifiedintheDefaultsessiontomaketheconnectionrequested.

EditDefaultSettingsPressthisbuttontoopentheSessionOptions-Defaultdialogforthedefaultsession.Inthisdialog,youcancustomizethesettingsinanycategory.Whenyouhavefinishedmakingyourchanges,clickontheOKbuttonandtheApplydefaultsessionchangesdialogisdisplayed.

TheApplydefaultsessionchangesdialogallowsyoutochoosebetweenChangetheDefaultsessiononly(thisisthesamebehaviorprovidedbytheNooptioninpreviousversions)andChangeALLsessions(noundo)(thisisthesamebehaviorprovidedbytheYesoptioninpreviousversions).ThedialogalsoincludesaWARNINGthatthereisnoUNDOforthischange.

Terminal

TheTerminalcategoryoftheGlobalOptionsdialogallowsyoutoconfigureSecureCRTterminalemulation-relatedoptions.SavewindowstateforeachsessionCheckthisoptiontosavethewindowsizeandpositionofeachsessionwindow.AutoreconnectCheckthisoptiontoautomaticallyreconnecttoaremotemachinewhenaconnectionisterminated.Thisfeaturecanalsobeenabledordisabledonapersessionbasis.

MousegroupThisgroupcontainsoptionsthataffectmousebehavior.

CopyonselectThisoptionallowsyoutospeeduptheprocessofcopyingtextfromtheterminalscreentotheClipboard.CheckthisoptiontoallowtexttobecopiedtotheClipboardassoonasitisselected.Pasteonmiddle/rightbuttonThisoptionallowsyoutospeeduptheprocessofpastingcontentfromtheClipboardtotheterminalscreen.CheckthisoptiontoallowtexttobepastedfromtheClipboardtotheterminalscreenassoonasthemiddleorrightmousebuttonispressed.Ifyourmousedoesnothaveamiddlemousebutton,amiddlebuttonclickcanbesimulatedbypressingboththeleftandrightmousebuttonssimultaneously.HidemousepointeronkeypressCheckthisoptiontohidethemousepointerwhenyoustarttyping.OpenURLwithCTRL+clickCheckthisoptiontoallowaURLintheterminalwindowtobeopenedbyclickingonitusingtheCTRL+left-clickkeycombination.

Terminal/Appearance

TheTerminal/AppearancecategoryoftheGlobalOptionsdialogallowsyoutoconfiguretheappearanceofyourSecureCRTapplicationwindow.

OptionsgroupThisgroupincludesoptionsthatdealwiththeSecureCRTapplicationwindow'sappearance.Toturnoffanyoftheseoptions,cleartheassociatedcheckbox.Theavailableoptionsareasfollows:

ShowsessiontabsThisoptionenablesordisablesthesessiontabs.ThiscanalsobecontrolledfromtheSessionTabsoptionontheViewmenuShowchatwindow

ShowbuttonbarBycheckingoruncheckingthisoption,youcandisplayorhidethebuttonbar(thiscanalsobecontrolledfromtheViewmenu).Thisoptionalsoallowsyoutodisplaythebuttonbareitheratthebottomofthewindoworatthetop.Showhorizontalscrollbar

Showverticalscrollbar

UseClearTypetosmoothedgesofscreenfontsCheckthisboxtouseClearTypewhichwillsmoothedgesofscreenfontsandmayimprovereadabilityonsomedisplays.Dependingonyourplatform,youmayneedtoenableClearTypefontsmoothingatthesystemdisplaylevel.

Note:ThisfeatureappliesonlytosystemsusingClearTypefonts.WindowleftmarginEntertheleftmarginoftheSecureCRTapplicationwindowinpixels.MaximumcolumnsEnterthemaximumcolumnstobedisplayedintheSecureCRTapplicationwindow.ChatwindowhistoryEnterthenumberofrecentlyusedchatwindowcommandsthatyouwantSecureCRTtoremember.Inyourchatwindow,youcancycle

throughthesecommandsusingyourUPandDOWNarrowkeys.Note:Todisablethechatwindowhistory,enterazero(0)inthisentrybox.

StatusbargroupThisgroupincludesoptionsthatdealwiththestatusbar.Toturnoffanyoftheseoptions,cleartheassociatedcheckbox.Theavailableoptionsareasfollows:

Showcursorposition

Showwindowsize

Showelapsedtime

Nevershowseconds

AccessibilitygroupThisgroupincludesoptionsthatdealwithaccessibilityissues.

UsetrackableinsertioncaretForuserswithaccessibilityissues,SecureCRTsupportstheuseofastandardinsertioncaret.CheckthisoptiontoenableSecureCRTtoworkwithscreenaccesstechnologyfortheblind(e.g.,screenreadingandscreenmagnificationprograms)thattrackthepositionofthecaret.

Note:TurningontheUsetrackableinsertioncaretoptionwillcausethelossofcontroloversomesessioncursoroptions:thecursorcolorwillalwaysbetheinversionofthescreencolor,andtheuserwillnotbeabletoturnoffcursorblinking.

Terminal/Appearance/ANSIColor

TheTerminal/Appearance/ANSIColorcategoryoftheGlobalOptionsdialogallowsyoutocustomizetheANSIcolorsdisplayedinyourSecureCRTapplicationwindow.RemoteapplicationsmaysendANSIcolorescapesequencestospecifythatvariousportionsofthatapplication'sdisplayappearsinoneof16colors.Eightoftheescapesequencescorrespondtowhatarecalled"normal"colorsandtheothereighttypicallycorrespondto"bold"versionsofthosecolors.Itisdifficulttoclassifyorlabelthesecolorsbeyond"normaland"bold"becauseanapplicationmayuseanyofthecolorsforwhateveritwants.AnyapplicationthatyouconnecttowithSecureCRTmayuseanyANSIcolorescapesequence(anditsassociatedcolor)foritsownpurposes.WhileitispossibletoconfigureSecureCRTgloballytodisplay16specificcolorsinresponsetoANSIcolorescapesequences,twodifferentapplicationsmayspecifydifferentescapesequencesforsimilarfeatures.Forexample,whendisplayingfilenames,oneapplicationmayusetheescapesequencethatdefaultstoblueandanotherapplicationmayusetheescapesequencethatdefaultstocyan.

Note:ANSIcolorscanbeenabledordisabledforaspecificsessionfromtheTerminal/EmulationcategoryoftheSessionOptionsdialog.

NormalcolorsgroupThisareadisplaysthecolorsthatareassociatedwiththeeight"normal"ANSIcolorescapesequences.BoldcolorsgroupThisareadisplaysthecolorsthatareassociatedwiththeeight"bold"ANSIcolorescapesequences.

CustomizingANSIColorsTocustomizeANSIcolorselections,clickonthecolorblockthatyouwanttochangeandselectanewcolorfromtheColordialog.PressingtheDefaultbuttonreturnsthecolorblockstotheiroriginalsettings.

Terminal/Appearance/Advanced

TheTerminal/Appearance/AdvancedcategoryoftheGlobalOptionsdialogallowsyoutocontrolthecolorschemeforyourapplicationwindow,andtocontrolthetransparency/opacityofthewindow.ColorschemesgroupThisgroupallowsyoutocreatecolorschemesusedinyourSecureCRTapplicationwindow.ByusingtheEdit...andNew...buttons,youcanmodifyexistingschemesorcreatenewones.

Tip:Usingdifferentcolorschemesfordifferentsessionwindowsmakesquickidentificationeasier.YoucanchangecolorschemesforindividualsessionsintheTerminal/AppearancecategoryoftheSessionOptionsdialog.

WindowtransparencygroupThisgroupallowsyoutocontrolthetransparency/opacityofyourapplicationwindow.

ActivewindowThisoptiondetermineshowtransparentoropaquetheSecureCRTwindowiswhenitistheactivewindowonthedesktop.Theminimumallowedvaluefortheactivewindowis15sothattheactivewindowcanneverbecompletelytransparent.InactivewindowThisoptiondetermineshowtransparentoropaquetheSecureCRTwindowiswhenitisNOTtheactivewindowonthedesktop.

Note:TheSecureCRTwindowwillbecomecompletelytransparent(invisible)ifthisoptionissetto0(allthewaytotheleft).

Terminal/Tabs/Tiling

TheTerminal/Tabs/TilingcategoryoftheGlobalOptionsdialogallowsyoutoconfigurethelookandbehavioroftabsandtiledsessionwindowsinSecureCRT.Someoptionsonlyapplytotabs.Seebelowforinformationaboutwhichoptionsapplytobothtabsandtiledsessions.

AppearancegroupThisgroupallowsyoutosettheappearanceofthetabsinSecureCRT.

ConnectedClickingonthistabwhentheShowstatusindicatorsoptionissettoBackgroundcolorsorColorrectangles,allowsyoutochoosethecolordisplayedforconnectedsessions.DisconnectedClickingonthistabwhentheShowstatusindicatorsoptionissettoBackgroundcolorsorColorrectangles,allowsyoutochoosethecolordisplayedfordisconnectedsessions.NewInputClickingonthistabwhentheShowstatusindicatorsoptionissettoBackgroundcolorsorColorrectangles,allowsyoutochoosethecolordisplayedforsessionsthathavereceivednewinput.InactivityClickingonthistabwhentheShowstatusindicatorsoptionissettoBackgroundcolorsorColorrectangles,allowsyoutochoosethecolordisplayedforsessionsthathavebeeninactiveforlongerthanthenumberofsecondsspecifiedbelowintheShowinactivitystatusafteroption.LockedClickingonthistabwhentheShowstatusindicatorsoptionissettoBackgroundcolorsorColorrectangles,allowsyoutochoosethecolordisplayedforsessionsthathavebeenlocked.ShowstatusindicatorsThisoptionallowsyoutoselecthowstatusindicatorsaredisplayedonthetabs:icons,backgroundcolors,orcoloredrectangles.Iconsarealwaysshownwhensessionsaretiled.

Showinactivitystatusafternseconds

Enterthenumberofsecondsafterwhichthesessionwillbeconsideredinactive.Therangeis1to999seconds;thedefaultis5.Thisoptionisalsousedbytiledsessions.

MinimumtabwidthEntertheminimumwidthofyourtabs.SinceSecureCRTwilltrytoshrinkmultipletabstofitinonewindow,thisoptioncanbeusefultokeepyourtabsreadable.Thisoptioncanbesetfrom20to300pixels.

Note:Ifyourtabnameistoolongforthespaceavailable,SecureCRTwilltruncatethename;however,youcanviewthefullnameinatooltipbyhoveringyourpointeroverthetabname.

OptionsgroupThisgroupallowsyoutosetthebehavioroftabsinyoursystem.

Double-clickactionThisoptionallowsyoutochoosetheactiontakenwhenyoudouble-clickonatab.Theactionsincludethefollowing:

•CloseTab–Disconnectsthetab'ssessionandclosesthetab.•CloneTab–Createsanewsessionthatisidenticaltothetab's

sessionandopensitinanewtab.•CloneTabinNewWindow–Createsanewsessionthatis

identicaltothetab'ssessionandopensitinanewwindow.•SendTabtoNewWindow–Removesthetabfromthe

currentwindowandmovesitintoanewwindow.•ReconnectTab–Reconnectsthetab'ssessionifitis

disconnected.Note:Fortiledsessions,double-clickingmaximizesthesession.

TablocationThisoptionallowsyoutochoosetheplacementofthetabs,eitheratthetoporthebottomofthewindow.ConfirmwhenclosingmultipletabsSelectthisoptiontohaveSecureCRTalertyouwhenyouareclosingmorethanonetab(forexample,ifyoucloseawindowcontainingmorethanoneopensession).IftheoptionShowconfirmdisconnectdialogischecked,SecureCRTwillalwaysalertyouifoneormoresessionsisopen.Thisoptionisalsousedbytiledsessions.

OnlyshowtabswhentherearemorethanoneSelectthisoptiontoonlyhavetabsdisplayedwhentherearemultipletabs.CTRL+TABswitchestomostrecentlyusedtabInstructsSecureCRTtoapplythisoperationtothestatedkeystrokes.Thisoptionisalsousedbytiledsessions.ReusedisconnectedtabsWhenopeninganewsession,thisoptioninstructsSecureCRTtoreusethecurrentlyselectedtabifitisdisconnected.Thisoptionisenabledbydefault.Thisoptionisalsousedbytiledsessions.

Terminal/Printing

TheTerminal/PrintingcategoryoftheGlobalOptionsdialogallowsyoutosetupyourprinterconfiguration.

MarginsgroupThisgroupallowsyoutosetthemarginsonyourprintedpages.Marginsaremeasuredininches.Bydefault,allprintmarginsaresetat0.5inches.

Note:Thesesettingsmayalsobeconfiguredonapersessionbasis.Formoreinformation,seetheTerminal/PrintingcategoryoftheSessionOptionsdialog.

PrinterfontsgroupThisgroupdisplaysthefontcurrentlybeingusedforprintedpagesandalsoallowsyoutochooseadifferentfont.

Choose...PressthisbuttontoopentheFontdialogwhereyoucanchoosethefontyouwanttouseforprintedpages.

Note:Thissettingmayalsobeconfiguredonapersessionbasis.Formoreinformation,seetheTerminal/PrintingcategoryoftheSessionOptionsdialog.

PrintSetup...PressthisbuttontoopentheWindowsPrintSetupdialogwhereyoucanmodifyyourprinterconfiguration.

Pass-throughprintinggroupPass-throughprintinginSecureCRTallowstheuseofspecialprintcontrolescapesequencesthatturnon/offaprintercontrolthatsendscharactersdirectlytotheprinter.Dependingonthesequencereceived,SecureCRTmaybypasstheterminaldisplayandsendthedatadirectlytotheprinter.

Disablepass-throughprintingCheckthisoptiontodisablepass-throughprintingandcauseSecureCRTtoignoreallprintercontrolescapesequencesitreceives:

Note:Thissettingmayalsobeconfiguredonapersessionbasis.Formoreinformation,seetheTerminal/PrintingcategoryoftheSessionOptions

dialog.Bufferpass-throughprintingCheckthisoptiontobufferpass-throughprinting.Thiswillaverttheissueofsomeapplicationsthatfrequentlytogglepass-throughprintingmodeonandoff,resultinginprintedpageswithonlyonelineorpagesthatareotherwiseincomplete.Thisoptionbuffersallpass-throughprintingdataanddoesnotsendittotheprinteruntilyouinstructSecureCRTtoprintthecontentsofthepass-throughprintingbuffer.Toprintthecontentsofthepass-throughprintingbuffer:1.OpentheFilemenuandselectPrint.2.InthePrintmenu,selectEjectPage.UserawmodeCheckthisoptiontoallowtheuseofanetworkprinterwhenusingpass-throughprinting.Rawmodepass-throughprintingallowsyoutosenddatatoanamedprinterasdefinedinWindows.Inaddition,rawmodeinstructsWindowstoallowthedatatobesenttothenamedprinterwithoutbeinginterpreted(i.e.bytheprinterdriver).Ifyourhostorapplicationsendsembeddedprintercommands(e.g.,changefont,etc.),enablingrawmodepass-throughprintingwillallowthesecommandstobesentdirectlytotheprinter.Ifrawmodepass-throughprintingisenabled,SecureCRTwillnotinterpretanyembeddedprintercommands.

Note:Thissettingmayalsobeconfiguredonapersessionbasis.Formoreinformation,seetheTerminal/PrintingcategoryoftheSessionOptionsdialog.

Directpass-throughprintingtoportnCheckthisoptiontoprintdirectlytotheCOMorLPTportonthelocalmachinetowhichaprinterisattached.Directpass-throughprintingtoaportessentiallybypassestheWindowsoperatingsystem,providingSecureCRTwithdirectcommunicationtothelocalprinter.Ifdirectpass-throughprintingisenabled,printjobsarenotspooledbutaresentdirectlytotheprinter.Theporttowhichtheprinterisattachedwillnotbeaccessibletootherapplicationsuntilthecurrentprintjobhasbeencompleted.Forthesereasons,itissuggestedthatyouuserawmodepass-throughprintingratherthandirectpass-throughprintingtoport(seeUserawmode

above).Note:Thissettingmayalsobeconfiguredonapersessionbasis.Formoreinformation,seetheTerminal/PrintingcategoryoftheSessionOptionsdialog.

Settings...ClickonthisbuttontoopentheDirectPass-ThroughPrintingSettingsdialog,whichallowsyoutoconfiguretheserialdevicesettingsforpass-throughprinting.

Other

ForceblackonwhiteCheckthisoptiontoforceyourprintertoprintasthoughyoursession'sforegroundcolorissettoblackandyourbackgroundcolorissettowhite,regardlessofyoursession'sactualcolorsettings.Thisoptionisoffbydefault.Enableprintscreen(PrtScn)keyWhenthisoptionisunchecked,SecureCRTwillignoretheprintscreenkeybeingpressed.Thisoptionisoffbydefault.

Terminal/WebBrowser

TheTerminal/WebBrowsercategoryoftheGlobalOptionsdialogallowsyoutochooseyourdefaultwebbrowserandTelnetapplication.

WebbrowsergroupWithSecureCRT,youcanopenaURLbyright-clickingontheURLtextandselectingOpenURLfromthepop-upmenu.ThisgroupallowsyoutospecifywhichwebbrowserSecureCRTshoulduseforthisoperation.

UseregistrysettingforwebbrowserBydefault,thisoptionischeckedandSecureCRTwillopenaURLusingthedefaultwebbrowserforWindowsasdefinedintheWindowsregistry.TospecifyawebbrowserotherthanthedefaultbrowserforWindows,clearthisoptionandenterthefullpathtothewebbrowserthatyouwanttouseorusetheBrowsebutton toselectthebrowserapplication..UseDynamicDataExchange(DDE)SelectthisoptionifyouwantanewbrowserwindowcreatedeachtimeyouopenaURLwithSecureCRT.Bydefault,ifthedesignatedwebbrowserisalreadyrunning,theURLwillnotbeopenedinanewbrowserwindow.Instead,therunningbrowserapplicationwillbebroughtintofocus,andtheURLwillbeopenedinthatwindow.

ToopenaURLwithSecureCRT,right-clickontheURLtextandselectOpenURLfromthepop-upmenu.IfyouhavetroubleopeningaURLorifyouwanttoopenarootfolderofaURLfollowthesesteps:1.IntheSecureCRTwindow,selectallorpartoftheURL.2.Right-clickontheselectedtext.3.ClickontheOpenSelectionasURLiteminthepop-upmenu.Forexample,supposethatyourSecureCRTwindowdisplayedthefollowingURL:http://www.vandyke.com/products/securecrt/index.html

YoucouldopentheURLwww.vandyke.combyselectingjustthattextandusingtheOpenSelectionasURLcommand.

DefaultURLhandler

MakeSecureCRTyourdefaultTelnetapplicationClickonthisbuttontomakeSecureCRTthedefaultTelnetapplicationratherthanusingtheWindowsTelnetapplicationwhenitopensaURLoftheform:telnet://...

MakeSecureCRTyourdefaultSSH1applicationClickonthisbuttontomakeSecureCRTthedefaultSSH1applicationsothatSecureCRTisusedwhenaURLoftheformbelowisopened.ssh1://...

MakeSecureCRTyourdefaultSSH2applicationClickonthisbuttontomakeSecureCRTthedefaultSSH2applicationsothatSecureCRTisusedwhenaURLoftheformbelowisopened.ssh2://...

Terminal/Advanced

TheTerminal/AdvancedcategoryoftheGlobalOptionsdialogallowsyoutoconfigureSecureCRTadvancedterminalemulation-relatedoptions.

OptionsgroupThisgroupcontainsvariousSecureCRToptions.

EnableexecuteescapesequenceThisoptionallowsyoutoenableanddisabletheabilitytosendescapesequences.DisableresizeCheckthisoptiontogloballydisallowtheresizingofsessionwindowsbymeansoftheresizehandles.Notethateventhoughyoumaychangethesettingofthisoptionglobally,itispossibletomakeexceptionsforoneormoresessionsbysettingthisoptiononapersessionbasis.ResizingtheSecureCRTwindowcanaffectthenumberofrowsandcolumns(seetheSizegroupoftheSessionOptionsdialog,Terminal/Emulation

category,formoreinformation).Bydefault,theDisableresizeoptionisnotselected.

Note:FullscreenmodeisnotallowedwhentheDisableresizefeatureisset.

ConnecttomultiplesessionssequentiallyWhenmultiplesessionsareconnecting,checkthisoptiontohavethesessionsconnectoneaftertheotherinsteadofallatonce.

CustommenuandtoolbarfileThisentryboxdisplaysandallowsyoutochangetheSecureCRTmenuandtoolbarconfigurationfile.ThisfiledefinestheappearanceoftheSecureCRTmainwindowmenusandtoolbar.

FileTransfer

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfercategoryoftheGlobalOptionsdialogallowsyoutocontrolattributesoftransfersandFTPconnections.

TransferoptionsgroupThisgroupcontainsoptionsthatdefineyourfiletransferparameters.

DefaulttransfertypeChoosethedefaultfiletransfertypeforundefinedfiletypes.

·ASCII-Selectthismodetotransfertextfiles.·Binary-Selectthismodetotransferprogramfiles,orothernon-

textfilessuchasZIPfiles.·Promptfortype-Selectthisoptionifyouwanttobeprompted

forthetransfertypeeachtimeafileoftheselectedtypeisdownloaded.

ActionforexistingfilesChoosethedefaultoverwriteactionwhenfilesinatargetdirectoryalreadyexist.Thechoicesare:

·Confirmoverwrite-Presentsadialogconfirmingwhetherornottooverwritefiles.Theconfirmationdialogallowsyoutoconfirmoverwritesindividually,ortochoosetheactionforallfilesinthetransferwith"YestoAll"or"NotoAll".

·Alwaysoverwrite-Alwaysoverwritesexistingfilesinthedestinationdirectory.

·Neveroverwrite-Neveroverwritesexistingfilesinthedestinationdirectory.

·Overwriteifolder-Overwriteexistingfileswhosetimestampisolderthanthesourcefile.

PreferencesgroupThisgroupcontainsoptionsthatdefineyourgeneralpreferences.

PrompttoresumeinterruptedtransferSelectwhetherornottobepromptedtoresumeinterruptedtransferswhenstartingasession.Ifthisoptionisnotselected,SecureFXwill

notattempttoresumeinterruptedtransfersatstartup.Thisoptionisenabledbydefault.ClosewindowondisconnectChoosewhetherornottoclosesessionwindowswhenasessionisdisconnected.Thisoptionisdisabledbydefault.RestorelastsessiondirectoryChooseifyouwanttorestorethelastremotedirectorythatwasvisitedwhenstartingasession.Thisoptionisdisabledbydefault.

ConnectionretryoptionsgroupThisgroupcontainsoptionsthatallowyoutocreatearetrystrategy.

MaximumnumberofattemptsChoosethemaximumnumberoflogonretryattemptsthatwillbeperformedafterafailedlogonattempts.DelaybetweenattemptsChoosethenumberofsecondstodelaybetweenretryattempts.

RemoteeditoptionsgroupThisgroupcontainsoptionsthatallowyoutodefineactionstobetakenaftereditingafile.

WhentheeditorexitsChoosetheactiontobetakenwhentheeditorexitsafterafilehasbeenmodified.

·Prompt-askstheusertoenteranaction.·Alwaysupload-alwaysuploadstheeditedfileinthe

destinationdirectory.·Neverupload-neveruploadsafilewhetherornotithasbeen

modified.UploadwhenthefileissavedintheeditorCheckthisboxtoexecutetheactionselectedabovewhenafilehasbeenmodifiedandsaved.SecureFXdetermineswhentotakeactionbycheckingthetimestamponthefilebeingeditedtoseeifthefilehasbeenmodifiedbeforetheeditorexits.Ifthefilehasbeenmodified,SecureFXimplementstheactiondefinedbytheaboveoption.Note:Ifyouareusinganeditor,suchasMSWord,thatlocksfileswhiletheyareopen,SecureFXcannotuploadtheupdatedfilewhile

theeditorisrunning.Youwillneedtoclosethefileorexittheeditorbeforethefilecanbeuploaded.

FileTransfer/Options

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/OptionscategoryoftheGlobalOptionsdialogallowsyoutocontrolattributesoftransfersandofFTPandSFTPconnections.

LocaldirectoriesgroupLocalwindowEnterthepathofalocaldirectorythatthelocalwindowshoulddisplayonstartup.Clickonthe browserbuttontoselectthedirectory.DownloaddirectoryEnterthepathofalocaldirectorythatistobeusedasthedestinationfolderwhentheDownloadcommandisusedandtheDownloaddirectoryfieldintheSessionOptions/FileTransferdialogisleftblank.Clickonthe browserbuttontoselectthedirectory.CachedirectoryChoosethedirectorywhereSecureFXwillplaceitstemporaryfiles.Clickonthe browserbuttontoselectthedirectory.

AnonymouslogingroupPasswordEntertheanonymouspassword(usuallyanemailaddress)thatyouwanttouseasthedefaultwhenyouarecreatinganonymousloginsessions.Notethatifyoudonotfillinthisfield,SecureFXwillattempttofillinanonymouspasswordfieldswithapasswordoftheform:username@.Note:AnonymousloginisonlyapplicabletoFTPsessions.

DirectorytreeoptionsgroupDisabledirectorytreedetectionThisoptionisuncheckedbydefault.ItsetsthedefaultbehaviorfortheidenticalSessionOptions/FileTransferoption.Checkingthisoption(inSessionOptions/FileTransfercategory)willdisablethedirectorytreeforthecurrentsession.

TransferoptionsgroupVerifyfilestatusonretrieveThisoptionischeckedbydefault.ItcausesaLISTcommandtobesentpriortoretrievingafilefromtheserverinordertoobtainthemostcurrentstatistics(i.e.,sizeanddate)forthefile.MaximumnumberofparalleltransfersThisoptionallowsyoutosetthemaximumnumberoftransferoperationsthatcanbeperformedsimultaneously,givingyoucontroloveryourbandwidthusage.Thisvalueonlyappliestothetransferqueueandthesynchronizeview(i.e.,thisdoesnotapplytothetransferwindowthatappearswhenthequeueisnotenabled).NotethatspecifyingalargenumbercouldcauseCPUand/ornetworkbandwidthissues.BandwidthlimitThisoptionallowsyoutocontrolthemaximumamountofdatathatcanbesentduringanindividualtransferoperationthuscontrollingyourbandwidthusage.Specifying0forthisfieldmeansthatthereisnolimit(i.e.,SecureFXwilluseasmuchbandwidthasisavailable).

DirectorylistingoptionsgroupResolvesymboliclinksCheckingthisboxcausesSecureFXtoincludethe"L"flagwhenlistingfilesanddirectories.

FileTransfer/Options/Advanced

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/Options/AdvancedcategoryoftheGlobalOptionsdialogallowsyoutoaccessadvancedfeaturesinSecureFX.

OptionsgroupMovedeletedlocalfilestotheRecycleBinThisoptionisenabledbydefault.Disablingthisoptioncausesdeletedlocalfilestobedeletedfromthefilesystem.KeepconnectionsaliveThisoptionisoffbydefault.EnablingthisoptioncausesSecureFXtosendSFTP/FTPNO-OPcommandstotheSFTP/FTPserverwhenever1minuteormorehaspassedwithoutsendinganormalfileoperationcommand.ThiswillusuallykeeptheSFTP/FTPserverfromdetectingthattheconnectionisidleand,consequently,disconnectingthesession.Itisnotrecommendedthatyouleavethisfeatureenabled.NeverusecachedfileforremoteeditingEnablingthisoptioninstructsSecureFXnevertousethelocallycachedcopyofafiletoperformremoteediting.

LoggroupEnablelogoutputtofileEnablingthisoptioncausestheSecureFXoutputtobeloggedtothespecifiedfile.LogfilenameThisisthelogfile'sfullpath.

PermissionsgroupThisgroupcontainsoptionsthatallowyoutospecifyfileanddirectorypermissions.Thepermissionsshouldbespecifiedintheappropriateoctalrepresentation.ForFTPconnections,theseoptionsonlyworkwithUNIXsystems.

Filepermissions

Thisoptionallowsyoutospecifytheread/write/executepermissionsonuploadedfiles.Forexample,entering660intheentryboxgivesreadandwriteaccesspermissionstothefileownerandthegroup.Ifthisoptionisleftblank/empty,noattemptwillbemadetosetthepermissionsandthepermissionsusedonthefileswillbesetaccordingtotheuser'sUMASKsettingsontheremotesystem.Thisoptiononlyaffectsnewfilesthatareuploaded(i.e.,itwillnotchangethepermissionsonfilesthatalreadyexist).TheexceptiontothisruleisthatwhentheAlwaysoverwriteoptionischosenforexistingfiles,thepermissionswillbeoverwrittenevenforexistingfiles.DirectorypermissionsThisoptionallowsyoutospecifytheread/write/executepermissionsoncreateddirectories.Forexample,entering775intheentryboxgivesreadandwriteaccesspermissionstothedirectoryownerandthegroup,andreadaccesstotheworld.Ifthisoptionisleftblank/empty,noattemptwillbemadetosetthepermissionsandthepermissionsusedonthedirectorieswillbesetaccordingtotheuser'sUMASKsettingsontheremotesystem.

TransferqueuegroupSuspendtransferofqueueditemsCheckthisoptiontopostponethetransferofqueuedfilesandfolders.Youcanstartthetransferofoneorallitemsinthetransferqueuebyright-clickinginthetransferqueuewindowandselectingthedesiredoption.

FileTransfer/View

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/ViewcategoryoftheGlobalOptionsdialogallowsyoutocontroltheattributesofthelocalwindoworofsessionwindows.

GeneralgroupThisgroupcontainsoptionsthatcontrolyourgeneralviewoptions.

ShowfileattributesindetailsviewSelectthisoptiontoincludeanAttributescolumninwindowsthatusetheDetailsiconview.InthelocalwindowthiscolumnwilldisplayWindowsfileattributes.InremotesessionwindowsthiscolumndisplaysUNIX-stylepermissions,ownerandgroupownershipoffiles.ThisinformationisusuallyonlyavailableonUNIX-basedFTPservers.DisplaythefoldertreeSelectthisoptiontodisplaythefoldertreeview.ThisdefaultbehaviorcanbetemporarilysupersededwiththeuseoftheSecureFXFolderTreecommandontheViewmenuorwiththeSecureFXFolderTreetoolbarbutton.

LocalwindowgroupThisgroupcontainsoptionsthatcontrolthelocalwindow.

DisplayfilenamesusingExplorerattributesEnablingthisoptionforcesSecureFXtodisplayfilenameswiththesamealphabeticcaseastheWindowsExplorer.Forexample,anuppercasefilenamestoredondiskasAUTOEXEC.BATwillnormallydisplayinWindowsExplorerasAutoexec.bat.Bydefault,thisoptionisdisabled,whichcausesfilenamestobedisplayedusingthesamealphabeticcaseinwhichthenameisactuallystoredondisk.

Note:Whenafileisuploadedtoaremotesite,therealfilenamecaseisusedregardlessofthissetting.

DonotshowhiddenorsystemfilesThisoptionaffectsthelocalwindowonlyandisdisabledbydefault.Positiononbottom/rightwhentabbedhorizontally/verticallyThisoptioncontrolsthelocationofthelocaltabandtheremotetabs.

Whenthisoptionisenabled,thelocaltabappearsattherightorbottomofthewindow.Thisoptionisoffbydefault.

RemotewindowgroupThisgroupcontainsoptionsthatcontroltheremotewindow.

DonotshowdotfilesEnablingthisoptionpreventsfilenamesbeginningwithadot(.)inremotedirectoriesfromdisplaying.Bydefault,itisenabled.ThisoptionmaybetemporarilysupersededusingtheDotFilescommandontheViewmenu.However,theDonotshowdotfilesoptionwilltakeprecedenceovertheAllentriesoptionintheConnection//FTPcategoryoftheSessionOptionsdialog.DisplayfiletimesinlocaltimezoneEnablingthisoptioncausestheremotedirectoryfiletimestobedisplayedinthetimezonebeingusedbythelocalmachineratherthanthetimezonedefinedforthesession.Thisoptionmaybehelpfulwhenvisuallycomparingthefiletimesdisplayedontheremotemachinetothefiletimesdisplayedinthelocalwindow.Bydefault,thisoptionisdisabled.DisplaythelogviewSelectthisoptiontodisplaythesessionwindow'slogview.ThisdefaultbehaviorcanbetemporarilysupersededwiththeuseoftheSecureFXLogViewtoolbarbutton.SavesessionwindowpositionCheckingthisoptioninstructsSecureFXtostoreyoursessionwindowpositionswhenyouclosethewindowsandreopentheminthesameplace.Logwindowbuffersize(lines)Thisoptionsetsthemaximumnumberoflinesthateachlogwindowcandisplay.Thedefaultvalueis500.

TransferwindowgroupThisgroupcontainsoptionsthataffectyourtransferwindow.

NumberstyleThisoptionsetsthewaythatnumbersaredisplayedinthetransferwindow.ThedefaultselectionisAbbreviated.Theavailableoptionsare:

·Abbreviated-Selectingthisoptionwillcausenumberstobedisplayedusinganappropriateabbreviatedsizequantity(i.e.,KB,MB,GB).Numberslessthan1kilobytearenotabbreviated.

·Punctuated-SelectingthisoptionwillcausenumberstobepunctuatedusingtheRegionalparametersdefinedinthesystemsettings(e.g.,numberswouldbedisplayedwithcommasaftereverythreedigitsonU.S.systems).

FileTransfer/FTP

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/FTPcategoryoftheGlobalOptionsdialogallowsyoutocontroltheattributesofFTPtransfers.

ReceivebuffergroupUsesystemdefaultsizeBydefaultthesystemdefaultbuffersizeisused.Itishighlyrecommendedthatyouusethesystemdefaultbuffersize.SizeIfyoudecidenottousethesystemdefaultbuffersize,enterthebuffersizehere.

SendbuffergroupUsesystemdefaultsizeBydefaultthesystemdefaultbuffersizeisused.Itishighlyrecommendedthatyouusethesystemdefaultbuffersize.SizeIfyoudecidenottousethesystemdefaultbuffersize,enterthebuffersizehere.

DataconnectionoptionsgroupUseoutgoingdataconnections(PASV)ThisoptionwillinstructtheremoteservertoassignaportandlistentoitforadataconnectionbeinginitiatedbySecureFX.

Note:Thisfeaturecanbeusefulifafirewallexistsbetweenyourclientandtheserver.

Thisoptionisonbydefault.ThisisusedasthedefaultsettingfortheidenticalSessionOptions/FileTransferoption.Disabledirectserver-to-servertransfersThisoptionisuncheckedbydefault.Checkingthisoptionwillforceallserver-to-servertransferstobehandledbyestablishingindirectdataconnectionsthroughthelocalhost.Thisoptionissometimesneededwhereaserverbehavespoorlyafterreceivingarequesttoestablisha

server-to-serverconnection.LimitlocalportsusedforPORTconnectionsThisoption,whenenabled,allowsyoutospecifyarangeofportsforSecureFXtousewhenmakinganFTPorFTP/SSLdataconnection.

FileTransfer/SSL

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/SSLcategoryoftheGlobalOptionsdialogallowsyoutochooseorcreateauthenticationcertificatesforSSLtransfers.

CertificateSecureFXsupportsgeneratingandusingself-signedcertificates,whichallowsmutualauthentication.

PathEnterthepathofthecertificateyouwantSecureFXtousewhenauthenticating.Create...Pressthisbuttontoconfigureandgenerateanewcertificate.

FileTransfer/Sound

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/SoundcategoryoftheGlobalOptionsdialogallowsyoutochoosethesoundsusedbySecureFXforspecifiedevents.SecureFXsupports.wavsoundfiles.Youcanassignsoundsforthefollowingevents:

·Connect·Unexpecteddisconnect·Transfercomplete·Error

UsetheBrowsebutton tolocateandselectasoundfile,andthePlaybutton totesttheselectedfile.

FileTransfer/FileTypes

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/FileTypescategoryoftheGlobalOptionsdialogallowsyoutoconfiguretheregisteredfiletypesandtheirassociatedactionsforremotesessions.FiletypescanberegisteredwithSecureFXsothatspecificactionsaretakenwhenfilesareopenedinaremotesession.Forexample,youcanconfigureSecureFXtoautomaticallydownload,thenopenremotetextdocumentswithNotepadwhenyoudouble-clickontheminaremotesession.TheinitialfiletypesusedbySecureFXareimportedfromthesettingsusedbyExplorerwhenSecureFXisinstalled.Youmayadd,edit,orremoveanyoftheregisteredfiletypes.

Note:Theactionsandapplicationsfortheregisteredfiletypesdescribedhereapplyonlytofilesopenedinremotesessionwindows.Eachfiletypealsoincludesinformationthatappliesonlywhenopeningaremotefile,suchastransfertypeandsave-to-diskoptions.ThefiletypesusedwhenopeningfilesintheSecureFXlocalwindowarethesamefiletypesusedbyWindowsExplorer.(Referto"FileTypes"inWindowsExplorerHelpformoreinformation.)

RegisteredfiletypesThiswindowdisplaysthefileassociationsthatSecureFXcurrentlyuses.NewOpensablankEditFileTypedialogwhereyoucanaddandconfigureanewfiletype.DeleteDeletesthecurrentlyselectedfiletype.EditOpenstheEditFileTypedialogfortheselectedfiletype.SearchYoucansearchforafiletypethatisassociatedwithafileextensionbyenteringthefileextensionintheExt.editbox.PressingreturninthiseditboxorclickingtheSearchbuttonwillcausethefiletypethatisassociatedwiththeenteredfileextensiontobedisplayedandhighlighted

inthefiletypeslist.ResetAllClickthisbuttontocauseallofthefiletypesknownbyWindowsExplorertobereloadedintoSecureFX.DetailsThiswindowdisplaysthedetailforthefiletypeselectedintheRegisteredfiletypeswindow..

FileTransfer/Filters

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/FilterscategoryoftheGlobalOptionsdialogallowsyoutoconfigurefilterstobeusedinfiletransferoperations.FiltersThiswindowdisplaysthefiltersthatSecureFXcanuseinsynchronizeoperations.Tocreateanewfilter,clickontheAdd...buttontoopenablankFilterPropertiesdialog.Tomodifyandexistingfilter,selectthatfilterandclickontheEdit...buttontoopenthatfilter'sFilterPropertiesdialog.Toremoveanexistingfilter,selectthatfilterandclickontheDeletebutton.

Firewall

TheFirewallcategoryoftheGlobalOptionsdialogallowsyoutoconfigureoneormorenamedfirewalls.SecureCRTsupportsconnectionsthroughgenericproxyfirewallsaswellasSOCKSversions4and5firewalltypes.

FirewallsThiswindowliststhefirewallsthatyouhaveconfigured.ThesefirewallscanbeappliedtospecificSSH1,SSH2,Telnet/SSL,andTelnetsessionsusingtheapplicableprotocolcategoryoftheSessionOptionsdialog.

NameDisplaystheuniqueidentifyingnameforthefirewall.ThisnamewillbeusedintheSessionOptionsdialogtospecifyaspecificfirewallforagivensession.TypeDisplaysthetypeoffirewalltobeused.HostnameDisplaysthehostnameorIPaddressusedbythefirewall.PortDisplaystheportusedbythefirewall.

Tocreateanewfirewall,clickontheAdd...buttontoopenablankFirewallPropertiesdialog.Tomodifyanexistingfirewall,selectthatfirewallandclickontheEdit...buttontoopenthatfirewall'sFirewallPropertiesdialog.Toremoveanexistingfirewall,selectthatfirewallandclickontheDeletebutton.

SSH2

TheSSH2categoryoftheGlobalOptionsdialogallowsyoutoconfigureyourSSH2public-keyandAgentsettings.

PublicKey

UseidentityorcertificatefileSelectingthisoptioninstructsSecureCRTtousetheidentityfileorPKCS#12filestoredonthelocalsystemasyourmethodofauthentication.Formoreinformationonconfiguringyoursystemtouseidentityfiles,seePublic-KeyAuthenticationforSSH2.SecureCRTalsosupportsaccessingX.509certificatesthroughPKCS#11.Thelocatorprefix(e.g.,“pkcs11::”)andsuffix(e.g.,“::standard”)specifywhichpublic-keyalgorithmtouse.Tousethisfeature,enterastringsimilartooneofthefollowingexamplesbutpointingtoyourPKCS#11.dllfileinthetextbox:pkcs11::prov=c:\windows\system32\opensc-pkcs11.dll

pkcs11::prov=c:\windows\system32\pkcs11.dll::cert

Theaboveexamplesusethex509v3-sign-rsaalgorithm.pkcs11::prov=c:\windows\system32\opensc-

pkcs11.dll::standard

Theaboveexampleusesthex509v3-sign-rsa-sha1algorithm.pkcs11key::prov=c:\windows\system32\pkcs11.dll

Theaboveexampleusesthessh-rsaalgorithm,whichcanbeusedtosendthecertificateasarawkey.

FingerprintThisentryboxwillbefilledinautomaticallywhenanidentityfileisenteredabove.CreateIdentityFilePressthisbuttontostarttheGenerateKeywizardandcreateidentityfileswhichcontainyourpublic/privatekeypair.

Note:SecureCRTsupportsbothDSAandRSAkeytypes.ChangePassphrasePressthisbuttontochangethepassphraseforyourglobalSSH2

identityfile.Note:Passphrasesforspecificsessionidentityfilescanbechangedusingthatsession'sPublicKeyPropertiesdialogwhichisopenedbypressingthePropertiesbuttonontheConnection/SSH2categoryoftheSessionOptionsdialog.

Usepersonalstorecertificate(CAPI)SelectingthisoptioninstructsSecureCRTtouseX.509certificatesfromyourMicrosoftCAPIpersonalstoreasyourmethodofauthentication.FormoreinformationonX.509certificates,seeUsingX.509Certificates.

AdvancedgroupAddkeystoagentCheckthisoptiontoenabletheSSH2Agent.Agentsareprogramsthatworkinthebackgroundgatheringinformationorperformingsmallprocessingtasks.InSecureCRT,theimplementedagenttemporarilyholdsprivatekeysforusewithpublic-keyauthenticationtomultipleremotehosts.Formoreinformationonagents,seeUsingtheAgent.EnableOpenSSHagentforwardingCheckthisoptiontousetheagenttoconnecttoaremotemachinethroughanotherremotemachine(seeUsingtheAgent).Thisoptioncanbeoverriddenonaper-sessionbasisfromtheSessionOptions/Connection/SSH2/Advancedcategory.EnabledeprecatedGSSAPICheckthisoptiontohaveSecureCRTfirstattempttoconnectusingGSSAPIwithMICandthen,ifthatisnotsuccessful,tryregularGSSAPI.Ifthisboxisnotchecked,SecureCRTwillonlytrytoconnectusingGSSAPIwithMIC.

Note:WhenusingKerberoshostanduserauthenticationviaGSSAPI,theconnectioncouldbevulnerabletoaman-in-the-middleattack.UsingGSSAPIwithMICeliminatesthisrisk.AlthoughtheGSSAPImethodhasbeendeprecated,GSSAPIwithMICisnotyetwidelysupported.SecureCRTallowsyoutoattempttoconnectusingGSSAPIwithMICifitisavailableontheserver.

CachesessionpasswordWhenthisoptionisset,passwordswillbecachedwhileSecureCRT,SecureFX®,ortheActivatorisrunningsothatwhenre-connectingto

thatsessionorconnectinginoneoftheotherapplications,thepassworddoesnothavetobere-entered.

SSHHostKeys

TheSSHHostKeyscategoryoftheGlobalOptionsdialogallowsyoutomanageyourhostkeys.SecureCRTprovidessupportforviewing,importing,exportinganddeletinghostkeys.

AcceptedhostkeysThislistdisplaysyourhostkeysbyHost(hostnameandIPaddress)andPort.Youcanalsoselectoneoftheexistinghostkeysfromthelistandview,export,ordeleteitbypressingtheappropriatebutton.ViewKey...Pressthisbuttontoviewtheselectedhostkeyintextualformat.ImportKey...Pressthisbuttontoimportanewhostkeyfile.ExportKey...Pressthisbuttontocreateatextfileoftheselectedhostkeythatissuitableforsendingtoserveradministratorsandothers.DeletePressthisbuttontoremovetheselectedhostkeyfromthelistanddeletethehostkeyfilefromyoursystem.

HostkeydatabaselocationThisentryboxdisplaysandallowsyoutochangethelocationofthehostkeydatabase.X.509HostKeysSecureCRTsupportsautomaticacceptanceofX.509hostkeys.Thismeansthatifthefollowingconditionsaremet,thehostkeywillbeacceptedwithoutpromptingtheuser.Beforeacceptingacertificate,SecureCRTcheckstoensurethefollowingconditions:1.Thehostnametowhichyouareconnectingmatchesthecommon

namepartofthesubjectnameofthecertificate.2.Thecurrentdateisbetweenthestartandendvaliditydatesofthe

certificate.3.Thecertificatechainstoatrustedrootcertificate(anchor)installedin

theMicrosoftCAPIstore.4.IftheCheckcertificaterevocationlistsoptionbelowhasbeen

checked,SecureCRTcheckstoensurethatthecertificate(andanyinitschain)havenotbeenlistedasrevokedinacertificaterevocationlist(CRL)installedintheMicrosoftCAPIstore.

DigitalcertificatesgroupCheckcertificaterevocationlistsCheckthisoptiontohaveSecureCRTcheckthecertificaterevocationlistsbeforeacceptingahostkey.

SessionOptionsDialog

TheSessionOptionsdialogallowsyoutocreateanewsessionortomodifyanexistingsession.ThedialogcanbeaccessedfromthemainSecureCRTwindowbyclickingonSessionOptions...intheOptionsmenuorbyclickingontheSessionOptionsbutton onthetoolbar.TheSessionOptionsdialogcanalsobeaccessedfromtheConnectdialogbyclickingoneithertheNewSession buttonorPropertiesbutton.TheSessionOptionsdialogliststheavailablecategoriesanddisplaystheoptionsforthecategoryselected.TheoptionschangewiththeselectionintheCategorywindow.

IMPORTANT:Ifyoueditasessiontowhichyouarecurrentlyconnected,thesettingswillrevertbacktoyouroldsettingswhenyouclosethesession.Topermanentlychangesessionoptions,closethesession,maketheedits,andthenreopenthesession.

ThesessionoptioncategoriesdisplayedwillchangedependingontheProtocolselectedintheConnectioncategory.Theavailablecategoriesandsubcategoriesareasfollows:

·Connection·LogonActions·SSH1(whenSSH1istheselectedprotocol)

·Advanced·SSH2(whenSSH2orSFTPistheselectedprotocol)

·SFTPSession·Advanced

·Telnet(whenTelnetistheselectedprotocol)·Telnet/SSL(whenTelnet/SSListheselectedprotocol)·RLogin(whenRLoginistheselectedprotocol)·FTP(whenFTPistheselectedprotocol)

·SSLOptions(whenFTP/SSListheselectedprotocol)·Serial(whenSerialistheselectedprotocol)·TAPI(whenTAPIistheselectedprotocol)

·Advanced

·Raw(whenRawistheselectedprotocol)·PortForwarding(whenSSH1orSSH2istheselectedprotocol)

·Remote/X11(whenSSH2istheselectedprotocol)·Terminal

·Emulation·Modes·Emacs·MappedKeys·Advanced

·Appearance·ANSIColor·Window

·LogFile·Printing

·Advanced·X/Y/Zmodem

·FileTransfer·FTP/SFTP(whenFTPorSFTPistheselectedtransferprotocol)

Connection

TheConnectionscategoryoftheSessionOptionsdialogallowsyoutoconfigureasessionconnection.TheoptionsoftheConnectioncategoryoftheSessionOptionsdialogarebasedonthechoiceofProtocol.Inotherwords,ifTelnetisselectedastheprotocol,theoptionsdisplayedonthedialogwillbedifferentthanifSSH2isselected.BelowisalistoftheprotocolsandoptionsavailableinSecureCRT.Thefollowingoptionsaredisplayedforallprotocols.NameEnterauniquelyidentifyingnameforthissession.Protocol(ThisoptionappearsifonlySecureCRTisinstalled)Selecttheprotocolthatyouwanttouseforthissession.SecureCRTsupportsthefollowingprotocols:SSH1,SSH2,Telnet,Telnet/SSL,RLogin,Serial(COM),TAPI,andRaw.

Protocolgroup(ThisgroupappearsifSecureCRTandSecureFXarebothinstalled)Selecttheprotocolthatyouwanttouseforthestatedtypeofsession.

Note:IfFIPSmodeisenabled,thefollowingprotocolscannotbeused:SSH1,Telnet/SSL,andFTP/SSL.TerminalSelecttheterminalemulationprotocolthatyouwanttouseforthissession.SecureCRTsupportsthefollowingprotocols:SSH1,SSH2,Telnet,Telnet/SSL,RLogin,Serial(COM),TAPI,andRaw.FiletransferSelectthefiletransferprotocolthatyouwanttouseforthissession.SecureFXsupportsthefollowingprotocols:SFTP,FTP,andFTP/SSL.

DescriptiongroupEnterasessiondescriptiontobedisplayedintheConnectwindow.

Connection/LogonActions

TheLogonActionscategoryoftheSessionOptionsdialogallowsyoutorunscriptstoautomateloggingontoaremotemachineandperformotherfunctions.AutomatelogonCheckthisoptiontocreateasimplescripttoautomateloggingontoaremotemachine.UsetheExpectandSendfieldstoenterthecharacterstringsthatSecureCRTshouldexpecttoreceivefromtheremotemachineandshouldsendasitsresponse.IfyouwantSecureCRTtosendacarriagereturnbeforerunningascript,checktheSendinitialcarriagereturnoption.SendinitialcarriagereturnCheckthisoptionifyouwantSecureCRTtosendacarriagereturntotheremotemachinebeforestartingtheautomatedlogonscript.Somesystemswillnotdisplayalogonpromptuntilreceivingacarriagereturn.Expect/SendIntheExpectentryboxes,enterthecharacterstringsthatSecureCRTshouldexpecttoreceivefromtheremotemachineintheorderthattheyshouldbereceived.IntheassociatedSendentryboxes,enterthestringsthatyouwantSecureCRTtosendinresponsewhenitreceivestheExpectstring.ForalistoffunctionkeycommandsthatcanbeincludedinSendstrings,seeSendStringandFunctionKeyCommands.

Note:SecureCRTworksthroughtheExpectstringsfromtoptobottom;inotherwords,ifSecureCRTdoesnotreceivethefirstexpectedstring,itwillnotsendtheassociatedSendstringorlistenforthenextexpectedstring.Examplescript:ThefollowingisanexamplescriptthatwillinstructSecureCRTtolistenforthelogonprompt"Logon>"andrespondwiththeusername"johnsmith"whenthepromptisreceived.SecureCRTwillthenlistenfor"Password>"andrespondtoitwith"way2easy".Finally,SecureCRTwilllistenforthestring"Welcome"andrespondwiththedirectoryrequest"dir".

Expect: Logon> Send: johnsmith

Expect: Password> Send: way2easyExpect: Welcome Send: dir

HideCheckthisboxtohavetheSendstringshownasasterisks.Thisoptionletsyouavoiddisplayingconfidentialinformationsuchasapassword.LogonscriptCheckthisoptiontoselectascriptfilethatyouwantSecureCRTtorunwhenitmakesaconnection.

Note:IftheAutomatelogonoptionisalsoselected,itwillbeexecutedfirst.

RemotecommandEnterthecommandthatyouwantSecureCRTtoinstructtheremotemachinetorunwhenaconnectionismade.

Note:Theremotecommandistheonlycommandthatthesessionwillrun.Oncethecommandexits,thesessionwilldisconnect.

DisplaylogonpromptsinterminalwindowCheckthisoptiontohaveSecureCRTdisplaylogonpromptsintheterminalwindow.

Connection/SSH1

TheSSH1categoryoftheSessionOptionsdialogallowsyoutoconfigureyourSSH1connection.TheSSH1categoryonlyappearswhenyouhaveselectedSSH1asyourProtocol.

SSH1OverviewPortforwardingisanotherfeaturebasedonSSHsecurity.SeePortForwardingwithSSHtolearnmoreaboutencryptingconnectionsforotherapplications(suchasIMAP)thatarenotsecurebydefault.SSH1connectionsettingsincludehostname,port,username,authentication,andkeyexchange.HostnameThehostnameorIPaddressoftheremotemachinethatprovidestheSSH1service.PortTheportnumberoftheSSH1serviceontheremotemachine.ForSSH1,thedefaultportis22.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Note:YoucanalsoselectanSSH2sessiontobeusedasafirewall.Whenasessionisspecifiedasafirewall,thefirewallsessionwillbeconnectedfirst.

UsernameTheusernameusedtologontotheremotemachine.AuthenticationSecureCRTsupportsthreetypesofauthenticationforconnectingtoSSH1servers:password,RSA,andTIS.

Passwordauthenticationtransmitstheuser'spasswordtotheservertoauthenticatetheconnection.Thetransmittedpasswordisprotectedfromnetworkeavesdropping,duetothecipherencryptionofthedatachannel.Forthisreason,someSSH1serversrejecttheuseofpasswordauthenticationifthecipherissettoNone.

RSAauthenticationusesapublic/privatekeypairtoauthenticatetheconnection.ThegeneralmechanismbehindRSAauthenticationisthattheSSH1server"challenges"theclienttodecryptamessageencodedusingtheuser'spublickeystoredontheserver.Uponconnecting,theSSH1servergeneratesarandomvalue,encryptsthevalueusingtheuser'spublickeyandsendstheencryptedchallengetotheclient.Theclientauthenticatestheconnectionbysuccessfullydecryptingthechallengeusingtheuser'sprivatekey.Thesecurityofthemechanismrequiresthatnoonebuttheownerhaveaccesstotheprivatekey.Theprivatekeyisstoredlocallyinanidentityfile.ThefirsttimeyouconnecttoanSSH1serverusingRSAauthentication,SecureCRTwillpromptyouforthelocationofthisfile.Also,priortousingRSAauthentication,thepublickeymustbemadeavailabletotheSSH1server.TISfirewallauthenticationusestheTISfirewallservertoprovideachallengephrase/responsecombination.SSH1serversmustbeconfiguredtoofferTISauthentication.

KeyexchangegroupKeyexchangeispartofestablishingtrustbetweenaclientandaSecureShellserver.SecureCRTsupportsseveralalgorithmsfordoingkeyexchangeandwillattempttousethemintheorderthatyouspecify.

Diffie-HellmankeyexchangealgorithmsarecommoncryptographicprotocolswhicharesupportedbySecureShellservers.GSSAPIkeyexchangealgorithmscanbeusedtoconnecttoSSH2serversthatsupportGSSAPI.WhenaGSSAPIkeyexchangealgorithmisspecifiedandtheserversupportsit,furtherauthenticationisnotneededifyoualreadyhaveGSSAPIcredentials(e.g.,byloggingontoaWindowsmachinethatispartofanActiveDirectorydomain).IfaGSSAPIkeyexchangealgorithmisspecifiedandisnotsupportedbytheserver,therecouldbeadelayduringconnectionbecausetheserveriswaitingtotimeout.Topreventthisdelay,unchecktheGSSAPIkeyexchangealgorithms.

Connection/SSH1/Advanced

TheSSH1/AdvancedcategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourSSH1connection.TheSSH1categoryonlyappearswhenyouhaveselectedSSH1asyourProtocol.CipherTheencryptionalgorithmtousefordataprivacy.Thedefaultcipheris3DES.DES,RC4andBlowfishciphersarealsoavailableforusewiththeSSH1protocol.YoumayalsosettheciphertoNone,whichwilleffectivelyrenderyourconnectioninsecure.NoencryptionwilloccurifthecipherissettoNone,andalldatawillbetransmittedinplaintext.

WARNING:SettingciphertoNonecausesthedatachanneltobeleftunencryptedandoffersnosecurity.

CipherSpeedInformation--TheDESand3DESciphersareveryCPUintensive(slow).TheRC4andBlowfishciphersareconsiderablylessCPUintensive(faster).MAC(MessageAuthenticationCode)(SSH2Only)TheSSH2protocolprovidesincreasedsecurityoverSSH1bymeansofaMAC(MessageAuthenticationCodes)whichensuresdataintegrity.AlthoughspecifyingaMACisoptional,itishighlyrecommendedthataMACbespecifiedinordertoensuredataintegrity.

WARNING:DataintegritycannotbeensuredifMACissettoNone.SecureCRTwillattempttoconnectusingthefirstselectedMACintheMAClistandthen,ifnotsuccessful,workdownthelisttryingeachselectedMAC.Toreorderthelist,selecttheMACthatyouwanttorepositionandusethebuttonstotherightofthelisttomovetheMACupordown.

OptionsgroupCompressionEnablethisoptiontohaveSecureCRTusecompressionwhentransferringdata.EnableOpenSSHagentforwardingCheckthisoptiontousetheagenttoconnecttoaremotemachinethroughanotherremotemachine(seeUsingtheAgent).

LevelThisoptioncontrolsthelevelofcompression.Thecompressionlevelrangesfrom0(minimalcompression)to9(maximumcompression).Ahigherlevelmeansbettercompressionbutslowerperformance.Thedefaultvalueis5.

Connection/SSH2

TheSSH2categoryoftheSessionOptionsdialogallowsyoutoconfigureyourSSH2connection.TheSSH2categoryonlyappearswhenyouhaveselectedSSH2orSFTPasyourProtocol.

SSH2OverviewSSH2providessecurecommunicationoveranunsecurechannelbyencryptingthedatachannelusingthecipheralgorithmselectedforthesessionbytheuser.ThecipherselectedmustalsobesupportedbythedestinationSSH2server(anerrorwillbereportedduringaconnectionattemptifthechosencipherisnotsupportedbytheserver).AcipherisusedtoencryptnetworktrafficbetweenthelocalmachineandtheSSH2server,thusprovidingdataprivacy.PortforwardingisanotherfeaturebasedonSSHsecurity.SeePortForwardingwithSSHtolearnmoreaboutencryptingconnectionsforotherapplications(suchasIMAP)thatarenotsecurebydefault.SSH2connectionsettingsincludehostname,port,username,authentication,andkeyexchange.HostnameThehostnameorIPaddressoftheremotemachinethatprovidestheSSH2service.PortTheportnumberoftheSSH2serviceontheremotemachine.ForSSH2,thedefaultportis22.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Note:YoucanalsoselectanSSH2sessiontobeusedasafirewall.Whenasessionisspecifiedasafirewall,thefirewallsessionwillbeconnectedfirst.

UsernameTheusernameusedtologontotheremotemachine.

Authenticationgroup

SecureCRTsupportsseveralauthenticationmethodsforconnectingtoSSH2servers,andwillattempttoconnectusingthemintheorderthatyouspecify.

Passwordauthenticationtransmitstheuser'spasswordtotheservertoauthenticatetheconnection.Thetransmittedpasswordisprotectedfromnetworkeavesdropping,duetothecipherencryptionofthedatachannel.

Note:IftheremotemachinesupportsboththeSSH2protocolandchangingpasswordsattheprotocollevel,thepasswordforanSSH2sessioncanbechangedfromthePasswordPropertiesdialog,whichisaccessedbyselectingPasswordintheAuthenticationgroupandclickingonthePropertiesbutton.

PublicKeyauthenticationusesapublic/privatekeypairtoauthenticatetheconnection.Duringtheauthenticationprocess,theclientandtheservernegotiateapublickeytousefortheconnection.Onceapublickeyhasbeendetermined,theclientusesthecorrespondingprivatekeytoperformasignatureoperationoverauniqueconnectionidentifier.Thissignatureisthensenttotheserverforverification.Ifverificationissuccessful,theclientisgivenpermissiontoconnecttotheserver.Thesecurityofthemechanismrequiresthatnoonebuttheownerhaveaccesstotheprivatekey.Theprivatekeyisstoredlocallyinanidentityfile.Also,priortousingpublic-keyauthentication,thepublickeymustbemadeavailabletotheSSH2server.Formoreinformationongeneratingprivate-publickeypairs,seePublic-KeyAuthenticationforSSH2.KeyboardInteractiveauthenticationallowsyoutousethekeyboardtorespondtochallengesputforthbytheserver.GSSAPI(GenericSecurityServicesApplicationProgramInterface)isagenericAPIforperformingclient/serverauthentication.GSSAPIallowsSecureCRTtoauthenticatewithaserverwithoutknowinganythingaboutthespecificauthenticationmechanisminuse.FormoreinformationaboutusingGSSAPI,seetheGSSAPIPropertiesdialog.SecureCRTalsosupportstheuseofX.509certificates.

KeyexchangegroupKeyexchangeispartofestablishingtrustbetweenaclientandaSecure

Shellserver.SecureCRTsupportsseveralalgorithmsfordoingkeyexchangeandwillattempttousethemintheorderthatyouspecify.

Diffie-HellmankeyexchangealgorithmsarecommoncryptographicprotocolswhicharesupportedbySecureShellservers.GSSAPIkeyexchangealgorithmscanbeusedtoconnecttoSSH2serversthatsupportGSSAPI.WhenaGSSAPIkeyexchangealgorithmisspecifiedandtheserversupportsit,furtherauthenticationisnotneededifyoualreadyhaveGSSAPIcredentials(e.g.,byloggingontoaWindowsmachinethatispartofanActiveDirectorydomain).IfaGSSAPIkeyexchangealgorithmisspecifiedandisnotsupportedbytheserver,therecouldbeadelayduringconnectionbecausetheserveriswaitingtotimeout.Topreventthisdelay,unchecktheGSSAPIkeyexchangealgorithms.

Connection/SSH2/Advanced

TheSSH2/AdvancedcategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourSSH2connection.TheSSH2categoryonlyappearswhenyouhaveselectedSSH2orSFTPasyourProtocol.CipherTheencryptionalgorithmtousefordataprivacy.TheciphersprovidedforusewiththeSSH2protocolinSecureCRTareAES,Twofish,Blowfish,3DES,andRC4.YoumayalsosettheciphertoNone,whichwilleffectivelyrenderyourconnectioninsecure.NoencryptionwilloccurifthecipherissettoNone,andalldatawillbetransmittedinplaintext.

WARNING:SettingciphertoNonecausesthedatachanneltobeleftunencryptedandoffersnosecurity.

SecureCRTwillattempttoconnectusingthefirstselectedcipherintheCipherlistandthen,ifnotsuccessful,workdownthelisttryingeachselectedcipher.Toreorderthelist,selectthecipherthatyouwanttorepositionandusethebuttonstotherightofthelisttomovethecipherupordown.CipherSpeedInformation--The3DEScipherisveryCPUintensive(slow).TheAESandTwofishciphersareconsiderablylessCPUintensive(faster)than3DES.MAC(MessageAuthenticationCode)TheSSH2protocolprovidesincreasedsecurityoverSSH1bymeansofaMAC(MessageAuthenticationCodes)whichensuresdataintegrity.AlthoughspecifyingaMACisoptional,itishighlyrecommendedthataMACbespecifiedinordertoensuredataintegrity.TheMACsprovidedforusewiththeSSH2protocolinSecureCRTareSHA1,MD5,andUMAC.

WARNING:DataintegritycannotbeensuredifMACissettoNone.SecureCRTwillattempttoconnectusingthefirstselectedMACintheMAClistandthen,ifnotsuccessful,workdownthelisttryingeachselectedMAC.Toreorderthelist,selecttheMACthatyouwanttorepositionandusethebuttonstotherightofthelisttomovetheMACupordown.

Optionsgroup

CompressionSelectthetypeofcompressionthatyouwantforthisSSH2session.LevelThisoptioncontrolsthelevelofcompression.Thecompressionlevelrangesfrom0(minimalcompression)to9(maximumcompression).Ahigherlevelmeansbettercompressionbutslowerperformance.Thedefaultvalueis5.EnableOpenSSHagentforwardingCheckthisoptiontousetheagenttoconnecttoaremotemachinethroughanotherremotemachine(seeUsingtheAgent).Thisisatri-stateoption;Ifthisoptionissettothetri-statevalue(square),thesettingfromtheGlobalOptions/SSH2categorywillbeused.

Connection/SSH2/SFTPSession

TheSSH2/SFTPSessioncategoryoftheSessionOptionsdialogallowsyoutospecifythedirectoriesyouwanttoconnecttouponstartingthesession.

InitialDirectoriesLocaldirectoryEnterthepathofthelocaldirectorythatyouwantthelocalwindowtodisplayonstartupofthesession.Thisisthedefaultfolderfromwhichyouwanttotransferfilestotheremotemachine.Clickonthebrowserbuttontouseadirectorybrowsertoselectthedirectory.RemotedirectoryEnterthefullpathofthedirectoryontheremotehostthatyouwanttobethecurrentdirectoryuponconnectingtotheremotehost.Ifthethisisnotspecified,thedefaultorhomedirectoryfortheusernameontheremotesystemwillbeused.

Connection/Telnet

TheTelnetcategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourTelnetconnection.TheTelnetcategoryonlyappearswhenyouhaveselectedTelnetasyourProtocol.HostnameThehostnameorIPaddressoftheremotehost.PortTheportnumberofaserviceonaremotemachine.ForTelnet,thedefaultportis23.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Note:YoucanalsoselectanSSH2sessiontobeusedasafirewall.Whenasessionisspecifiedasafirewall,thefirewallsessionwillbeconnectedfirst.

AdvancedgroupWillLFLOWSelectthisoptiontoenablelocalflowcontrolwhenconnectingtoTelnetsitesthatsupportLFLOW.Thisoptionisselectedbydefault.EnableNAWSSelectthisoptiontoenabletheNegotiateAboutWindowSize(NAWS)feature.NAWSallowsaTelnetclientandaTelnetservertonegotiateresizingtheterminalwindow.

Note:NAWSmaynotbeapplicabletoallsystems.ForcecharacteratatimemodeSelectthisoptiontoforceSecureCRTtobein"characteratatime"Telnetmode.ThisoptionmayberequiredinrarecaseswhereTelnetnegotiationbetweentheclientandserverdoesnotoccurcorrectly.

WARNING:Formostusers,thisoptionshouldnotbeselected.SendSGA(port23only)SelectthisoptiontoinitiateTelnetnegotiationbysendingtheTelnetSGAcommand.MostTelnetserversexpectthisfromtheTelnetclient.

WARNING:Formostusers,thisoptionshouldbeselected.SendSGASelectthisoptiontosendtheDOSGAcommandimmediatelyafterconnecting.EnableNTLMauthenticationSelectthisoptiontoenableNTLANManager(NTLM)authentication.Thisoptionisenabledbydefault.

Connection/Telnet/SSL

TheTelnet/SSLcategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourTelnetconnectionoverthecryptographiccommunicationsprotocolSSL.TheTelnet/SSLcategoryonlyappearswhenyouhaveselectedTelnet/SSLasyourProtocol.HostnameThehostnameorIPaddressoftheremotehost.PortTheportnumberofaserviceonaremotemachine.ForTelnet/SSL,thedefaultportis992.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Note:YoucanalsoselectanSSH2sessiontobeusedasafirewall.Whenasessionisspecifiedasafirewall,thefirewallsessionwillbeconnectedfirst.

AdvancedgroupWillLFLOWSelectthisoptiontoenablelocalflowcontrolwhenconnectingtoTelnetsitesthatsupportLFLOW.Thisoptionisselectedbydefault.EnableNAWSSelectthisoptiontoenabletheNegotiateAboutWindowSize(NAWS)feature.NAWSallowsaTelnetclientandaTelnetservertonegotiateresizingtheterminalwindow.

Note:NAWSmaynotbeapplicabletoallsystems.ForcecharacteratatimemodeSelectthisoptiontoforceSecureCRTtobein"characteratatime"Telnetmode.ThisoptionmayberequiredinrarecaseswhereTelnetnegotiationbetweentheclientandserverdoesnotoccurcorrectly.

WARNING:Formostusers,thisoptionshouldnotbeselected.SendSGA(port992only)SelectthisoptiontoinitiateTelnetnegotiationbysendingtheTelnet

SGAcommand.MostTelnetserversexpectthisfromtheTelnetclient.WARNING:Formostusers,thisoptionshouldbeselected.

SendSGASelectthisoptiontosendtheDOSGAcommandimmediatelyafterconnecting.EnableNTLMauthenticationSelectthisoptiontoenableNTLANManager(NTLM)authentication.Thisoptionisenabledbydefault.

SSLgroupDisablecertificatevalidationSelectthisoptiontodiscontinuecheckingthevalidityofX.509certificates.

WARNING:Whileselectingthisoptionmayspeedupyourconnectiontime,itmayleaveyouvulnerabletoinvalidcertificates.

Connection/RLogin

TheRLogincategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourRLoginconnection.TheRLogincategoryonlyappearswhenyouhaveselectedRLoginasyourProtocol.RLoginconnectionsettingsincludehostnameorIPaddress,andusername.HostnameEnterthehostnameorIPaddressoftheremotehost.UsernameEntertheusernameusedtologontotheremotemachine.

Connection/Serial

TheSerialcategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourSerialconnection.TheSerialcategoryonlyappearswhenyouhaveselectedSerialasyourProtocol.TheSerialprotocolisusedtoconnecttoanothercomputerwithyourcomputer'sCOMportorwithamodemattachedtoyourcomputer'sCOMport.PortEntertheSerialport(COM1,COM2,etc.)usedbythesession.BaudrateSelectthebaudrateforthedevice.Thedefaultvalueis38400.Thebaudratecanbechangedwhileasessionisconnected.DatabitsSelectthenumberofcommunicationdatabits.Thedefaultvalueis8.ParityChoosetheparitysettingsupportedbytheconnecteddevice.ThedefaultsettingisNone.StopbitsChoosenumberofstopbitssentaftereachcharacter.Thedefaultvalueis1.

FlowcontrolgroupDTR/DSRSelectthisoptiontousetheDTR/DSR(data-terminal-ready/data-set-ready)signalswiththeconnecteddevice.Bydefault,thisisnotselected.RTS/CTSSelectthisoptiontouseRTS/CTS(request-to-send/clear-to-send)hardwareflowcontrol.Bydefault,thisoptionisselected.XON/XOFFSelectthisoptiontouseXON/XOFFsoftwareflowcontrol.Bydefault,thisoptionisnotselected.

Serialbreaklength

SelectthelengthofbreaksinSerialdatatraffic.Formoreinformationaboutbreaks,pleaseseeSendingaSerialBreak.

Connection/TAPI

TheTAPIcategoryoftheSessionOptionsdialogallowsyoutoconfigureyourTAPIconnectionsandredialstrategyforbusynumbers.TheTAPIcategoryonlyappearswhenyouhaveselectedTAPIasyourProtocol.YoucanusetheTAPIprotocolto"share"yourcomputer’smodemwithotherapplications.Forexample,ifyouhaveafaxapplicationthatisTAPIcompliant,youwillbeabletohavebothSecureCRTandyourfaxsoftwareopenatthesametime.Althoughbothprogramscannotusethemodematexactlythesametime,TAPIcompliantprogramscanberunningatthesametime,usingthemodemtodialoutorreceivecallsonan"asneeded"basis.WhenusingTAPI,thefollowinginformationmustbeentered:DialusingSelectthemodemyouwouldliketousefromtheDialusinglistofmodems.Ifyouhaveamodeminstalled,youcanalsoconfigureitwhileintheSessionOptionsdialogbyselectingthemodemandclickingontheConfigurebutton.CountrycodeEnterthecountrycodeassociatedwiththenumberyouaredialing.AreacodeEntertheareacodeforthenumberyouaredialing.PhonenumberEnterthephonenumberthatyouaredialing.SecureCRTalsoallowsyoutospecifyanyalternatephonenumbersyouwishtodialusingthesamesession.

AutoredialgroupNumberofredialattemptsSelectthenumberofredialattemptsthatSecureCRTwillmakebeforegivingupontheconnection.DelaybetweenattemptsSelectthenumberofsecondsthatSecureCRTwillwaitbetweenredialattempts.

Connection/TAPI/Advanced

TheTAPI/AdvancedcategoryoftheSessionOptionsdialogallowsyoutoenteralternatephonenumbersiftheremotemachineorBBSyouareattemptingtodialprovidesyouwithalternatenumbers.TheTAPI/AdvancedcategoryonlyappearswhenyouhaveselectedTAPIasyourProtocol.NewphonenumberEnterthealternatephonenumber.ClickontheAddbuttontoaddthenumbertothePhonenumberslistbelow,orclickontheReplacebuttontoreplaceanumberselectedinthelist.PhonenumbersThislistdisplaystheconfiguredphonenumbersintheorderinwhichtheywillbetried.YoucanchangethisorderbyselectinganumberandusingtheUporDownbuttonstomoveitinthelist.

MovesuccessfulnumbertotopoflistonconnectionCheckthisoptiontomoveanumberthathasmadeasuccessfulconnectiontothetopofthelist.

Connection/Raw

TheRawcategoryoftheSessionOptionsdialogallowsyoutofurtherconfigureyourRawconnection.TheRawcategoryonlyappearswhenyouhaveselectedRawasyourProtocol.HostnameThehostnameorIPaddressoftheremotehost.PortTheportnumberofaserviceonaremotemachine.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Note:YoucanalsoselectanSSH2sessiontobeusedasafirewall.Whenasessionisspecifiedasafirewall,thefirewallsessionwillbeconnectedfirst.

Connection/FTP

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFTPcategoryoftheSessionOptionsdialogallowsyoutocontrolattributesofFTPconnections.TheFTPcategoryonlyappearswhenyouhaveselectedFTPasyourProtocol.

FTPlogongroupHostnameThehostnameorIPaddressoftheremotemachinethatprovidestheFTPservice.PortTheportnumberoftheFTPserviceontheremotemachine.ForFTPandFTP/SSL(explicit),thedefaultportis21.ForFTP/SSL(implicit),thedefaultportis990.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Note:YoucanalsoselectanSFTPorSCPsessiontobeusedasafirewall.IfSecureFXisintegratedwithSecureCRT,anSSH2sessioncanalsobeusedasafirewall.Whenasessionisspecifiedasafirewall,thefirewallsessionwillbeconnectedfirst.

AnonymousloginWhenthisoptionisselected,SecureFXautomaticallyselectsanonymousastheusernameandfillsinthepasswordfieldusingthepasswordyousuppliedintheGlobalOptions/FileTransfer/Optionsdialog.Unselectingthisoptionmakestheusernameandpasswordfieldsavailable.UsernameTheusernameusedtologontotheremotemachine.PasswordThepasswordusedtologontotheremotemachine.AccountTheaccountnametobeusedontheremotemachine.

DataconnectionoptionsgroupUseoutgoingdataconnection(PASV)CheckingthisboxforcesalldataconnectionstobeoriginatedbySecureFX(usingtheFTPPASVcommand).ThissettingisoftenneededwhereafirewallwillnotallowincomingconnectionsfromexternalFTPservers.Whenthischeckboxisunchecked,SecureFXwillhavetheFTPservercreateanincomingdataconnectioninstead(usingtheFTPPORTcommand).Thischeckboxcanalsobesettoathird,indeterminatestate.Whenthecheckboxisinthisstate,itappearsgrayedoutandwillcauseSecureFXtousetheUseoutgoingdataconnectionsettingintheGlobalOptions/FileTransfer/FTPdialog.

DirectorylistingoptionsgroupResolvesymboliclinksCheckingthisboxcausesSecureFXtoincludethe"L"flagwhenlistingfilesanddirectories.LongformatCheckingthisboxcausesSecureFXtoincludethe"-l"flagwhenlistingfilesanddirectories.ThisrequeststhattheFTPserverincludeallavailablecolumnsofinformationaloutputwhenperformingdirectorylistings.ThisoptionisusuallyonlyusefulwhentheserverisaUNIXsystem.Thisoptionisoffbydefault.AllentriesCheckingthisboxcausesSecureFXtoincludethe"-a"flagwhenlistingfilesanddirectories.ThisrequeststhattheFTPserverincludehiddenfiles(includingdotfiles)whenperformingdirectorylistings.ThisoptionisusuallyonlyusefulwhentheserverisaUNIXsystem.Thisoptionisoffbydefault.

Note:TheDonotshowdotfilesoptionfromtheGlobalOptions/FileTransfer/ViewdialogwilltakeprecedenceovertheAllentriesoption.

Connection/FTP/SSLOptions

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFTP/SSLOptionscategoryoftheSessionOptionsdialogallowsyoutocontrolattributesofFTP/SSLconnections.TheFTP/SSLOptionscategoryonlyappearswhenyouhaveselectedFTP/SSLasyourProtocol.

CertificategroupSecureFXsupportsgeneratingandusingself-signedcertificates,whichallowsmutualauthentication.

UseglobalcertificateCheckingthisoptioninstructsSecureFXtousethecertificatespecifiedintheGlobalOptions/FileTransfer/SSLdialogforthissession.PathIfyouchoosenottousetheglobalcertificateforthissession,enterthepathofthecertificateyouwantSecureFXtousewhenauthenticating.Create...Pressthisbuttontoconfigureandgenerateanewcertificate.

AdvancedgroupDisablecertificatevalidationSelectthisoptiontodiscontinuecheckingthevalidityofX.509certificates.

WARNING:Whileselectingthisoptionmayspeedupyourconnectiontime,itmayleaveyouvulnerabletoinvalidcertificates.

UseCCC(ClearCommandChannel)afterauthenticationThisoptiontellsSecureFXtotransmitdataoverthecontrolchannelinanunencryptedform(i.e.,cleartext)afterauthentication.Itmaybenecessarytoenablethisoptionwhenthelocalclientmachineisbehindafirewall.UseunencrypteddatachannelThisoptiontellsSecureFXtotransmitdataoverthedatachannelinanunencryptedform(i.e.,cleartext).Thecontrolchannel,however,willremainencryptedevenwhenthisoptionhasbeenturnedon.

WARNING:Theaboveoptionsshouldonlybeusedwhenabsolutelynecessarybecauseselectingeitheroftheaboveoptionswillresultindatabeingtransmittedascleartext.

Connection/PortForwarding

ThePortForwardingcategoryoftheSessionOptionsdialogallowsyoutoconfiguresecureconnectionstoanSSH1orSSH2server.

OverviewofPortForwardingPortforwardingisapowerfultoolthatallowsyoutosecureTCP/IPtrafficusingSecureCRT'sSSH1andSSH2protocolsupport.ThismeansthatyoucanencryptapplicationdatausingprotocolssuchasIMAP,POP3andSMTP.Forexample,ifyoureceiveyouremailfromanInternetServiceProvider(ISP),youcouldencryptthecommunicationbetweenyourworkstationrunningtheemailclientandtheISP'sSSHserver.Ingeneral,withanyportforwardedbySecureCRTforanapplication,theapplicationneedstobereconfiguredtousethelocalhostorloopbackaddress127.0.0.1asitsapplicationserveraddress.

LocallyforwardedconnectionsNameDisplaystheuniqueidentifyingnamefortheconnection.LocalAddressDisplaysthelocalportnumberfortheconnection.RemoteHostDisplaystheremotemachineshostnameorIPaddressandtheremoteport.ApplicationDisplaystheapplicationtoberunoverthisconnection.

Tocreateanewport-forwardedconnection,clickontheAdd...buttontoopenablankLocalPortForwardingPropertiesdialog.Tomodifyanexistingconnection,selectthatconnectionandclickontheEdit...buttontoopenthatconnection'sLocalPortForwardingPropertiesdialog.Toremoveanexistingconnection,selectthatconnectionandclickontheDeletebutton.DonotrequestashellSelectthisoptiontohaveSecureCRTnotrequestacommandshellwhenattemptingtoportforward.Thisensuresthatportforwardswillworkeven

ifshellaccessisdenied.

PortForwardingwithSSHSessionOptions/ConnectionSessionOptions/ConnectionPortForwarding/Remote

Connection/PortForwarding/Remote/X11

ThePortForwarding/Remote/X11categoryoftheSessionOptionsdialogallowsyoutoconfiguresecureconnectionsthroughanSSHservertoanapplicationthatresidesontheSSHclient-side,andtoenabletheforwardingofX11packets.

Remotelyforwardedconnections

NameDisplaystheuniqueidentifyingnamefortheconnection.RemoteAddressDisplaystheportnumberontheremotemachinethatisusedforthisconnection.LocalHostDisplaysthehostnameorIPaddressofthelocalmachineandthelocalportnumber.

Tocreateanewport-forwardedconnection,clickontheAdd...buttontoopenablankRemotePortForwardingPropertiesdialog.Tomodifyanexistingconnection,selectthatconnectionandclickontheEdit...buttontoopenthatconnection'sRemotePortForwardingPropertiesdialog.Toremoveanexistingconnection,selectthatconnectionandclickontheDeletebutton.

X11forwardingForwardX11packetsCheckthisoptiontoallowtheforwardingofXWindowspacketsthroughtheSSHsession,whichmakespossibletheencryptionofthedatabetweentheclientandserver

Note:SecureCRTisnotanXServer.TheForwardX11packetsoptionallowsSecureCRTtoacceptX11datafromtheremotemachineandforwardsittotheXserverrunningonthelocalmachine.ThelocalXServermustberunningbeforeanyX11sessionscanbedisplayed.IfyouareusingXhostauthorityaccessonthelocalX11server,youwillneedtoaddthelocalhostorloopbackaddress127.0.0.1toyourserver'sXhostlist.EnforceX11authentication

CheckthisboxtoinstructSecureCRTtoenforceX11authentication.Note:ItmaybehelpfultodisablethisoptionwhenswitchingtoadifferentuserbeforelaunchinganXapplication.Ifthisoptionisenabledandthesecondaryuser's.Xauthorityfiledoesnotmatchtheinitialuser'sfile,accesstotheXserverwillbedenied.

Terminal

TheTerminalcategoryoftheSessionOptionsdialogallowsyoutoconfiguregeneralsessionoptionsfortheselectedsession.AudiobellCheckthisoptiontohaveSecureCRTemitanaudiblesoundwhenabellcharacterisreceived.Thisoptionisonbydefault.VisualbellCheckthisbuttontohaveSecureCRTflashthesessionwindowwhenabellcharacterisreceived.Thisoptionisoffbydefault.CloseondisconnectCheckthisbuttontohaveSecureCRTautomaticallyclosethesessionwindowafterdisconnectingfromtheremotemachine.ClearondisconnectCheckthisbuttontohaveSecureCRTautomaticallyclearthesessionwindowafterdisconnectingfromtheremotemachine.AutoreconnectCheckthisoptiontoautomaticallyreconnecttoaremotemachinewhenaconnectionisterminated.JumpscrollWhenthisoptionisoff,eachlineisscrolledoffthescreenoneatatime.WhenJumpScrollison,uptoafullscreencanbescrolledoffthescreenatonce.Whenviewingalargevolumeofdatafromtheremotehost,turningonJumpScrollcansignificantlyenhanceperformance.

Minimizedrawing(faster)Checkingthisoptionspeedsthescrollingprocessbynotrefreshingthescreenasoften..

ScrolltoclearscreenManyapplicationssendanescapesequencetoclearthescreen.Whenthisoptionisturnedon,thecurrentscreen'sdataisscrolledintothescrollbackbufferpriortoclearingthescreen.ScrolltobottomonoutputCheckthisbuttontohaveSecureCRTautomaticallyscrolltothebottomoftheincomingdatawhennewdataisreceived,aslongasthesessionis

scrolledbacklessthanascreenlength.Ifthisoptionisturnedoff,youmustscrollbackatleastonepageinordertonotbescrolledbacktothebottomonoutput.ScrolltobottomonkeypressCheckthisbuttontohaveSecureCRTautomaticallyscrolltothebottomoftheincomingdatawhenakeyispressed.MousegroupThisgroupcontainsoptionsthataffectmousebehavior.

ShiftforceslocalmouseoperationsThisoptioncausesmouseoperationstobelocalratherthanremotewhentheSHIFTkeyispressed.Thisoptionison,bydefault.SendscrollwheeleventstoremoteThisoptionallowsSecureCRTtoscrollremoteapplications.Thisonlyworkswhenyourunaremoteapplicationthatstartsanalternatescreenbuffer.ThisappliestomostapplicationssuchasEmacs,Vim,andMidnightCommander.

Anti-idlegroupThisgroupcontainscontrolsdesignedtopreventyourconnectionfrombeingclosedduetoalackofnetworktrafficbetweenSecureCRTandtheremotemachine.

SendstringneverynsecondsCheckthisboxtosendastringtotheremotemachineonaregularbasis.

·EnterthestringthatyouwanttosendintheSendstringentrybox.Stringscancontaincommandsorotherinformation.Foralistingofspecialoctalandescapecodesthatcanbeincludedaspartofthesentstring,seethetableofASCIIControlCodesandthetableofSendStringandFunctionKeyCommands.

·Enterhowoftenyouwantthestringsentintheassociatedeverynsecondsentrybox.Thedefaultvalueforthisoptionis300seconds;theminimumis10seconds.

SendprotocolNO-OPeverynsecondsCheckthisboxtosendaNO-OPinstructiontotheremotemachineonaregularbasis.

·EnterhowoftenyouwanttheNO-OPsentintheassociated

everynsecondsentrybox.Thedefaultvalueforthisoptionis60seconds;theminimumis10seconds.

Note:SendingNO-OPinstructionsisonlyavailableforSSH2andTelnetsessions.

SelectiongroupSetworddelimitercharactersBydefault,SecureCRTusesallnon-alphanumericcharacters(exceptunderscore)asworddelimiterswhenselectinganentire"word"withadouble-clickactionasdescribedinSelectingTextintheTerminalWindow.Youcanmodifytheworddelimitercharactersbyenteringyourpersonalworddelimitercharactersinthisentrybox.Donotseparatetheentrieswithspacesoranyothercharacter.

Terminal/Emulation

TheEmulationcategoryoftheSessionOptionsdialogallowsyoutocustomizeyourterminalemulationforasession.Terminalkeyboardemulationsettingsaredefinedbyakeymapfile.SecureCRTincludesseveralbuilt-inkeymapfiles:VT100,VT220,Linux,SCOANSI,Custom,andDefault.TheDefaultkeymapfiledefinesanemulationmostsimilartothePCkeyboard,butalsoprovidesmappingsforthekeysF1-F4.SecureCRTwillautomaticallychooseakeyboardemulationbasedontheTerminalemulationthatyouselectbutyoucanchangethisselectionusingtheSelectanalternatekeyboardemulationoptiondescribedbelow.

EmulationgroupThisgroupcontainsgeneralemulationcontrols.

TerminalSelecttheterminaltypethatyouwanttoemulate.SecureCRTsupportsANSI,Linux,SCOANSI,VShell,VT100,VT102,VT220,WYSE50,WYSE60,andXtermterminalemulation.ANSIColorCheckthisoptiontousetheANSIcolorpalettedefinedintheTerminal/Appearance/ANSIColorcategoryoftheGlobalOptionsdialog.

UsecolorschemeWhenANSIcolorisselected,checkthisoptiontohonorthecolorschemedefinedintheGlobalOptions/Terminal/Appearance/ColorSchemedialog.Otherwise,thedefaultANSIforegroundandbackgroundcolorswillbeused.

SelectanalternatekeyboardemulationSecureCRTautomaticallychoosesakeyboardemulation(or"keymap")tousebasedontheTerminalemulationdescribedabove.Toselectadifferentkeymap,checkthisoptionandselectfromthelistofkeymaps,orusetheBrowsebuttontodisplaytheOpendialogandselectthekeymapyouwant.Formoreinformationoncustomizingthekeyboardforyourneeds,seeOverviewofKeymaps.

SizegroupThenumberofrowsandcolumnsthataredefinedintheparametersofa

connectionbetweentheclientandtheremotemachineareknownasthenumberoflogicalrowsandcolumns.Thisgroupletsyouspecifyanexplicitnumberoflogicalrowsandcolumnsthatappearinyoursessionwindow.Anychangesinthenumberoflogicalrowsandcolumnswillbereflectedinthesizeofthesessionwindow.

LogicalrowsEntertheintegervalueforthenumberofrowsinthesessionwindow.LogicalcolumnsEntertheintegervalueforthenumberofcolumnsinthesessionwindow.

Note:SecureCRTallowsyoutosetamaximumforthenumberofcolumnsintheSecureCRTwindow(theupperlimitallowedis1024columns).TheMaximumcolumnssettingintheTerminal/Appearance

categoryoftheGlobalOptionsdialogcontrolsthemaximumnumberofcolumnsthatcanbespecifiedunderSessionOptions.

OnresizegroupThisgroupcontainscontrolsthatallowyoutospecifyhowasessionwindowbehaveswhenmanuallyresized.

SynchronizeviewtosizeCheckthisoptiontoallowthenumberofrowsandcolumnstomatchthesizeofthesessionwindow.Ifthisoptionisnotchecked,thenumberofrowsandcolumnswillbemaintainedwhenresizingthewindow.ScalethefontCheckthisoptiontoincreaseordecreasethefontsizedisplayedinthesessionwindowasthewindowisresized.RetainsizeandfontCheckthisoptiontomaintainthefontsizedisplayedinthesessionwindowasthewindowisresized.

Scrollbackgroup

ScrollbackbufferEnterthenumberoflinestobesavedinthescrollbackbuffer.Thismustbeanintegervaluebetween0and128000.Toclearthescrollbackbuffer:

1.OpentheEditmenu.2.SelecttheClearScrollbackmenuitem.

Terminal/Emulation/Modes

TheEmulation/ModescategoryoftheSessionOptionsdialogallowsyoutocustomizetheterminalemulationmodesettingsforasession,therebyconfiguringhowtheterminaloperates.YoucanconfigureSecureCRTtostartwithacustomizedselectionofthesemodesonapersessionbasis.ThisisdonebymakingmodeselectionswithintheInitialmodesgroup.Inaddition,ifasessionisopen,youcanmodifythecurrentterminalmodesbymakingmodeselectionswithintheCurrentmodesgroup.CursorkeymodeCheckthisoptiontoenablethecursorkeystosendANSIcursorcontrolsequencestotheremotehost.Ifthisoptionisnotselected,thecursorkeyssendapplicationcontrolsequencesfortheremotehost.Bydefault,theCursorkeymodeoptionisnotselected.LinewrapCheckthisoptiontohaveanycharactersreceivedwhenthecursorisattherightmarginbedisplayedonthenextline.Therightmarginisdefinedbythenumberoflogicalcolumns.IfLinewrapisnotselected,anycharactersreceivedwhenthecursorisattherightmarginwillbedisplayedjusttoleftoftherightmargin,replacingthecurrentcharacterdisplayedthere.Bydefault,Linewrapmodeisselected.NewlinemodeCheckthisoptiontohavetheENTERkeygeneratebothCRandLFcharacters.Inaddition,anyLF,FF,orVTcharacterwillcausethetextcursortobemovedtothefirstcolumnofthenextline.WhenNewlinemodeisnotselected,theENTERkeygeneratesonlytheCRcharacter.Bydefault,Newlinemodeisnotselected.NumerickeypadSelectthisoptiontohavethekeypadsendASCIIcharactercodesthatcorrespondtothenumericcharactersshownonthekeys.

Note:TheApplicationkeypadmodeandNumerickeypadmodearemutuallyexclusive.

ApplicationkeypadSelectthisoptiontohavethekeypadsendescapesequencestothe

applicationontheremotehost.ModeswitchinggroupSomeapplicationssendspecialescapecodesequencesthattogglethecursorkey,linewrap,newline,andnumeric/applicationkeypadmodes.Bydefault,thesemodeswitchingsequencesareinterpretedandmodeswitchingisallowed.YoucanconfigureSecureCRTtoignoresomeorallofthesemodeswitchingsequencesbycheckingorclearingthefollowingoptions:

Enable80/132columnswitchingEnablecursorkeymodeswitchingEnablekeypadmodeswitchingEnablelinewrapmodeswitching

Terminal/Emulation/Emacs

TheEmulation/EmacscategoryoftheSessionOptionsdialogallowsyoutoconfigureyoursessiontousetheALTkeyasthemetakey.ThismaybehelpfulifyoucommonlyuseEmacs.

UseALTasmetakeyCheckthisoptiontoenableEmacscompatibilityandusetheALTkeyasthemetakey.

WARNING:TheUseALTasmetakeyoptionwillaffectyourabilitytouseALTkeycombinationstoaccessapplicationmenus.YouwillstillbeabletoaccesstheapplicationmenusbypressingandreleasingtheALTkeyandthenpressingthemenuhotkey.Forexample,toaccesstheFilemenuwhenUseALTasmetakeyisenabled,pressandreleasetheALTkeyandthenpresstheFkey.However,holdingdowntheALTkeyandpressingFwillbeinterpretedbyEmacsandwillnotbringuptheFilemenu.ThepatternshowninthisexampleappliestoallALTkeycombinations.PreserveALTGRinternationalkeyManyinternationalkeyboardshaveanALTGRkeythatusesthesamekeyboardcodeasCTRL+ALTtocreateanalternateshiftstateforaccessingadditionalcharactersoncertainkeys.ToenabletheuseofthiskeyandpreventEmacsfrominterpretingitasaCTRL+ALTsequence,selectthePreserveALTGRinternationalkeyoption.Withthisoptionenabled,EmacsmodeisignoredforallALTGRcombinations.Use8thbitformetakey(requirestermcapsupport)SelectthisoptiontousetheeighthbitformetakeycombinationsinsteadofsendingtheESCkeycharacter.Thisoptionrequirestermcapsupport.Bydefault,theESCcharacterissentformetakeycombinationswhenEmacscompatibilityisenabled.SendescapeformetakeySelectthisoptiontohaveSecureCRTsendanESCcharacterformetakeycombinations.Bydefault,theESCcharacterissentformetakeycombinationswhenEmacscompatibilityisenabled.

Terminal/Emulation/MappedKeys

TheEmulation/MappedKeyscategoryoftheSessionOptionsdialogallowsyoutocreateoreditkeymapsforasession.

Note:Mappedkeysapplyonlytothecurrentsessionandwillnotcarryovertoothersessions.Ifyouwanttomakeakeyassignmentthatworksinmultiplesessions,youmaywanttousetheKeymapEditor.

MappedkeysgroupThisgroupliststheKeyCombination,Function,andArgumentforkeysmappedinthissession.

Mapakey...Thisbuttonallowsyoutomapakeyfromthekeyboard.WhentheMapKeydialogappears,pressthekeycombinationyouwanttomap.IntheMapSelectedKeydialog,specifytheactionyouwantthekeytoperform,andanyapplicablearguments.Edit...Thisbuttonallowsyoutoeditthemappingforthekeyselectedinthewindowabove.DeleteThisbuttondeletesthemappingforthekeyselectedinthewindowabove.

OthermappingsgroupYoumayfinditnecessarytochangethebehavioroftheBACKSPACEkeybysendingtheDELETEsequenceandviceversa.ThisgroupcontainsoptionscontrollingtheBACKSPACEandDELETEkeybehaviors.

BackspacesendsdeleteCheckthisoptiontohavetheBACKSPACEkeysendtheDELETEcharacter.TheDELETEcharacterisgenerallyASCII127(decimal).DeletesendsbackspaceCheckthisoptiontohavetheDELETEkeysendtheBACKSPACEcharacter.TheBACKSPACEcharacterisgenerallyCTRL+HorASCII8(decimal),0x8(hexadecimal),or10(octal).

CUAsettingsgroup

UseWindowscopyandpastehotkeysCheckthisoptiontoenabletheCTRL+C,CTRL+V,CTRL+A,andCTRL+Facceleratorkeysforcopy,paste,selectall,andfind,respectively.WARNING:TurningonUseWindowscopyandpastehotkeyswilldisableyourabilitytosendCTRL+C,CTRL+V,CTRL+A,andCTRL+Ftotheremotehost.MostUNIXusersshouldleavethisoptionoff.

Terminal/Emulation/Advanced

TheEmulation/AdvancedcategoryoftheSessionOptionsdialogallowsyoutomodifystandardterminalemulationsettingsfortheselectedsessioninordertocommunicatewithspecialremotemachines.Mostuserswillnotneedtomodifyanyofthesesettings.

AdvancedterminaloptionsgroupThisgroupcontainsadvancedemulationcontrols.

AnswerbackBydefault,SecureCRTdoesnotrespondtotheENQcharacterwithananswerbackmessage.Toenabletheanswerbackfeatureforthissession,checkthisoptionandenterthemessagetobesent.WiththeAnswerbackoptionselected,SecureCRTwillrespondtotheENQcharacterwiththespecifiedanswerbackmessage.YoucanincludesubstitutionvariablestobesenttotheremoteserverwhentheserversendstheENQ(controlbyte5)command.TerminaltypeBydefault,SecureCRTsendstheterminaltypetotheremotemachineasdesignatedbytheterminalemulationtype.TosendastringotherthantheterminaltypeemulatedbySecureCRTtotheremotemachine,checkthisoptionandentertheterminaltypestring.DisplaytabasSomeapplicationsproducedatainatab-separatedcolumnarformat.SecureCRTallowsyoutochangehowthetabcharacterisdisplayedbysubstitutingaspecificcharacterorstringinplaceofthetabcharacter.Forexample,substitutingacommainplaceofthetabcharacterwouldproducecomma-separateddatawhichcouldbeimportedintoaspreadsheetorotherapplicationthatusescomma-separateddata.TochangethetextdisplayedwhenatabcharacterisreceivedbySecureCRT,checkthisoptionandenterthetabreplacementstringorcharacter.

OthergroupThisgroupcontainsmiscellaneousemulationcontrols.

LocalechoMostsystemsthatacceptremoteterminalconnectionsreceivecharactersfromtheterminalkeyboardandechothemtotheterminalscreen.However,therearesomelegacysystemsthatdonotechocharactersreceivedfromtheterminalkeyboardtotheterminalscreen.Onsuchmachines,youwillnotbeabletoseewhatyouhavetypedunlessyouenablelocalecho.Bydefault,localechoofuserinputisdisabled.Toenablelocalechoofuserinput,checkthisoption.Strip8thbitASCIIusessevenbitstorepresentcharacters.Someseven-bitsystemsdonotcleartheeighthbit,causingsomecharacterstobedisplayedincorrectly.Ifsomecharactersarenotbeingdisplayedcorrectly,tryenablingtheStrip8thbitoption.TocauseSecureCRTtostrip(ignore)thehigh-orderbitofeachbytereceivedfromtheremotehost,checkthisoption.IgnorewindowtitlechangerequestsThisoptioncausesSecureCRTtoignoreescapesequencesthatwouldchangethetitlebar.CopytranslatesANSIline-drawingcharactersThisoptioncausesSecureCRTtotranslateANSIline-drawingcharacterstothethreecharacters"+","-",and"|"whentheyarecopiedtotheclipboard.CopytoclipboardasRTFandplaintextThisoptionallowsSecureCRTtocopyANSIcolorandfontdatatotheclipboardinRTFformatsothatitcanbepastedintodocumenteditors(e.g.,MicrosoftWord).TranslateincomingCRtoCR/LFThisoptioncausesSecureCRTtotranslateanincomingcarriagereturncharacter(CR)toacarriagereturn/linefeedcharacter(CR/LF).

SenddelayoptionsgroupThisgroupcontainslineandcharactersenddelaycontrols.

LinesenddelayThisoptionallowsyoutosetthenumberofmillisecondsthatSecureCRTpausesaftersendingacarriagereturn.Thisonlyapplies

inthefollowingcircumstances:WhentextispastedintotheSecureCRTwindowWhentextissentbyselectingtheSendASCIIcommandfromtheTransfermenu

WhendataissentfromanActiveXscriptusingSecureCRTSend()function

CharactersenddelayThisoptionallowsyoutosetthenumberofmillisecondsthatSecureCRTpausesaftersendingeachindividualcharacter.Thisonlyappliesinthefollowingcircumstances:

WhentextispastedintotheSecureCRTwindowWhentextissentbyselectingtheSendASCIIcommandfromtheTransfermenu

WhendataissentfromanActiveXscriptusingSecureCRTSend()function

PromptThisoptionallowsyoutospecifyastringtowaitfor.Thisonlyappliesinthefollowingcircumstances:

WhentextispastedintotheSecureCRTwindowWhentextissentbyselectingtheSendASCIIcommandfromtheTransfermenu

WhendataissentfromanActiveXscriptusingSecureCRTSend()function

MaxwaitThisoptionisusedinconjunctionwiththePromptoptiontospecifythemaximumnumberofmillisecondstowait.Avalueof0indicatesthatSecureCRTwillpauseuntilthepromptisreceived.

Terminal/Appearance

TheAppearancecategoryoftheSessionOptionsdialogallowsyoutoconfiguretheappearanceofthescreenfortheselectedsession.CurrentcolorschemegroupThislistboxdisplaysthecurrentcolorschemeforthissession'swindowandallowsyoutoselectthecolorschemeforyoursessionwindowsfromtheexistingschemes.ByusingtheEdit...andNewbuttons,youcanalsomodifyexistingschemesorcreatenewones.

Note:IfthesettingsforthisoptiondifferfromthecolorschemesettingsintheGlobalOptions/Terminal/Appearance/ColorSchemedialog,thesesettingswilloverridetheglobalsettings.Formoreinformationoncolorschemes,seeOverviewofColorSchemesandCreatingorModifyingaColorScheme.

FontsgroupThisgroupallowsyoutoselectthefontdisplayedinyoursessionwindow.

NormalfontThisboxdisplaysthecurrentfontusedinthissession'swindow.ByusingtheFont...button,youcanselectadifferentfonttodisplay.NarrowfontCheckthisoptiontodisplaythenarrowfontcurrentlybeingusedandtoenabletheFont...button.ByusingtheFont...button,youcanselectadifferentfonttodisplay.CharacterencodingDifferentcomputersystemscanusedifferentcharacterencodingsforthesamelanguage.Forexample,UNIXvariantsoftenuseacharacterencodingcalledExtendedUNIXCoding(EUC)torepresentJapanesecharacters.MicrosoftWindowsusesanencodingcalledShiftJIS.SecureCRTalsosupportsUTF-8characterencodingforthosesystemsthatrequireit.Thisoptionallowsyoutoselecttheencodingmethodyouneedtodisplayyourlanguage.Selectthetypeofencodingusedbytheremotesystem.IftheremotesystemusesthesamecharacterencodingasusedbyMicrosoftWindowssystems,selectDefault.ThisoptionusesfacilitiesbuiltintotheMicrosoft

operatingsystemtodecodeanddisplaythedata.Iftheremotesystemusesadifferentencoding,selectfromtheavailableencodingmethods.Iftheencodingmethodforyourlanguageisnotavailable,trysettingthisoptiontoDefault(besurethatyourfontandscriptsettingsarecorrect).Ifyoustillcannotdisplayyourlanguage,pleaseletusknow.UseUnicodeline-drawingcharactersCheckthisboxtouseUnicodeline-drawingcharacters.

CursorgroupThisgroupallowsyoutoconfigurethecursorusedinthissession'swindow.

CursorstyleThisoptionallowsyoutoconfigurethestyleofcursordisplayed.UsecolorThisoptionallowsyoutoconfigurethecolorofthecursordisplayed.ByusingtheColor...button,youcanselectadifferentcolorfordisplay.BlinkingThisoptionturnsonandofftheblinkingofthecursorforthissession'swindow.Tostoptheblinking,clearthecheckbox.

HighlightkeywordsgroupThisgroupallowsyoutocreatelistsofkeywordsthatcanbehighlightedintheSecureCRTterminalwindow.

NameThisoptionallowsyoutoselect(orcreate)alistofkeywordsthatyouwanttobehighlightedintheterminalwindow(theentirekeywordwillbehighlighted).Tocreateanewlistofkeywords,selecttheNew...entryfromthedrop-downlist.ThisopenstheKeywordListPropertiesdialogwhereyoucanassignanametothenewlistandaddwordstoit.Toeditanexistinglist,selectthenameofthelistyouwanttomodifyandpresstheEditbutton.Theworddelimitersforkeywordhighlightingarethefollowing:

`~!#$%^&*()+=:;<>,.?/\[]{}|'WorddelimitersspecifiedintheTerminalcategoryoftheSessionOptionsdialogonlyaffectwordselectionbydouble-clickinganddonotaffect

keywordhighlighting.Todisablethehighlightfeature,select<None>fromthedrop-downlist.StyleThisoptionallowsyoutoselectthestyleinwhichkeywordsarehighlighted.Note:Usingthisoptionreducesoutputdisplayperformance.Ifthehost'sshellsupportshighlighting,thatistherecommendedwaytohighlightkeywords.

Terminal/Appearance/ANSIColor

TheTerminal/Appearance/ANSIColorcategoryoftheSessionOptionsdialogallowsyoutocustomizetheANSIcolorsdisplayedinyourSecureCRTapplicationwindow.RemoteapplicationsmaysendANSIcolorescapesequencestospecifythatvariousportionsofthatapplication'sdisplayappearsinoneof16colors.Eightoftheescapesequencescorrespondtowhatarecalled"normal"colorsandtheothereighttypicallycorrespondto"bold"versionsofthosecolors.Itisdifficulttoclassifyorlabelthesecolorsbeyond"normaland"bold"becauseanapplicationmayuseanyofthecolorsforwhateveritwants.AnyapplicationthatyouconnecttowithSecureCRTmayuseanyANSIcolorescapesequence(anditsassociatedcolor)foritsownpurposes.WhileitispossibletoconfigureSecureCRTgloballytodisplay16specificcolorsinresponsetoANSIcolorescapesequences,twodifferentapplicationsmayspecifydifferentescapesequencesforsimilarfeatures.Forexample,whendisplayingfilenames,oneapplicationmayusetheescapesequencethatdefaultstoblueandanotherapplicationmayusetheescapesequencethatdefaultstocyan.

Note:ANSIcolorscanbeenabledordisabledforaspecificsessionfromtheTerminal/EmulationcategoryoftheSessionOptionsdialog.

UseglobalANSIcolorsettingsCheckthisoptiontousetheANSIcolorsettingsspecifiedintheGlobalOptions/Terminal/Appearance/ANSIColorcategoryinsteadofconfiguringsession-specificsettings.NormalcolorsgroupThisareadisplaysthecolorsthatareassociatedwiththeeight"normal"ANSIcolorescapesequences.BoldcolorsgroupThisareadisplaysthecolorsthatareassociatedwiththeeight"bold"ANSIcolorescapesequences.

CustomizingANSIColorsTocustomizeANSIcolorselections,clickonthecolorblockthatyouwant

tochangeandselectanewcolorfromtheColordialog.PressingtheDefaultbuttonreturnsthecolorblockstotheiroriginalsettings.

Terminal/Appearance/Window

TheAppearance/WindowcategoryoftheSessionOptionsdialogallowsyoutoconfiguretheappearanceofthewindowfortheselectedsession(s).Toturnoffanyoftheseoptions,cleartheassociatedcheckbox.

Note:Thecheckboxesforthefeaturesinthiscategorycanbesettooneofthreestates.

·Nocheckmark--Donotshowthefeatureforthissession.·Checkmark--Showthefeatureforthissession.·Solidsquare--Accepttheglobalsettingforthisfeature.

ShowchatwindowCheckthisoptionifyouwanttoshowthechatwindow.TheSecureCRTchatwindowprovidesaninterfacetotheremotecommandlinethatisunaffectedbyconcurrentoutputtotheterminalscreen.Thechatwindowisagreatinterfacetousewhencommunicatingintheenvironmentofachatroom.Inaddition,thechatwindowisusefulforissuingsubsequentcommands.Whilewaitingfortheoutputofapreviouscommandtocomplete,youcanpreparethenextcommandbytypingitintothechatwindow.ThecontentsofthechatwindowaresenttothecommandlineassoonastheENTERkeyispressedinthechatwindow.YoucanpreparemultiplelinesinthechatwindowwithCTRL+ENTER.SecureCRTwillrememberthenumberofrecentlyusedchatwindowcommandsthatarespecifiedintheChatwindowhistoryoptionoftheGlobalOptions/Terminal/Appearancedialog.YoucancyclethroughthesecommandsusingyourUPandDOWNarrowkeys.Enteringa0fortheChatwindowhistorywillturnoffthisfeature.Ifyouwanttosendcommandstoallyouropentabbedsessionsatonce,right-clickinthechatwindowandselecttheSendChattoAllTabsoption.Commandswillbesenttoallyourtabbedsessionsaslongasthisoptionisenabled,ShowhorizontalscrollbarCheckthisoptionifyouwanttoshowthehorizontalscrollbar.Showverticalscrollbar

Checkthisoptionifyouwanttoshowtheverticalscrollbar.ShowbuttonbarCheckthisoptionifyouwanttoshowthebuttonbarinthecurrentsession.Youcanalsoselectwhichbuttonbaryouwanttodisplayfromthedrop-downlist.DisableresizeCheckthisoptionifyouwanttodisablemanualresizingofthesessionwindow.SessionwindowalwaysontopCheckthisoptiontokeepthesessionwindowinfrontor"ontop"ofotherwindowsonyourscreen.TitlebarCheckthisoptionifyouwanttochangethetitledisplayedinthetitlebarofyoursession(ifyouareusingtabs,thisoptionwillchangethenameatthetopofyoursessiontab).Enterthealternatetitleintheassociatedentrybox.YoucanalsousethefollowingvariableswhichwillbeexpandedwhenSecureCRTwritestothetitlebar.

%H-hostname%S-sessionname%U-username%I-IPaddress%P-portNote:Itispossibleforsomeremotesystemstochangethetitlebartextbysendinganescapesequence.Ifyouwanttheseescapesequencestobeignored,settheIgnorewindowtitlechangerequestsoptionfoundintheTerminal/Emulation/Advancedcategory.

YoucanalsousethecommandslistedintheSendString&FunctionCommandstopic.InitialpositionIfyouwantthissessionwindowtoalwaysopeninthesamescreenposition,enterthatposition'sx,ypixellocationcoordinates.

Note:Ifnegativevaluesareusedforxory,theinitialpositionwillbetheoffsetfromtherightorbottom,respectively.Inadualmonitorconfiguration,negativeinitialpositionvalueswillbe

honored.Youcanalsochangethewindow'sinitialpositionbyfollowingthesesteps:1.IntheSessionOptionsdialog,openthe

Terminal/Appearance/Windowcategory.2.BesurethattheInitialpositionoptionisnotselected.3.ClickontheOKbuttonatthebottomoftheSessionOptions

dialog.4.Movethesessionwindowtothepreferreddefaultposition.5.OpentheOptionsmenuandselectSessionOptions...6.IntheSessionOptionsdialog,clickonthe

Terminal/Appearance/Windowcategory.7.ChecktheInitialpositionoptioncheckbox.8.ClickontheOKbuttonatthebottomoftheSessionOptions

dialog.Aftercompletingthesesteps,theSecureCRTwindowwillnowbeplacedinthelocationspecifiedeachtimeyouconnectwiththesession.

Terminal/LogFile

TheLogFilecategoryoftheSessionOptionsdialogallowsyoutocustomizetheloggingoptionsfortheselectedsession.

LogfilenamegroupThissectionallowsyoutospecifyadefaultfilenameforyourlogfile.Youcanenterapathorfilename,oryoucanusetheBrowsebutton toopentheSaveAsdialogandselectthepathorfilename.YoucanalsoincludeanyofthevariableslistedintheSubstitutionsectionbelow.ThesevariableswillbeexpandedwhenSecureCRTwritestothelogfile.

OptionsgroupThissectionletsyouspecifylogfilebehaviors.

PromptforfilenameCheckthisoptiontoprompttheuserforthesessionlogfilenamewhenthelogisstarted.StartloguponconnectCheckthisoptiontostartwritingtothesessionlogfilewheneveraconnectionismade.Bydefault,thisoptionisnotselected.OverwritefileIfthisoptionisselectedandthesessionlogfilealreadyexists,thecurrentlogfilewillbeoverwrittenbythenewsessionlogfile.AppendtofileIfthisoptionisselectedandthesessionlogfilealreadyexists,thenewsessionlogwillbeappendedtotheexistinglogfile.Ifthelogfiledoesnotalreadyexist,anewfileiscreated.RawlogCheckthisoptiontowriteeverycharacterreceivedbySecureCRT,includingterminalescapesequences,tothesessionlogfile.Bydefault,thisoptionisoff.StartnewlogfileatmidnightCheckthisoptiontohaveSecureCRTstartanewlogfileeachnightatmidnight.Usingthisfeaturecanaidinautomaticlogrotation.

CustomlogdatagroupThissectionletsyouspecifycustommessagestobewrittentothelog

file.YoucanincludeanyofthevariableslistedintheSubstitutionsectionbelow.ThesevariableswillbeexpandedwhenSecureCRTwritestothelogfile.

UponconnectEntriesinthisboxwillbewrittentothelogfilewhenthesessionconnects.UpondisconnectEntriesinthisboxwillbewrittentothelogfilewhenthesessiondisconnects.OneachlineEntriesinthisboxwillbewrittentoeachlineofthelogfile.LogonlycustomdataIfthisoptionisselected,SecureCRTwilllogonlythecustomdatafromthethreefieldsabove.Allnormallogmessageswillbesuppressed.

SubstitutionsgroupInthedialog,thissectionlistssomeofthevariablesthatSecureCRTcanexpandwhenwritingtothelogfile.Acompletelistisshownbelow.

%H-hostname%S-sessionname%Y-four-digityear%M-two-digitmonth%D-two-digitdayofthemonth%P-port%h-two-digithour%m-two-digitminute%s-two-digitseconds%t-three-digitmilliseconds%%-percent(%)%envvar%-environmentvariable

Note:Theenvironmentvariablesubstitutionoccursfirst.

Terminal/Printing

ThePrintingcategoryoftheSessionOptionsdialogallowsyoutosetupyourprinterconfigurationfortheselectedsession.UseglobalprintsettingsCheckthisoptiontousetheglobaloptionsinsteadofconfiguringsession-specificoptions.Bydefault,allprintsettingsforSecureCRTsessionsarederivedfromglobalprintsettings.

Note:Ifthisoptionisnotchecked,thesettingsspecifiedherewilloverridethesettingintheTerminal/PrintingcategoryoftheGlobalOptionsdialogfortheselectedsession.

MarginsgroupThisgroupallowsyoutosetthemarginsonyourprintedpages.Marginsaremeasuredininches.Bydefault,allprintmarginsaresetat0.5inches.

PrinterfontsgroupThisgroupdisplaysthefontcurrentlybeingusedforprintedpagesandalsoallowsyoutochooseadifferentfont.

Choose...PressthisbuttontoopentheFontdialogwhereyoucanchoosethefontyouwanttouseforprintedpages.

PrintSetup...PressthisbuttontoopentheWindowsPrintSetupdialogwhereyoucanmodifyyourprinterconfiguration.

Pass-throughprintinggroupPass-throughprintinginSecureCRTallowstheuseofspecialprintcontrolescapesequencesthatturnon/offaprintercontrolthatsendscharactersdirectlytotheprinter.Dependingonthesequencereceived,SecureCRTmaybypasstheterminaldisplayandsendthedatadirectlytotheprinter.

Disablepass-throughprintingCheckthisoptiontodisablepass-throughprintingandcauseSecureCRTtoignoreallprintercontrolescapesequencesitreceives:Bufferpass-throughprinting

Checkthisoptiontobufferpass-throughprinting.Thiswillaverttheissueofsomeapplicationsthatfrequentlytogglepass-throughprintingmodeonandoff,resultinginprintedpageswithonlyonelineorpagesthatareotherwiseincomplete.Thisoptionbuffersallpass-throughprintingdataanddoesnotsendittotheprinteruntilyouinstructSecureCRTtoprintthecontentsofthepass-throughprintingbuffer.Toprintthecontentsofthepass-throughprintingbuffer:1.OpentheFilemenuandselectPrint.2.InthePrintmenu,selectEjectPage.UserawmodeCheckthisoptiontoallowtheuseofanetworkprinterwhenusingpass-throughprinting.Rawmodepass-throughprintingallowsyoutosenddatatoanamedprinterasdefinedinWindows.Inaddition,rawmodeinstructsWindowstoallowthedatatobesenttothenamedprinterwithoutbeinginterpreted(i.e.bytheprinterdriver).Ifyourhostorapplicationsendsembeddedprintercommands(e.g.,changefont,etc.),enablingrawmodepass-throughprintingwillallowthesecommandstobesentdirectlytotheprinter.Ifrawmodepass-throughprintingisenabled,SecureCRTwillnotinterpretanyembeddedprintercommands.Directpass-throughprintingtoportnCheckthisoptiontoprintdirectlytotheCOMorLPTportonthelocalmachinetowhichaprinterisattached.Directpass-throughprintingtoaportessentiallybypassestheWindowsoperatingsystem,providingSecureCRTwithdirectcommunicationtothelocalprinter.Ifdirectpass-throughprintingisenabled,printjobsarenotspooledbutaresentdirectlytotheprinter.Theporttowhichtheprinterisattachedwillnotbeaccessibletootherapplicationsuntilthecurrentprintjobhasbeencompleted.Forthesereasons,itissuggestedthatyouuserawmodepass-throughprintingratherthandirectpass-throughprintingtoport(seeUserawmodeabove).Settings...ClickonthisbuttontoopentheDirectPass-ThroughPrintingSettingsdialog,whichallowsyoutoconfiguretheserialdevicesettingsforpass-throughprinting.

Other

ForceblackonwhiteCheckthisoptiontoforceyourprintertoprintasthoughyoursession'sforegroundcolorissettoblackandyourbackgroundcolorissettowhite,regardlessofyoursession'sactualcolorsettings.Thisoptionisoffbydefault.

Terminal/X/Y/Zmodem

TheTerminal/X/Y/ZmodemcategoryoftheSessionOptionsdialogallowsyoutoconfigureyourXmodem,Ymodem,andZmodemsettings.

DirectoriesgroupUploadEnterthepathofalocaldirectorythatistobeusedasthesourcefolderwhentheUploadcommandisused.Clickonthebrowserbuttontoselectthedirectory.DownloadEnterthepathofalocaldirectorythatistobeusedasthedestinationfolderwhentheDownloadcommandisused.Clickonthebrowserbuttontoselectthedirectory.

X/YmodemsendpacketsizegroupThisgroupallowsyoutoselectthesizeoftheXmodemandYmodempacketsyousend.Youroptionsareasfollows:

128bytes1024bytes(Xmodem-1k/Ymodem-1k)

ZmodemDisableZmodemCheckthisoptiontoturnofftheabilitytomakeZmodemtransfers.

TFTPservergroupStartTFTPserverwhensessionconnectsCheckthisoptiontolaunchaTFTPserverwhenthesessionconnects.TheTFTPserverwillusetheuploadanddownloaddirectoriesspecifiedintheDirectoriesgroupinthiscategory.NotethattheuploadanddownloaddirectoriesareusedoppositeofhowtheyarenormallyusedinSecureCRTbecausetheTFTPserverisaserverinsteadofaclient.

FileTransfer

TheFileTransfercategoryoftheSessionOptionsdialogallowsyoutocontrolattributesofthedirectorylocationsforagivensession.

LocaldirectoriesgroupLocalwindowEnterthepathofthelocaldirectorythatyouwantthelocalwindowtodisplayonstartupofthesession.Thisisthedefaultfolderfromwhichyouwanttotransferfilestotheremotemachine.Clickonthebrowserbuttontouseadirectorybrowsertoselectthedirectory.DownloaddirectoryEnterthepathofthelocaldirectorytobeuseasthedestinationfolderwhentheDownloadcommandisused.Thisisthedefaultfolderinwhichyouwanttoreceivefilesfromaremotemachine.Clickonthebrowserbutton touseadirectorybrowsertoselectthedirectory.

RemotedirectoriesgroupInitialdirectoryEnterthefullpathofthedirectoryontheremotehostthatyouwanttobethecurrentdirectoryuponconnectingtotheremotehost.Iftheinitialdirectoryisnotspecified,thedefaultorhomedirectoryfortheusernameontheremotesystemwillbetheinitialdirectory.

DirectorytreeoptionsgroupDisabledirectorytreedetectionThisoptionisuncheckedbydefaultleavingthedirectorytreeenabled.Checkingthisoptionwilldisablethedirectorytreeforthecurrentsession.Thischeckboxcanalsobesettoathird,indeterminatestate.Whenthecheckboxisinthisstate,itappearsgrayedoutandwillcauseSecureFXtousetheDisabledirectorytreedetectionsettingintheGlobalOptions/FileTransfer/Optionsdialog.

TransferoptionsgroupVerifyfilestatusonretrieveThisoptionischeckedbydefault.ItcausesaLISTcommandtobe

sentpriortoretrievingafilefromtheFTPserverinordertoobtainthemostcurrentstatistics(i.e.,sizeanddate)forthefile.Thischeckboxcanalsobesettoathird,indeterminatestate.Whenthecheckboxisinthisstate,itappearsgrayedoutandwillcauseSecureFXtousetheVerifyfilestatusonretrievesettingintheGlobalOptions/FileTransfer/Optionsdialog.

FileTransfer/FTP/SFTP

ThiscategoryonlyappearsifVanDykeSoftware'sSecureFX®3.0(ornewer)isalsoinstalled.TheFileTransfer/FTP/SFTPcategoryoftheSessionOptionsdialogallowsyoutocontrolserveranduploadattributesforagivensession.

ServerparametersgroupOperatingsystemSelecttheoperatingsystemusedontheserver.Bydefault,thisoptionissettoautomaticallydetecttheoperatingsystemontheserverwhenconnecting.Thisoptionallowsyoutooverridetheautomaticdetectionandspecifyasupportedtype.TimezoneSelectthetimezoneoftheserver.Thisinformationisusedwhentranslatingfiletimesfromtheserversothatamoreaccuratecomparisoncanbeperformedwhencomparinglocalfiletimeandremotefiletimes.Bydefault,thisoptionissettoautomaticallydetectthetimezoneoftheserver,ifpossible,usingtheserver'sconnectionreply.Manyserversputtimeanddateinformationintheinitialreplytextsentfromtheserver,andSecureFXwillattempttodeterminetimezoneoftheserverfromthistext.Ifitfailstodetectanappropriatetimezone,thelocaltimezone(i.e.,thetimezoneinuseontheclientmachine)isusedbydefault.

UploadoptionsgroupFilenameconversionChoosethefilenameconversionrulethatwillbeappliedtouploadedfiles.Thechoicesforthisoptionareasfollows:

·PreservecasecausesSecureFXtocreatethefileontheremotemachineusingthefilenameexactlyasitisstoredonthelocalmachine.

·Uppercasecausesthealphabeticcharactersinafilenametobeconvertedtoalluppercase.

·Lowercasecausesthealphabeticcharactersinafilenametobe

convertedtoalllowercase.Filecreationmask(notavailablewhenusingSFTP)Enterafilecreationmask(alsocalledtheUMASK)thatwillbeusedwhenanewfileisuploadedtotheFTPserver.Bydefault,thisoptionisblank,whichmeansthattheUMASKcommandwillnotbesenttotheFTPserver,andtheserverwillusethedefaultUMASKsettingforcurrentlogon.Thefilecreationmaskisavaluethatisusedtodeterminethedefaultpermissionssettingsfornewfiles.ThisfeatureisusuallyonlyavailableonUNIXsystems.ThevaluespecifiedforthefilecreationmaskisgiveninoctalandisXORedontheremotesystemwiththepermissionsof666forfilesand777fordirectories.Forexample,thevalue002wouldgivecompleteaccesstothegroupandonlyread(anddirectorysearch)accesstoothers.Thevalue022wouldgiveonlyread(anddirectorysearch)accesstothegroupandothers.

CustomizeDialog

TheCustomizedialogallowsyoutocustomizetheuserinterfacemenubarandtoolbarstosuityourneedsandpreferences.Youcanshoworhidetoolbars,rearrangemenucommandsandtoolbarbuttons,addorremovecommandsandbuttons,andcreatenewmenusandtoolbars.

Note:YoucanalsocustomizeyourtoolbarsbyusingtheALT+dragmethod.Todothis,placethemousepointeroveramenutitleortoolbarbutton,holddowntheALTkey,anddragthemenuorbuttontoanewlocation,ortotallyoffthebarifyouwanttoremoveit.

TheCustomizeToolbardialogcanbeaccessedinseveralways:Right-clickonanyofthebarsandselectCustomize...fromthecontextmenu.

Right-clickontheToolbarOptionsbuttononthemaintoolbarandselectCustomize...fromthecontextmenu.

CommandstabCategorieswindowDisplaysthecategoriesofcommandsavailableforuseinmenusandbuttons.SelectingacategorydisplaystheassociatedcommandsintheCommandswindow.CommandswindowDisplaysthecommandsassociatedwiththeselectedcategory.Thesecommandscanbeaddedtomenusandusedastoolbarbuttons.Youaddcommandsorbuttonstomenusandtoolbarsbyclickingonthatcommandanddraggingittothedesiredmenuortoolbar.Ifacommandthatyouwanttoaddasatoolbarbuttondoesnothaveabuttonicon,SecureCRTwillcreateabuttononthetoolbardisplayingthecommand'sname.

ToolbarstabToolbarswindowDisplaystheMenubar,Maintoolbar,andanyothertoolbarsthathavebeencreated.Tohideatoolbarintheinterface,unchecktheboxtotheleftofthattoolbar'sname.TheMenubarcannotbehidden.WhentheCustomizedialogisopen,SecureCRTallowsyoutoadd

commandstoandremovecommandsfrommenususingdraganddrop.Toaddacommandtoamenu,dragthatcommandfromtheCommandstabtothemenuwhereyouwantit.Toremoveacommandfromamenu,openthatmenuanddragthecommandoffofthatmenu.ClickingontheResetbuttononthistabwillresettheselectedtoolbartoitsdefaultvalues.ClickingontheResetAllbuttonresetsallthetoolbars.

Menutab

ApplicationFrameMenusgroupShowMenusforSelectthemenubartouse.ResetResetsselectedmenubartodefaultvalues.

MenuanimationsSelectyourpreferredmethodofanimatingtheopeningandclosingofSecureCRTmenus.MenushadowsSelectthisoptiontohaveanopenmenudisplayashadow.

Optionstab

ToolbargroupShowScreenTipsontoolbarsCheckthisoptiontohaveSecureCRTdisplayScreenTipswhenyouhoveryourpointeroveratoolbarbutton.

ShowshortcutkeysinScreenTipsCheckthisoptiontohaveSecureCRTdisplayalternativekeyboardshortcutoptionswithScreenTipswhenyouhoveryourpointeroveratoolbarbutton.

DirectPass-ThroughPrintingSettings

TheDirectPass-ThroughPrintingSettingsdialogallowsyoutosettheserialdevicesettingsforpass-throughprinting.BaudrateSelectthebaudrateforthedevice.Thedefaultvalueis38400.DatabitsSelectthenumberofcommunicationdatabits.Thedefaultvalueis8.ParityChoosetheparitysettingsupportedbytheconnecteddevice.ThedefaultsettingisNone.StopbitsChoosenumberofstopbitssentaftereachcharacter.Thedefaultvalueis1.

FlowcontrolDTR/DSRSelectthisoptiontousetheDTR/DSR(data-terminal-ready/data-set-ready)signalswiththeconnecteddevice.Bydefault,thisisnotselected.RTS/CTSSelectthisoptiontouseRTS/CTS(request-to-send/clear-to-send)hardwareflowcontrol.Bydefault,thisoptionisselected.XON/XOFFSelectthisoptiontouseXON/XOFFsoftwareflowcontrol.Bydefault,thisoptionisnotselected.

FirewallPropertiesDialog

TheFirewallPropertiesdialogcanbeaccessedbyclickingoneithertheAdd...orEdit...buttonontheFirewallcategoryoftheGlobalOptionsdialog.NameEnteruniquenameforthisfirewall.ThisnamewillbeusedintheSessionOptionsdialogtospecifythefirewallforagivensession.TypegroupSelectthetypeoffirewallthatyouareusingfromthelistoffirewallsthataresupportedbySecureCRT.ParametersgroupThisgroupallowsyoutoconfiguretheparametersforthefirewallTypethatyouselectedabove.TheoptionsinthisgroupvarybasedontheTypeselection.Thesupportedfirewallsarelistedbelow:

•Generic/Telnet-Choosethisoptionifyouconnectthroughaproxyserverthatusesasimplesend/expectinterface.SelectingthistypewillenabletheProxypromptandProxycommandoptionsdescribedbelow.

•SOCKSVersion4•SOCKSVersion5(noauthentication)•SOCKSVersion5(username/password)-Ifyourfirewallserver

isrunningeitherSOCKSversion4orSOCKSversion5,selectoneofthesetypesfortheTypefield.EnterthehostnameorIPaddressofyourSOCKSfirewallserverinthe"HostnameorIP"field,andentertheSOCKSfirewallportnumberinthe"Port"field.TheconventionalportnumberforSOCKSis1080.The"username/password"versionoftheSOCKSfirewallchoicesallowsforfirewalluserauthentication.Theonlymethodofauthenticationcurrentlysupportedisthe"Username/PasswordAuthentication"protocol,whichrequirestheusernameandpasswordtobesentascleartext.Therefore,thismethodisnotrecommendedfornon-secureenvironments

•HTTP(noauthentication)-ThistypeallowsyourservertoconnectthroughanHTTPproxyserver.

•HTTP(Basicusername/password)-Thistypeallowsyourserver

toconnectthroughanHTTPproxyserverthatsupports"Basic"authentication(thisisanHTTPstandard)."Basic"authenticationsendsusernamesandpasswordsintheclear,therefore,thismethodisnotrecommendedfornonsecureenvironments.

•OPENhost-SelectthistypeifyourfirewallserverrequirestheOPENcommand.ThistypemaybeselectedfortheCSMproxyserver.Also,enterthehostnameandportofthefirewallserverintheappropriatefields.

•USERuser@host:port-SelectthistypeifyourserverisrunningtheWinGateproxyserver.EnterthehostnameorIPaddressandportofthefirewallserverintheappropriatefields.ThistypemayalsobeselectedforusewiththeCSMproxyserver.ThistypeshouldalsobeusedfortheWinProxyproxyserver.ForthisparticularproxyserveryoumayalsoneedtohavetheUseoutgoingdataconnections(PASV)optionuncheckedintheConnection/FTPcategoryoftheSessionOptionsdialog.

•USERuser@hostport•USERuser@hostport(withlogin)-Selectthesetypesifyour

serverisrunningtheTISInternetFirewallToolkit.Choosethefirstformifthefirewallserverdoesnotrequireauthentication.Ifyourfirewallserverrequiresauthentication,choosethesecondform.Also,enterthehostnameorIPaddressandportofthefirewallserverintheappropriatefields.

•USERuser@hostlogin-ThistypewillsendtheremoteusernameandtheserveraddressfollowedbythefirewalluserID.Itthenexpectstosendthepasswordfortheremoteuserandthepasswordforthefirewalluser.ThistypeshouldbeusedifyourserverisrunningtheRaptorFirewall.Forthisfirewalltypeyouwillneedtoentertheusernameandpasswordthatisrequiredbythefirewallservertoauthenticateyourconnection.Also,enterthehostnameorIPaddressandportofthefirewallserverintheappropriatefields.

HostnameorIPEnterthehostnameorIPaddressofthemachinetowhichyouwanttoconnect.PortEntertheporttowhichyouwanttoconnect.ForaSOCKSfirewall,

thisisusually1080.UsernameEntertheusernameforthisconnection.PasswordEnterthepasswordforthisconnection.ProxypromptThisoptionappliesonlyifyouhaveselectedGeneric/TelnetproxyasyourfirewallType.EnterthepromptthatSecureCRTcanexpecttoreceivefromthegeneric/Telnetproxy.Forexample,tousetheTISFirewalltoolkit,thepromptwouldbe:tn-gw>

ForWinGate,thepromptwouldbe:WinGate>

ProxycommandThisoptionappliesonlyifyouhaveselectedGeneric/TelnetproxyasyourfirewallType.EntertheconnectoropencommandthatSecureCRTneedstosendtothegeneric/Telnetproxy.Forexample,tousetheTISFirewalltoolkit,thecommandwouldbe:c%h%p\r

ForWinGate,thecommandwouldbe:%h%p\r\n

TheSSHprotocolimposessomespecialconstraintsonwhatfirewallsoftwarecanbeused.SSHdoesworkwithSOCKSfirewalls.SSHdoesnotworkwithgenericfirewallsthatarenot8-bitcleanorthatmodifythecontentsofthedatastream.SSHcannotbeusedthroughtheTIStn-gwgenericproxy.

GSSAPIPropertiesDialog

TheGSSAPIPropertiesdialogcanbeaccessedbyclickingonthePropertiesbuttonintheAuthenticationgroupoftheConnection/SSH1,SSH2,orTelnetcategoryoftheSessionOptionsdialogwhenGSSAPIisthespecifiedauthenticationmethod.GSSAPI(GenericSecurityServicesApplicationProgramInterface)isagenericAPIforperformingclient/serverauthentication.GSSAPIallowsSecureCRTtoauthenticatewithaserverwithoutknowinganythingaboutthespecificauthenticationmechanisminuse.

MethodSecureCRTsupportsthefollowingtypesofGSSAPIprovider:

·MSKerberos-Inordertousethisprovider,SecureCRTmustberunningonWindows2000ornewer.TheWindows2000computermusthavebeenconfiguredaspartofanActiveDirectorydomainorbeenconfiguredtoparticipateinaKerberosrealm.

·GSSAPI-Inordertousethisprovider,youmusthaveaGssapi32.dllfileprovidedbyathirdparty(e.g.,theMITKerberosdistribution).Thisthird-partyapplicationmustbeconfiguredcorrectlyforyourenvironment.

·AutoDetect-ThissettinginstructsSecureCRTtoattempttoautomaticallydeterminewhichoftheabovetwomethodswillworkwiththeserverthatyouareconnectingto.Thisistherecommendedsetting.

DelegationWhenSecureCRTauthenticateswithGSSAPI,itcancontrolwhetherornottheserverisallowedtoaccessothersecuredresources(suchasnetworkfileservers)withoutfurtherpromptingforcredentials.SecureCRTsupportsthefollowingdelegationsettings:

·Full-IfthisdelegationisselectedandtheGSSAPImechanismbothsupportsdelegationandisconfiguredtoallowdelegation,theservermaybeabletoaccessothersecuredresourceswithoutpromptingforcredentials.

·None-Ifthisdelegationisselected,theservermayhavetopromptforfurtherauthenticationinordertoaccesssecured

resourcessuchasnetworkfiles,printers,ortologontoadifferentserver.

·Limited-ThisdelegationisthesameasFulldelegationfortheMSKerberosmethod.IftheGSSAPImethodisinuse,it'smeaningisdeterminedbytheGssapi32.dllinuse.

<<AdvancedPressingthisbuttonexpands(orcontracts)theGSSAPIPropertiesdialogtodisplay(orhide)thefollowingoptions.

SPN(ServerPrincipalName)WhenauthenticatingwithGSSAPI,SecureCRTmustdeterminethecanonicalnameofaserver.Theserverhasexactlyonecanonicalname,whichnootherservercanshare.Theservermayhaveothernames,forexample,theserver192.168.20.1maybeknownasmail.mydomain.com,mydomain.comandmail,butithasonlyonecanonicalname,mail.mydomain.com.SecureCRTusesthiscanonicalnametoformaServerPrincipalName(SPN),whichtheGSSAPIproviderusestoidentifytheserverwithwhichitshouldauthenticate.SecureCRTusuallyusesthehostvariable(HOST)todeterminetheserverSPN.However,thisdependsonhostnamelookupsworkingcorrectly.Ifthisdoesnotworkcorrectly,thisbehaviorcanbeoverriddenbymanuallyspecifyingtheSPN.

ManuallyspecifytheSPN(defaultishost@$(HOST))CheckingthisboxwillenabletheSPNtextboxbelowandmanuallyspecifytheSPN.SPNEntertheSPNstring.Thestringisalmostalwaysoftheformhost@<servercanonicalname>.Anexampleofavalidstringis"host@mail.mydomain.com".SecureCRTwillmakethefollowingvariablesubstitutionsinthespecifiedSPNname:·$(HOST)-thehostnameasspecifiedintheSession

Options/Connection/SSH2category.·$(PORT)-theportasspecifiedintheSessionOptions/Connection/SSH2

categoryIftheserverisinadifferentKerberosrealm,therealmnamemayneed

tobeappended(e.g.,host@mail.mydomain.com@KRBS.MYDOMAIN.COM.

KeymapEditorDialog

TheKeymapEditordialogisaccessedfromtheKeymapEditortoolbarbutton orfromtheKeymapEditor...commandontheToolsmenu.TheKeymapEditorallowsyoutomodifykeymaps.YoucanmakechangestothekeymapcurrentlyselectedintheTerminal/EmulationcategoryoftheSessionOptionsdialog,oryoucanloadandmodifyotherkeymaps.SecureCRTprovidesbuilt-inkeymapsfortheANSI,Linux,SCOANSI,VShell,VT100,VT102,VT220,WYSE50,andWYSE60terminalemulations.YoucanalsocreatecustomkeymapfilesbysavingmodificationsmadewiththeKeymapEditorasanewfile.Keymapfilesaresavedwiththeextension.key.UnliketheMappedKeysfunction,whichonlychangeskeyassociationsforthesessioninwhichthekeysweremapped,built-inandcustomkeymapscanbeusedbymultiplesessionsbysettingtheSelectanalternatekeyboardemulationtothesamekeymap.

KeymapEditorDialog

KeyboardThetoppartoftheKeymapEditordialogisarepresentationofaphysicalkeyboard.Byclickingonakeyinthekeyboardarea,youcanseeifthekeyismappedtoanaction(displayedintheSelectedkeymapstofield)orselectitformapping.Thisareaalsoprovidescheck

boxesforAlt,Ctrl,andShiftmodifiersthatyoucanaddtokeycombinationselections.

Note:TheALT+F6keycombinationisreservedinWindowsandcannotbemapped.

SelectedkeymapstoThisfielddisplaysanyactiontowhichtheselectedkeyismapped.MapSelectedKey...Afterselectingakeyinthekeyboardareaabove,clickonthisbuttontoopentheMapSelectedKeydialog.Inthatdialogyoucanmaptheselectedkeytooneofthelistedactions.MapaKey...Clickonthisbuttontomapakeyusingyourphysicalkeyboard.Afteryouclickonthisbuttonandpressthekey(orkeycombination)thatyouwanttomap,theMapSelectedKeydialogwillopenallowingyoutoselecttheactionthatyouwantmappedtothespecifiedkey.UnmapSelectedKeyClickonthisbuttontoremovethemappingoftheselectedkeyfromthekeymap.SaveClickonthisbuttontosaveyourmodificationstothekeymapcurrentlyinuse.SaveAs...Clickonthisbuttontosaveyourmodificationtoakeymapotherthantheonecurrentlyinuse.Load...Clickonthisbuttontoloadanexistingkeymapforediting.Toeditthekeymapbeingusedbythecurrentsession,youdonothavetoloadthekeymap.CloseClickonthiskeytoclosetheKeymapEditor.

LocalPortForwardingPropertiesDialog

TheLocalPortForwardingPropertiesdialogcanbeaccessedbyclickingoneithertheAdd...orEdit...buttonontheConnection/PortForwardingcategoryoftheSessionOptionsdialog.

Name

NameEnterauniquenameforthisconnection.

Local

ManuallyselectlocalIPaddressonwhichtoallowconnectionsCheckthisoptiontobindthelocalendofaportforwardtoanaddressotherthanthedefaultlocalhostloopbackadaptor(e.g.,127.0.0.2).PortEnterthenumberornameoftheportonthelocalmachinefromwhichyouwanttoconnect.

Remote

DestinationhostisdifferentfromtheSSHserverCheckthisoptioniftheremotedestinationhostisdifferentfromtheSSHserver.PortEnterthenumberornameoftheportontheremotemachinetowhichyouwanttoconnect.DynamicforwardingusingSOCKS4or5CheckthisoptiontohaveSecureCRTactasaSOCKSproxyserveronthespecifiedport.ThiswillallowanyclientthatcanconnectusingaSOCKSfirewalltousethe“dynamicportforward”tosetupaportforward.Forexample,ifyouhaveadynamicportforwardsetuptouse127.0.0.3onport1080,youcouldthenusethatonedynamicportforwardtoconnecttoanyhostbehindthefirewall.

Application

ApplicationSecureCRTallowsyoutooptionallystartanapplicationonthelocalmachineonceyouhaveestablishedaconnection.Enterthefullpathnameoftheapplication.ArgumentsEnteranyargumentsthatyouwanttousewiththespecifiedapplication.

MapButtonDialog

TheMapButtondialogcanbeaccessedbyright-clickinganywhereinthebuttonbarandselecttheNewButton…option.TheMapButtondialogallowsyoutoassociateanaction(functionandassociatedargument)withthebuttonselectedwhenaccessingthedialog.

ActionThisgroupcontainsthefunctionsandargumentsthatmakeupabuttonaction.AlistanddescriptionsoftheavailablefunctionsisintheTableofKeymapFunctions.

FunctionSelectthetypeoffunctionthatyouwanttoassigntothespecifiedbutton.YoualsoneedselectthespecificfunctiondetailsthattheFunctionrequires.<Functiondetails>ThisentryboxwillchangedependingontheselectedFunctionoption.Selectorenterthespecificfunctionthatyouwanttoassigntothespecifiedbutton.LabelEnterthetextyouwanttoappearasthelabelonthebutton.

ArgumentThisentryboxappearsifyouselectRunScriptintheFunctionboxabove.Enterargument(orarguments)neededforyourselectedscript.Thesescriptargumentsfunctioninthesamemannerasiftheywerepassedinusingthecommandline/ARGoption.

MapSelectedKeyDialog

TheMapSelectedKeydialogcanbeaccessedbyseveralmethods:·OpentheKeymapEditor,selectakeytobemappedfromthekeyboard

area,andclickontheMapSelectedKey...button.·OpentheKeymapEditor,clickontheMapaKey...button,andentera

keyorkeycombinationtobemapped.·OpentheTerminal/Emulation/MappedKeyscategoryoftheSession

Optionsdialog,clickontheMapaKey...button,andenterakeyorkeycombinationtobemapped.

·OpentheTerminal/Emulation/MappedKeyscategoryoftheSessionOptionsdialog,selectamappedkeyfromthelist,andclickontheEditbutton.

TheMapSelectedKeydialogallowsyoutoassociateanaction(functionandassociatedargument)withthekey(orkeys)selectedwhenaccessingthedialog.KeyCombinationThisfielddisplaysthekeyorkeycombinationspecifiedwhenaccessingthisdialog.

ActionThisgroupcontainsthefunctionsandargumentsthatmakeupakeyaction.AlistanddescriptionsoftheavailablefunctionsisintheTableofKeymapFunctions.

FunctionSelectthetypeoffunctionthatyouwanttoassigntothespecifiedkey.YoualsoneedtoselectthespecificargumentthattheFunctionrequires.<Functiondetails>ThisentryboxwillchangedependingontheselectedFunctionoption.Selectorenterthespecificfunctionthatyouwanttoassigntothespecifiedkey.

ArgumentThisentryboxappearsifyouselectRunScriptintheFunctionboxabove.Enterargument(orarguments)neededforyour

selectedscript.Thesescriptargumentsfunctioninthesamemannerasiftheywerepassedinusingthecommandline/ARGoption.

Public-KeyAssistantDialog

ThePublic-KeyAssistantdialogisaccessedfromthePublic-KeyAssistanttoolbarbuttonorfromthePublic-KeyAssistant...optionontheToolsmenu.Thisdialogallowsyoutoviewandmanagethepublickeysthatareinstalledforthecurrentuserontheremoteserverthatisconfiguredforthesession.UserDisplaystheusernameofthecurrentuser.StatusDisplaysthestatusoftheconnectiontotheserver.Thelistwindowinthisdialogdisplaysthepublickeysthatareinstalledforthecurrentuserontheremoteserver.Foreachpublickey,thelistalsodisplaystheTypeofalgorithmusedtogeneratethekey(eitherDSAorRSA),thekey'sComment,andthekey'sFingerprint.

Upload...Clickthisbuttontochooseanotherpublickeytouploadtotheremoteserverusingthepublic-keyassistant..Create...ClickthisbuttontoopentheKeyGenerationwizardwhereyoucancreateanduploadanewpublickeyfile.DeleteClickthisbuttontodeletetheselectedpublickeyfromtheserver.Note:IfthecomputeronwhichSecureCRTisrunningdoesnotsupportthekeytypeforakeyinthelist,theFingerprintwillread"unsupportedkeytype"andtheDeletebuttonwillbedisabledforthatkey.

PublicKeyPropertiesDialog

ThePublicKeyPropertiesdialogcanbeaccessedbyclickingonthePropertiesbuttonintheAuthenticationgroupoftheConnection/SSH1orSSH2categoryoftheSessionOptionsdialog.Thisdialogisnotavailablewhenthesessionisconnected.Useglobalpublickeysetting/UsesessionpublickeysettingSelectwhetherSecureCRTshouldusetheglobalidentityfileoraspecifiedsessionidentityfileasyourmethodofauthenticationforthissession.Yourchoicewilldeterminetheoptionsavailableinthegroupbelow.

Global/SessionsettingsgroupUseidentityorcertificatefileSelectingthisoptioninstructsSecureCRTtousethespecifiedidentityorPKCS#12fileasyourmethodofauthentication.Formoreinformationonconfiguringyoursystemtouseidentityfiles,seePublic-KeyAuthenticationforSSH1orPublic-KeyAuthenticationforSSH2.SecureCRTalsosupportsaccessingX.509certificatesthroughPKCS#11.Thelocatorprefix(e.g.,“pkcs11::”)andsuffix(e.g.,“::standard”)specifywhichpublic-keyalgorithmtouse.Tousethisfeature,enterastringsimilartooneofthefollowingexamplesbutpointingtoyourPKCS#11.dllfileinthetextbox:pkcs11::prov=c:\windows\system32\opensc-pkcs11.dll

pkcs11::prov=c:\windows\system32\pkcs11.dll::cert

Theaboveexamplesusethex509v3-sign-rsaalgorithm.pkcs11::prov=c:\windows\system32\opensc-

pkcs11.dll::standard

Theaboveexampleusesthex509v3-sign-rsa-sha1algorithm.pkcs11key::prov=c:\windows\system32\pkcs11.dll

Theaboveexampleusesthessh-rsaalgorithm,whichcanbeusedtosendthecertificateasarawkey.TouseanAmazonEC2"keypair"withSecureCRT,specifytheprivatekeyfileofthekeypairgeneratedbyAmazonastheidentityorcertificatefile.Thisfiletypicallyhasa.pemextension.

FingerprintThisentryboxwillbefilledinautomaticallywhenanidentityfileisenteredabove.CreateIdentityFilePressthisbuttontostarttheKeyGenerationwizardandcreateidentityfileswhichcontainyourpublic-privatekeypair.

Note:SecureCRTtosupportsbothDSAandRSAkeytypes.UploadPressthisbuttontoopentheUploadPublicKeydialoganduploadthespecifiedidentityfiletotheserverconfiguredforthissession.Publickeysareuploadedusingthepublic-keyassistant.Uploadsareonlyavailableonserversthatsupportthepublic-keyassistant(suchasVanDykeSoftware'sVShell®server2.1ornewer).ChangePassphrasePressthisbuttontochangethepassphraseforyouridentityfile.Usepersonalstorecertificate(CAPI)SelectingthisoptioninstructsSecureCRTtouseX.509certificatesfromyourMicrosoftCAPIpersonalstoreasyourmethodofauthentication.FormoreinformationonX.509certificates,seeUsingX.509Certificates.

RemotePortForwardingPropertiesDialog

TheRemotePortForwardingPropertiesdialogcanbeaccessedbyclickingoneithertheAdd...orEdit...buttonontheConnection/PortForwarding/Remote/X11categoryoftheSessionOptionsdialog.

Name

NameEnterauniquenameforthisconnection.

Remote

ManuallyselectremoteIPaddressonwhichtoallowconnectionsCheckthisoptiontobindtheremoteendofaportforwardtoanaddressotherthanthedefaultlocalhostloopbackadaptor(e.g.,aninternalLANinterface).PortEnterthenumberornameoftheportontheremotemachinefromwhichyouwanttoconnect.

Local

DestinationhostisdifferentfromlocalhostCheckthisoptionifthedestinationhostisdifferentfromthelocalhost.PortEnterthenumberornameoftheportonthelocalmachinetowhichyouwanttoconnect.

SelectFilestoSend...Dialogs

TheSelectFilestoSend...dialogsconsistoftheSelectFilestoSendasASCIIdialog,theSelectFilestoSendasBinarydialog,theSelectFilestoSendusingXmodemdialog,theSelectFilestoSendusingYmodemdialog,andtheSelectFilestoSendusingZmodemdialog.ThesedialogshavesimilaroptionsandcanbeaccessedfromtheTransfermenuusingtheSendASCII...,SendBinary...,SendXmodem...,SendYmodem...,andZmodemUploadList...options,respectively.Thefollowingoptionsappearonallfourdialogs:

LookinSelectthefolderinwhichyouwanttolookforthefilethatyouwanttosend.Thelistbelowwilldisplaythecontentsofthespecifiedfolder.Youcanalsousethebuttonstotherightoftheentryboxtohelpyounavigatethroughandsorttheitemsinthelist.FilenameEnterthenameofthefilethatyouwanttosend,orclickonthefileinthelistabove.FilesoftypeSelectthetypeoffilesthatyouwantdisplayedinthelistabove.

OntheSelectFilestoSendasASCIIdialog,theSelectFilestoSendasBinarydialog,andtheSelectFilestoSendusingXmodemdialog,youbegintransferringtheselectedfilebyclickingontheSendbutton.YmodemandZmodemsupportmultiplefiletransfersand,therefore,theSelectFiletoSendusingYmodemandSelectFiletoSendusingZmodemdialogshaveafewmoreoptions:

AddClickonthisbuttontoaddthefileshownintheFilenameentryboxtotheFilestosendlist.FilestosendThislistdisplaysthefilesthatarequeuedtobesentusingZmodem.Tosendthespecifiedfiles,followthesesteps:1.ClickontheOKbuttontosavethefilesandclosethedialog

2.OpentheTransfermenu3.SelecttheStartZmodemUploadoption.RemoveClickthisbuttontoremoveselectedfilesfromtheFilestosendwindow.StartUpload(Zmodemonly)Clickthisbuttontostartthetransferimmediately.UploadfilesasASCIICheckthisboxtoinstructSecureCRTtosendthefilesintheFilestosendwindowinASCIIformat.Ifleftunchecked,fileswillbesentinbinaryformat.

Note:Forthisoptiontoworkproperly,theinstallationofZmodemontheremotemachinemustbeabletoconvertASCIItousethelocalconventionforlinetermination.

SpecifyFilenametoReceive...Dialogs

TheSpecifyFilenametoReceive...dialogsconsistoftheSpecifyFilenametoReceiveasASCIIdialogandtheSpecifyFilenametoReceiveusingXmodemdialog.ThesedialogshavethesameoptionsandcanbeaccessedfromtheTransfermenuusingtheReceiveASCII...andReceiveXmodem...options,respectively.Thefollowingoptionsappearonbothdialogs:

SaveinSelectthefolderinwhichyouwanttosavethefilethatyouaretoreceive.Thelistbelowwilldisplaythecontentsofthespecifiedfolder.Youcanalsousethebuttonstotherightoftheentryboxtohelpyounavigatethroughandsorttheitemsinthelist.FilenameEnterthenameofthefilenamethatyouaretoreceive,orclickonthefilenameinthelistabove.SaveastypeSelectthetypeoffilethatyouwanttosavethereceivedfileas.

Tobegintransferringthespecifiedfile,clickontheReceivebutton.

UploadPublicKeyDialog

TheUploadPublicKeydialogcanbeaccessedbyclickingontheUploadbuttononthePublicKeyPropertiesdialogorfromtheKeyGenerationwizardafteryouhavecreatedapublickeyfile.Thisdialogallowsyoutoviewthestatusofpublickeyfileuploadstoaserver.Usingpasswordauthentication,SecureCRTattemptstoconnecttotheserverthatisconfiguredforthesession.SecureCRTthenuploadsthepublickeyfilebywayofthepublic-keyassistant.Uploadsareonlypossibleonserversthatsupportthepublic-keyassistant(suchasVanDykeSoftware'sVShell®2.1ornewerserver).Onceapublickeyforasessionhasbeenuploadedtoaserver,furthersessionconnectionstothatservercanbemadeusingpublic-keyauthentication.

TheToolbar

TheSecureCRTtoolbarisuser-manageableinthattheusercantoggleitsdisplayonoroff.Whenenabled,thetoolbarappearsbelowtheSecureCRTmenubar.Movethemousecursoroveratoolbarbuttontoviewitsassociatedaction.Thetoolbarisenabledbydefault.Thetoolbarcanbecustomizedtosuitthepreferencesandneedsoftheuser.Thetablebelowdepictsthetoolbarbuttonsandtheirassociatedtasks.

Button Description

Connect:OpenstheConnectdialog

Connect(Connectdialogbutton):Connectstoselectedsession

QuickConnect:BringsuptheQuickConnectdialog

ConnectinTab/Tile:OpenstheConnectinTab/Tiledialog

NewSession(Connectdialogbutton):OpenstheSessionOptionsdialogforanewsession

Reconnect:Reconnectslastconnection

Disconnect:Closesthecurrentconnection

ConnectBar:Allowsyoutoenterandopenasessioninanewtaborwindow.

Copy:CopiestheselectedtexttotheClipboard

Paste:PastesthecontentsoftheClipboard

Find:Searchesthecontentsofthescrollbackbufferandterminalscreenforagivenstring

PrintScreen:Printsthetextcurrentlydisplayedintheterminalwindow

PrintSelection:Printstheselectedtext

AutoPrint:TogglesAutoPrintonoroff

Properties:BringsuptheSessionOptionsdialog

KeymapEditor:InvokestheKeymapEditor

Public-KeyAssistant:OpensthePublic-KeyAssistantdialog

Help:Invokestheonlinehelpmanual

SecureFX:StartsVanDykeSoftware'sSecureFX®(iftheprogramisinstalled)

SessionTabs

SecureCRTallowsyoutodisplaymultiplesessionseitherinseparateapplicationwindowsorinonewindowusingsessiontabs.YouturnontabsbyselectingtheSessionTabsoptionontheViewmenuorbyenablingtheShowsessiontabsoptionontheGlobalOptions/Terminal/Appearance

dialog.Whensessiontabsareenabled,aseparatetabwillbedisplayedforeachopensession.Todisplayanewsessiontab,clickontheConnectinTab/TiletoolbarbuttonoropentheFilemenuandselectConnectinTab/Tile....ThiswillopentheConnectinTab/Tiledialogallowingyoutoselectfromalistofyourexistingsessions.

Note:YoucanstillopensessionsinseparatewindowsbyusingtheConnectbuttontostartothersessions.

Tabscanbemovedusingdrag-and-dropoperationsandcanbeclosedbypressingCTRL+F4.Tabscanberenamedbyright-clickingonthenameonthesessiontabandselectingRename.ThenamechangeremainsineffectuntilthetabisreusedoruntilSecureCRTexits.Youcanalso"clone"atabbedsessionbyright-clickingonthesessionandselectingtheCloneSessionoptionorbyopeningtheFilemenuandselectingtheCloneSessionoption.Thiswillcreateasessionthatisidenticaltothecurrentsession.IftheoriginalsessionisusingtheSSH2protocol,thetransportissharedandre-authenticationisnotneeded.Forotherprotocols,authenticationisrequired.Whenworkingwithtabs,thefirstsessionalwaysdictatesgeometryandfontchoicesoftheothersessionsregardlessoftheactualsettingsforsizeandfontintheothersessions.TabsareautomaticallysizediftheydonotfitintheSecureCRTwindow.

SFTPsessionsIfyouhaveanSSH2sessionopen,youcanalsoopenanSSHfiletransferprotocol(SFTP)sessionusingthesametransportasthecurrentSSH2session.Todothis,opentheSecureCRTFilemenuandselecttheConnectSFTPSessionoption(youcanalsoaccessthisoptionfromthe

right-clickcontextmenu).ThiswillopenanewtabortiledsessionwithaSFTPcommandline.Drag-and-droptransfersaresupportedintheSFTPtab.SingleormultiplefilescanbedraggedfromMicrosoftExplorer(orotherOLE-enabledapplications)intotheSFTPtab,whichcauseaputcommandtobeissuedforthefile(s).SecureCRTalsosupportstabcompletionofcommandargumentsontheSFTPcommandline.BegintypingacommandandargumentandthenpresstheTABkey.SecureCRTwillattempttocompletetheargument(s)basedontheavailablechoices.Iftherearemultiplechoices,SecureCRTwilldisplayalistofpossibleoptions.YoucanchoosefromthislistorcontinuetypinguntilSecureCRTcanidentifytheuniqueargument.SeeSFTPCommand-LineOptionsforacompletelistingofavailableoptions.

TheConnectBar

TheSecureCRTconnectbarprovidesacommand-basedmethodthatallowsyoutoenterandconnecttoasessionorsessions.TheconnectbarisaccessedviathetoolbarorbytypingtheALT+Rkeycombination.TheconnectbarcanbedisplayedorhiddenbyselectingordeselectingtheConnectBaroptionontheViewmenu.PressingCTRL+ENTERintheconnectbarwillopenthespecifiedsessioninanewwindow.

SyntaxExamplesThefollowingisanexampleofhowtoopenanewconnection.ThehostcanbeanIPaddressoranamedhost.Ifonlythehostisspecified,thedefaultprotocolandportwillbeused.[<protocol>://][<user>[:<password>]@]<host>[:<port>]

Thefollowingisanexampleofhowtoopenaspecificsession./S<sessionname>

Thefollowingisanexampleofhowtoopenconnectionstothespecifiedsessionsintwotabs(inthecurrentwindoworanewwindow)./S<sessionname>/S<sessionname>

Thefollowingisanexampleofhowtoopenaconnectionto<host>using<firewall>/FIREWALL=<firewall>ssh2://[<user>]@<host>

UsingSecureCRT'sdependentsessionoptiononthecommandlineorintheconnectbar(asinthefollowingexample),it'spossibletolinkasessiontoanSSH2sessionthatitdependson,whichallowsconnectiontoajumphostbeforeconnectingtoothersessions.Boththecommandlineandtheconnectbarusethenormal/FirewallspecifierandthefirewallwillbeSession:<sessionname>withthefollowingsyntax./FIREWALL=Session:<SessionName>

ssh2://[<user>]@<host>

Session:iscaseinsensitive.

TheButtonBar

TheSecureCRTbuttonbarisauser-configurablerowofbuttonsthatyoucanusetoquicklyaccessfrequentlyneededactionsandcommands.YoucantogglethebuttonbardisplayonoroffbyselectingorunselectingtheButtonBaroptionontheViewmenu,orbyselectingorunselectingtheShowbuttonbaroptionontheTerminal/Appearance/WindowcategoryoftheSessionOptionsdialogortheTerminal/AppearancecategoryoftheGlobalOptionsdialog.

Note:Toperformanaction,whichhasbeenmappedtoabutton,onallconnectedsessions,usetheSHIFT+<click>combination.IfthemappedactionisLaunchApplication,onlyoneinstanceoftheapplicationwillbelaunched.

ThebuttonbarassignedtothedefaultsessionisusedforallnewandQuickConnectsessions.Thedefaultbuttonbarisnormallyassignedtothedefaultsession,butthiscanbechangedbyeditingtheDefaultSessioncategoryintheGlobalOptionsdialog.

Note:Thedefaultbuttonbarcanbeedited,butcannotbedeleted.Tocreateanewbuttonbar,right-clickonanypartofthebuttonbartoopenthecontextmenuandthenselecttheNewButtonBar…option.ThisopenstheNewButtonBardialogwhichallowsyoutoaddanamedbuttonbartothegloballistofbuttonbarsavailabletoSecureCRT.AbuttonbarcanbeassignedtoasessionintheTerminal/Appearance/Window

categoryoftheSessionOptionsdialog,orbyselectingadifferentbuttonbarinthebuttonbardrop-downlistwhilethesessionisactive.Toaddabuttontothebuttonbar,right-clickanywhereinthebuttonbarandselecttheNewButton…option;thiswillopentheMapButtondialog.Tochangeanexistingbutton,right-clickonthebuttonyouwanttochangeandchoosetheEditButton…option.Eachbuttononabarcanbeassignedoneaction.ThelistofactionsavailableisthesameasthelistofactionsavailableforkeymapkeyassignmentsandincludesSendString,RunScript,Menu,ScrollBar,Telnet,SSH,andVTfunctiongenres.Youcanrearrangethebuttonsonthebuttonbarbyright-clickingonabuttonandselectingtheMoveButtonLeftorMoveButtonRightoption.

Note:Inordertodisplayanampersandcharacter(&)inabuttonbar,itmustbeprecededbyasecondampersand.Forexample,tolabela

button"A&B",thetextenteredintheLabelfieldoftheMapButtonBardialogshouldbe"A&&B".

Youcanalsocreateabuttonthatlauncheslocalcommands.ByassigningabuttontothefunctionLaunchApplicationandenteringtheappropriateexecutablefile,SecureCRTcanopenwhateverapplicationyouneed.

Note:Someactionsmightfailorbeignorediftheactivesessionisnotconnectedorisinastatewheretheactioncannotbeperformed.

Toremoveabuttonfromabuttonbar,right-clickthebuttonthatyouwanttodeleteandselectDeleteButtonfromthecontextmenu.Todeleteabuttonbar,selectthebuttonbaryouwanttodeleteinthebuttonbardrop-downlist(makingittheactivebuttonbarforthesession),right-clickanywhereinthebuttonbar,andchoosetheDeleteButtonBaroption.Assignmentsofkeysinkeymapsandofbuttonsinbuttonbarsareindependentofeachother;i.e.,assigningakeytoanactiondoesnotaffectanyassignmentsorlabelsinbuttonbars,butyoucanedityourkeymapandbuttonbarsseparatelytohavecorrespondingsettings.

TheStatusBar

TheSecureCRTstatusbar(shownbelow)ismadeupofthefollowingfields(astheyappearfromlefttoright):

StatusBar

MessageThemessagesincludethefollowing:thedefault"Ready";shortdefinitionsofhighlightedtoolbarbuttonsandmenucommands;andthecoordinateswhenyouresizetheSecureCRTwindoworselectanareawithinthewindow.ProtocolTheprotocolthatisbeingusedbythecurrentsession.TheseprotocolsincludeSSH1,SSH2,Telnet,Telnet/SSL,RLogin,andSerial.CursorLocationTherowandcolumn(row,column)inwhichtheterminalcursorcurrentlyresides.RowsConfiguredThenumberofrowstobedisplayedintheSecureCRTwindow(asconfiguredintheSessionOptionsdialog).ColumnsConfiguredThenumberofcolumnsdisplayedintheSecureCRTwindow(asconfiguredintheSessionOptionsdialog).EmulationThetypeofterminalthatSecureCRTiscurrentlyemulating.TheseemulationsincludeANSI,Linux,SCOANSI,VT100,VT102,andVT220.ElapsedtimeIndicateselapsedconnectiontimeforthesessioniftheShowelapsedtime

optionisenabled.CapsLockIndicateswhetherthekeyboardCapsLockcontrolisonoroff.NumLockIndicateswhetherthekeyboardNumLockcontrolisonoroff.

ArrangingEntriesintheConnectDialog

SessionslistedintheConnectdialog'ssessiontreecanbearrangedalphabetically(i.e.,A1,A10,A2,B),logically(i.e.,A1,A2,A10,B),ormanually.YoucanselecttheorderbywhichyouwanttosortthesessiontreebyusingtheConnectdialogsortorderoptionintheGlobalOptions/Generaldialog,orbyright-clickingonanyentrylistedintheConnectdialogandchoosingtheArrangeTreeoptionfromtheresultingcontextmenu.ChangingthesortorderwiththeArrangeTreeoptionwillalsochangetheConnectdialogsortorderandviceversa.Bydefault,sessionsarelistedinalphabeticalorderasdepictedinthesamplesessionsandfolderslistedintheConnectdialogshowninConnectDialog:ArrangedInAlphabeticalOrderbelow.

ConnectDialog:ArrangedInAlphabeticalOrder

Bychoosingtomanuallyarrangetheentriesinthesessiontree,youcaneasilymoveindividualsessionsorevenentirefoldersusingdrag-and-dropoperations.InConnectDialog:ManualArrangementUsingDrag-and-DropOperationsbelow,theuserisintheprocessofmanuallyarrangingtheschoolsessiontobelistedbeforeorabovethegaboonsessionintherloginsessionsfolderusingdrag-and-dropoperations.

ConnectDialog:ManualArrangementUsingDrag-and-DropOperations

CopyingandPasting

SecureCRTprovidesyouwithavarietyofwaystocopyandpastetexttoandfromtheterminalscreen.Thissectioncoversthebasicsonaccomplishingthefollowingtasks:

SelectingTextintheTerminalWindow

CustomizingWordDelimiterCharacters

CopyingTexttotheClipboard

PastingTextfromtheClipboardtotheTerminalScreen

CopyonSelect

Middle/RightButtonPaste

CopyingandPastingwithCTRL+CandCTRL+V(CUACopyandPaste)

SelectingTextintheTerminalWindowThereareavarietywaystoselecttextintheSecureCRTterminalscreen.

SelectingRowsofTextThismethodinvolvesmovingthemousepointeracrossthewordsorrowsoftextyouwantselectedwhileholdingdowntheleftmousebutton.Thisisthedefaultmethodforselectingtext(seeSelectingRowsofTextintheTerminalScreenbelow).SelectingColumns(blocks)ofTextThismethodisusefulforselectingcolumnsoftextratherthanrowsoftext.Toselectablockoftextmadeupofoneormorecolumnsoftextontheterminalscreen,holddowntheALTkeywhilemovingthemousepointerdownthecolumn(s)youwantselectedwhileholdingdowntheleftmousebutton(seeSelectingColumnsofTextintheTerminalScreenwhileHoldingDowntheALTKeybelow).SelectinganEntire"Word"ofTextAnothermethodofselectingtextmakesselectinganentirewordeasy.Youcanselectanentirewordjustbypositioningthemousecursoroverthewordandthendouble-clickingonthewordwiththeleftmousebutton.Inadditiontobeingabletoselectanentirewordwithameredouble-click,SecureCRTprovidesawayforyoutocustomizetheworddelimitercharactersonaper-sessionbasis.

SelectingRowsofTextintheTerminalScreen

SelectingColumnsofTextintheTerminalScreenwhileHoldingDowntheALTKey

ModifyingaSelection

Youcanmodifyanexistingselectionintheterminalscreen.Tomodifythecurrentselection,holddowntheSHIFTkey,movethemousepointertothenewdesiredstartorendpoint,andpresstheleftmousebutton.

CustomizingWordDelimiterCharactersBydefault,SecureCRTusesallnon-alphanumericcharacters(exceptunderscore,"_")asworddelimiterswhenselectinganentire"word"withadouble-clickactionasdescribedinthe"SelectingTextintheTerminalWindow"sectionofthishelptopic.Youcanmodifytheworddelimitercharactersusingthefollowingsteps:1.IntheSessionOptionsdialog,selecttheTerminalcategory.2.IntheTerminalpanel,selecttheSetworddelimitercharacters

option.3.Enteryourpersonalworddelimitercharacters.Donotseparatethe

entrieswithspacesoranyothercharacter.Note:A"space"charactercanbeusedasadelimitercharacter.

Bydefault,SecureCRTusesallnon-alphanumericcharacters(exceptunderscore,"_")asdelimiterswhenselectingaword.Thisincludespunctuationsuchas.,!?()",butalso$#@/\.Youmightwantsomeofthesecondcharacterset($#@/\)tobeexcludedfromtheworddelimitercharacterssothatyoucanselectcurrencyamounts,pathnames,emailaddresses,andthelike.

CopyingTexttotheClipboard:TocopytextfromtheterminalscreentotheClipboard:1.Selectthetextyouwanttocopybydraggingthemousecursorover

thedesiredareaoftext.2.SelectCopyfromtheEditmenuontheSecureCRTmenubarorclick

ontheCopybutton locatedontheSecureCRTtoolbar.TheselectedtextisnowcopiedtotheClipboardandreadyforpasting.TheformatofthedatasavedtotheClipboardcannotbechangedintheSecureCRTuserinterface,butcanbechangedmanuallybyeditingtheGlobal.inifileintheConfigfolder.IntheGlobal.inifile,theClipboard

DataFormatoptioncanbesettoCF_TEXT,CF_OEMTEXT,CF_UNICODETEXT,DEFAULTFORMAT,orVDS_TEXT.

Note:WhencopyingtotheClipboard,SecureCRTalwaystranslatesDECline-drawingcharacterstothefourcharacters:"+","-","_",and"|".IftheCopytranslatesANSIlinedrawingcharactersoptionisenabledontheSessionOptions/Terminal/Emulation/Advanceddialog,SecureCRTalsotranslatesANSIline-drawingcharacterstothethreecharacters:"+","-",and"|".

PastingTextfromtheClipboardtotheTerminalScreen:TopastetextfromtheClipboardtotheterminalscreen:

·SelectPastefromtheEditmenuontheSecureCRTmenubarorclickonthePastebutton locatedontheSecureCRTtoolbar.

ThecontentsoftheClipboardwillbeinsertedatthepointofthetextcursorintheterminalscreen.SecureCRTalsoprovidesafeaturethatallowsyoutocopyandpastefromtheterminalscreenbacktotheterminalscreenwithjustonestep.Selectthetextyouwouldliketopaste,andthenselectCopy&PastefromtheEditmenuontheSecureCRTmenubartopastetheselectedtextatthecursororinsertionpoint.

CopyonSelectTheCopyonselectfeatureallowsyoutospeeduptheprocessofcopyingtextfromtheterminalscreentotheClipboard.Ifthisfeatureisenabled,textiscopiedtotheClipboardassoonasitisselected.Toenable/disabletheCopyonselectfeature:1.SelecttheTerminalcategoryintheGlobalOptionsdialog.2.IntheMousegroup,selectorunselecttheCopyonselectoption.

Middle/RightButtonPasteThePasteonmiddle/rightbuttonfeatureallowsyoutospeeduptheprocessofpastingcontentfromtheClipboardtotheterminalscreen.Ifthisfeatureisenabled,textispastedfromtheClipboardtotheterminalscreenassoonasthemiddleorrightmousebutton(asspecifiedintheGlobalOptions/Terminaldialog)ispressed.Ifyourmousedoesnothavea

middlemousebutton,amiddlebuttonclickcanbesimulatedbypressingboththeleftandrightmousebuttonssimultaneously.Toenable/disablethePasteonmiddle/rightbuttonfeature:1.SelecttheTerminalcategoryoftheGlobalOptionsdialog.2.IntheMousegroup,selectorunselectthePasteonmiddle/right

buttonoption.

CopyingandPastingwithCTRL+CandCTRL+V(CUACopyandPaste)ToenabletheCTRL+C,CTRL+V,CTRL+A,andCTRL+Facceleratorkeysforcopy,paste,selectall,andfind,respectively:1.SelecttheTerminal/Emulation/MappedKeyscategoryintheSessionOptionsdialog.2.SelecttheUseWindowscopyandpastehotkeysoption.3.Amessageboxwillappearwiththefollowingwarning:

WARNING:TurningonUseWindowscopyandpastehotkeyswilldisableyourabilitytosendCTRL+C,CTRL+V,CTRL+A,andCTRL+Ftotheremotehost.MostUNIXusersshouldleavethisoptionoff.

4.ClickontheOKbuttonontheWarningdialog.5.ClickontheOKbuttonatthebottomoftheSessionOptionsdialog.

CustomizingtheUserInterface

SecureCRTallowsyoutocustomizesomepartsofitsuserinterfaceintwodifferentways:eitherbyusingtheCustomizedialog,orbyeditingthemenuconfigurationfile(describedbelow).Usingeitherofthesemethods,youcanmodifyorremoveexistingmenus,rearrangethemaintoolbarbuttons,andmuchmore,however,youmustchooseoneortheothermethod,astheycannotbeusedtogether.

CustomizingtheMenuConfigurationFileWARNING:CustomizingtheSecureCRTinterfacebyeditingthemenuconfigurationfilecanbeacomplexundertaking.Someprogrammingknowledgewillbehelpful.

Thecustomizableinterfacefeaturesarelistedbelow:·Menutitlesonthemainwindow·Menuoptionsonthemainwindowmenus,theSystemmenu,andright-click

menus·Accelerators·Toolbarbuttons·ToolTips·Statusbarmessages

Tomakechangestotheitemsmentionedabove,youwillneedtoedittheSecureCRTmenuconfigurationfilefoundintheSecureCRTdatafolder.ThedefaultconfigurationfileisDefault.mnu,butotherfilescanbeusedbychangingthefilespecifiedintheCustommenuandtoolbarfileoptionintheTerminalcategoryoftheGlobalOptionsdialog.

Tip:ToreturnSecureCRTtoitsdefaultconfiguration,eitherdeleteanyexistingconfigurationfilesorcleartheentryintheCustommenuandtoolbarfileentrybox,andrestartSecureCRT.ThiswillforceSecureCRTtoreturntodefaultvalues.

ConfigurationFileFormat

Thissectioncoverstheformatandsyntaxofthemenuandtoolbarconfigurationfile.TheprecedenceforacceleratorkeysisF-Keys,Keymap,MenuItem,builtin.

Fileformatrules

Thefieldsinadefinitionwillbeseparatedbyacomma.Commandargumentswillbeseparatedbyaverticalbarorpipe(|).Acceleratordefinitionswillstartwithauniquestringidentifier.TheywillnotcontainafieldforthecommandIDstring,asthatalreadyexistsintheassociatedmenuortoolbaritemdefinition.Stringtabledefinitionswillstartwithauniquestringidentifier.TheywillnotcontainafieldforthecommandIDstringasthatalreadyexistsintheassociatedmenuortoolbaritemdefinition.Acceleratorandstringtabledefinitionsmustappearinthefilebeforeanymenuortoolbardefinitions.

Commandstrings

TheSecureCRTmenuconfigurationfilesupportscommandstringsformostoftheapplicationcommands.SeetheMenuConfigurationCommandStringstopicforacomprehensivelist.Inadditiontostandardmenuandtoolbarcommands,threeuser-definedcommandsarealsoavailable:

·OPEN_SESSION--Thiscommandconnectsyoutothespecifiedsession.

·OPEN_SESSION_TAB--Thiscommandconnectsyoutothespecifiedsessioninatab.

·RUN--Thiscommandrunsthespecifiedscript.Thiscommanddoesnotsupportarguments.

·SEND--Thiscommandsendsthespecifiedstring.

Theabovecommandstringscanbeusedasinthefollowingexamplesextractedfromtheexamplefileattheendofthistopic:TOOLBARITEM"server.bmp","OPEN_SESSION","server",

"server","server"

TOOLBARITEM"run.bmp","RUN","C:\vss\test.vbs",

"script"

TOOLBARITEM"send.bmp","SEND","HelloWorld\n",

"hello"

Keywordsandsyntax

Itemsenclosedinanglebrackets(<>)arerequired.Itemsenclosedinsquarebrackets([])areoptional.

END(endsadefinitionofamenu,toolbar,popupmenu,acceleratorkeys,orstringtable)MENU(formainmenudefinitions)MENU<“label”>

<definitionofmenuitemsorsubmenus>

END

TOOLBAR(fortoolbardefinitions)TOOLBAR<“label”>

<definitionofbuttonsinthetoolbar>

END

POPUPMENU(forcontextandsystemmenuaswellassub-menus)POPUPMENU<”label”>

<definitionofmenuitemsorsubmenus>

END

ACCELERATOR(forthedefinitionofacceleratorkeys)ACCELERATOR

<definitionofacceleratorkeys>

END

Anacceleratorkeydefinitionisoftheform:<”unique_identifier”>,<”key”>,<”keymodifiersseparatedby‘|’”>

STRINGTABLE(forthedefinitionofstatusbarandToolTipstrings)STRINGTABLE

<definitionofstatusbarandtooltipstrings>

END

Astringtabledefinitionisoftheform:<”unique_identifier”>,<”statusbarmessage\ntooltip”>

SEPARATOR(indicatesthataseparatorshouldbeplacedinthemenuortoolbar)MENUITEM(designatesthatthefollowingtextdefinesamenuitem)

MENUITEM<”label”>,<”commandstr”>[,”command

argument(s)”][,”stringtableidentifier”]

[,”acceleratoridentifier”]

TOOLBARITEM(designatesthatthefollowingtextdefinesatoolbarbutton)TOOLBARITEM<”icon”>,<”commandstr”>[,”command

argument(s)”][,”stringtableidentifier”]

[,”acceleratoridentifier”]

//(designatesacomment)//[commentstring]

Anylinethathas//asthefirsttwocharacterswillbeconsideredasacomment.Commentsmustbeonalinebythemselves.

ForMENUITEM,the“label”and“commandstr”arerequired.Theremainingargumentsareoptional.However,orderisimportant.Ifanoptionalargumentisnotprovidedanditisfollowedbyanargumentthatisprovided,theargumentseparator(,)mustbeincluded.Forexample:MENUITEM&MyItem,MY_MENU_COMMAND,,”Thisismy

menuitem”

Theaboveargumentsare:<”label”>,<”commandstr”>,,<”stringtableidentifier”>

ForTOOLBARITEM,oneof“icon”and“commandstr”isrequired.Againorderisimportantandskippedargumentsmusthavetheargumentseparatorincluded.

Errorsandwarnings

Whenanerrorconditionoccurs,youwillbeinformedaboutthenatureoftheerrorandthatthedefaultmenuortoolbarwillbeloadedanddisplayed.Whenawarningconditionoccurs,youwillbeinformedaboutwhatcausedthewarningconditionandthattheparticularmenuortoolbaritem,accelerator,orhintwillnotbeused.However,thosepartsofthemenuortoolbarthatarecorrectwillbeloadedanddisplayed.

Examplefile

ThefollowingexamplefileisthedefaultmenuandtoolbarconfigurationfileDefault.mnu.

//***ThisfilewillbeoverwrittenwhenSecureCRTisupgraded.***//***Ifyouwishtomodifythefile,pleasemakeyourchangesinacopy.***//acceleratortableACCELERATOR"Connect","C","VIRTKEY|ALT"

"ConnectinTab","B","VIRTKEY|ALT"

"NewSFTPTab","P","VIRTKEY|ALT"

"Quick","Q","VIRTKEY|ALT"

"GotoChatWindow","G","VIRTKEY|ALT"

END//stringtableforstatusbarandtooltipsSTRINGTABLE"Connect","Connecttoaremotehostinanew

window\nConnect"

"ConnectinTab","Connecttoaremotehostina

newtab\nNewTab"

"CloneSession","Clonecurrentsession\nClone

Session"

"NewSFTPTab","ConnectnewSFTPtabusing

currentsession\nSFTP"

"LockSession","Lock/Unlockcurrent

session\nLock/UnlockSession"

"Quick","Quickconnect\nQuickConnect"

"GotoChatWindow","Gotothechatwindowor

sessionwindow\nGotoChatWindow"

END//mainmenuMENU"[main]"POPUPMENU"&File"

MENUITEM"&Connect...","MENU_CONNECT",,"Connect","Connect"

MENUITEM"&QuickConnect...","MENU_QUICK_CONNECT",,"Quick","Quick"MENUITEM"ConnectinTa&b...","MENU_TAB_NEW",,"ConnectinTab","ConnectinTab"SEPARATORMENUITEM"&Reconnect","MENU_RECONNECT"MENUITEM"Reconnect&All","MENU_RECONNECT_ALL"MENUITEM"&Disconnect","MENU_DISCONNECT"MENUITEM"Disc&onnectAll","MENU_DISCONNECT_ALL"SEPARATORMENUITEM"Clo&neSession","MENU_TAB_CLONE",,"CloneSession",MENUITEM"Connect&SFTPTab","MENU_TAB_NEW_SFTP",,"NewSFTPTab","NewSFTPTab"SEPARATORMENUITEM"Loc&kSession...","MENU_TAB_LOCK",,"LockSession",SEPARATORPOPUPMENU"&Print"MENUITEM"&AutoPrint","MENU_PRINT_AUTO"

MENUITEM"&Screen","MENU_PRINT_SCREEN"

MENUITEM"Se&lection","MENU_PRINT_SELECTION"

MENUITEM"&Ejectpage",

"MENU_PRINT_EJECT_PAGE"

MENUITEM"&Cancel","MENU_PRINT_CANCEL"

ENDMENUITEM"PrintSet&up...","MENU_PRINT_SETUP"SEPARATORMENUITEM"&LogSession","MENU_LOG_SESSION"MENUITEM"Ra&wLogSession","MENU_DEBUG_LOG"MENUITEM"&TraceOptions","MENU_TRACE_OPTIONS"SEPARATORMENUITEM"RecentSession","MENU_MRU_FILE1"SEPARATORMENUITEM"E&xit","MENU_EXIT"

END

POPUPMENU"&Edit"

MENUITEM"&Copy","MENU_COPY"

MENUITEM"&Paste","MENU_PASTE"MENUITEM"C&opy&&Paste","MENU_COPY_PASTE"MENUITEM"Pasteas&Quotation","MENU_EDIT_PASTE_AS_QUOTATION"MENUITEM"Select&All","MENU_SELECT_ALL"MENUITEM"&Find...","MENU_FIND"SEPARATORMENUITEM"PrintSe&lection","MENU_PRINT_SELECTION"SEPARATORMENUITEM"&GotoChatWindow","MENU_GOTO_CHAT_SESSION_WINDOW"SEPARATORMENUITEM"ClearScroll&back","MENU_CLEAR_SCROLLBACK"MENUITEM"Clear&Screen","MENU_CLEAR_SCREEN"MENUITEM"ClearScreen&&Scrollbac&k","MENU_CLEAR_SCREEN_AND_SCROLLBACK"SEPARATORMENUITEM"&Reset","MENU_RESET"

END

POPUPMENU"&View"

MENUITEM"&MenuBar","MENU_TOGGLE_MENU_BAR"MENUITEM"&Toolbar","MENU_TOGGLE_TOOLBAR"MENUITEM"SessionTa&bs","MENU_TOGGLE_SESSION_TABS"MENUITEM"&ChatWindow","MENU_TOGGLE_CHAT_WINDOW"MENUITEM"ConnectBa&r","MENU_TOGGLE_CONNECT_BAR"MENUITEM"&StatusBar","MENU_TOGGLE_STATUS_BAR"MENUITEM"&ButtonBar","MENU_TOGGLE_BUTTON_BAR"POPUPMENU"Th&emes"MENUITEM"&Shaded","MENU_THEMES_SHADED"

MENUITEM"Office200&0",

"MENU_THEMES_OFFICE2000"

MENUITEM"Office200&3",

"MENU_THEMES_OFFICE2003"

MENUITEM"&Blue","MENU_THEMES_BLUE"

MENUITEM"Blac&k","MENU_THEMES_BLACK"

MENUITEM"&Aqua","MENU_THEMES_AQUA"

MENUITEM"S&ilver","MENU_THEMES_SILVER"

ENDSEPARATORMENUITEM"&WindowTransparency","MENU_TOGGLE_ALPHA_TRANSPARENCY"SEPARATORMENUITEM"&HorizontalScrollBar","MENU_TOGGLE_HORZ_SCROLLBAR"MENUITEM"&VerticalScrollBar","MENU_TOGGLE_VERT_SCROLLBAR"SEPARATORMENUITEM"&AlwaysonTop","MENU_ALWAYS_ON_TOP"MENUITEM"&FullScreen","MENU_TOGGLE_FULL_SCREEN"

END

POPUPMENU"&Options"

MENUITEM"&SessionOptions...","MENU_SESSION_OPTIONS"MENUITEM"&GlobalOptions...","MENU_GLOBAL_OPTIONS"SEPARATORMENUITEM"&AutoSaveOptions","MENU_AUTO_SAVE"MENUITEM"SaveSettings&Now","MENU_SAVE_NOW"

END

POPUPMENU"&Transfer"

MENUITEM"&SendASCII...","MENU_SEND_ASCII"MENUITEM"&ReceiveASCII...","MENU_RECEIVE_ASCII"SEPARATORMENUITEM"Send&Binary...","MENU_SEND_BINARY"SEPARATORMENUITEM"Se&ndXmodem...","MENU_SEND_XMODEM"MENUITEM"Re&ceiveXmodem...","MENU_RECEIVE_XMODEM"SEPARATORMENUITEM"Sen&dYmodem...","MENU_SEND_YMODEM"MENUITEM"Recei&veYmodem...","MENU_RECEIVE_YMODEM"

SEPARATORMENUITEM"&ZmodemUploadList...","MENU_ZMODEM_ADD_FILE"MENUITEM"StartZmodem&Upload","MENU_SEND_ZMODEM"

END

POPUPMENU"&Script"

MENUITEM"&Run...","MENU_SCRIPT_RUN"MENUITEM"&Cancel","MENU_SCRIPT_CANCEL"SEPARATORMENUITEM"&StartRecordingScript","MENU_SCRIPT_START_RECORDING"MENUITEM"S&topRecordingScript...","MENU_SCRIPT_STOP_RECORDING"MENUITEM"C&ancelRecordingScript","MENU_SCRIPT_CANCEL_RECORDING"SEPARATORMENUITEM"RecentScript","MENU_SCRIPT_MRU_FILE1"

END

POPUPMENU"Too&ls"

MENUITEM"&KeymapEditor...","TOOLS_MENU_KEYMAP_EDITOR"SEPARATORMENUITEM"&CreatePublicKey...","TOOLS_CREATE_PUBLIC_KEY"MENUITEM"ConvertPrivateKeyto&OpenSSHFormat...","TOOLS_CONVERT_PRIVATE_KEY"MENUITEM"&ExportPublicKeyfromCertificate...","TOOLS_EXPORT_PUBLICKEY_FROM_CERTIFICATE"MENUITEM"&Public-KeyAssistant...","TOOLS_PUBLIC_KEY_ASSISTANT"SEPARATORMENUITEM"Ma&nageAgentKeys...","TOOLS_MANAGE_AGENT_KEYS"

END

POPUPMENU"&Help"

MENUITEM"&HelpTopics","MENU_HELP_FINDER"SEPARATORMENUITEM"SecureCRT&WebPage...","MENU_HELP_WEBPAGE"MENUITEM"&OrderSecureCRT...","MENU_HELP_ORDER"MENUITEM"Checkfor&Updates...","MENU_HELP_UPDATE"MENUITEM"VanDykeSoftware&Forum...","MENU_FORUMS_WEBPAGE"SEPARATORMENUITEM"&EnterLicenseData...","MENU_ENTER_LICENSE_DATA"SEPARATORMENUITEM"&AboutSecureCRT...","MENU_APP_ABOUT"

END

ENDPOPUPMENU"[context]"MENUITEM"&Copy","MENU_COPY"

MENUITEM"&Paste","MENU_PASTE"

MENUITEM"Copy&&Paste","MENU_COPY_PASTE"

MENUITEM"Pasteas&Quotation",

"MENU_EDIT_PASTE_AS_QUOTATION"

SEPARATOR

MENUITEM"&OpenURL","MENU_OPEN_URL"

SEPARATOR

MENUITEM"&Find...","MENU_FIND"

MENUITEM"Select&All","MENU_SELECT_ALL"

MENUITEM"PrintSe&lection",

"MENU_PRINT_SELECTION"

SEPARATOR

MENUITEM"ClearScroll&back",

"MENU_CLEAR_SCROLLBACK"

MENUITEM"Clear&Screen","MENU_CLEAR_SCREEN"

MENUITEM"ClearScreen&&Scrollbac&k",

"MENU_CLEAR_SCREEN_AND_SCROLLBACK"

ENDPOPUPMENU"[system]"MENUITEM"&Restore","SYS_MENU_RESTORE"

MENUITEM"&Move","SYS_MENU_MOVE"

MENUITEM"&Size","SYS_MENU_SIZE"

MENUITEM"Mi&nimize","SYS_MENU_MINIMIZE"

MENUITEM"Ma&ximize","SYS_MENU_MAXIMIZE"

SEPARATOR

MENUITEM"&AlwaysonTop","MENU_ALWAYS_ON_TOP"

MENUITEM"SaveSettingsNo&w","MENU_SAVE_NOW"

MENUITEM"&ToggleMenuBar",

"MENU_TOGGLE_MENU_BAR"

SEPARATOR

MENUITEM"&Close","SYS_MENU_CLOSE"

END//thetoolbarTOOLBAR"[toolbar]"TOOLBARITEM"MENU_CONNECT","MENU_CONNECT",,

"Connect","Connect"

TOOLBARITEM"MENU_QUICK_CONNECT",

"MENU_QUICK_CONNECT",,"Quick","Quick"

TOOLBARITEM"MENU_TAB_NEW","MENU_TAB_NEW",,

"ConnectinTab","ConnectinTab"

TOOLBARITEM"MENU_RECONNECT","MENU_RECONNECT"

TOOLBARITEM"MENU_DISCONNECT","MENU_DISCONNECT"

TOOLBARITEM"CONNECT_BAR","CONNECT_BAR"

SEPARATOR

TOOLBARITEM"MENU_COPY","MENU_COPY"

TOOLBARITEM"MENU_PASTE","MENU_PASTE"

TOOLBARITEM"MENU_FIND","MENU_FIND"

SEPARATOR

TOOLBARITEM"MENU_PRINT_SCREEN",

"MENU_PRINT_SCREEN"

TOOLBARITEM"MENU_PRINT_SELECTION",

"MENU_PRINT_SELECTION"

TOOLBARITEM"MENU_PRINT_AUTO","MENU_PRINT_AUTO"

SEPARATOR

TOOLBARITEM"MENU_SESSION_OPTIONS",

"MENU_SESSION_OPTIONS"

TOOLBARITEM"TOOLS_MENU_KEYMAP_EDITOR",

"TOOLS_MENU_KEYMAP_EDITOR"

TOOLBARITEM"TOOLS_PUBLIC_KEY_ASSISTANT",

"TOOLS_PUBLIC_KEY_ASSISTANT"

SEPARATOR

TOOLBARITEM"MENU_HELP_FINDER","MENU_HELP_FINDER"

SEPARATOR

TOOLBARITEM"TOOLBAR_LAUNCH_SECUREFX",

"TOOLBAR_LAUNCH_SECUREFX"

END

KeyboardAccelerators

Thispagelistskeyboardaccelerators(shortcutkeys)thataresupportedinSecureCRT.Theacceleratorsareasfollows:

•CTRL+TABtakesyouthroughmultipleSecureCRTsessiontabs.•CTRL+SHIFT+TABcyclesbackwardsthroughthesessions.•CTRL+F4closestheactivetab.•ALT+1(2,3,4,5,6,7,8,9,&0)allowsyoutojumpdirectlytoone

ofthefirsttentabs.•ALT+BopenstheConnectinTab/Tiledialog.•ALT+CopenstheConnectdialog.•ALT+Gswitchesthefocusbetweenthechatwindowandtheactive

session.•ALT+PopensanSFTPtabusingtheactivetab'ssession.•ALT+QopenstheQuickConnectdialog.

Withinthechatwindow,CTRL+SHIFT+TABswitchesthefocustotheactivesession.Fortheadvanceduser,theTableofKeymapFunctionslistskeyboardmenufunctionsthatyoucanlinktokeystrokesusingtheKeymapEditor.

SwitchingBetweenMultipleSessions

ThereareseveralwaystoswitchbetweenmultipleSecureCRTsessions.

·IfyouenabletheShowsessiontabsoptionontheGlobalOptions/Terminal/Appearancedialog,youcanswitchbetweensessionsbyclickingonthetabsintheSecureCRTwindow.

·IfyouareusingtheMinimizetoActivatorinsystemtrayoption,right-clickontheActivatoriconinthesystemtrayandselecttheSecureCRTsessionwindowthatyouwanttoopenfromthepop-upmenu.

·YoucanalsousetheCTRL+TABkeyboardshortcuttotakeyouthroughmultipleSecureCRTsessionwindows,whileCTRL+SHIFT+TABwilltakeyoubackwardsthroughthesessions.

·UsingALT+1throughALT+0willallowyoutodirectlynavigatetoanyofthefirsttentabs.

UsingtheActivator

TheActivatorallowsyoutominimizespecificsessionsorallsessionstothesystemtrayinsteadofthetaskbar.ThiscanbeusefulifyouhaveanumberofsessionsrunningorifyouonlyuseSecureCRTtoportforwardyourconnectionstoanothermachine.TheActivatoralsosupportsSSHagentfunctionality,sothatifSecureCRTisclosed,authenticationwillhappenautomaticallyaslongastheActivatorisstillrunning.IfyouwouldliketousetheActivator'sSSHagentfunctionalitybutdonotwanttominimizetotheActivator,theActivatorcanbeaddedtotheWindowsStartmenuorcanbestartedmanually.

EnablingtheActivatorTheActivatorcanbeenabledasaglobaloption(affectingallsessions).ToenabletheActivatoroptionforallsessions,completethefollowingsteps:1.SelectGlobalOptions...fromtheOptionsmenu.2.ClickontheGeneralcategory.3.ChecktheMinimizetoActivatorinthesystemtraycheckboxto

turnontheActivator.Thisoptionisoffbydefault.4.ClicktheOKbuttontosaveyourchanges.

RestoringSessionsTorestoresessionsthathavebeenminimizedtothesystemtray,right-clickontheActivatoriconinthetrayandchoosethesessionthatyouwanttorestorefromtheresultingmenu.

ManagingAgentKeysIntheActivatormenu,selectingtheManageAgentKeys…commandwillopentheManageAgentKeysdialogwhichallowsyoutoaddkeystoandremovekeysfromthelistofacceptedagentkeys.

OverviewofCommand-LineOptions

Command-LineOptionsTherearetwocategoriesofSecureCRTcommand-lineoptions:standardoptions,andprotocol-specificoptions.Standardoptionsmaybeusedinanycombinationwithotherstandardoptions.Protocol-specificoptionsaremutuallyexclusive;aprotocol-specificoptioncannotbeusedincombinationwithanyotherprotocol-specificoption.Syntax:SecureCRT.exe[standardoptions][protocol-specificoptions]

Youmayfindithelpfultoseetheexamplesofusingcommand-lineoptions.

TableofStandardCommand-LineOptions

StandardOption Arguments Description

/ARG argument Passesoption(s)toSecureCRTscriptsbywayofArgumentsscriptingobjects.Morethanone/ARGoptioncanbeusedinacommand.

/COLOR_SCHEME scheme Specifiesanexistingcolorschemetobeusedforthesessionbeingstarted.Whenthisswitchisused,anychangestothesessioncolorschemewillbeignored.Ifanonexistentschemeisspecified,thesessionconfigurationcolorschemewillbeused.

/F folder

pathname

Pointstoanalternateconfigurationfolderlocation.Ifthereisnoconfigurationfileinthealternatefolder,SecureCRTwillcreateone.Withoutthisoption,SecureCRTwillusetheconfigurationinformationinthedefaultfolderlocation.

/FIREWALL firewall

name

Connectssessionusingspecifiedfirewallsettings.Replaces/PROXYand/SOCKSoptions.Theformatofthiscommandisasfollows:/FIREWALL=<name>

Ifthefirewallnamecontainsspaces,itshouldbeenclosedbyquotationmarks.

Ifnofirewallargumentisspecified,SecureCRTwillusethefirewallspecifiedbythesessionbeingconnected.IfthesessionfirewallissettoNone,SecureCRTwillusethefirewallspecifiedinthecurrentglobalfirewallsettings.Ifafirewallisnamedinthecommandargument,SecureCRTwilltemporarilyoverridethesession’sfirewallsettingsandusethefirewallspecifiedforthecurrentsession.

Note:Whenspecifyingafirewallonthesamecommandlineusedtoopenmultiplesessions,SecureCRTwillapplythefirewalltoeachofthesessions.

UsingSecureCRT'sdependentsessionoptiononthecommandlineorintheconnectbar(asinthefollowingexample),it'spossibletolinkasessiontoanSSH2sessionthatitdependson,whichallowsconnectiontoajumphostbeforeconnectingtoothersessions.Boththecommandlineandtheconnectbarusethenormal/FirewallspecifierandthefirewallwillbeSession:<sessionname>withthefollowingsyntax./FIREWALL=Session:

<SessionName>

ssh2://[<user>]@<host>

Session:iscaseinsensitive.

/LOG filename Specifiesalogfiletobeusedforthesessionbeingstarted.

/MAX_COLS n Specifiesthemaximumnumberofcolumns.Themaximumvaluefornis1024andtheminimumvalueis132.

/N tabname Specifiesthenametodisplayonthetab.

/NOMENU Hidesthemenubar.

/NOTOOLBAR Hidesthetoolbar.

/NOSAVE Nochangestosettingswillbesaved.

/POS xy SpecifiestheinitialpositionoftheSecureCRTwindow,wherexandyspecifytheupperleftcorneroftheSecureCRTwindowinpixelcoordinates.

/SCRIPT filename Runsscriptcontainedinfilename.

/SESSION_FOLDER folder Opensthesessionsinthespecifiedfolderthatwouldbeopenedifthefolderwasdesignatedasanautosession.Toopenallthesessions,usethefollowingcommand:/SESSION_FOLDER\

The/SESSION_FOLDERoptioncanbeusedwiththe/Soption.

/TITLEBAR "Title Setsthetextinthetitlebartothe

to

display"

stringgivenasargument.

ExamplesofCommandLineUsage:Example:

TolaunchanewTelnetsession,displayingthename"Houston,TX"onthetab,usethefollowing:

/T/N"Houston,TX"/TELNET192.168.0.6

TableofProtocol-SpecificCommand-LineOptions

Anyofthestandardoptionsmaybeusedincombinationwithaprotocol-specificoption.

ProtocolOptionAndMandatoryArguments

RelatedOptionsandArguments Description

/S

session_namenone StartsSecureCRTandopens

aconnectionwithsession_name.Ifsession_nameincludesanyspaces,itmustbeenclosedwithquotationmarks,(e.g.,"MySession").Multiplesessionscanbeopenedbyspecifyingmultiple"/Ssession_name"argumentpairsonthecommandline.Note:The/Soptionisconsideredaprotocol-specificoptionbecausetheprotocoltobeusedisdefinedbythesessionparameters.

/T

/S Whenusedinconjunction

withthe/Soptions,the/Toptionopensthespecifiedsessionorsessionsinaseparatetabortabs.Forexample,thecommand:/T/Salphaopenssessionalphainanewtab.Thecommand:

/T/Salpha/Sbetaopensbothsessionsalphaandbetaintheirowntabs.Note:/Tmustprecede/Sinthecommandstring.The/Toptioncanalsobeusedwith"adhoc"sessionssuchas:/T/SSH2myserver

/SSH1

[ssh_options]hostname

none StartsSecureCRTandopensthedefaultsessionwiththeSSH1protocolandbeginsconnectingtohostname.SecureCRTalsoacceptsusername@hostnamesyntax.Note:/SSH1anditsrelatedoptionsareonlyavailableifSSH1supportwasselectedforinstallationduringtheinstallationprocess.

[/ACCEPTHOSTKEYS] InstructsSecureCRTtoautomaticallyaccepthostkeys.

[/Ccipher] Specifiesacipherforencryptingthesession.ValidvaluesforSSH1cipherareNONE,DES,3DES,RC4andBLOWFISH.ThedefaultSSH1cipheris3DES.

[/ENCRYPTEDPASSWORDpassword]

Specifiesapasswordinencryptedform.This

passwordmusthavebeenencryptedbySecureCRT.Toobtainanencryptedpassword,specifyapasswordintheSessionOptionsdialog,thenopenthatsession's.inifileandcopytheencryptedstringfromthePasswordfield.Tousepasswordsinscripts,refertotheSessionObjectConnectmethod.

[/Iidentityfile] Specifiesthelocationoftheuser'sidentityfile.TheidentityfilecontainstheprivatekeyneededtoconnecttotheserverusingRSAauthentication.Theabsenceofthisoptioncausespasswordauthenticationtobeused.

[/Lusername] SpecifiestheusernamewhenconnectingtotheSSH1server.

[/Pport] SpecifiestheSSHserverport.Thedefaultvalueis22.

[/PASSPHRASEpassphrase]

LogsontotheSSH1serverusingpassphraseasthepassphrasefortheidentityfilegivenwiththe/Loption.

[/PASSWORDpassword] LogsontotheSSH1serverusingpasswordas

thepasswordfortheusernamegivenwiththe/Loption.

[/Zcompressionlevel] Specifiesthecompressionlevelfrom1(lowestcompression=fastest)to9(highestcompression=slowest).Settingthisoptionto0turnsoffcompression.

/SSH2

[ssh_options]hostname

none StartsSecureCRTandopensthedefaultsessionwiththeandbeginsconnectingtoSecureCRTalsoacceptsusername@hostnameNote:/SSH2anditsrelatedoptionsareonlyavailableifSSH2supportwasselectedforinstallationduringtheinstallationprocess.

[/ACCEPTHOSTKEYS] InstructsSecureCRTtoautomaticallyaccepthostkeys.

[/AUTHmethod] Specifiestheauthenticationmethod(s)tobeattemptedwhenconnectingtotheSSH2server.Ifmultiplemethodsarespecified,theymustbecomma-separatedwithnospaces(i.e.,/AUTHpassword,publickey,keyboard-

interactive,gssapi

[/Ccipher] Specifiesacipherforencryptingthesession.ValidvaluesforSSH2cipherareNONE,3DES,RC4,andTWOFISH.ThedefaultSSH2cipheris3DES.

[/COMPRESSIONStype] Specifiesthecompressiontypeforthesession.ValidvaluesforSSH2compressiontypeareNONE,ZLIB,andZLIB@OPENSSH.COM.ThedefaulttypeisNONE.

[/ENCRYPTEDPASSWORDpassword] Specifiesapasswordinencryptedform.ThispasswordmusthavebeenencryptedbySecureCRT.Toobtainanencryptedpassword,specifyapasswordintheOptionsdialog,thenopenthatsession's.inifileandcopytheencryptedstringfromthefield.Tousepasswordsinscripts,refertotheSessionObject

[/Iidentityfile] Specifiesthelocationoftheuser'sidentityfile.Theidentityfilecontainstheprivatekeyneededtoconnecttotheserverusingpublic-keyauthentication.Theabsenceofthisoptioncausespasswordauthenticationtobeused.

[/Lusername] SpecifiestheusernamewhenconnectingtotheSSH2server.

[/LOCAL[localip:]localport:hostname:hostport]

AllowsyoutospecifyalocallisteningIPaddresswhensettingupa(notrequired),andforwardsconnectionrequestsfrom(onlocalhost)tohostname.

[/MMAC] SpecifiestheMessageAuthenticationCode(MAC)touse.

[/Pport] SpecifiestheSSH2serverport.The

defaultvalueis22.

[/PASSPHRASEpassphrase] LogsontotheSSH2serverusingpassphraseastheidentityfilegivenwiththe/Loption.

[/PASSWORDpassword] LogsontotheSSH2serverusingpasswordasthepasswordforusernamegivenwiththe/Loption.

[/REMOTE[listenip:]listenport:destination-host:destination-port]

AllowsyoutospecifyaremotelisteningIPaddresswhensettinguparemoteforward(notrequired),andrequeststheSSH2servertoconnectionrequestsontheremotemachine)andforwardtherequeststohostport

[/Zcompressionlevel] Specifiesthecompressionlevelfrom1(lowestcompression=fastest)to(highestcompression=slowest).Settingthisoptionto0turnscompression.

/TELNET

hostname[port]none StartsSecureCRTand

opensthedefaultsessionwiththeTelnetprotocolandbeginsconnectingto[port]onhostname.

/RLOGIN

hostnamenone StartsSecureCRTand

opensthedefaultsessionwiththeRLoginprotocolandbeginsconnectingtohostname.SecureCRTalsoacceptsusername@hostnamesyntax.

[/Lusername] Specifiestheusernameto

usewiththeRLoginprotocol.

/TAPIphonenumber

none StartsSecureCRTandopensthedefaultsessionwiththeTAPIprotocolandbeginsconnectingtothespecifiedphonenumber.Note:Thiscommandmustbeformattedasinthefollowingexample:/TAPI"+1(555)555-5555"

[/REDIALattempts] SpecifiesthenumberofredialattemptsthatSecureCRTwillmakebeforegivingupontheconnection.

/SERIALport none StartsSecureCRTandopensthedefaultsessionwithport.Ifnoportvalueisentered,SecureCRTwillusethevalueofthePortoptionintheGlobalOptions/General/DefaultSessioncategory.Ifnosettingisenteredforthedefaultsession,SecureCRTwilluseCOM2astheportentry.Note:/SERIALanditsrelatedoptionsareonlyavailableifSerialcapabilityisselectedduringinstallation.

[/BAUDbaudrate] Setthebaudrate.Validvaluesforbaudrateare110,300,600,1200,2400,4800,9600,14400,19200,38400,

57600,115200,230400,380400,460800,and921600.Thedefaultvalueis38400.

[/CTS|/NOCTS] EnableorDisableRTS/CTS(request-to-send/clear-to-send)hardwareflowcontrol.Bydefault,RTS/CTSisenabled.

[/DATAdatabits] Setthedatabits.Validvaluesfornare5,6,7or8.Thedefaultvalueis8.

[/DSR|/NODSR] EnableorDisableDTR/DSR(data-terminal-ready/data-set-ready).Bydefault,DTR/DSRarenotenabled.

[/PARITYparity] Settheparity.ValidvaluesforparityareNONE,ODD,EVEN,MARK,SPACE.ThedefaultisNONE.

[/STOPstopbits] Setsthestopbits.Validvaluesforstopbitsare0,1or2(0indicates1stopbit,1indicates1.5stopbits,2indicates2stopbits).Thedefaultvalueis0(1stopbit).

[/XON|/NOXON] EnableorDisableXON/XOFFsoftwareflowcontrol.Bydefault,softwareflowcontrolisdisabled.

ExamplesofCommandLineUsage:

Example1:Thefollowingexampleopensaconnectiontothe"MyCompany"sessioninthespecifiedposition:

SecureCRT.exe/POS10050/S"MyCompany"Example2:

ThefollowingexamplecreatesanSSH2connectiontotheremotemachinenamedmySSH2server.myISP.com.Itusestheusernamemyusernametobeginthelogonprocess.ItalsospecifiestheciphertouseasTwofish,andtheMACtouseasMD5.Inaddition,portforwardingissetupwiththeremotemachineimap.myserver.com,instructingthelocalmachinetolistenforIMAPrequestsonport8143(localmachine):

SecureCRT.exe/SSH2/Lmyusername/Ctwofish/MMD5/LOCAL8143:imap.myimapserver.com:143Example3:

Thefollowingexampleconnectstomycompany.comusingtheSSH1protocolspecifyingtheusername"bob",thelocationofanidentitycontainingaprivateRSAkeyandtheBlowfishcipher:SecureCRT.exe/SSH1/Lbob/I"C:\SecureCRT\RSAIdentity.pri"

Example4:Thefollowingexampleconnectstomycompany.comusingtheSSH2protocol,username"bob",level4compression,andsetsupportforwardingofconnectionsfromport555onthelocalhost(thePCrunningSecureCRT)toport6666onmycompany.com:SecureCRT/SSH2/Lbob/Z4/LOCAL555:mycompany.com:6666mycompany.com

SFTPTabCommandOptions

SFTPTabcommandoptionsaredescribedbelow.Commandsthatspecifyapathcancontainthewildcardcharacters*and?.SFTPwillexpandthesewildcardcharacters.Multiplewildcardcharactersarepermittedinapath(e.g.,"*.*"or"*.?").TheSFTPTabalsosupportsfile"globbing".Thesequence[...]willmatchanyoneofthecharactersenclosed.Within[...],apairofcharactersseparatedbyaquotationmark(")matchesanycharacterlexicallybetweenthetwo.Thebackslashcanbeusedtoturnoffwildcardcharacters(e.g.,\*or\[).SecureCRTalsosupportstabcompletionofcommandargumentsontheSFTPTab.BegintypingacommandandargumentandthenpresstheTABkey.SecureCRTwillattempttocompletetheargument(s)basedontheavailablechoices.Iftherearemultiplechoices,SecureCRTwilldisplayalistofpossibleoptions.YoucanchoosefromthislistorcontinuetypinguntilSecureCRTcanidentifytheuniqueargument.ToopenanSFTPtabsession,right-clickonanexisting,connectedSSH2tabandchooseConnectSFTPSessionfromthedisplayedmenu.

Option Arguments Description

ascii SetsthefiletransfermodetoASCII.

binary Setsthefiletransfermodetobinary.

cd [path] ChangestheremotedirectorytothatspecifiedbySthepath.Ifapathisnotspecified,theuserisplacedintheir"home"directory.

chgrp grouppath Changesgroupoffile"path"to"group".

chmod modepath Changespermissionsoffile"path"to"mode".

chown ownerpath Changesowneroffile"path"to

"owner".

detail remotepath Displayssysteminformationaboutthespecifiedremotefileorfolder.

exit ExitstheSFTPapplication.

get [-r][-a|-b]

remotepath

Retrievestheremotepathandstoresitinthecurrentlocaldirectory.The-rargumentspecifiesarecursiveget.The-aargumentspecifiesthatthefilesaretransferredasASCII;-bspecifiesbinary.Ifneither-anor-bisspecified,thecurrenttransfermodewillbeused(seetypecommand).

help Displaysusage.

include filenameor<filename

Includesthecommandsinthespecifiedfileasthoughtheyhadbeentypedin.

lcd [path] Changesthelocaldirectorytothatspecifiedbythepath.Ifapathisnotspecified,thelocalworkingdirectoryissettothelocaluser's"home"directory.Addingthe-aargumentwillshowallfilesandfolders(includingthosehidden),andthe-dargumentwillshowonlydirectories.

ldetail localpath Displayssysteminformationaboutthespecifiedlocalfileorfolder.

ln existingpath Createssymboliclinkonremote

linkpath[-

s]

file.

lls [-l][-a|-d]

[path]

Displaysthelocaldirectorylistingofthepathspecifiedorofthecurrentlocalworkingdirectoryifthepathisnotspecified.Addingthe-aargumentwillshowallfilesandfolders(includingthosehidden),andthe-dargumentwillshowonlydirectories.

lmkdir path Createslocaldirectoryspecifiedbythepath.

lmv oldpath

newpath

Moves/renameslocalfile.IdenticaltothelocalRename(lrename)command.

lpwd Printslocalworkingdirectory.

lrename oldname

newname

Renamesthespecifiedfile.IdenticaltothelocalMove(lmv)command.

lrm path Deleteslocalfile.

lrmdir path Removeslocaldirectory.

ls [-l][-a|-d]

[path]

Displaystheremotedirectorylistingofeitherthepathorofthecurrentdirectoryifthepathisnotspecified.Ifthe-lflagisset,SFTPdisplayspermissionandownershipinformation.Addingthe-aargumentwillshowallfilesandfolders(includingthosehidden),andthe-dargumentwillshowonlydirectories.Note:Thiscommand,ifusedwitha/(i.e.,ls/),liststhe

rootswhenconnectingtoaserverthatallowsmultipleroots,suchasVanDykeSoftware'sVShell®.

mkdir path Createsremotedirectoryspecifiedbythepath.

mv oldpath

newpath

Moves/renamesremotefile.IdenticaltotheRenamecommand.

pwd Printstheremoteworkingdirectory.

put [-r][-a|-b]

localpath

Uploadsthelocalpathtothecurrentlyopendirectoryontheremotemachine.The-aargumentspecifiesthatthefilesaretransferredasASCII;-bspecifiesbinary.Ifneither-anor-bisspecified,thecurrenttransfermodewillbeused(seetypecomment).

rename oldname

newname

Renamesthespecifiedfile.IdenticaltotheMove(mv)command.

rm [-r]path Deletestheremotefilespecifiedbythepath.Addingthe-rargumentwillinitiatearecursiveremoveoperation.

rmdir path Deletestheremotedirectoryspecifiedbythepath.

su username Substitutesthecurrentuserwiththeonespecified.Note:Thiscommandcanonlybecallediftheremotemachine

isrunningVShellforWindows3.5orlater.

type [transfer

mode]

Displaysorsetsthefiletransfermode.Issuingthiscommandwithnoparameterwilldisplaythecurrentmode;issuingitwithamodeparameter(eitherasciiorbinary)willsetthemodetothatparameter.

view filename Displaysor,ifapplicable,runsthespecifiedfileorfiles.Displayedfilescanbemodifiedbutchangesmadewillnotbeuploadedtotheoriginalfile.

OverviewofXmodem

Xmodemisasimplefiletransferprotocolthatsupportsbasicerrordetectionmethodstoensurethatinformationisnotlostorcorruptedduringatransfer.Generally,Xmodemusesachecksumtoprovideerrordetection,however,theSecureCRTimplementationofXmodemalsosupportstheCRCoptionforerrordetection.TheSecureCRTXmodemimplementationsupportsboth128-byteandXmodem-1K(1024-byte)packetsizes.Xmodemdoesnotsupportmultiple-file(“batch”)transfers.However,SecureCRTdoessupportZmodemwhichiscapableofmultiple-filetransfers.Topicsforthissectioninclude:

ChangingtheDefaultFileTransferDirectories

DownloadingaFilewithXmodem

UploadingaFilewithXmodem

ChangingtheDefaultFileTransferDirectories

Filesdownloadedfromaremotehostwillbesavedtothedefaultdownloaddirectoryunlessotherwisespecified.Whenselectingfilestobeuploadedtoaremotemachine,SecureCRTinitiallydisplaysthecontentsofthedefaultuploaddirectory.Tochangethedefaultdownloadanduploaddirectories:1.IntheSessionOptionsdialog,selecttheTerminal/X/Y/Zmodemcategory.2.IntheDirectoriesgroup,enterthefullpathofthenewdefaultupload

ordownloaddirectoryorusetheBrowsebutton toopentheBrowseforFolderdialogandselectthenewdirectory.

DownloadingaFilewithXmodem

Todownloadafilefromaremotemachine,completethefollowingsteps:1.Ontheremotemachine,issuetheappropriateXmodemcommandto

instructtheXmodemsoftwaretosendthefilethatyouwanttodownload.Theremotemachinesoftwareshouldthenpromptyoutoinitiatethetransfer.

2.ToinitiatetheXmodemdownload,opentheSecureCRTTransfermenuandselectReceiveXmodem.

3.IntheSpecifyFilenametoReceiveusingXmodemdialog,provideafilenamefortheincomingfile.Thefilewillbesavedtothedefaultdownloaddirectoryunlessotherwisespecified.

4.ClicktheReceivebuttontostartthedownload.TheXmodemTransferdialogwillappear,displayingthestatusofthedownload.

SpecifyFilenametoReceiveusingXmodemDialog

UploadingaFilewithXmodem

Touploadafiletoaremotemachine,completethefollowingsteps:1.Ontheremotemachine,issuetheappropriateXmodemcommandto

instructtheXmodemsoftwaretoreceivethefilethatyouwanttoupload.Theremotemachinesoftwareshouldthenpromptyoutoinitiatethetransfer.

2.ToinitiatetheXmodemupload,opentheSecureCRTTransfermenuandselectSendXmodem.

3.IntheSelectFiletoSendusingXmodemdialog,selectthefilethatyouwanttouploadtotheremotehost.Bydefault,thedialogopenstothedefaultuploadfolder.

4.ClicktheSendbuttontostarttheupload.TheXmodemTransferdialogwillappear,displayingthestatusoftheupload.

SelectFiletoSendusingXmodemDialog

OverviewofZmodem

Zmodemisafull-duplexfiletransferprotocolthatsupportsfastdatatransferratesandeffectiveerrordetection.Zmodemisveryuserfriendly,allowingeitherthesendingorreceivingpartytoinitiateafiletransfer.Zmodemsupportsmultiplefile("batch")transfers,andallowstheuseofwildcardswhenspecifyingfilenames.ZmodemalsosupportsresumingmostpriorZmodemfiletransferattempts.TheZmodemprotocolfeaturescanbedisabledtopreventundesiredautomaticuploadstothelocalmachinefromanunknownsource.Topicsforthissectioninclude:

ChangingtheDefaultFileTransferDirectories

DownloadingaFilewithZmodem

UploadingaFilewithZmodem

DisablingZmodem

Initsdefaultconfiguration,SecureCRTinitiatesZmodemfiletransfersbysendingan"rz"commandtotheremoteserver.Ifyouaretryingtoconnecttoaserverthatexpectsadifferentcommand(e.g.,"lrz"inFreeBSD),youcanchangethiscommandbyeditingthesession's.inifile.Inthe.inifile,locatethefollowingentry:S:"ZmodemReceiveCommand"=rz\r

Youcansetthereceivecommandtowhatevertheremotesystemexpectsandaddcommand-lineargumentsifyouwant.

DownloadingaFilewithZmodem

Todownloadafilefromaremotemachine,completethefollowingsteps:1.Ontheremotemachine,issuetheappropriateZmodemcommandto

instructtheZmodemsoftwaretosendthefilethatyouwanttodownload.

2.AZmodemTransferdialogwillappear,displayingthestatusofthedownload.Thefilewillbesavedtothedefaultdownloaddirectory.

UploadingaFilewithZmodem

Touploadafiletoaremotemachine,completethefollowingsteps:1.Ontheremotemachine,issuetheappropriateZmodemcommandto

instructtheZmodemsoftwaretoreceivethefilethatyouwanttoupload.ThiswillcauseSecureCRTtoopentheSelectFilestoSendusingZmodemdialog(shownbelow).NotethatZmodemmustbeinstalledontheremotemachinetotransferfileswithZmodem.Note:AnotherwaytoopenthisdialogistoopentheTransfermenuandselectZmodemUploadList.

2.IntheSelectFilestoSendusingZmodemdialog,selectthefile(s)thatyouwanttouploadtotheremotemachineandclickontheAddbuttontoaddthefile(s)totheFilestosendlist.Youcanalsochoosetosendyourfile(s)inASCIIinsteadofbinarybycheckingtheUploadfilesasASCIIcheckbox.

3.Whenyouhavefinishedaddingallthefilesthatyouwanttoupload,clickontheOKbutton.

SelectFilestoSendusingZmodemDialog

DisablingZmodem

TodisabletheZmodemprotocolfeaturesinSecureCRT:1.IntheSessionOptionsdialog,opentheFileTransfer/X/Y/Zmodemcategory.2.SelecttheDisableZmodemoption.WhentheZmodemprotocolisdisabled,SecureCRTwillignorethecharactersequencethatstartsaZmodemtransfer.

AdministrativeTemplate

VanDykeSoftwarehascreatedanadministrativetemplatefilethatadministratorscanusetoconfigureadministrativeoptions(e.g.,FIPSMode)eitheronaper-machinebasisoraper-userbasis.Tousethisfile,youmustrequestitfromVanDykeSoftwareandthenconfigureyoursystemtorecognizeit.

RequestinganAdministratorTemplateFileTorequestaSecureCRTadministratortemplatefile,openyourbrowsertotheappropriatewebsiteshownbelowandfollowtheinstructionsthere.

ForWindowsVista/7andnewer:https://secure.vandyke.com/cgi-bin/adm_request.php?pid=SecureCRT&format=admx

ForWindowsXP/2003:https://secure.vandyke.com/cgi-bin/adm_request.php?pid=SecureCRT&format=adm

InstructionsforusingADMfile(WindowsXP/2003)1.Asanadministrator,startMMC.2.FromtheFilemenu,selectAdd/RemoveSnap-in.3.IntheAdd/RemoveSnap-indialog,clickontheAddbutton.4.Addthestand-alonesnap-inGroupPolicy.5.FortheGroupPolicyObject,chooseLocalComputer(thedefault).

Thiscanalsobedonefordomains.ClickonFinish,andcloseallthedialogsbyclickingeitherCloseorOK.

6.FromtheConsoleRoot,expandLocalComputerPolicyandthenexpandUserConfiguration.

7.Right-clickonAdministrativeTemplatesandselectAdd/RemoveTemplates.

8.ClickontheAddbutton.9.InthePolicyTemplatesdialog,browsetothelocationwhereyou

storedthefileVanDykePolicy.admandselectthatfile.ClosetheAdd/RemoveTemplatesdialog.

10.Thiswillhaveaddedafoldercalled"VanDykeSoftwareSettings"to

theAdministrativeTemplatesfolderundertheLocalComputerPolicy/UserConfigurationsnap-in.Fromhere,youcanconfigurealltheVanDykeadministratoroptions.

InstructionsforusingADMXandADMLfiles(WindowsVista/7andnewer)1.Asanadministrator,savetheADMXfileinthecorrectlocation.In

mostcases,thislocationis:C:\Windows\PolicyDefinitions\

2.Asanadministrator,savetheADMLfileinthecorrectlocation.InmostcasesforthoseintheUS,thislocationis:C:\Windows\PolicyDefinitions\en-US

Additionalinformationcanbefoundat:http://msdn.microsoft.com/en-

us/library/bb530196.aspx

3.Asanadministrator,runthefollowingsnap-in:gpedit.msc

4.WhentheGroupPolicywindowappears,afoldernamed"VanDykeSoftwareSettings"canbefoundintheAdministrativeTemplatesfolderunderUserConfiguration.Fromhere,youcanconfigurealltheVanDykeadministratoroptions.

FIPSMode

Federal,state,andlocalgovernmentagencies,criticalinfrastructureproviderslikepublicutilities,andprivatesectororganizationsthatdobusinessoverthepublicnetworkwiththeseagenciesmustuseencryptionthatmeetstheFIPS140-2standard.IfyouneedtoprotectdataintransitasoutlinedbyFIPS140-2orNIST800-53,SecureCRThasanadministratoroptiontorunin"FIPSMode".Whenthisoptionisset,SecureCRTwilluseaFIPS140-2validatedcryptographiclibraryandonlyallowFIPS-approvedalgorithms.VanDykeSoftwarehaspartneredwithRSASecurity,Inc.tousetheBSAFECrypto-CMicroEditioncryptographymodulewhichhasbeentestedbyAtlanLaboratories,anaccreditedtestinglaboratoryforFIPScompliance.ThismodulehasmetallLevel1requirementsforFIPS140-2compliancewhenoperatedinFIPSmode.ThefollowingFIPS-approvedCryptographicalgorithmsareused:DSA(Cert.#143);Triple-DES(Cert.#378);AES(Cert,#303);RSA(Cert.#96);SHA-1;Diffie-Hellman(usedforkeyexchangeinSSH2isallowedinFIPSmodebutnotapproved).ThefollowingalgorithmsarenotavailableinFIPSmode:MD5;Twofish;Blowfish;RC4.

EnablingFIPSModeTorunSecureCRTinFIPSmode,youmustfirstconfiguretheMicrosoftManagementConsole(MMC)torecognizetheVanDykeSoftwareadministrativetemplate(.adm)file;oncethisisdone,youcanenableFIPSmodebycompletingthefollowsteps:1.InMMC,navigatetoVanDykeSoftwareSettingsandselectthe

EnableFIPSModesetting.2.OpenthePropertiesdialogbyselectingPropertiesfromtheAction

menu.3.OntheSettingtab,selectEnabled.PresstheOKbuttontosavethe

change.FIPSmodewillbeenabledthenexttimeSecureCRTisstarted.

SessionsOverview

SecureCRTsupportsconnectionswithavarietyofprotocols:SSH1,SSH2,Telnet,Telnet/SSL,RLogin,andSerial.Inaddition,SecureCRTsupportsmodemdialingwiththeTAPIconnectionprotocol.ThissectionoftheSecureCRThelpmanualcontainsinformationonhowtosetupasessiontoconnectwitharemotemachineusingtheseprotocols.SecureCRTallowsyoutopersonalizeyoursettingsandoptionsandautomaticallyusethemeverytimeyouestablishaconnectiontoaremotecomputerThisisaccomplishedbycreatingasessionthatwillstoreyourpersonalizedsettingsunderasessionname.

Note:Asessionisasetofoptionsandcustomizedsettingsthatareassignedtoaconnectiontoaremotemachine.Thesesettingsandoptionsaresavedunderasessionnameandallowyoutohavedifferentpreferencesfordifferenthosts.

SecureCRTprovidestwodifferentmethodsforcreatingasession:·TheQuickConnectdialog·TheConnectdialog

YoumayfinditusefultoreadanOverviewofConnectionProtocolsbeforecreatingoreditingasession.Ifyouhavealreadycreatedasession,youmaywanttolearnaboutChangingSessionOptions.

CreatingaNewSessionwithConnect

IncontrasttotheQuickConnectdialog(seeCreatingaNewSessionwithQuickConnect),theNewSessionbutton onthetoolbaroftheConnectdialogallowsyoutonamethesessionsomethingotherthanthehostnameorIPaddressofthecomputertowhichyouareconnecting.

Note:"Default"isnotavalidnameforasessionthatisattherootlevelintheConnectdialog.

WhenyouusetheNewSessionbutton,theSessionOptionsdialogappears(shownbelow),allowingyoutocustomizeallofthesettingsassociatedwiththenewsession.EntertheNameandProtocolofyournewsessionandtheConnectionsubcategorieswillchangebasedonyourchosenprotocol.Tocompleteyoursetup,clickonthesubcategoryfortheProtocolyouchoseandentertherequiredinformation.YourProtocolsettingoptionsareSSH1,SSH2,Telnet,Telnet/SSL,RLogin,Serial,andTAPI.

SessionOptions:CreatingaNewSession

Whenyouhavefinishedsettingupthenewsession,youwillseethenewsessionlistedintheConnectdialog.Onceyouhavecreatedasession,youmaywanttocustomizeitsbehavior.Formoreinformation,seethetopicsinthe"CustomizingSessionBehavior"section.

OverviewofConnectionProtocols

SecureCRTsupportsthefollowingprotocols:SSH1,SSH2,Telnet/SSL,Telnet,RLogin,Serial(COM),TAPI,andRaw.IfyouareusingSecureCRTtoconnecttoaBBSoranyothertypeofterminalserverbydirectlydialingtheremotemachineusingyourcomputer'smodem,youwillneedtouseeithertheSerialorTAPIprotocol.IfyouareusingSecureCRTtoconnecttoaremotemachineviatheInternetoryourLAN,youshouldusetheSSH1,SSH2,Telnet,Telnet/SSL,orRLoginprotocoldependingontheservicesprovidedbytheremotemachinetowhichyouareconnecting.IfyouareusingSecureCRTtoestablishasecureconnectionusingencryption,youwillneedtouseeithertheSSH1orSSH2protocol.WhentheRawprotocolisused,littleornointerpretationoftheremotedatatakesplace,whichcanbehelpfulfortroubleshooting.ThisfollowingtopicsprovideanexplanationofthesettingsrelatedtoeachoftheprotocolssupportedinSecureCRT:

TelnetConnectionSettings

RLoginConnectionSettings

SerialConnectionSettings

TAPIDialerSettings

SSH1ConnectionSettings

SSH2ConnectionSettings

Telnet/SSLSettings

FTPConnectionSettings

RawConnectionSettings

Note:Onlytheprotocolsselectedduringtheinstallationprocesswillbeavailable.

ChangingSessionOptions

ChangingsessionoptionsisdonewiththeSessionOptionsdialog.TheSessionOptionsdialogisaccessedinavarietyofways.

Ifyouarenotcurrentlyconnectedwithasessiontoaremotemachine:

1.OpentheConnectdialogbyclickingontheConnectbutton ,orbyopeningtheFilemenuandselectingtheConnectmenuitem.

2.SelectthesessionlistedintheConnectdialogthatyouwouldliketoedit.

3.OpentheSessionOptionsdialogbyeitherclickingonthePropertiesbutton ,orbyright-clickingonthetargetsessionandselectingPropertiesfromthepop-upmenu.YoucanalsoopentheSessionOptionsdialogbyselectingthetargetsessionandusingtheALT+ENTERhot-keysequence.

Ifyouareconnectedwithasessiontoaremotemachineandwouldliketoeditthecurrentopensession:

·OpentheSessionOptionsdialogbyeitherclickingonthePropertiesbutton ,orbyopeningtheOptionsmenuandselectingtheSessionOptions...menuitem.

TheSessionOptionsdialog(SessionOptionsDialogbelow)isdividedintotwomajorsections:anoptionscategorytreeview,andanoptionscategorypanel.Theoptionscategorytreeviewallowsyoutoselectthecategoryofoptionsyouwishtochange.Theoptionscategorypaneldisplaysalltheoptionsassociatedwiththecategoryselectedintheoptionscategorytreeview.Forexample,inthefigurebelow,theConnectioncategoryisselected,andalloftheoptionsassociatedwiththeConnectioncategoryaredisplayedintheoptionscategorypanel.

SessionOptionsDialog

SecurityConsiderations

Sessionsecuritydependsonseveralfactors,includingwhethertheconnectionyouareusingtothehostisatrustedconnection.Ifitisnot,considerwhetherprivateorconfidentialinformationwillbesentandreceived.ATelnetsessionwilltransmituserID,password,andothersensitiveorprivateinformationinaneasilyreadableformat.Formaximumsecurity,DONOTputpasswordsinscriptfilesorrunthemasmappedkeysorasbuttonfunctions.ThisinformationisstoredintheSecureCRTconfigurationfileandmaybeaccessibletootherusersthathaveaccesstothecomputeronwhichSecureCRTisinstalled.MaximumsecurityandprivacyontheInternetandlocalnetworksrequirestheuseoftheSecureShellProtocols(SSH1orSSH2)ortheSecureSocketsLayer(SSL)supportedinSecureCRT.NotethatalthoughSecureCRTdoessupporttheTelnetprotocol,SecureCRTTelnetsessionsthatarenotTelnet/SSLarenotencrypted.EncryptedconnectionsareachievedthroughtheSSH1,SSH2,andTelnet/SSLprotocols.

PortForwardingwithSSH

OverviewofPortForwardingPortforwardingisapowerfultoolthatallowsyoutosecureTCP/IPtrafficusingSecureCRT'sSSH1andSSH2protocolsupport.ThismeansthatyoucanencryptapplicationdatausingprotocolssuchasIMAP,POP3,andSMTP.Forexample,ifyoureceiveyouremailfromanInternetServiceProvider(ISP),youcouldencryptthecommunicationbetweenyourworkstationrunningtheemailclientandtheISP'sSSHserver.SecureCRTalsosupportsX11forwarding,whichallowsXWindowstrafficbetweentheXserverandXclienttobeencrypted.Ingeneral,withanyportforwardedbySecureCRTforanapplication,theapplicationneedstobereconfiguredtousethelocalhostorloopbackaddress127.0.0.1asitsapplicationserveraddress.

SettingupPortForwardingTosetupportforwarding,followthesesteps:1.ClickonFile/ConnectandselecttheSSHsessionforwhichyouwould

liketouseforwardedports.2.ClickonthePropertiesbutton orright-clickonthesessionand

selectPropertiesfromthepop-upmenutobringuptheSessionOptionsdialog.

3.UndertheConnectioncategory,clickonthePortForwardingsubcategory.

4.Toaddanewlocallyforwardedport,clickontheAddbuttonandfillinthelocalport,remotehostnameandremoteport.ClickontheOKbuttontosaveyoursettings.

5.ToaddanewremotelyforwardedportforanSSH2connection,clickontheRemote/X11subcategoryandthenclickontheAddbutton.Fillinthelocalport,remotehostnameandremoteport,thenclickOK.

Note:Asyouenterthelocalport,theremoteportisautomaticallyfilledinfromtheexistingsessioninformation.Portsmaybedefinedeitherbytheirportnumberorbytheirservicename.

6.Connectwiththissessiontostartportforwarding,thenruntheclient

application.Portforwardingworksbyforwardingdatafromalocalporttotheremotehost/port.Forexample,tosecurePOP3trafficthroughyourmailclient,setupportforwardingwiththefollowingsettings:

·localport=110·remotehostname:settothemailserver'shostname·remoteport=110.

Configureyourmailclienttouse127.0.0.1(otherwiseknownas"localhost")asthePOP3server'sIPaddress.HostnameandportconfigurationneedstobedoneinbothSecureCRTandtheclientapplication(e.g.,email).Afterconnectingwiththissession,POP3trafficisencryptedtotheSSHserveraslongasSecureCRTisrunning.IftheconnectiontotheSSHserverisbrokenorclosed,theforwardedportswillnolongerbeforwarded,andtheclientapplicationsmayreceiveanerrorwhentheytrytoconnecttothelocalport.

ForwardingX11PacketsX11Forwardingisconfiguredaspartoftheportforwardingsetup.ToenableX11packetforwarding,followthestepsoutlinedinthe"SettingupPortForwarding"section(above)withtheaddedstepofselectingtheForwardX11packetsoptionontheRemote/X11category.

Note:SecureCRTisnotanXServer.TheForwardX11packetsoptionallowsSecureCRTtoacceptX11datafromtheremotemachineandforwardsittotheXserverrunningonthelocalmachine.ThelocalXServermustberunningbeforeanyX11sessionscanbedisplayed.IfyouareusingXhostauthorityaccessonthelocalX11server,youwillneedtoaddthelocalhostorloopbackaddress127.0.0.1toyourserver'sXhostlist.

SecurityConsiderationswithPortForwardingItisimportanttounderstandthattheclientdataisonlyencryptedbetweenthemachinethatSecureCRTisrunningonandtheSSHserverthatSecureCRTisconnectedto.AnydatamovingfromtheSSHserveracrossthenetworktoanotherserverisnotencrypted.Twoconfigurationsarepresentedbelowtoillustratedifferentmachine/networkconfigurationsandtheiraffectonsecurity.Your

evaluationoftheconnectionbetweenServersAandBisthecriticalfactorindecidingwhethertheaggregatesecuritymeetsyourneeds.

Configuration1(Lesssecure)SecureCRTforwardsPOP3mailtoaremotemailserverthatisadifferentmachinethantheSSHserver.

·BetweentheLocalMachineandServerAthedataisencrypted.·BetweenServerAandServerBthedataisnotencrypted.·SincetheSSHserverandmailserverareondifferentmachines

yourdatacanbeviewedonthisconnection.InConfiguration1,theconnectionbetweenServersAandBcouldbeoneofthefollowing:

·OntheInternet-anunsecurenetwork.·OnaninternalLAN-anetworkthatmayormaynotdelivera

satisfactorylevelofsecurity.

Configuration2(Moresecure)SecureCRTforwardsPOP3mailtoaremotemailserverthatisrunningonthesamemachineastheSSHserver.

·BetweentheLocalMachineandServerAthedataisencrypted.·SincethereisnonetworktrafficbetweentheSSHserverand

Mailserver,securityisincreasedoverConfiguration1.

ConfiguringPort-ForwardingFilters

SecureCRTport-forwardingfiltersletyouallowordenyconnectionsfromspecificIPaddressorrangeofsubnets.Thefilterconfigurationisstoredinthesessioninitializationfile(<sessionname>.ini)intheSecureCRTConfig/Sessionsfolder.Port-forwardingfiltersaredefinedinalistandappliedfromthefirsttolast.Whenanapplicationmakesaport-forwardconnectionviaSecureCRT,theIPaddressoftheapplication'smachineischeckedagainstthefilterlist.SecureCRTcomparestheaddresswiththefirstfilterentryandthengoesthroughthelisttothelastfilterentry.Whenanaddressmeetsthecriteriaofafilterentry,thatfilterisappliedandtherestofthelistisignored.Anemptylistwilldenyallport-forwardingconnections.Thefiltersyntaxisasfollows:"PortForwardFilter"=[access,host][access,host]

[...]

Intheabovesyntax,theargumentvaluesareasfollows:access-allowordenyhost-IPaddressorarangeofsubnets

Thedefaultsettingsfortheport-forwardfilterisasfollows:S:"PortForwardFilter"=allow,127.0.0.1,0

deny,0.0.0.0/0.0.0.0,0

Thissettingallowsconnectionsfromlocalhost,butdeniesconnectionsfromanyothermachine.

ReversePortForwardingSecureCRTalsosupportsreverseportforwarding.Thefiltersyntaxisasfollows:"ReverseForwardFilter"=[access,host][access,host]

[...]

Intheabovesyntax,theargumentvaluesareasfollows:access-allowordeny

host-IPaddressorarangeofsubnetsThedefaultsettingsfortheport-forwardfilterisasfollows:S:"ReverseForwardFilter"=allow,127.0.0.1,0

deny,0.0.0.0/0.0.0.0,0

Thissettingallowsconnectionsfromlocalhost,butdeniesconnectionsfromanyothermachine.

ExampleFiltersThefollowingisanexampleofaport-forwardfilterlistthatallowsconnectionsfromthespecifiedmachines(Alice'scablemodemat129.24.32.16andBob'sDSLsubnetat198.129.241.85/255.255.255.128,0)butdeniesaccessfromothermachines:S:"PortForwardFilter"=allow,129.24.32.16,0

allow,198.129.241.85/255.255.255.128,0

deny,0.0.0.0/0.0.0.0,0

Thisexamplelistwillallowallconnections:S:"PortForwardFilter"=allow,0.0.0.0/0.0.0.0,0

Or,forIPv6:S:"PortForwardFilter"=allow,::/0,0

AndthisexamplelistwillalloweverythinginalocalreservedclassCnetworkandanylocalhostloopbackadapter(e.g.,127.0.0.2,127.0.0.3,etc.),anddenyeverythingelse:S:"PortForward

Filter"=allow,192.168.0.0/255.255.255.0,0

allow,127.0.0.0/255.255.255.0,0

deny,0.0.0.0/0.0.0.0,0

Anexampleofamorecommonfilterwouldbethefollowing,whichallowslocalhoston127.0.0.1,0,allowsanyhostonlocal192.168.0.0network,anddenieseverythingelse:S:"PortForwardFilter"=allow,127.0.0.1,0

allow,192.168.0.0/255.255.255.0,0

deny,0.0.0.0/0.0.0.0,0

Thefollowingisanexampleofaport-forwardfilterlistthatallowsspecific

IPv6connections:S:"PortForward

Filter"=allow,::ffff:198.129.241.85/128,0

Forreverseportforwarding,thesyntaxissimilar.Forexample,thisexamplelistwillalloweverythinginalocalreservedclassCnetworkandanylocalhostloopbackadapter(e.g.,127.0.0.2,127.0.0.3,etc.),anddenyeverythingelse:S:"ReverseForward

Filter"=allow,192.168.0.0/255.255.255.0,0

allow,127.0.0.0/255.255.255.0,0

deny,0.0.0.0/0.0.0.0,0

Public-KeyAuthenticationforSSH1

OverviewofRSAAuthenticationRSAauthenticationusesapublic-privatekeypairtoauthenticateandlogontoanSSH1server.Itoffersahigherlevelofauthenticationsecuritythanpasswordauthenticationbyrequiringboththeprivatekeyandthepassphrasethatprotectstheprivatekeyinordertocompleteauthentication.SettingupRSApublic-keyauthenticationforaSecureCRTSSH1sessionisamulti-stepprocess.IdentityfilesarefirstcreatedwiththeSecureCRTKeyGenerationwizard.Theidentityfileisdefinedforglobalorsession-specificuseintheSSH1categoryoftheGlobalOptionsdialogorintheConnection/SSH1categoryoftheSessionOptionsdialog.Thenthepublickeyisaddedtotheauthorized_keysfile,whichislocatedontheSSH1server.

CreatingIdentityFilesTocreateanRSAidentityfile:1.IntheConnectdialog,selecttheSSH1sessionwithwhichyouwould

liketousetheidentityfiles.2.OpentheSessionOptionsdialogandclickontheConnection/SSH1category.3.IntheAuthenticationfield,chooseRSAastheauthenticationtype

andclickontheProperties...button.3.InthePublicKeyPropertiesdialog,selectwhetheryouwantthenew

identityfiletobeglobalorsessionspecificandclickontheCreateIdentityFilebutton.

4.FollowtheinstructionsintheKeyGenerationwizardtocreateyouridentityfiles.Onceyourpublic-privatekeypairhasbeengeneratedbytheKeyGenerationwizard,youwillbepromptedforthepathandfilenameinwhichyourprivatekeywillbestored.Besuretospecifyasecurelocationforthisfilesuchthatyouaretheonlyindividualwithaccesstoit.Thepublickeywillbeplacedinafilewiththesamebasenameastheprivatekeyfile,butwithanextensionof.pub.

UsingYourIdentityFilesOnceyouhavecreatedyouridentityfiles,thereareseveralstepsthatwill

needtobecompletedsothatyoucanmakeuseofthemwithSecureCRT.Thenecessarystepsare1)Transferthepublic-keyfile(e.g.,Identity.pub)totheremotemachine;2)Putthecontentsofthepublic-keyfileinyourauthorized_keysfileontheremotemachine;and3)ConfigureSecureCRTtousetheidentityfilewithRSAauthentication.

1.TransfertheidentityfiletotheSSHserverInordertouseyourpublickeyyoumusttransferthepublic-keyfile(withtheextension.pub)createdbytheKeyGenerationwizardtothe~/.ssh/directoryontheSSHserver.OneoftheeasiestwaystotransferthisfiletotheSSHserveristousetheZmodemfiletransferfeatureprovidedbySecureCRT.IftheremotemachinedoesnothaveZmodeminstalled,youwillneedtouseanFTPclienttotransfertheidentityfiletotheremotemachine.Anotherwaytotransfertheidentityfiletotheremotemachineistocopyandpastethecontentsoftheidentityfile.Toaccomplishthis,useNotepad.exetoopentheidentityfileandcopythecontentsoftheidentityfiletotheclipboard.Ontheremotemachine,createafileusingyourfavoriteeditorandpastethecontentsoftheclipboardusingthepastebutton.

2.Updatetheauthorized_keysfileontheremotemachineOnceyouhavetransferredtheIdentity.pubfiletotheremotemachine,youmustupdatetheauthorized_keysfileontheremotemachine.Thefollowingstepsoutlinethisupdateprocess.1.ConnecttotheremoteSSHserverusingSSH1andpassword

authentication.2.Appendthecontentsofthepublic-keyfilecreatedwiththeKey

Generationwizardtothefile~/.ssh/authorized_keysontheremotehost.Thedefaultnameofthepublic-keyfileisIdentity.pub.Createthe~/.ssh/authorized_keysfileifitdoesnotalreadyexist.Ifyouwantmultipleauthorizedkeys,appendthecontentsofthepublic-keyfiletotheauthorized_keysfile.Thesimplestwaytodothisistypically:

%catidentity.pub>>~/.ssh/authorized_keys(notethatthenameoftheidentityfilecanbedifferentthanthe

example)Noteonplacingpublickeys:Theformatoftheauthorized_keysfilerequiresthateachentryconsistofasinglelongline.IfyouuseCopyandPastetoaddapublickeytothe~/.ssh/authorized_keysfile,makesurethattheentrycontainsnoadditionalnew-linecharacters.

3.ConfigureSecureCRTtouseyouridentityfilesTheidentityfilecreatedbytheKeyGenerationwizardcontainsbothyournewpublickeyandyournewprivatekey.ToconfigureSecureCRTtousetheidentityfile:1.IntheConnectdialog,selecttheSSHsessionwithwhichyou

wouldliketousetheidentityfile.2.OpentheSessionOptionsdialogandintheConnection/SSH1

category,changetheAuthenticationsettingfromPasswordtoRSA.

3.Ifyouhavemorethanoneidentityfile,youmayneedtoclickontheProperties...buttonandverifythatthesessionisusingthesession-specifickeyyouhavecreated.

4.ClickontheOKbuttontosavethechanges.Ifyousuppliedapassphrasewhenyoucreatedyourkey,youwillbepromptedtoenteritduringtheconnectionprocess.

Public-KeyAuthenticationforSSH2

OverviewofPublic-KeyAuthenticationPublic-keyauthenticationusesapublic-privatekeypairtologontoanSSH2server.Settinguppublic-keyauthenticationforanSSH2SecureCRTsessionisamulti-stepprocess.IdentityfilesmustbecreatedusingtheKeyGenerationwizard.OneoftheidentityfilescreatedbytheKeyGenerationwizardwillcontainaprivatekeythatwillbeassignedeitheronagloballevelforallSSH2sessionsoronasession-specificlevel.Theglobalorsession-specificcharacteristicoftheprivatekeyisspecifiedintheSSH2category.TheotheridentityfilecreatedbytheKeyGenerationwizardwillcontainthecorrespondingpublickeyandwillneedtobetransferredtotheproperlocationontheSSH2server.

Note:PublickeysgeneratedusingVanDykeSoftwareproductscomplywiththeestablishedIETFdraftspecificationdefiningtheformatofSecureShellpublickeyfiles.ThisdoesnotguaranteethatSecureCRTwillworkwithpublickeyfilesgeneratedusingotherSecureShellsoftwareimplementationswhichmayormaynotcomplywiththisspecification.SincethereisnoIETFspecificationdefiningtheformatofSecureShellprivatekeyfiles,SecureCRTmaynotbeabletouseprivatekeyfilesgeneratedwithotherimplementations.Itshouldalsobenotedthat,sincetheprivatekeygeneratedbySecureCRTusesadifferentformatfromOpenSSH'sprivatekey,OpenSSHcannotuseaVanDykeSoftwaregeneratedprivatekey.SecureCRTsupportsSSH2public-privatekeyfilesgeneratedwithVanDykeSoftwareproductsandthepublic-privatekeyfilesgeneratedwiththeOpenSSHssh-keygenutility.

CreatingGlobalIdentityFiles1.OpentheGlobalOptionsdialogandclickontheSSH2category2.ClickontheCreateIdentityFilebutton.3.FollowtheinstructionsintheKeyGenerationwizardtocreateyour

identityfiles.TheKeyGenerationwizardwillaskforapassphrase,butthepassphraseisnotrequired.Ifthepublickeyisgoingtobeusedas

partofanautomatedprocess,youmaynotwanttouseapassphrase.4.Onceyourpublic-privatekeypairhasbeengeneratedbytheKey

Generationwizard,youwillbepromptedforthepathandfilenameinwhichyouridentityfileswillbestored.Besuretospecifyasecurelocationforthesefilessuchthatyouaretheonlyindividualwithaccesstothem.Thepublickeywillbeplacedinafilewiththesamenameastheprivatekeyfile,butwithanextensionof.pub.

Note:SecureCRTsupportsbothDSAandRSAkeytypes.

CreatingSession-SpecificIdentityFiles1.IntheConnectdialog,selecttheSSH2sessionwithwhichyouwould

liketousetheidentityfiles.2.OpentheSessionOptionsdialog3.IntheAuthenticationgroup,setoneofyourauthenticationmethods

tobePublicKeyandclickontheassociatedPropertiesbutton.4.InthePublicKeyPropertiesdialog,clickontheCreateIdentityFilebutton.5.FollowtheinstructionsintheKeyGenerationwizardtocreateyour

identityfiles.TheKeyGenerationwizardwillaskforapassphrase,butthepassphraseisnotrequired.Ifthepublickeyisgoingtobeusedaspartofanautomatedprocess,youmaynotwanttouseapassphrase.

6.Onceyourpublic-privatekeypairhasbeengeneratedbytheKeyGenerationwizard,youwillbepromptedforthepathandfilenameinwhichyouridentityfileswillbestored.Besuretospecifyasecurelocationforthesefilessuchthatyouaretheonlyindividualwithaccesstothem.Thepublickeywillbeplacedinafilewiththesamenameastheprivatekeyfile,butwithanextensionof.pub.

UsingYourIdentityFilesOnceyouhavecreatedyouridentityfiles,thereareseveralstepsthatwillneedtobecompletedsothatyoucanmakeuseofthemwithSecureCRT.Thenecessarystepsare:1.ConfiguretheSSH2servertorecognizeyourpublic-keyfile(e.g.,

Identity.pub).InstructionsareprovidedforconfiguringVanDykeSoftware'sVShell®server,OpenSSH,SSHCommunications,andDataFellowsservers.

2.ConfigureSecureCRTtousetheidentityfilewithpublic-key

authenticationonthelocalmachine.TheidentityfilecreatedbytheKeyGenerationwizardcontainsbothyournewpublickeyandyournewprivatekey.ToconfigureSecureCRTtousetheidentityfilecompletethefollowinginstructions:a.IntheConnectdialog,selecttheSSH2sessionwithwhichyou

wouldliketousetheidentityfile.b.OpentheSessionOptionsdialogandintheConnection/SSH2category,

changetheAuthenticationsettingfromPasswordtoPublicKey.c.Ifyouhavemorethanoneidentityfile,youmayneedtoclickon

thePropertiesbuttonandverifythatthesessionisusingthesession-specifickeyyouhavecreated.

d.ClickontheOKbuttontosavethechanges.Ifyousuppliedapassphrasewhenyoucreatedyourkey,youwillbepromptedtoenteritduringtheconnectionprocess.

ConfigureOpenSSHtoRecognizeYourPublic-KeyFile

Inordertouseyourpublickeyyoumusttransferthepublic-keyfile(typicallyIdentity.pub)createdbytheKeyGenerationwizardtothe~/.sshdirectoryontheSSH2server.ItisrecommendedthatyoufollowtheprocedurebelowforusingcopyandpastetocreateacopyoftheIdentity.pubfileinthe~/.sshdirectoryontheremotemachine.IfyoudecideinsteadtotransfertheIdentity.pubfiletothe~/.sshdirectoryusinganFTPclient,besuretotransferthefileinASCIImode.Alsobesuretocompletestep4dbelow.TousecopyandpastetoconfiguretheSSH2servertorecognizeyourpublic-keyfile:1.LogontotheremoteSSH2serverusingSSH2andpassword

authentication.2.Onthelocalmachine,useNotepad.exetoopentheIdentity.pubfile

thatwascreatedwiththeKeyGenerationwizard.3.WiththeIdentity.pubfileopenedintheNotepadapplication,openthe

EditmenuandchooseSelectAll.Onceeverythingisselected,opentheEditmenuagainandselectCopy.

4.Ontheremotemachine,completethefollowingsteps:a.%cat>~/.ssh/identity.pubb.ClickontheSecureCRTpastebutton topastethecontentsof

theClipboard(whichshouldnowcontainthecontentsofyourIdentity.pubfile).

c.IssueaCTRL+DtoclosetheIdentity.pubfile.d.ConvertthekeytoonethatOpenSSHwillrecognizeusingthe

followingcommand:%ssh-keygen-i-f~/.ssh/identity.pub>>~/.ssh/authorized_keys

IfyouareconnectingtoaversionofOpenSSHthatisolderthan2.9,usethefollowingcommandinstead:

%ssh-keygen-X-f~/.ssh/identity.pub>>~/.ssh/authorized_keys2

Note:IfthekeyisanOpenSSH-formatkey,suchasaconvertedkeyorakeyexportedfromacertificate,thekeydoesnotneedtobeconvertedasshownabove.Instead,usethefollowingcommand:%cat~/.ssh/identity.pub>>

~/.ssh/authorized_keys

IfyouareconnectingtoaversionofOpenSSHthatisolderthan2.9,usethefollowingcommand:%cat~/.ssh/identity.pub>>

~/.ssh/authorized_keys2

e.Ensurethatyouaretheonlyuserwithpermissionstowritetoyour"authorized_keys"file.Thiscanbedoneusingthefollowingcommand:

%chmod600~/.ssh/authorized_keysThemethoddescribedaboveusesonlyasinglepublickeyintheauthorizationfile.Itispossibletohavemorethanonepublickeyinthe"authorized_keys"file.Toaddadditionalpublickeys,repeatsteps2through4.ReturntoPublic-KeyAuthenticationforSSH2

ConfigureanSSHCommunicationsServertoRecognizeYourPublic-KeyFile

Inordertouseyourpublickey,youmusttransferthepublicidentityfile(generallyIdentity.pub)createdbytheKeyGenerationwizardtothe~/.ssh2folderontheSSH2server.ItisrecommendedthatyoufollowtheprocedurebelowforusingcopyandpastetocreateacopyoftheIdentity.pubfileinthe~/.ssh2folderontheremotemachine.IfyoudecideinsteadtotransfertheIdentity.pubfiletothe~/.ssh2folderusinganFTPclient,besuretotransferthefileinASCIImode.Alsobesuretocompletestep4-dbelow.TousecopyandpastetoconfiguretheSSH2servertorecognizeyourIdentity.pubfile:1.LogontotheremoteSSH2serverusingSSH2andpassword

authentication.2.Onthelocalmachine,useNotepad.exetoopentheIdentity.pubfile

thatwascreatedwiththeKeyGenerationwizard.3.WiththeIdentity.pubfileopenedintheNotepadapplication,openthe

EditmenuandchooseSelectAll.Onceeverythingisselected,opentheEditmenuagainandselectCopy.

4.Ontheremotemachine,completethefollowingsteps:a.%cat>~/.ssh2/identity.pubb.ClickontheSecureCRTpastebutton topastethecontentsof

theClipboard(whichshouldnowcontainthecontentsofyourIdentity.pubfile).

c.IssueaCTRL+DtoclosetheIdentity.pubfile.OnceyouhavetypedCTRL+D,theIdentity.pubfilewillhavebeencreatedinthe~/.ssh2folderontheremotemachine.

d.%echo"Keyidentity.pub">>~/.ssh2/authorization

ReturntoPublic-KeyAuthenticationforSSH2

ConfiguringaVanDykeSoftwareVShell®ServertoRecognizeYourPublic-KeyFile

UsingSecureCRT-GeneratedPublicKeyswithVShellforWindowsInordertouseyourpublickey,youmusttransfertheIdentity.pub(orwhatevernameyouchose)filecreatedbytheKeyGenerationwizardtotheindividualuser'sfolderunderthePublickeyfolderontheVShellserver.Forexample:C:\Program

files\VShell\Publickey\%User%\Identity.pub

IfyouareusingVShellversion2.1ornewer,youcanusetheSecureCRTpublic-keyassistanttouploadyourpublickeyforyouwithoutknowingtheexactlocationoftheserver'spublic-keyfolder.IfyouarenotusingVShellversion2.1ornewer,itisrecommendedthatyoufollowtheprocedurebelowforusingcopy-and-pasteoperationstocreateacopyoftheIdentity.pubfileinthePublickeyfolderontheremotemachine.IfyoudecideinsteadtotransfertheIdentity.pubusinganFTPclient,besuretotransferthefileinASCIImode.Tousecopy-and-pasteoperationstoconfiguretheVShellservertorecognizeyourIdentity.pubfile:1.LogontotheremoteVShellserverusingSSH2andpassword

authentication.2.Onthelocalmachine,useNotepad.exetoopentheIdentity.pubfile

thatwascreatedwiththeSecureCRTKeyGenerationwizard.3.WiththeIdentity.pubfileopeninNotepad,opentheEditmenuand

chooseSelectAll.Onceeverythingisselected,opentheEditmenuagainandselectCopy.

4.Ontheremotemachine,completethefollowingsteps:a.Changetotheindividualuser'sfolderunderthePublickeyfolder.

Forexample:\Programfiles\VShell\Publickey\%User%

b.Typecopyconidentity.pubonthecommandlineandpressthe

ENTERkey.c.ClickontheSecureCRTPastebuttontopastethecontentsofthe

Clipboard(whichshouldnowcontainthecontentsofyourIdentity.pubfile).

d.PressCTRL+ZENTERtoclosetheIdentity.pubfile.OnceyouhavetypedCTRL+ZENTER,theIdentity.pubfilewillhavebeencreatedinthefolderontheremoteVShellserver.

UsingSecureCRT-GeneratedPublicKeyswithVShellforUNIXInordertouseyourpublickey,youmusttransfertheIdentity.pub(orwhatevernameyouchose)filecreatedbytheKeyGenerationwizardtotheindividualuser's.vshell/publickeydirectory.Forexample:/home/someuser/.vshell/publickey/Identity.pub

or~someuser/.vshell/publickey/Identity.pub

YoucanusetheSecureCRTpublic-keyassistanttouploadyourpublickeyforyouwithouthavingtocopytheidentityfileby-hand.Ifyouarenotabletousethepublic-keyassistant,itisrecommendedthatyoufollowtheprocedurebelowforusingcopy-and-pasteoperationstocreateacopyoftheIdentity.pubfileinthePublickeyfolderontheremotemachine.IfyoudecideinsteadtotransfertheIdentity.pubusinganFTPorSFTPclient,besuretotransferthefileinASCIImodeifapplicable.Tousecopy-and-pasteoperationstoconfiguretheVShellservertorecognizeyourIdentity.pubfile:1.LogontotheremoteVShellserverusingSSH2andpassword

authentication.2.Onthelocalmachine,useNotepad.exetoopentheIdentity.pub

filethatwascreatedwiththeSecureCRTKeyGenerationwizard.3.WiththeIdentity.pubfileopeninNotepad,opentheEditmenu

andchooseSelectAll.Onceeverythingisselected,opentheEditmenuagainandselectCopy.

4.Ontheremotemachine,completethefollowingsteps:

a.Issueacdcommandtochangethecurrentworkingdirectorytotheindividualuser's.vshell/publickeyfolder.Forexample:

cd~someuser/.vshell/publickeyb.Typecat>~someuser/.vshell/publickey/identity.pubonthecommandlineandpresstheENTERkey.

c.ClickontheSecureCRTPastebuttontopastethecontentsoftheClipboard(whichshouldnowcontainthecontentsofyourIdentity.pubfile).

d.PressCTRL+DtoclosetheIdentity.pubfile.OnceyouhavetypedCTRL+D,theIdentity.pubfilewillhavebeencreatedintheuser's.vshell/publickeydirectoryontheremoteVShellserver.

ReturntoPublic-KeyAuthenticationforSSH2

ChangingthePassphraseforaPrivateKey

Ifyouwouldliketochangethepassphraseforaprivatekey,followthestepsoutlinedbelow.1.IntheConnectdialog,selecttheSSHsessionthatusestheprivatekey

forwhichyouwanttochangethepassphrase.2.OpentheSessionOptionsdialogbyselectingasessionandeitherclicking

onthePropertiesbutton ,orbyright-clickingontheselectedsessionandselectingthePropertiesmenuitemfromthepop-upmenu.

3.ForSSH1sessions:clickontheConnections/SSH1category,selectRSAastheAuthenticationmethodandthenclickontheassociatedPropertiesbutton.

4.ForSSH2sessions:intheConnections/SSH2category,selectPublicKeyintheAuthenticationwindowandthenclickontheassociatedPropertiesbutton.

5.ClickontheChangePassphrasebuttoninthePublicKeyPropertiesdialog.

6.IntheChangePassphrasedialog(shownbelow),enteryourcurrentpassphraseandthenewpassphrase(twice),andclickontheOKbutton.

ChangePassphraseDialog

KeyTerminology

Mostencryptiontechnologiesarebasedaroundasystemof“keys”thatallowinformationtobeencodedandthendecoded.Theterms“privatekey”,“publickey”,and“hostkey”areusedextensivelyinSSHcommunicationandcanbeconfusingtothosewhoarenewtotheterminology.Thistopichopestodefineandclarifythesetermsandtheiruse.

PrivateKeyAprivatekeyisoneoftwokeysusedinpublic-keyencryption(theotherbeingapublickey).Theuserkeepstheprivatekeysecretandusesittoencryptoutgoingmessagesanddecryptincomingmessages.Thepermissionsfortheprivatekeyshouldbesetsothatonlytheownerhasread/writeaccess.Thisisespeciallyimportantifthekeydoesnothaveapassphrase.

PublicKeyApublickeyisoneoftwokeysusedinpublic-keyencryption(theotherbeingaprivatekey).Theuserreleasesacopyofthiskeytothepublictoallowanyonetouseitforencryptingmessagestobesenttotheuserandfordecryptingmessagesreceivedfromtheuser.

Public-KeyEncryptionAschemeusinganasymmetricalgorithmtocreateapairofkeysforencryption:apublickeyencryptsdata,andacorrespondingprivatekeydecryptsit.Insomesituations,suchasdigitalsignatures,theprocessisreversed:thesenderusesaprivatekeytocreateauniquenumberthatcanbereadbyanyonewhohasthecorrespondingpublickey.Theagreementofthepublicandprivatekeysverifiesthatthemessageistrulyfromthesender.

Public-KeyAuthenticationInpublic-keyauthentication,public-privatekeypairsareusedtoidentifyausertoanSSH2server.Ausercreatesbothapublicandprivatekey,andthentransfersacopyofthepublickeytoanSSH2servertowhichtheuserwantssecureaccess.Theprivatekeyiskeptontheuser’slocal

machineandisusedtoverifytheidentityoftheuserwhentheuserattemptstoconnecttotheSSH2server.Thepublicandprivatekeysmustbecorrectfortheservertoallowtheconnection.

HostKeyAhostkeyisthepublickeyinapublic-privatekeypairthatisusedtoidentifyaserverhosttoaclientinSSH2connections.Whenaclientconnectstoaserverhost,theserversendsahostkeytotheclient(theserverkeepstheprivatekeysecret).Thefirsttimetheclientconnectstoaserver,theclient’suserisaskediftheywanttosavethehostkey.Iftheuserchoosestosavethehostkey,theclientaddsthekeytoitshostkeydatabase.Eachtimetheclientconnectstothatserver,theclientexpectstoreceivethesamekey.Iftheserversendsadifferenthostkey,theclientisalertedtothefactthattheremaybeaproblem,whichcouldbeanythingfromacorruptkeyfiletoafraudulentserver.Theclientthentakeswhateveractionthatisrequiredtoacceptorrejecttheconnection.Alsosee"AcceptingaHostKey"andGlobalOptions/SSH2HostKeys.

UsingX.509Certificates

OverviewX.509isaproposedstandardusedforgeneratingdigitally-signedpublic-keyauthenticationcertificates.ThesecertificatescanbeusedforauthenticationinsupportingSSHsystems.NotallSSHserverssupportX.509certificates.BeforeyoucanuseX.509certificates,youmustconfigureyoursystemtosupportthesecertificates.Intheexamplesystemshownbelow,aclientmachineisconnectedtoanSSHserverwhichinturnisabletoqueryaCertificationAuthority(CA)server.

X.509SystemConfiguration

ObtaininganX.509CertificateToobtainanX.509certificate,beginbygeneratingapublic/privatekeypaironyourclientmachine(refertoyoursystemdocumentationforinformationonthisprocess).KeepyourprivatekeyonthelocalmachineandforwardthepublickeywithanyotherrequiredinformationtotheCAintheformofarequestforcertification.Iftherequestisapproved,theCAdigitallysignsthecertificateandreturnsittoyouintheformofasmartcard,token,orothermedium.SecureCRTsupportsX.509systemsthatworkwithWindowscompatiblesmartcardreaders.

ConfiguringSecureCRTtoUseX.509CertificatesOnceyouhaveyourX.509certificate,youneedtoconfigureSecureCRTtouseit.1.Ontheclientmachine,startSecureCRT.2.SelectthesessionthatyouwanttousewiththeX.509certificateand

opentheSessionOptionsdialog.

3.IntheConnection/SSH2category,selectPublicKeyasoneofyourAuthenticationtypesandclickontheassociatedPropertiesbutton.

4.InthePublicKeyPropertiesdialog,cleartheUseglobalpublickeysettingoptionandchecktheUsecertificateoption.

5.ClickontheOKbuttontosaveyoursettings.Note:SecureCRTalsosupportstheuseofX.509certificatesforpublickeysonaglobalbasis.ThisoptionisavailableintheSSH2categoryoftheGlobalOptionsdialog.

UsingtheAgent

OverviewAgentsareprogramsthatworkinthebackgroundgatheringinformationorperformingsmallprocessingtasks.InSecureCRT,theimplementedagenttemporarilyholdsprivatekeysforusewithpublic-keyauthenticationtomultipleremotehosts.Public-keyauthenticationusesapublic-privatekeypairtologontoaSecureShellserver.Afteryoucreateyourpublic-privatekeypair,youstoreyourprivatekeyonyourlocalmachineandtransferyourpublickeytotheremotehosttowhichyouwanttoconnect.Ifyouwanttoconnecttomorethanoneremotemachine,youmusttransferyourpublickeytoeachmachine.Manyuserschoosetoencrypttheirprivatekeywithapassphrase.Tologontoallthemachinesintheexamplebelow,youwouldhavetoenteryourpassphrasethreetimes;onceeachtimeyoumadeaconnection,evenifthemachinesusethesamepublic-privatekeypair.

ConnectingtoMultipleHosts

IfyouusetheSecureCRTagent,however,youonlyhavetoenteryourpassphrasewhenmakingthefirstconnection.Theagentholdsyourdecryptedprivatekeyandauthenticatesanyfurtherconnectionstomachinesusingthesamepublic-privatekeypair.

AgentForwardingAgentforwardingisusingtheagenttoconnecttoaremotemachinethroughanotherremotemachine(seethefigurebelow).

ConnectingThroughaRemoteHost

Toconnecttothedestinationmachinewithoutusingtheagent,youwouldhavetotransferyourpublickeytoboththeintermediateanddestinationhostsandyouwouldhavetostoreyourprivatekeyontheintermediatemachineaswellasonyourlocalmachine.Withtheagentenabled,itactsasyourproxyinauthenticatingtothedestinationhostandallowsyoutokeepyourprivatekeyonjustthelocalmachine.

Note:AgentforwardingwillonlyworkifallintermediatemachinesareOpenSSHagentprotocolserversrunningSSH2.DestinationserversmustberunningSSH2butdonothavetobeOpenSSHagentprotocolservers.

EnablingtheAgentToenabletheagentoptionsfollowthesesteps:1.Onthelocalmachine,startSecureCRT.2.OpentheGlobalOptionsdialog,andselecttheSSH2category.3.ToenabletheSSH2Agent,checktheAddkeystoagentcheckbox

intheAdvancedgroup.4.Toenableagentforwardingonaglobalbasis,checktheEnable

OpenSSHagentforwardingcheckboxintheAdvancedgroupandclickontheOKbuttontosaveyoursettings.

5.Toenableagentforwardingonaper-sessionbasis,opentheSessionOptionsdialogandselecttheSSH2/Advancedcategory.ChecktheEnableOpenSSHagentforwardingcheckboxintheOptionsgroupandclickontheOKbuttontosaveyoursettings.Thisisatri-stateoption;Ifthisoptionissettothetri-statevalue(square),thesettingfromtheGlobalOptions/SSH2categorywillbeused.

FlushingtheAgentCacheTodeletethepublickeysfromtheagent'scacheyouwillneedtoassign

theSSH_FLUSH_AGENTcommandtoaspecifiedkeyboardkey.Youcandothisbyfollowingthesesteps:1.FromtheToolsmenu,selectKeymapEditor...2.IntheKeymapEditor,selectthekeythatyouwanttoassociatewiththe

SSH_FLUSH_AGENTcommand.ThisshouldbeakeythatisnotalreadyassignedorfrequentlyusedsuchasF2orF11forexample.

3.PresstheMapSelectedKey...buttontoopentheMapSelectedKeydialog.

4.FromtheFunctionlist,selectSSHFunction.5.FromtheSSHFunctionlist,selectSSH_FLUSH_AGENTandclickthe

OKbutton.6.SavethekeymapthatyoucreatedandclosetheKeymapEditor.7.RestartSecureCRTusingthenewkeymap.8.Pressthekeyyouchosetoflushtheagentcache.

Note:Therewillbenofeedbacklettingyouknowthattheagentcachehasbeenflushedexceptthatthepreviouslycachedpublickeyswillnotlongerwork.

XtermEscapeSequences

SecureCRTsupportsmanystandardescapesequences.ThefollowingisalistofthextermsequencessupportedbySecureCRT.

Note:Themousetrackinginformationisprovidedforusersdevelopingapplicationsforremotesystemsinordertosupportmousetracking.Typicallythisimplementationwillbetransparenttotheuser.SecureCRTsupportsX10mousetracking.

GeneralSequences Action

ESC]2;titleBELSettextparameters;changewindowtitletotitle

MouseTrackingSequences Action

ESC[?9hSendmouseXandYonbuttonpress

ESC[?1000hSendmouseXandYonbuttonpressandrelease

ExampleScript:ChangingtheWindowTitleSecureCRTsupportsthextermescapesequenceforchangingthesessionwindowtitlebaronthefly.ThePerlscriptbelowshowshowthiscanbedone:

#!/usr/local/bin/perl

#title.pl-sendsxtermescapesequenceto

#changewindowtitleto@ARGV

$esc="\x1b";

$bel="\x7";

$txt=join("",@ARGV);

print$esc,"]2;",$txt,$bel;

Thisscriptcanbeplacedinashellaliastodisplaythecurrentworkingfolderinthetitlebarofthesessionwindow:

aliascd'cd\!\!*;prompt;~/bin/title.pl$host\:`pwd`'

256-ColorExtensionSupportSecureCRTsupportsthe256-colorextensionsintroducedforxtermversionsthatneedtosupportmorethan16colors.For256-colorxtermescapesequencestowork,youmusthavetheANSIColoroptionenabledintheTerminal/EmulationcategoryoftheSessionOptionsdialog.Thegeneralformofthe256-colorescapesequencesisasfollows.

Tosetforegroundcolor:ESC[38;5;<color>m

CSI38;5;<color>m

Tosetbackgroundcolor:ESC[48;5;<color>m

CSI48;5;<color>m

ThefollowingPerlscriptdemonstratesusingthesesequencestolayouta"colorcube"withacolored"X"ineachcolorcell:

---#!/usr/bin/perl$ESC="\x1b";$CSI="${ESC}\[";for($green=0;$green<6;$green++){for($red=0;$red<6;$red++){for($blue=0;$blue<6;$blue++){$bgcolor=16+($red*36)+($green*6)+$blue;$fgcolor=16-$red-$green-$blue;print"${CSI}48;5;${bgcolor}m";print"${CSI}38;5;${fgcolor}mX";}

print"${CSI}0m";}print"\n";}---

CreatingaPersonalFontMap

SecureCRTprovidesamethodforyoutocreateapersonalfontmap,incasethefontmapsavailableintheCharacterEncodingoptionarenotsufficientforyourneeds.Thismethodconsistsoftwotasks:creatingafontmapfileandaddingthatfiletoaSecureCRTsession.

CreatingaFontMapAfontmapisatextfileofupto256lines(0through255).Eachlineinthisfilecorresponds(byitspositioninthefile)toacharactercellintheselectedcodepage.ThehexadecimalnumberoneachlinetellsSecureCRTwhichUnicodecharactertodisplayforthatcell.Forexample,ifthevalue00dfappearedonline65ofthefile,any"A"charactersreceivedfromtheremotemachinewouldbedisplayedas"ß"characters.Thelineentryformatisasfollows:<hexadecimalnumber><comments>

Example:0000

0001

…

00df“SharpS”

…

00ff

AnythingonthelineafterthehexnumberisignoredbySecureCRT,makingthespaceusefulforcomments.Blanklinesinthefilewillbeignored.Ifyouonlywanttotranslateafewcharacters,youcanchoosenottoincludeall256linesinyourmapfile,however,theentriesmustbesequentialandallentriesmustbeincludedthroughthelastassignmentyouwanttomake.Forexample,ifyouwantedtochangethecharactersdisplayedforlines2and10,youstillmustincludelines0through10inyourfile.

AddingaFontMaptoaSessionFontmapfilesaresessionspecific.Toassignafontmaptoasession,

addalinelikethefollowingtoyoursession’s.inifile:S:“UserFontMap”=<path>

Inthiscommand,the“path”variableisthefullpathofyourfontmap.

OverviewofColorSchemes

SecureCRTallowsyoutocustomizetheforegroundandbackgroundcolorsofbothnormalandboldtextattributes.Theforegroundandbackgroundcolorsaredefinedinwhatiscalleda"colorscheme"whichcanthenbecustomizedandassignedtoasession.SecureCRTcomeswithanumberofpredefinedcolorschemes.SecureCRTalsoallowsyoutocreateanynumberofpersonalizedcolorschemes.

Note:IfANSIcolorisenabledforasession,thecolorschemespecifiedbythesessionwillnotbeused.Forinformationonhowtoenable,disable,orcustomizeANSIcolorsettings,seetheANSIcolorsettingsintheGlobalOptionsandSessionOptionsdialogs.

CreatingorModifyingaColorScheme

YoucanmodifyacolorschemefromeithertheGlobalOptionsorSessionOptionsdialogsinSecureCRT.FromtheSessionOptionsdialog:

·SelecttheTerminal/Appearancecategory.·Tocreateacolorscheme,intheCurrentcolorschemegroup,

clickontheNew...button.·Tomodifyacolorscheme,intheCurrentcolorschemegroup,

clickontheEdit...button.FromtheGlobalOptionsdialog:

·IntheGlobalOptionsdialog,selecttheTerminal/AppearancecategoryandclickontheColorSchemessubcategory.

·Tocreateacolorscheme,intheColorschemepanel,clickontheNew...button.

·Tomodifyacolorscheme,selectthecolorschemethatyouwanttomodifyfromtheSchemeslistandclickontheEdit...button.

Ineithercase,tocreateormodifyacolorscheme:·IntheColorSchemedialog(shownbelow),selectthetextattribute

(Normal,Bold,etc...)youwantfromamongthelistofattributesbyusingthedrop-downboxorbyclickingontheattributenameasitisdisplayedintheattributepreviewarea.Whenanattributeisselected,itwillbeindicatedwithaboxdrawnaroundit(inthefigurebelow,theNormalattributeisselected)intheattributepreviewarea.-Tochangetheforegroundcoloroftheselectedtextattribute,

clickontheForegroundbutton(seebelow)andselectthenewforegroundcolorfromtheColordialog.

-Tochangethebackgroundcoloroftheselectedtextattribute,clickontheBackgroundbuttonandselectthenewbackgroundcolorfromtheColordialog.

Note:TocustomizetheforegroundandbackgroundcolorsofadditionaltextattributessuchasUnderline,BoldUnderline,Blink,BlinkBold,BlinkUnderline,andBlinkBoldUnderline,selecttheAdvancedoptionintheColorSchemedialog.TheColorScheme

dialogalsoallowsyoutoenableordisablethedisplayofOverstrikebold,ShowunderlineandEnableblinktextattributeswithintheterminalscreen(seebelow).

ColorSchemeDialog

OverviewofKeymaps

Terminalemulators,suchasSecureCRT,useakeyboardemulationor“keymap”tomapkeystrokesfromyourlocalkeyboardtothekeystrokesthataremotehostwouldexpect.Forexample,assumeyouareaWindowsNTuserrunningaSecureCRTsessionthatisconfiguredwiththeVT220terminalemulationandassociatedkeymap.WhenyoupresstheF1key(whichinNTwouldopentheHelpsystem),SecureCRTsendsaHoldScreencommandtotheremotehostasifyouwerepressingtheF1keyonaVT220terminal.InSecureCRT,everysessionusesakeymap.Keymapscanalsobeusedformorethanonesession.SecureCRTprovidesbuilt-inkeymapsforANSI,Linux,SCOANSI,VShell,VT100,VT102,VT220,WYSE50,andWYSE60terminalemulation.YoucanalsocreatecustomkeymapsusingtheKeymapEditor.

SelectingaKeymapSecureCRTautomaticallychoosesabuilt-inkeymaptousebasedontheterminalemulationselectedintheTerminal/EmulationcategoryoftheSessionOptionsdialog.Toselectadifferentkeymapforasession,checktheSelectanalternatekeyboardemulationoptionintheTerminal/Emulationcategoryandselectthebuilt-inorcustomkeymapthatyouwanttouse.

CustomizingaKeymap

SecureCRTprovidestwomechanismsforcustomizethefunctionsdefinedbyakeymap:theMappedKeyscategory;andtheKeymapEditor.

MappedKeysIntheTerminal/Emulation/MappedKeyscategoryoftheSessionOptionsdialog,youcanassociatefunctionsandargumentswithspecifiedkeysorkeycombinations.Theseassociationsonlyapplytothesessioninuseandwillnotcarryovertoothersessions.Theassociationsmadeonlysupersedethecurrentkeymapanddonotchangethekeymapitself.

YoucanalsoreturnakeymapbacktoitsoriginalconfigurationbyclickingonthedefaultbuttonintheMapSelectedKeydialog.

KeymapEditorTheKeymapEditorallowsyoutomodifyanexistingkeymaporcreateanewone.Inthisway,youcanmakekeymapcustomizationsthatcanbeusedwithmultiplesessions.

TableofKeymapFunctions

KeycombinationscanbemappedtoanyoneoftheSendString,RunScript,Menu,ScrollBar,Telnet,SSH,andVTfunctiongenres,orcanbedisabledcompletely.Youcanalsomapakeythatlauncheslocalcommands.ByassigningakeytothefunctionLaunchApplicationandenteringtheappropriateexecutablefile,SecureCRTcanopenwhateverapplicationyouneed.

FunctionGenre FunctionNameandParameter Action

SendString N/Astring Sends

"string".

RunScript N/Ascriptfile Runs

scriptfile.

MenuFunction MENU_CLEAR_SCREEN

Clearstheterminalscreen.

MENU_CLEAR_SCROLLBACKClearsthescrollbackbuffer.

MENU_CLEAR_SCREEN_AND_SCROLLBACK

Clearsboththeterminalscreenandthescrollbackbuffer.

MENU_CONNECT

OpensanewSecureCRTwindowandbringsuptheSecureCRT

Connectdialog.

MENU_COPY

CopiesthetextselectedintheSecureCRTterminalscreen.

MENU_COPY_PASTE

CopiesthetextselectedintheSecureCRTterminalscreenandpastesitbacktotheterminalscreen.

MENU_DISCONNECTClosesthecurrentconnection.

MENU_EXIT ExitsSecureCRT.

MENU_FIND

OpenstheFinddialogfortextsearching.

MENU_GOTO_CHAT_SESSION_WINDOW

Switchesfocusbetweenthechatandsession

windows.

Toggles

MENU_LOG_SESSION sessionlogging.

MENU_NEW_WINDOWOpensanewSecureCRTwindow.

MENU_PASTE

PastesthecontentsoftheClipboardtotheSecureCRTterminalscreen.

MENU_PRINT_AUTO TogglesAutoPrint.

MENU_PRINT_CANCEL TurnsAutoPrintoff.

MENU_PRINT_EJECT_PAGE

Sendsthecontentsofthepass-throughprintingbuffertotheprinter.

MENU_PRINT_SCREEN

PrintsthecontentsoftheSecureCRTterminalscreen.

MENU_PRINT_SELECTIONPrintsthecurrentselection

Opensanew

MENU_QUICK_CONNECT

SecureCRTwindowandbringsuptheSecureCRTQuickConnectdialog.

MENU_RECENT_n

OpensthesessionindicatedbythenthitemontheRecentlyUsedSessionsListgroupoftheFilemenu.Validvaluesfornaretheintegers1-4.

MENU_RECONNECT

Reconnectstothemachinewhoseconnectionwasmostrecentlyclosed.

MENU_RESET

ResetstheSecureCRTterminalemulator.

MENU_SAVE_SETTINGS_NOWSavessessionsettings.

Selectsthe

MENU_SELECT_ALLcontentsofthescrollbackbuffer.

MENU_TAB_1 SetsfocustoTab1.

MENU_TAB_2 SetsfocustoTab2.

MENU_TAB_3 SetsfocustoTab3.

MENU_TAB_4 SetsfocustoTab4.

MENU_TAB_5 SetsfocustoTab5.

MENU_TAB_6 SetsfocustoTab6.

MENU_TAB_7 SetsfocustoTab7.

MENU_TAB_8 SetsfocustoTab8.

MENU_TAB_9 SetsfocustoTab9.

MENU_TAB_10 SetsfocustoTab10.

MENU_TAB_CLONE

Createsanewsessionthatisidenticaltothecurrent

session.Formoreinformation,seetheSessionTabstopic.

MENU_TAB_CLOSE Closestheactivetab.

MENU_TAB_NEW Createsanewtab.

MENU_TAB_NEW_SFTP

OpensanewtabcontaininganSFTPcommandline.(availableinSecureCRTonly)

MENU_TAB_NEXTChangesthefocustothenexttab.

MENU_TAB_PREVChangesthefocustotheprevioustab.

MENU_TAB_RENAMEAllowsyoutorenametheactivetab.

StartsVanDykeSoftware'sSecureFX®withthesame

MENU_TAB_SECUREFX sessionconfiguration,iftheprogramisinstalled(availableinSecureCRTonly)

MENU_TOGGLE_ALPHA_TRANSPARENCY

TogglestheactivewindowtransparencybetweenfullyopaqueandthetransparencyvaluesetintheTerminal/Appearance/AdvancedcategoryoftheGlobalOptionsdialog.

MENU_TOGGLE_CHAT_WINDOW

TogglesdisplayoftheSecureCRTchatwindow.

MENU_TOGGLE_FULL_SCREENTogglesfullscreenmode.

MENU_TOGGLE_MENU_BAR

TogglesdisplayoftheSecureCRTmenubar.

Toggles

MENU_TOGGLE_SESSION_TABS displayoftabs.

MENU_TOGGLE_STATUS_BAR

Togglesdisplayofthe.SecureCRTstatusbar.

MENU_TOGGLE_TOOLBAR

TogglesdisplayoftheSecureCRTtoolbar.

MENU_WINDOW_n

CyclesfocustothenthSecureCRTwindowasdesignatedintheWindowmenu.Validvaluesfornareintegers1-0,wherethevalue0indicatesthe10thwindow.

MENU_WINDOW_NEXT

CyclesfocustothenextSecureCRTwindow

MENU_WINDOW_PREV

CyclesfocustothepreviousSecureCRTwindow.

ScrollBarFunction

SB_BEGIN

Scrollstothebeginningofthescrollbackbuffer.

SB_COLUMN_LEFT

Movesthecontentsoftheterminalscreenrightbyonecolumn.Sameasclickingonthehorizontalscrollbarleftarrow.

SB_COLUMN_RIGHT

Movesthecontentsoftheterminalscreenleftbyonecolumn.Sameasclickingonthehorizontalscrollbarrightarrow.

SB_END

Scrollstotheendofthescrollbackbuffer.

Movesthecontentsoftheterminal

SB_HALF_PAGE_DOWN screenupbyone-halfofapage.

SB_HALF_PAGE_UP

Movesthecontentsoftheterminalscreendownbyone-halfofapage.

SB_LINE_DOWN

Movesthecontentsoftheterminalscreenupbyoneline.Sameasclickingontheverticalscrollbardownarrow.

SB_LINE_UP

Movesthecontentsoftheterminalscreendownbyoneline.Sameasclickingontheverticalscrollbaruparrow.

Movesthecontentsoftheterminalscreenupbyonepage.Sameas

SB_PAGE_DOWN clickingbetweenthedownarrowandthesliderintheverticalscrollbar"trough".

SB_PAGE_LEFT

Movesthecontentsoftheterminalscreenrightbyonepage(numberoflogicalcolumns).Sameasclickingbetweentheleftarrowandtheslideronthehorizontalscrollbar.

SB_PAGE_RIGHT

Movesthecontentsoftheterminalscreenleftbyonepage(numberoflogicalcolumns).Sameasclickingbetweentherightarrowandtheslideronthe

horizontalscrollbar.

SB_PAGE_UP

Movesthecontentsoftheterminalscreendownbyonepage.Sameasclickingbetweentheuparrowandthesliderintheverticalscrollbar"trough".

Telnet

Function TN_ABORT_OUTPUT

SendstheAbortOutput(AO)controlfunctiontotheremotehost.

TN_ARE_YOU_THERE

SendstheAreYouThere(AYT)controlfunctiontotheremotehost.

TN_BREAK

SendstheBREAKcontrolfunctiontotheremotehost.

TN_INTERRUPT_PROCESS

SendstheInterruptProcess(IP)controlfunctiontotheremotehost.

TN_SYNCH

SendstheSYNCHcontrolfunctiontotheremotehost.UsedincombinationwiththeIPcontrolfunctiontoensurethatthehostandclientareinsynchwitheachotherafteranIPcontrolfunctioniscalled.

VTFunction

EachVTfunctionsendsthekeycodesassociatedwiththenameoftheVTfunction.

VT_AUTO_PRINT TogglesAutoPrint.

VT_BREAKSeeTelnetfunctionTN_BREAK

VT_CURSOR_DOWN SendsESC[B

VT_CURSOR_LEFT SendsESC[D

VT_CURSOR_RIGHT SendsESC[C

VT_CURSOR_UP SendsESC[A

VT_F6 SendsESC[17~

VT_F7 SendsESC[18~

VT_F8 SendsESC[19~

VT_F9 SendsESC[20~

VT_F10 SendsESC[21~

VT_F11 SendsESC[23~

VT_F12 SendsESC[24~

VT_F13 SendsESC[25~

VT_F14SendsESC[26~

VT_F15 SendsESC[28~

VT_F16 SendsESC[29~

VT_F17 SendsESC[31~

VT_F18 SendsESC[32~

VT_F19 SendsESC[33~

VT_F20 SendsESC[34~

VT_FIND SendsESC[1~

VT_HOLD_SCREEN PerformsaHoldScreen.

VT_INSERT_HERE SendsESC[2~

VT_KEYPAD_0 Sends0

VT_KEYPAD_1 Sends1

VT_KEYPAD_2 Sends2

VT_KEYPAD_3 Sends3

VT_KEYPAD_4 Sends4

VT_KEYPAD_5 Sends5

VT_KEYPAD_6 Sends6

VT_KEYPAD_7 Sends7

VT_KEYPAD_8 Sends8

VT_KEYPAD_9 Sends9

VT_KEYPAD_COMMA Sendsa","

VT_KEYPAD_ENTER SendsaCR

VT_KEYPAD_MINUS Sendsa"-"

VT_KEYPAD_PERIOD Sendsa"."

VT_NEXT_SCREEN SendsESC[6~

VT_PF1SendsESCOP(VT100PF1key).

VT_PF2SendsESCOQ(VT100PF2key).

VT_PF3SendsESCOR(VT100PF3key).

VT_PF4SendsESCOS(VT100PF4key).

VT_PREV_SCREEN SendsESC[5~

VT_PRINT_SCREEN PerformsaPrintScreen.

VT_REMOVE SendsESC[3~

VT_SELECT SendsESC[4~

Disable N/A

Disablestheselectedkeyorkeycombination.

SSHFunction

SSHfunctionswillonlyworkwithSSHconnections.

SSH_BREAKSendstheBREAKcontrolfunctiontotheremotehost.

SSH_CLOSE_SESSION Closesthecurrentterminalsession.

SSH_FLUSH_AGENT FlushestheSSHagentcache.

SSH_NEW_SESSION Opensanewterminalsession.

SSH_NEXT_SESSION Switchestothenextterminalsession.

SSH_PREV_SESSIONSwitchestothepreviousterminalsession.

ASCIIControlCodes

ThistableliststhevaluesfortheASCIIcontrolCharacters(ASCIIdecimalvalues0-31).DecimalandHexvaluesareprovidedtoaidinconversion.

Note:SecureCRTrequiresoctalvalues.

CTRL Decimal Hex Octal

^@ 0 0x00 \000^A 1 0x01 \001^B 2 0x02 \002^C 3 0x03 \003^D 4 0x04 \004^E 5 0x05 \005^F 6 0x06 \006^G 7 0x07 \007^H 8 0x08 \010^I 9 0x09 \011^J 10 0x0A \012^K 11 0x0B \013^L 12 0x0C \014^M 13 0x0D \015^N 14 0x0E \016^O 15 0x0F \017^P 16 0x10 \020^Q 17 0x11 \021^R 18 0x12 \022^S 19 0x13 \023^T 20 0x14 \024^U 21 0x15 \025

^V 22 0x16 \026^W 23 0x17 \027^X 24 0x18 \030^Y 25 0x19 \031^Z 26 0x1A \032^[ 27 0x1B \033^\ 28 0x1C \034^] 29 0x1D \035^^ 30 0x1E \036^_ 31 0x1F \037

SendStringandFunctionKeyCommands

Thefollowingcommandscanbeincludedaspartofakeymap,button,oranti-idlestring.

Command Action

\r Sendsacarriagereturn(CR)

\n Sendsalinefeed(LF)

\b Sendsabackspace

\e Sendsanescape

\t Sendsatab

\vPastesthecontentsoftheClipboardtotheactivesessionwindow

\p Pausesforonesecond

Note:Whenmappingakey,youcansendarbitraryoctalcodesusingSendStringcommands.

Emulation-SpecificKeymappings

TheSecureCRTbuilt-inkeymapsforLinux,VT220,andVT100haveseveralkeyassignmentsthatdonotmatchthetraditionalWindowskeyassignments.Thefollowingtableslistthoseemulation-specifickeys.

Linux

Key LiteralValue OctalValue HexidecimalValue

F1 ESC[[A \033\133\133\101 0x1B0x5B0x5B0x41

F2 ESC[[B \033\133\133\102 0x1B0x5B0x5B0x42

F3 ESC[[C \033\133\133\103 0x1B0x5B0x5B0x43

F4 ESC[[D \033\133\133\104 0x1B0x5B0x5B0x44

F5 ESC[[E \033\133\133\105 0x1B0x5B0x5B0x45

VT220

Key LiteralValue OctalValue HexidecimalValue

F1 VT_HOLD_SCREEN localfunction-nothingsenttoremote

F2 VT_PRINT_SCREEN localfunction-nothingsenttoremote

F3 VT_PF3 \033\117\122 0x1B0x4F0x52

F4 VT_PF4 \033\117\123 0x1B0x4F0x53

protocolfunction-noescape

F5 TN_BREAK sequence

INS VT_FIND \033\133\061\176 0x1B0x5B0x310x7F

HOME VT_INSERT_HERE \033\133\062\176 0x1B0x5B0x320x7F

PG_UP VT_REMOVE \033\133\063\176 0x1B0x5B0x330x7F

DEL VT_SELECT \033\133\064\176 0x1B0x5B0x340x7F

END VT_PREV_SCREEN \033\133\065\176 0x1B0x5B0x350x7F

PG_DN VT_NEXT_SCREEN \033\133\066\176 0x1B0x5B0x360x7F

VT100

Key LiteralValue OctalValue HexidecimalValue

F1 VT_PF1 \033\117\120 0x1B0x4F0x50

F2 VT_PF2 \033\117\121 0x1B0x4F0x51

F3 VT_PF3 \033\117\122 0x1B0x4F0x52

F4 VT_PF4 \033\117\123 0x1B0x4F0x53

NM_LK VT_PF1 \033\117\120 0x1B0x4F0x50

/ VT_PF2 \033\117\121 0x1B0x4F0x51

* VT_PF3 \033\117\122 0x1B0x4F0x52

_ VT_PF4 \033\117\123 0x1B0x4F0x53

DetermineEscapeSequenceKeyCodes

Ifyouneedtodeterminetheescapesequenceforaparticularkeythataterminalemulatorsendstoaremotesystem(e.g.,foruseinscriptingorcustomkeymappings),thereareacoupleofwaystodothis.Usinganyterminalemulator,connecttoaremotesystemrunningUNIX.Youshouldbeabletousethefollowingcommandfromyourshelltodeterminewhatsequenceofcharacterstheremotesystemreceiveswhenaparticularkeyispressed:cat–v

Forexample,ifyoupressthePF1keyfromaVT100terminal(oranemulatorwhichmapsthePF1key),youshouldsee:^[OP

(Thisistypicallyread:ESCOP.)InSecureCRT,usingtheVT100keyboardemulation,thiscanbesentbypressingtheNUMLOCKkey.UsingSecureCRT'sActiveXscriptingsupportwithVBScript,youcouldsendthissequenceusingthefollowingcommandstring:crt.Screen.SendChr(27)&"OP"

UsingSecureCRT'sPythonscriptingsupport,youcouldsendthissequenceusingthefollowingcommandstring:crt.Screen.Send(chr(27)+"OP")

Intheexamplesabove,"27"istheASCIIdecimalvaluefortheESCcharacter.Similarly,inSecureCRT'sSessionOptions/Terminal/Emulation/MappedKeysdialogorKeymapEditor,youcanuse"\e"torepresenttheESCcharacter,orusetheoctalASCIIvalue"\033".MoreinformationaboutthiscanbefoundintheTableofKeymapFunctionsandSendStringandFunctionKeyCommandssections.UsingtheKeymapEditor,youcanalsofindoutthedefaultmappingsforthekeysyoupress.Forexample,withtheVT100keymaploaded,clickingontheF1buttonintheKeymapEditorwillshowyou"VT_PF1",whichisaninternalaliasforthesequence"ESCOP"(or"^[OP","\033OP",etc.).

Itisimportanttounderstandthattherearenoabsolutevaluesthatanyparticularkeysends,sowhatoneremotesystemacceptsforPF1maynotbeconsistentonadifferentsystem.Moreover,therearemanywaysofrepresentingthesameescapesequence,includingdecimal(e.g.,"Chr(27)"inVBScript),backslashescapecharacters(e.g.,"\e"forESCinSecureCRT),andoctal(e.g.,"\033OP"or"\033\117\120").

CreatingActiveXScripts

SecureCRTiscapableofhosting"ActiveXScript"engines.ThemostcommonActiveXscriptenginesareVBScriptandJScript(Microsoft’sversionofJavaScript),bothofwhicharefreelyavailablefromMicrosoft.Chancesareyoualreadyhavetheminstalledifyou’veinstalledInternetExplorer4.0.ActiveXscriptenginescommunicatewithSecureCRTviastandardinterfaces.Therefore,SecureCRTcanhostanycompliantscriptenginetorunyourscripts.TheadvantageofthisapproachisthatyoucanscriptSecureCRTusingthelanguageofyourchoice.IfanActiveXscriptengineisavailableforyourpreferredscriptinglanguage,youcanwritescriptsthatwillworkwithSecureCRT.

Note:TorunalogonscriptinSecureCRT,youmustfirstturnofftheAutomatelogonoptionintheConnection/LogonActionscategoryoftheSessionOptionsdialogandthen,onthesamedialog,checktheLogonscriptcheckboxandchoosethescriptthatyouwanttorun.Note2:Ascriptcannotberunfromanotherscript.Thisincludesscriptsstartedmanuallyandlogonscripts.

ScriptsforSecureCRTaretextfilesthatyoucreatewithyourtexteditor.Ascriptheaderisnotrequiredaslongasthefileextensionisregisteredintheregistrywithascriptengine(ascommonfileextensionsare).Ifyouwanttouseaheader(forexample,ifyouareusingafilewithoutanextensionorwithanextensionthatisnotcommon),theheadermustbeginonthefirstlineofthescript.ScriptheaderswillbeusedbySecureCRTtoidentifywhichscriptlanguagethescriptiswritteninandtheversionofSecureCRTscriptinginterface.Eachlineofthescriptheadermustbeginwitha(#)character.ASecureCRTscriptheaderincludesa$languagelinethatidentifiesthescriptengineandan$interfacelinetoidentifySecureCRT'sinterfaceversion.Thesyntaxofthescriptheaderisalwaysthesameregardlessofthescriptlanguageyouareusing.AsimplebutcompleteSecureCRTscriptwithaheaderthatidentifiesitasVBScriptisshownbelow:

#$language="VBScript"#$interface="1.0"

SubMain'DisplaySecureCRT'sversionMsgBox"SecureCRTversionis:"&crt.Version

EndSub

Note:ASecureCRTscriptheadermayalsocontainblanklinesthatbeginwith(#).

Thequotedstringfollowing$languageidentifiesthescriptengine.IfyouarewritingscriptsthatuseMicrosoft’sJScriptlanguage,theappropriateidentifierisJScript.Ifyouareusinganotherscriptengineyou’llneedtoconsultthedocumentationfortheidentifierforthatlanguage.Currentlythescriptheadershouldspecifyversion1.0for$interface.FutureversionsofSecureCRTmaysupportotherversions.Theexamplescriptabovehasasubroutinenamedmainwhereallofthescript’scodeislocated.WhenSecureCRTexecutesscriptsitalwaysattemptstorunamainroutineifyouhavedefinedone.Itisnotarequirementthatyouplaceyourcodewithinamainhowevertheremaybereasonswhyyouwouldwanttodothis.TheVBScriptandJScriptengineswillparseandexecuteglobalscriptcode(scriptcodeyouhavedefinedoutsideofanysubroutine)beforeyourmainisexecuted.Ifyouhave"initialization"codethatyouwanttoensurehasbeencompletelyexecutedbeforeyouractualscriptcodebegins,itmaybeusefultoplaceyourinitializationcodeatthegloballevel.Thiswillensurethatyourinitializationcodewillallexecutebeforeyourmaincoderuns.Anotherreasonyoumaywantamainroutineistoallowyourscriptsawayofabortingthemselvesincaseofproblems.InVBScriptthereisnobuilt-inwayofexitingascriptatthegloballevel.However,ifyouwanttoexitasubroutineitispossibletousetheExitSubsyntaxtodoso.Forexample,inVBScript:SubMain

condition=DoSomething()Ifcondition=0Then'Error,bailoutExitSubEndIf

EndSub

Whenthemainroutineendsthescripthasfinishedrunning.ByplacingyourcodewithinamainyouhavetheoptionofinvokingExitSubwheneveritmightbenecessary.ThepreviousscriptsamplesarewritteninVBScript.TheremainderofcodesamplesinthisdocumentareallwritteninVBScriptunlessitisstatedotherwise.ThepropertiesandmethodsofSecureCRT'sinterfacecanbeusedasdocumentedbyanycompatiblescriptinglanguage.ForfilesstoredonNTFSfilesystems,thescriptheadercanoptionallybestoredinanNTFSalternatedatastreamcalledheader.txt.OnewaytodothisistochooseRunfromtheWindowsStartmenuandenterthefollowing:notepadmyscript.txt:header.txt

ScriptfilescanbestoredinUTF-8orUnicodeformat.StoringascriptfileinUTF-8orUnicodeformatenablescharactersfromlanguagessuchasChineseorJapanesetobeincludedinthescript.ForexamplesofSecureCRTscripts,seethesamplescriptsintheSecureCRTInstallation\ScriptsfolderandontheVanDykeSoftwarewebsiteintheScriptingFAQsection.

CreatingPythonScripts

SecureCRTcontainsanembeddedPythoninterpreter,whichmeansthatPythonscriptscanberunfromSecureCRTwithouthavingtoinstalladditionalsoftware.

Note:TorunalogonscriptinSecureCRT,youmustfirstturnofftheAutomatelogonoptionintheConnection/LogonActionscategoryoftheSessionOptionsdialogandthen,onthesamedialog,checktheLogonscriptcheckboxandchoosethescriptthatyouwanttorun.Note2:Ascriptcannotberunfromanotherscript.Thisincludesscriptsstartedmanuallyandlogonscripts.

ScriptsforSecureCRTaretextfilesthatyoucreatewithyourtexteditor.AscriptheaderisnotrequiredforPythonscriptsaslongasthefileextension“.py”isused.Ifyouwanttouseaheader(forexample,ifyouareusingafilewithoutanextensionorwithanextensionthatisnotcommon),thentheheadermustbeginonthefirstlineofthescript.ScriptheaderswillbeusedbySecureCRTtoidentifywhichscriptlanguagethescriptiswritteninandtheversionofSecureCRTscriptinginterface.Eachlineofthescriptheadermustbeginwithapound/hash(#)character.ASecureCRTscriptheaderincludesa$languagelinethatidentifiesthescriptengineandan$interfacelinetoidentifySecureCRT'sinterfaceversion.Thesyntaxofthescriptheaderisalwaysthesameregardlessofthescriptlanguageyouareusing.AsimplebutcompleteSecureCRTscriptwithaheaderthatidentifiesitasPythonisshownbelow:

#$language="Python"#$interface="1.0"defmain():#DisplaySecureCRT'sversioncrt.Dialog.MessageBox("SecureCRTversionis:"+crt.Version)main()Note:ASecureCRTscriptheadermayalsocontainblanklinesthatbeginwith#.

Thequotedstringfollowing$languageidentifiesthescriptengine.ForPythonscripts,theappropriateidentifierisPython.Currentlythescriptheadershouldspecifyversion1.0for$interface.FutureversionsofSecureCRTmaysupportotherversionsItisnotarequirementthatyouplaceyourcodewithinamainroutinehowevertheremaybereasonswhyyouwouldwanttodothis.ThePythoninterpreterwillparseandexecuteglobalscriptcode(scriptcodeyouhavedefinedoutsideofanysubroutine)beforeyourmainisexecuted.Ifyouhave"initialization"codethatyouwanttoensurehasbeencompletelyexecutedbeforeyouractualscriptcodebegins,itmaybeusefultoplaceyourinitializationcodeatthegloballevel.Thiswillensurethatyourinitializationcodewillallexecutebeforeyourmaincoderuns.Anotherreasonyoumaywantamainroutineistoallowyourscriptsawayofabortingthemselvesincaseofproblems.InPythonforSecureCRT,thereisnobuilt-inwayofexitingascriptatthegloballevel.However,ifyouwanttoexitasubroutineitispossibletousethereturnsyntaxtodoso.Forexample:

defmain():condition=DoSomething()if(condition==0):#Error,bailoutreturnmain()

ForexamplesofSecureCRTscripts,seethesamplescriptsontheVanDykeSoftwarewebsiteintheScriptingFAQsection.ManyexcellentPythonresourcescanbefoundontheInternet.Hereareafewyoumayfinduseful:

http://docs.python.org/reference/index.html

http://diveintopython.org

http://wiki.python.org/main/BeginnersGuide

HandlingScriptErrors

Whenscripting,SecureCRTprovidesseveralApplicationscriptmethodstoaidyouinmanagingerrors.ThefirstisGetLastError.Thismethodreturnstheerrorcodeofthescriptexceptionthatmostrecentlyhappened.ThenextmethodisGetLastErrorMessage,whichreturnstheerrortextofthescriptexceptionthatmostrecentlyhappened.And,tohelpyoudeterminewhereanerrorcamefrom,SecureCRTsupportstheClearLastError,methodwhichresetstheresponsefromGetLastErrorandGetLastErrorMessagetoERROR_SUCCESSand"Theoperationcompletedsuccessfully."

OverviewofSecureCRTScriptObjects

ScriptsinteractwithSecureCRTbyinvokingpropertiesandmethodsonSecureCRT's"top-level"orApplicationobjectorbyinvokingthepropertiesandmethodson"sub-objects"availablethroughSecureCRT'sapplicationobject.SecureCRT'sapplicationobjectisaccessedinscriptswiththename‘crt’.PropertiesandmethodsonSecureCRT'ssub-objectsmaybeaccessedbycreatingareferencetoasub-object,orthroughtheuseofVBScript’smultipledotsyntax.Forexample:

DimdlgSetdlg=crt.Dialogdlg.Prompt("Login:")

InPython,thelineswouldlooklike:dlg=crt.Dialogdlg.Prompt("Login:")

Or,inVBScriptandPython,withoutcreatingthereference:crt.Dialog.Prompt("Login:")

ForacompletereferencetoallSecureCRTscriptobjects,seethe"ScriptObjectsReference"sectioninthisbook.

SendKeysKeystrokeTable

Somekeystrokesdonotgeneratecharacters(suchasENTERandTAB).Somekeystrokesrepresentactions(suchasBACKSPACEandBREAK).Tosendthesekindsofkeystrokes,sendtheargumentsshowninthefollowingtable:

Key Argument

BACKSPACE{BACKSPACE},{BS},or{BKSP}

BREAK {BREAK}

CAPSLOCK {CAPSLOCK}

DELorDELETE {DELETE}or{DEL}

DOWNARROW {DOWN}

END {END}

ENTER {ENTER}or~

ESC {ESC}

HELP {HELP}

HOME {HOME}

INSorINSERT {INSERT}or{INS}

LEFTARROW {LEFT}

NUMLOCK {NUMLOCK}

PAGEDOWN {PGDN}

PAGEUP {PGUP}

PRINTSCREEN {PRTSC}

RIGHTARROW {RIGHT}

SCROLLLOCK {SCROLLLOCK}

TAB {TAB}

UPARROW {UP}

F1,F2,...F16 {F1},{F2},...{F16}

0,1,...9onnumberpad

{NUM_0},{NUM_1},...{NUM_9}

.onnumberpad {NUM_.}

/onnumberpad {NUM_/}

*onnumberpad {NUM_*}

-onnumberpad {NUM_-}

+onnumberpad {NUM_+}

ENTERonnumberpad

{NUM_ENTER}

HOMEonnumberpad

{NUM_HOME}

PAGEUPonnumberpad

{NUM_PGUP}

ENDonnumberpad {NUM_END}

PAGEDOWNonnumberpad

{NUM_PGDN}

UPARROWonnumberpad

{NUM_UP}

DOWNARROWonnumberpad

{NUM_DOWN}

LEFTARROWonnumberpad

{NUM_LEFT}

RIGHTARROWonnumberpad

{NUM_RIGHT}

ApplicationObject

Description

Top-levelobject.ProvidesaccesstoallofSecureCRT'spropertiesandmethods.

Syntax

crt.Property[=expression]crt.Method([arglist])

Remarks

ThenamecrtisusedtoaccessallofSecureCRT'stop-levelpropertiesandmethods.Someofthesetop-levelpropertiesreturnreferencestootherobjects.WhenascriptisrunbySecureCRTitisnotnecessarytocreatethecrtobject.Itisautomaticallypartofthescriptnamespace.

ApplicationObjectPropertiesandMethodsProperties Methods

ActivePrinter ClearLastErrorArguments GetActiveTabClipboard GetLastErrorDialog GetLastErrorMessageFileTransfer GetScriptTabScreen GetTabCountScriptFullName GetTabSession OpenSessionConfigurationVersion QuitWindow SleepProperties

ActivePrinter

DescriptionReturnsorsetsthenameoftheactiveprinter.

RemarksRead/Writestringproperty.

VBScriptSyntax

crt.ActivePrinter[=printerName]Example

Ifcrt.ActivePrinter<>"\\SERVER\InkJet2"Thencrt.ActivePrinter="\\SERVER\InkJet2"MsgBox"UpdatedPrinter"

EndIfPython

Syntaxcrt.ActivePrinter[=printerName]

Exampleifcrt.ActivePrinter!="\\SERVER\InkJet2":crt.ActivePrinter="HPLaserJet8000SeriesPCL5"crt.Dialog.MessageBox("UpdatedPrinter")

Arguments

DescriptionReturnsareferencetoSecureCRT'sArgumentsobject.

RemarksInVBScript,objectvariablesassignedfromtheArgumentspropertyrequirethe"Set"syntax.SeetheArgumentsobjectdocumentationforadescriptionofitsproperties.

VBScriptSyntax

Setobject=crt.ArgumentsPython

Syntaxobject=crt.Arguments

Clipboard

DescriptionReturnsareferencetoSecureCRT'sClipboardobject.

Remarks

InVBScript,objectvariablesassignedfromtheClipboardpropertyrequirethe"Set"syntax.SeetheClipboardobjectdocumentationforadescriptionofitsproperties.

VBScriptSyntax

Setobject=crt.ClipboardPython

Syntaxobject=crt.Clipboard

Dialog

DescriptionReturnsareferencetoSecureCRT'sDialogobject.

RemarksInVBScript,objectvariablesassignedfromtheDialogpropertyrequirethe"Set"syntax.SeetheDialogobjectdocumentationforadescriptionofitspropertiesandmethods.

VBScriptSyntax

Setobject=crt.DialogPython

Syntaxobject=crt.Dialog

FileTransfer

DescriptionReturnsareferencetoSecureCRT'sFileTransferobject.

RemarksInVBScript,objectvariablesassignedfromtheFileTransferpropertyrequirethe"Set"syntax.SeetheFileTransferobjectdocumentationforadescriptionofitspropertiesandmethods.

VBScriptSyntax

Setobject=crt.FileTransferPython

Syntaxobject=crt.FileTransfer

ScreenDescription

ReturnsareferencetoSecureCRT'sScreenobject.Remarks

InVBScript,objectvariablesassignedfromtheScreenpropertyrequirethe"Set"syntax.SeetheScreenobjectdocumentationforadescriptionofitspropertiesandmethods.

VBScriptSyntax

Setobject=crt.ScreenPython

Syntaxobject=crt.Screen

ScriptFullName

DescriptionReturnsthefullpathandfilenameofthecurrentlyrunningscript.

RemarksNone.

VBScriptSyntax

Setobject=crt.ScriptFullNamePython

Syntaxobject=crt.ScriptFullName

Session

DescriptionReturnsareferencetoSecureCRT'sSessionobject.

RemarksInVBScript,objectvariablesassignedfromtheSessionpropertyrequirethe"Set"syntax.SeetheSessionobjectdocumentationforadescriptionofitspropertiesandmethods.

VBScriptSyntax

Setobject=crt.SessionPython

Syntax

object=crt.Session

VersionDescription

ReturnsastringcontainingSecureCRT'sversion.Remarks

Read-onlystringpropertyVBScript

Syntaxcrt.Version

ExampleMsgBox"TheversionofSecureCRTis:"&crt.Version

PythonSyntax

crt.VersionExample

crt.Dialog.MessageBox("TheversionofSecureCRTis:"+crt.Version)

Window

DescriptionReturnsareferencetoSecureCRT'sWindowobject.

RemarksInVBScript,objectvariablesassignedfromtheWindowpropertyrequirethe"Set"syntax.SeetheWindowobjectdocumentationforadescriptionofitspropertiesandmethods.

VBScriptSyntax

Setobject=crt.WindowPython

Syntaxobject=crt.Window

Methods

ClearLastErrorDescription

ResetstheresponsefromGetLastErrorand

GetLastErrorMessagetoERROR_SUCCESSand"Theoperationcompletedsuccessfully."

RemarksThisisintendedtobeusedinconjunctionwithGetLastErrorMessagesothattheusercandeterminewheretheerrorcamefrom.

VBScriptSyntax

crt.ClearLastErrorPython

Syntaxcrt.ClearLastError()

GetActiveTab

DescriptionReturnstheTabobjectassociatedwiththetabortiledsessionwindowthatiscurrentlyselectedintheGUI.

RemarksNone.

VBScriptSyntaxSetobject=crt.GetActiveTab

PythonSyntax

object=crt.GetActiveTab()

GetLastErrorDescription

Returnstheerrorcodeofthescriptexceptionthatmostrecentlyhappened.

RemarksThisismostusefulwhenthescriptisinthe"resumenext"errormode,meaningthescriptkeepsexecutingeveniferrorshappen.

VBScriptSyntaxvarname=crt.GetLastError

Example

SubMain()

onerrorresumenext

CRT.Session.ConnectInTab("nowhere")

errcode=crt.GetLastError

crt.Dialog.MessageBox"ErrorCode:"&

errcode

EndSub

PythonSyntax

varname=crt.GetLastError()Example

defmain():try:crt.Session.ConnectInTab("nowhere")exceptScriptError:errcode=crt.GetLastError()crt.Dialog.MessageBox("ErrorCode:"+str(errcode))main()

GetLastErrorMessage

DescriptionReturnstheerrortextofthescriptexceptionthatmostrecentlyhappened.

RemarksThisismostusefulwhenthescriptisinthe"resumenext"errormode,meaningthescriptkeepsexecutingeveniferrorshappen.

VBScriptSyntaxvarname=crt.GetLastErrorMessge

ExampleSubMain()

onerrorresumenext

CRT.Session.ConnectInTab("nowhere")

errmsg=crt.GetLastErrorMessage

crt.Dialog.MessageBox"ErrorMessage:"&

errmsg

EndSub

Thisexamplewoulddisplay:ErrorMessage:Connectionfailed

PythonSyntax

varname=crt.GetLastErrorMessage()Exampledefmain():

try:

crt.Session.ConnectInTab("nowhere")

exceptScriptError:

errmsg=crt.GetLastErrorMessage()

crt.Dialog.MessageBox("ErrorMessage:"+

errmsg)

main()

Thisexamplewoulddisplay:ErrorMessage:Connectionfailed

GetScriptTab

DescriptionReturnsthetabortiledsessionwindowfromwhichthescriptwasstarted.

RemarksNone.

VBScriptSyntaxSetobject=crt.GetScriptTab

ExampleSetScriptTab=crt.GetScriptTabMsgBox"Tabwhichstartedthisscriptistabnumber:"&ScriptTab.index

PythonSyntax

object=crt.GetScriptTab()ExampleScriptTab=crt.GetScriptTab()

crt.Dialog.MessageBox("Tabwhichstartedthis

scriptistabnumber:"+

str(ScriptTab.Index))

GetTabCount

DescriptionReturnsthenumberoftabsortiledsessionwindows(connectedornot)thatexistinthecurrentSecureCRTwindow.

RemarksReturnvaluewillalwaysbegreaterthan0(zero).

VBScriptSyntax

varname=crt.GetTabCountPython

Syntaxvarname=crt.GetTabCount()

GetTab

DescriptionReturnsthetabobjectofthespecifiedindex.

RemarksThisdoesnotbringthetabortiledsessionwindowtotheforeground.Whensessionsaretabbed,theindexforeachtabobjectmatchesitspositioninthetabbar.Whensessionsaretiled,theindexesofthetabobjectsmaynotmatchtheindexeswhentabbed,butwillremainconsistentwhilethesessionsaretiled.

VBScriptSyntax

Setobject=crt.GetTab(arg)Python

Syntaxvarname=crt.GetTab(arg)

OpenSessionConfiguration

DescriptionLoadstheconfigurationforthespecifiedsession.

RemarksSessionPathisastringparameterthatistherelativepathof

thesession.ReturnsaConfigobject.IfSessionPathisnotspecified,theDefaultsession'sconfigurationobjectisreturned.Toaccessthesessionconfigurationassociatedwithanactiveconnection,usecrt.Session.ConfigorobjTab.Session.Config.

VBScriptSyntax

Setobject.OpenSessionConfiguration[SessionPath]ExampleSetobjConfig1=

crt.OpenSessionConfiguration("Routers\Telnet\Session1")

SetobjDConfig=

crt.OpenSessionConfiguration("Default")

PythonSyntax

object.OpenSessionConfiguration([SessionPath])ExampleobjConfig1=

crt.OpenSessionConfiguration("Routers\Telnet\Session1")

objDConfig=

crt.OpenSessionConfiguration("Default")

Quit

DescriptionCausesSecureCRTtoexit.

RemarksAscriptthatinvokesQuitwillbeterminatedimmediatelyandcauseSecureCRTtoexit.

VBScriptSyntax

crt.QuitPython

Syntaxcrt.Quit()

Sleep

DescriptionSpecifiesthetime(inmilliseconds)topausethescript's

execution.Remarks

TheamountoftimethatittakestoexecutetheSleep()methoditselfisafactorinhowlongthescriptpauses.Therefore,theaccuracyofinvokingSleepwithsmallvaluesof1or10millisecondswillbeaffectedbythisoverhead.

VBScriptSyntax

crt.SleepmillisecExample'SendaCRandpauseforonesecond

crt.Screen.SendvbCr

crt.Sleep1000

PythonSyntax

crt.Sleep(millisec)Example#Sendanewlineandpauseforonesecond

crt.Screen.Send("\n")

crt.Sleep(1000)

ArgumentsObject

Description

TheArgumentsobjectallowsscriptstoaccessargumentsthatarepassedtothescriptbyoneormoreSecureCRT/ARGcommand-lineoptions.

Syntax

crt.Arguments.Propertycrt.Arguments.Method(arg)

Remarks

TheSecureCRT/ARGcommand-lineoptionallowsyoutowritecommonscriptswherespecificvaluesusedbythescripts(suchasahostnameorport)arepassedtothescriptthroughtheSecureCRTcommandline.Scriptargumentsarepassedasanargumenttoeach/ARG<argument>option.

ArgumentsObjectPropertiesandMethodsProperties Methods

Count GetArg

Properties

CountDescription

ReturnsthenumberofargumentspassedtoSecureCRTusingSecureCRT's/ARGcommand-lineoption.

RemarksRead-onlynumericproperty.IfSecureCRTisstartedwithno/ARGcommand-lineoptions,thecrt.Arguments.Countpropertyissetto0.

VBScriptSyntax

crt.Arguments.Count

PythonSyntaxcrt.Arguments.Count

Methods

GetArgDescription

Returnstheargumentdataassociatedwitheach/ARGcommand-lineoptionpassedtoSecureCRT.

RemarksTheGetArgmethodreturnsthedatapassedtoSecureCRT.ThefirstargumentpassedtoSecureCRTisretrievedbycallingGetArg(0).Thelastargumentisretrievedbypassingthecountreturnedbycrt.Arguments.Countminus1.

Note:TheGetArgmethodisthedefaultmethodontheArgumentsobjectthereforeitwillbeinvokedimplicitlyifitisnotnamed.Thismeansthefollowingtwostatementsareequivalent:

MsgBoxcrt.Arguments.GetArg(0)MsgBoxcrt.Arguments(0)

VBScriptSyntax

crt.Arguments.GetArg(number)Example

#$language="VBScript"#$interface="1.0"SubMain()'ThisscriptshouldberunbySecureCRTthathastwo'/ARGparametersforahostnameandport,forexample:''SecureCRT.exe/ARGmyhostname/ARG5555

'Detectlackofarguments.Ifcrt.Arguments.Count<>2ThenMsgBox"Thisscriptrequireshostnameandportarguments"ExitSubEndIf'MsgBox"Connectingtohostname:"&crt.Arguments(0)MsgBox"Connectingtoport:"&crt.Arguments(1)...EndSub

Python

Syntaxcrt.Arguments.GetArg(number)

Example#$language="Python"#$interface="1.0"defmain():#ThisscriptassumesthatSecureCRTwasrunwithtwo#/ARGparametersforahostnameandport,suchas:##SecureCRT.exe/ARGmyhostname/ARG5555#Detectlackofarguments.ifcrt.Arguments.Count!=2:crt.Dialog.MessageBox("Thisscriptrequireshostnameandport"+"arguments")returncrt.Dialog.MessageBox("Connectingtohostname:"+crt.Arguments[0])crt.Dialog.MessageBox(

"Connectingtoport:"+crt.Arguments[1])...main()

ClipboardObject

Description

TheClipboardobjectprovidesaccesstotheapplication'sclipboard.Syntax

crt.Clipboard.Property[=expression]ClipboardObjectPropertiesProperties

FormatCF_OEMTEXTCF_TEXTCF_UNICODETEXTDEFAULTFORMATVDS_TEXTTextProperties

FormatDescription

Returnsorsetstheclipboardformat.Remarks

PossibleformatsonWindowsare:CF_TEXT,CF_OEMTEXT,CF_UNICODETEXT,andVDS_TEXT.PossibleformatsonMacare:CF_UNICODETEXTandVDS_TEXT.Thefollowingcommandrestoresthevaluetotheglobalformatfortheclipboard:crt.Clipboard.Format=

crt.Clipboard.DEFAULTFORMAT

VBScript

Example#$language="VBScript"

#$interface="1.0"

crt.Screen.Synchronous=True

SubMain

'Getthecurrentclipboardformat

format=crt.Clipboard.Format

'SettheclipboardformattoVDS_TEXT:

crt.Clipboard.Format=

crt.Clipboard.VDS_TEXT

'Restoretheoriginalclipboardformat

crt.Clipboard.Format=format

EndSub

PythonExample#$language="Python"

#$interface="1.0"

crt.Screen.Synchronous=True

defmain():

#Getthecurrentclipboardformat

format=crt.Clipboard.Format

#SettheclipboardformattoVDS_TEXT:

crt.Clipboard.Format=

crt.Clipboard.VDS_TEXT

#Restoretheoriginalclipboardformat

crt.Clipboard.Format=format

main()

CF_OEMTEXTDescription

Read-onlypropertythatreturnstheformatstringforCF_OEMTEXTclipboardformat.ThistextformatcontainscharactersintheOEMcharacterset.Eachlineendswithacarriagereturn/linefeed(CR-LF)combination.Anullcharactersignalstheendofthedata.

NoteThisformatisonlysupportedonWindows.

VBScript

Syntaxvar=crt.clipboard.CF_OEMTEXT

PythonSyntaxvar=crt.clipboard.CF_OEMTEXT

CF_TEXT

DescriptionRead-onlypropertythatreturnstheformatstringforCF_TEXTclipboardformat.Inthistextformat,eachlineendswithacarriagereturn/linefeed(CR-LF)combination.Anullcharactersignalstheendofthedata.UsethisformatforANSItext.

NoteThisformatisonlysupportedonWindows.

VBScriptSyntaxvar=crt.clipboard.CF_TEXT

PythonSyntaxvar=crt.clipboard.CF_TEXT

CF_UNICODETEXT

DescriptionRead-onlypropertythatreturnstheformatstringforCF_UNICODETEXTclipboardformat.ForWindows:InUnicodetextformat,eachlineendswithacarriagereturn/linefeed(CR-LF)combination.Anullcharactersignalstheendofthedata.

VBScriptSyntaxvar=crt.clipboard.CF_UNICODETEXT

PythonSyntaxvar=crt.clipboard.CF_UNICODETEXT

DEFAULTFORMATDescription

Read-onlyPropertythatreturnstheformatstringfor

DEFAULTFORMATclipboardformat.Settingtheformattothispropertyrestoresthevaluetotheglobaldefaultformatfortheclipboard.

VBScriptSyntaxvar=crt.clipboard.DEFAULTFORMAT

PythonSyntaxvar=crt.clipboard.DEFAULTFORMAT

VDS_TEXT

DescriptionRead-onlypropertythatreturnstheformatstringforVDS_TEXTclipboardformat.ThisisaprivateclipboardformatthattranslatescertainspecialcharacterstoASCIIwhencopyingdatafromthescreentotheclipboard.Thecharactersthataretranslatedareasfollows:

·directionalquotationmarks(alsoknownas"smartquotes")arechangedtoASCIIquotationmarks

·"em"dashesarechangedtohyphens·"en"dashesarechangedtohyphens

VBScriptSyntaxvar=crt.clipboard.VDS_TEXT

PythonSyntaxvar=crt.clipboard.VDS_TEXT

Text

DescriptionReturnsorsetsthecontentsoftheclipboard.

VBScriptSyntaxcrt.clipboard=varname

[varname=]crt.clipboard

Example#$language="VBScript"

#$interface="1.0"

'Puttheselectedtextintotheclipboard:

crt.Clipboard.Text=crt.Screen.Selection

'Transfertextfromtheclipboardintoa

variablefor

'usewithinthescript:

MyStr=crt.Clipboard.Text

'Sendthecontentsoftheclipboardtothe

remote

'machine:

crt.Screen.Sendcrt.Clipboard.Text

PythonSyntaxcrt.clipboard=varname

[varname=]crt.clipboard

Example#$language="Python"

#$interface="1.0"

#Puttheselectedtextintotheclipboard:

crt.Clipboard.Text=crt.Screen.Selection

#Transfertextfromtheclipboardintoa

variablefor

#usewithinthescript:

MyStr=crt.Clipboard.Text

#Sendthecontentsoftheclipboardtothe

remote

#machine:

crt.Screen.Send(crt.Clipboard.Text)

DialogObject

Description

TheDialogobjectprovidesaccesstosimpleuser-interfacefeaturesprovidedbySecureCRT.

Syntax

crt.Dialog.Method([arglist])Remarks

SecureCRT'sDialogobjectisaccessedthroughthetop-levelobject’sDialogproperty.

DialogObjectMethodsMethods

FileOpenDialogMessageBoxPromptMethods

FileOpenDialogDescription

Displayafilebrowsedialogfromwhichtheusercanselectasinglefile.

RemarksIfthedefaultFilenameparameterissimplyafilename(nopathprovided),thefiledialogbrowserwillopenincurrentworkingdirectory.IfthedefaultFilenameparameterspecifiesanabsolutepathtoafile,thefiledialogbrowserwillopenintheparentdirectoryofthefile.Thefilenamefilterisinthefollowingformat:<NameofFilter>(*.<extension>)|*.

<extension>||

Forexample:TextFiles(*.txt)|*.txt||

orTextFiles(*.txt)|*.txt|LogFile

(*.log)|*.log||

TheFileOpenDialogmethodreturnsthepathtotheselectedfile.

VBScriptSyntax

crt.Dialog.FileOpenDialog([title,[buttonLabel,[defaultFilename,[filter]]]])

Examples'BrowseforafileofanytypefilePath=crt.Dialog.FileOpenDialog("Pleaseselectafile")'Browseforonly.txtfilesfilePath=crt.Dialog.FileOpenDialog("Pleaseselectatextfile","Open","","TextFiles(*.txt)|*.txt||")

PythonSyntax

crt.Dialog.FileOpenDialog([title,[buttonLabel,[defaultFilename,[filter]]]])

Examples#BrowseforafileofanytypefilePath=crt.Dialog.FileOpenDialog(title="Pleaseselectafile")#Browseforonly.txtfilesfilePath=crt.Dialog.FileOpenDialog(title="Pleaseselectatextfile",filter="TextFiles(*.txt)|*.txt||")

MessageBox

DescriptionDisplayamessage

RemarksTheMessageBoxfunctiondisplaysamessagestringtotheuser.Theoptionaltitlestringsetsthetitleorcaptionofthe

MessageBox.ThebuttonsthatappearontheMessageBoxcanbeconfiguredbypassingacombinationofnumericvaluesintheoptional‘buttons’parameter.BydefaultMessageBoxwilldisplaythemessagestringwithanOKbutton.However,manypossibilitiesexistfordisplayingmessageboxeswithdifferenticons,andbuttons.TheMessageBoxfunctionreturnsanumericvaluethatcanbeusedtoidentifywhichbuttonwasclicked.

VBScriptSyntax

crt.Dialog.MessageBox(message[,title[,buttons]])Example

Thefollowingcodesampledefinestheconstantsthatcanbecombinedtoformthe"button"parameteraswellasthepossiblenumericreturnvalues:'buttonparameteroptions

ConstICON_STOP=16'displaytheERROR/STOPicon.ConstICON_QUESTION=32'displaythe'?'iconConstICON_WARN=48'displaya'!'icon.ConstICON_INFO=64'displays"info"icon.

ConstBUTTON_OK=0'OKbuttononlyConstBUTTON_CANCEL=1'OKandCancelbuttonsConstBUTTON_ABORTRETRYIGNORE=2'Abort,Retry,andIgnorebuttonsConstBUTTON_YESNOCANCEL=3'Yes,No,andCancelbuttonsConstBUTTON_YESNO=4'YesandNobuttonsConstBUTTON_RETRYCANCEL=5'RetryandCancel

ConstDEFBUTTON1=0'FirstbuttonisdefaultConstDEFBUTTON2=256'SecondbuttonisdefaultConstDEFBUTTON3=512'Thirdbuttonisdefault

'PossibleMessageBox()returnvaluesConstIDOK=1'OKbuttonclickedConstIDCANCEL=2'CancelbuttonclickedConstIDABORT=3'AbortbuttonclickedConstIDRETRY=4'RetrybuttonclickedConstIDIGNORE=5'IgnorebuttonclickedConstIDYES=6'Yesbuttonclicked

ConstIDNO=7'Nobuttonclicked

'DisplayamessageboxwithYes/Nobuttons.'Makethe'No'buttonthedefault.result=crt.Dialog.MessageBox("LoginFailed,Retry?","Error",ICON_QUESTIONOrBUTTON_YESNOIfresult=IDNOThenExitSubEndIf

PythonSyntax

crt.Dialog.MessageBox(message[,title[,buttons]])Example

Thefollowingcodesampledefinestheconstantsthatcanbecombinedtoformthe"button"parameteraswellasthepossiblenumericreturnvalues:#buttonparameteroptions

ICON_STOP=16#displaythe

ERROR/STOPicon.

ICON_QUESTION=32#displaythe

'?'icon

ICON_WARN=48#displaya

'!'icon.

ICON_INFO=64#displays

"info"icon.

BUTTON_OK=0#OKbutton

only

BUTTON_CANCEL=1#OKand

Cancelbuttons

BUTTON_ABORTRETRYIGNORE=2#Abort,

Retry,andIgnorebuttons

BUTTON_YESNOCANCEL=3#Yes,No,

andCancelbuttons

BUTTON_YESNO=4#YesandNo

buttons

BUTTON_RETRYCANCEL=5#Retryand

Cancelbuttons

DEFBUTTON1=0#Firstbuttonis

default

DEFBUTTON2=256#Secondbuttonis

default

DEFBUTTON3=512#Thirdbuttonis

default

#PossibleMessageBox()returnvalues

IDOK=1#OKbuttonclicked

IDCANCEL=2#Cancelbutton

clicked

IDABORT=3#Abortbuttonclicked

IDRETRY=4#Retrybuttonclicked

IDIGNORE=5#Ignorebutton

clicked

IDYES=6#Yesbuttonclicked

IDNO=7#Nobuttonclicked

#DisplayamessageboxwithYes/Nobuttons.

#Makethe'No'buttonthedefault.

result=crt.Dialog.MessageBox("Login

Failed,Retry?","Error",ICON_QUESTION|

BUTTON_YESNO|DEFBUTTON2)

ifresult==IDNO:

return

Prompt

DescriptionPromptausertoenterastring.

RemarksThePromptfunctiondisplaysasimpledialogthathasmessageandaneditfieldfortheusertoenterastring.Themessageparameterisaninformationalstringdisplayedinthepromptdialog.Optionallythetitleofthepromptdialogmaybesetbypassingatitlestring.Bydefaulttheeditfieldisempty,buttheinitialcontentsoftheeditfieldmaybesetwiththeoptionaldefaultstring.Finally,ifthetextenteredintheeditfieldistobeobscuredasitisentered(suchaswhenenteringapassword)

thentheBooleanisPasswordfieldshouldbesettoTrue.IftheuserclicksOK,Promptreturnstheenteredstring;whereas,iftheuserclicksCancel,Promptreturnsanemptystring.

VBScriptSyntax

crt.Dialog.Prompt(message[,title[,default[,isPassword]]])Example

Dimpasspass=crt.Dialog.Prompt("Enteryourpassword:","LogonScript","",True)Ifpass=""Then'UserclickedCancelbuttonElse'UseraddeddataEndIf

PythonSyntax

crt.Dialog.Prompt(message[,title[,default[,isPassword]]])Example

password=crt.Dialog.Prompt("Enteryourpassword:","LogonScript","",True)ifpassword=="":#UserclickedCancelbuttonelse:#Useraddeddata

FileTransferObject

Description

TheFileTransferobjectprovidesmethodsforperformingfiletransfersinitiatedbyscripts.

Syntax

crt.FileTransfer.Method([arglist])crt.FileTransfer.Property[=varname]

Remarks

SecureCRT'sFileTransferobjectisaccessedthroughthetop-levelobject’sFileTransferproperty.

FileTransferObjectPropertiesandMethods Properties Methods

DownloadFolder AddToZmodemUploadList

ZmodemUploadAscii SendXmodem

ReceiveXmodem

Properties

DownloadFolderDescription

Returnspathforsessiondownloadfolder.Remarks

DownloadFolderisaread-onlypropertythatreturnsthepathforthecurrentsession'sdownloadfolder.Note,filesdownloadedwitheitherXmodemorZmodemarealwaysplacedinthesession'sdownloadfolder.Scriptscanusethispropertytodeterminethelocationofthedownloadedfiles.

VBScriptSyntax

crt.FileTransfer.DownloadFolder

ExampleMsgBox"Downloadcompletedto:"&vblf&crt.FileTransfer.DownloadFolder

PythonSyntax

crt.FileTransfer.DownloadFolderExample

crt.Dialog.MessageBox("Downloadcompletedto:\n"+crt.FileTransfer.DownloadFolder)

ZmodemUploadAsciiDescription

SpecifiesASCIIorbinarymodeforZmodemuploads.Remarks

ZmodemUploadAsciispecifieswhetherfilesuploadedusingZmodemwillbeinASCIIorbinaryformat.WhenZmodemUploadAsciiissetto"true",uploadswillbemadeinASCII.AfteryouhaverunascriptthatsetstheZmodemUploadAsciioptiontotrue,thatsettingwillbesavedasasessionoptionuntilitischangedbackeitherbyrunninganotherscriptthatresetsittofalseorbychangingtheoptionintheSelectFilestoSendusingZmodemdialog.Ifnoargumentisspecifiedforthisproperty,thecurrentvalueisreturned.

NoteForthisoptiontoworkproperly,theinstallationofZmodemontheremotemachinemustbeabletoconvertASCIItousethelocalconventionforlinetermination.

VBScriptSyntax

crt.FileTransfer.ZmodemUploadAscii=[True|False]Example

#$language="VBScript"#$interface="1.0"OptionexplicitDimszPromptszPrompt="->"

crt.screen.synchronous=True'ZmodemASCIIuploadscrt.FileTransfer.AddToZmodemUploadList"c:\temp\File1.txt"crt.FileTransfer.AddToZmodemUploadList"c:\temp\File2.txt"crt.FileTransfer.AddToZmodemUploadList"c:\temp\anotherFile.txt"'LetCRTknowthatwewantthesefilestobetransferredasASCIIcrt.FileTransfer.ZmodemUploadAscii=True'StarttheZmodemuploadcrt.Screen.Send"rz"&vbCR'Waitfortransfertocompletecrt.Screen.WaitForStringszPrompt'ResetASCIIflagcrt.FileTransfer.ZmodemUploadAscii=False

PythonSyntax

crt.FileTransfer.ZmodemUploadAscii=[True|False]Example

#$language="Python"#$interface="1.0"crt.Screen.Synchronous=True#ZmodemASCIIuploadscrt.FileTransfer.AddToZmodemUploadList("c:\\temp\\File1.txt")crt.FileTransfer.AddToZmodemUploadList("c:\\temp\\File2.txt")crt.FileTransfer.AddToZmodemUploadList("c:\\temp\\anotherFile.txt")#LetCRTknowthatwewantthesefilestobetransferredasASCIIcrt.FileTransfer.ZmodemUploadAscii=True#StarttheZmodemupload

crt.Screen.Send("rz\n")#Waitfortransfertocompletecrt.Screen.WaitForString("->")#ResetASCIIflagcrt.FileTransfer.ZmodemUploadAscii=False

Methods

AddToZmodemUploadListDescription

PlacesfileonZmodemuploadlist.Remarks

AddToZmodemUploadListplacesthespecifiedfileonalistoffilesthatwillbeuploadedduringthenextZmodemupload.Onceoneormorefileshavebeenaddedtotheuploadlist,aZmodemuploadcanbeinitiatedbythescriptsendingtheappropriatecommandtotheremotesystem.Errors:IfthepathprovidedtoAddToZmodemUploadListisnotavalidfile,ascripterrorisgeneratedandthefollowingmessageisdisplayed:

"FileTransfer.AddToZmodemUploadList:<filepath>doesnotexist."

VBScriptSyntax

crt.FileTransfer.AddToZmodemUploadListfilepathExamplecrt.FileTransfer.AddToZmodemUploadList

"c:\temp\File1.txt"

crt.FileTransfer.AddToZmodemUploadList

"c:\temp\File2.txt"

'Starttheuploadofthetwofiles...

crt.Screen.Send"rz"&vbCR

PythonSyntax

crt.FileTransfer.AddToZmodemUploadList(filepath)Examplecrt.FileTransfer.AddToZmodemUploadList("c:\\temp\\File1.txt")

crt.FileTransfer.AddToZmodemUploadList("c:\\temp\\File2.txt")

#Starttheuploadofthetwofiles...

crt.Screen.Send("rz\n")

SendXmodem

DescriptionSendsspecifiedfile.

RemarksSendXmodemsendsthespecifiedfileusingtheXmodemprotocol.Thefullpathtothefilemustbespecified.Note,theappropriateXmodemreceivecommandshouldbesentorinitiatedontheremotesystembeforeexecutingSendXmodemforthetransfertobeginproperly.Errors:1.IftheSendXmodemmethodisexecutedwhilenotconnectedthefollowingscripterrorisgenerated:

"FileTransfer.SendXmodem:notconnected"2.IfthepathprovidedtoSendXmodemisnotavalidfilethenascripterrorisgeneratedandthefollowingmessageisdisplayed:

"FileTransfer.SendXmodem:<filepath>doesnotexist."

VBScriptSyntax

crt.FileTransfer.SendXmodemfilepath

Example'uploadC:\temp\myFile.txtusingXmodemcrt.Screen.Send"rxmyFile.txt"&vbCRcrt.Screen.WaitForString"readytoreceive"crt.FileTransfer.SendXmodem"C:\temp\myFile.txt"

PythonSyntax

crt.FileTransfer.SendXmodem(filepath)Example

#uploadC:\temp\myFile.txtusingXmodemcrt.Screen.Send("rxmyFile.txt\n")crt.Screen.WaitForString("readytoreceive")crt.FileTransfer.SendXmodem("C:\\temp\\myFile.txt")

ReceiveXmodem

DescriptionInitiatesfiledownloadtodownloadfolder.

RemarksReceiveXmodeminitiatesanXmodemdownloadofafileandsavesthefileasthespecifiedfilenameinthesession'sdownloadfolder.Downloadedfilesarealwaysplacedinthesession'sdownloadfolder.NotethattheXmodemsendcommandshouldbesentorinitiatedontheremotesystembeforeexecutingReceiveXmodemforthetransfertoproceedproperly.Errors:1.IftheReceiveXmodemmethodisexecutedwhilenotconnected,thefollowingscripterrorisgenerated:

"FileTransfer.ReceiveXmodem:notconnected"2.IfafilenamepassedtoReceiveXmodemisnotasimplefilename(i.e.,ifitisapathorcontainspathseparators),thefollowingscripterrorwillbegenerated:

"FileTransfer.ReceiveXmodem:Invalidfilename\"%s\".Argumentshouldnotincludepathinformation."

VBScript

Syntaxcrt.FileTransfer.ReceiveXmodemfilepath

Examplecrt.Screen.Send"sx-XmyFile.txt"&vbCR'CustomizethewaitstringbelowtomatchoutputofremoteXmodemprogram.crt.Screen.WaitForString"GiveyourlocalXMODEMreceivecommandnow."&vbCRcrt.FileTransfer.ReceiveXmodem"yourFile.txt"

Note:WhenusingaWaitForStringcommandasintheaboveexample,thestringbeingwaitingforshouldbetheexactXmodemoutput,includingcarriagereturnsandlinefeeds.

PythonSyntax

crt.FileTransfer.ReceiveXmodem(filepath)Example

crt.Screen.Send("sx-XmyFile.txt\n")#CustomizethewaitstringbelowtomatchoutputofremoteXmodemprogram.crt.Screen.WaitForString("GiveyourlocalXMODEMreceivecommandnow.")crt.FileTransfer.ReceiveXmodem("yourFile.txt")

Note:WhenusingaWaitForStringcommandasintheaboveexample,thestringbeingwaitingforshouldbetheexactXmodemoutput,includingcarriagereturnsandlinefeeds.

ScreenObject

Description

TheScreenobjectprovidesaccesstoSecureCRT'sterminalscreen.Syntax

Screen.Property[=expression]Screen.Method([arglist])

RemarksSecureCRT'sScreenobjectisaccessedthroughthetop-levelobject’sScreenproperty.

ScreenObjectPropertiesandMethodsProperties Methods

CurrentColumn ClearCurrentRow GetColumns Get2IgnoreEscape IgnoreCaseMatchIndex PrintRows ReadStringSelection SendSynchronous SendKeys SendSpecial WaitForCursor

WaitForKey

WaitForString

WaitForStrings

Properties

CurrentColumn

DescriptionReturnsthecurrentcolumnofthecursor.

RemarksRead-onlynumericproperty.Thefirstcolumnis1.Anerrorwillbereturnedifthereisnoconnectionopen.

VBScriptSyntax

[varname=]object.CurrentColumnPython

Syntax[varname=]object.CurrentColumn

CurrentRow

DescriptionReturnsthecurrentrowofthecursor.

RemarksRead-onlynumericproperty.Thefirstrowis1.Anerrorwillbereturnedifthereisnoconnectionopen.

VBScriptSyntax

[varname=]object.CurrentRowPython

Syntax[varname=]object.CurrentRow

Columns

DescriptionReturnsthecurrentnumberofcolumns.

RemarksRead-onlynumericproperty.

VBScriptSyntax

[varname=]object.ColumnsPython

Syntax[varname=]object.Columns

IgnoreEscape

DescriptionAllowsthescripttocontrolwhetherescapesequencesareignoredornotforWaitForString(s)andReadStringmethods.

RemarksTheIgnoreEscapepropertytoggleswhetherReadString()orWaitForString()recognizesescapesequences.Bydefault,Readstringwillcaptureandlookforescapesequences.

VBScriptSyntax

object.IgnoreEscape[=True|False]Examplecrt.screen.IgnoreEscape=False

'Thefollowingcallwillreturnafterwe

receiveeitheran

''Escape'or'BEL'characterfromtheremote

MsgBoxcrt.screen.Readstring(chr(27),chr(7))

crt.screen.IgnoreEscape=True

'NowthatIgnoreEscapeissettotrue,the

followingcall

'willalwaystimeoutafter5secondsbecause

ReadStringis

'ignoringnon-printablecharacters

MsgBoxcrt.screen.Readstring(chr(27),chr(7),

5)

PythonSyntax

object.IgnoreEscape[=True|False]Examplecrt.Screen.IgnoreEscape=False

#Thefollowingcallwillreturnafterwe

receiveeitheran

#'Escape'or'BEL'characterfromtheremote

crt.Dialog.MessageBox(crt.Screen.ReadString([chr(27),

chr(7)]))

crt.Screen.IgnoreEscape=True

#NowthatIgnoreEscapeissettotrue,the

followingcall

#willalwaystimeoutafter5secondsbecause

ReadStringis

#ignoringnon-printablecharacters

crt.Dialog.MessageBox(crt.Screen.ReadString([chr(27),

chr(7)],5))

MatchIndex

DescriptionDetermineswhichindexwithinyourlistofstringswasfoundbytheReadStringorWaitForStringsmethod.

RemarksIsonlyusefulincombinationwitheithertheReadStringorWaitForStringsmethod.Thecrt.Screen.MatchIndexpropertyisusedinconjunctionwiththeReadStringmethodwhenReadStringispassedmultiplestringstowaitfor.Whenused,MatchIndexwillindicatewhichstringwasfoundbyReadString(1=first_string,2=second_string,etc.).AMatchIndexvalueof0indicatesthatatimeoutoccurredbeforeamatchwasfound.

VBScriptSyntax

[varname=]object.MatchIndexExampleszOutput=crt.Screen.ReadString("error",

"warning","#",10)

SelectCasecrt.Screen.MatchIndex

Case0

MsgBox"Timedout!"

Case1

MsgBox"Found'error'"

Case2

MsgBox"Found'warning'"

Case3

MsgBox"Found'#'"

EndSelect

PythonSyntax

[varname=]object.MatchIndexExample

szOutput=crt.Screen.ReadString(["error",

"warning","#"],10)

index=crt.Screen.MatchIndex

if(index==0):

crt.Dialog.MessageBox("Timedout!")

elif(index==1):

crt.Dialog.MessageBox("Found'error'")

elif(index==2):

crt.Dialog.MessageBox("Found'warning'")

elif(index==3):

crt.Dialog.MessageBox("Found'#'")

Rows

DescriptionReturnsthecurrentnumberofrows.

RemarksRead-onlynumericproperty.

VBScriptSyntax

[varname=]object.RowsPython

Syntax[varname=]object.Rows

Selection

DescriptionReturnsthecurrentselection.

VBScriptSyntax

[varname=]object.SelectionExample

#$language="VBScript"#$interface="1.0"'GoogleSelectedText.vbs'sendtheselectedtexttotheclipboardcrt.Clipboard.Text=crt.Screen.Selection'Extracttheselectedtextfromtheclipboardintoavariableas"Text"

szSelection=crt.Clipboard.Text'NowsearchonGooglefortheinformation.g_szSearchBase="http://www.google.com/search?hl=en&q="Setg_shell=CreateObject("WScript.Shell")g_shell.Run"iexplore"&g_szSearchBase&szSelection

PythonSyntax

[varname=]object.SelectionExample

#$language="Python"#$interface="1.0"importSecureCRTimportwebbrowser#sendtheselectedtexttotheclipboardcrt.Clipboard.Text=crt.Screen.Selection#Extracttheselectedtextfromtheclipboardintoavariableas"Text"szSelection=crt.Clipboard.Text#NowsearchonGooglefortheinformation.g_szURL="http://www.google.com/search?q="+szSelectionwebbrowser.open(g_szURL)

SynchronousDescription

ReturnsorsetstheSynchronoussettingofthescreen.Remarks

IfSynchronousisFalsethenundercertaincircumstancesascriptcanmissdatasentbytheserverthatitisexpectingtosee.SynchronousissettoFalsebydefault.

VBScriptSyntax

object.Synchronous[=True|False]Example

Thefollowingcodethatwaitsfortwodifferentstrings,couldpotentiallymissthesecondstringwhileitisperformingsomeoperationafterreceivingthefirststring.Inordertopreventthiskindofcondition,ittemporarilysetsSynchronoustoTrue:

...

crt.screen.Synchronous=True

crt.screen.Send("someCommand")crt.screen.WaitForString("thisString")...dosomethingelsecrt.screen.WaitForString("thatString")

PythonSyntax

object.Synchronous[=True|False]Example

Thefollowingcodethatwaitsfortwodifferentstrings,couldpotentiallymissthesecondstringwhileitisperformingsomeoperationafterreceivingthefirststring.Inordertopreventthiskindofcondition,ittemporarilysetsSynchronoustoTrue:...

crt.Screen.Synchronous=True

crt.Screen.Send("someCommand")

crt.Screen.WaitForString("thisString")

...dosomethingelse

crt.Screen.WaitForString("thatString")

Methods

ClearDescription

Clearsthescreen.Remarks

None.VBScript

Syntaxobject.Clear

PythonSyntax

object.Clear()

GetDescription

Returnsastringofcharactersreadforaportionofthescreen.Remarks

Returnsastringcontainingthecharactersonthescreenrectangledefinedbythenumericvaluesrow1,col1(upper-left)androw2,col2(lower-right).

VBScriptSyntax

object.Get(row1,col1,row2,col2)Python

Syntaxobject.Get(row1,col1,row2,col2)

Get2

DescriptionReturnsthecharactersoneachrowrequested.

RemarksReturnsthecharactersoneachrowrequestedwitha\r\n,sotherowscanbesplitbylookingforthe\r\nsequence.Thisallowstherowstobedifferentlengthsasrequiredbythecontentsoftherows.

NotesIfyourscriptsneedtoworkwithMBCSlanguages,youshouldusetheGet2interface.

VBScriptSyntax

object.Get2(row1,col1,row2,col2)Python

Syntaxobject.Get2(row1,col1,row2,col2)

IgnoreCase

DescriptionProvidesaglobalmethodtosetcaseinsensitivity.Inaddition,caseinsensitivitycanbesetper-functionasdescribedbelowintheWaitForStrings,WaitForString,andReadStringmethods.

RemarksIfthismethodistrue,theWaitForStrings,WaitForString,andReadStringmethodsarenotcasesensitive,otherwise,theyare

casesensitive(default).VBScript

Syntaxobject.IgnoreCase

PythonSyntax

object.IgnoreCase()

PrintDescription

Printsthescreen.Remarks

Ifnoprinterisdefinedonyourmachine,anerrorwillbereturned.VBScript

Syntaxobject.Print

PythonSyntax

object.Print()

ReadString

DescriptionCapturesdataasitisreceivedfromtheremote.

RemarksReadStringissimilartotheWaitForStringsfunctionexceptinthatReadStringcapturesdata.Bydefault,ReadStringwillcapturealldatareceivedfromtheremote,includingescapesequences.ToenableordisabletheinclusionofescapesequencesinthedatacapturedbyReadString,settheScreen.IgnoreEscapepropertytofalse/true,respectively.IftheremotesideissendingescapesequencesandScreen.IgnoreEscapeissettotrue,ReadStringwillreturnthestring"plug"when"p"wasdrawnintheupperleftcorner,"l"intheupperrightcorner,"u"inthebottomleftcorner,and"g"inthebottomrightcorner.Ifatimeoutparameterisprovided,andReadStringreachesthetimeoutperiodwithoutreceivingthespecifiedstring(s)fromtheremote,ReadStringwillreturnanemptystring.

NotesThismethodtakesanoptionalbCaseInsensitiveparameterthatdefaultstofalse(case-sensitivewaitstringmatching).ItalsotakesanoptionallWaitTimeoutparameter,whichdefaultsto"0"ifnotspecified.TospecifythebCaseInsensitiveparameter,youmustalsoexplicitlyspecifythelWaitTimeoutparameterwhenusingthisfunctioninascript.Toretrievea1-basedindexofwhichstringReadStringencountered,checktheScreen.MatchIndexproperty.

VBScriptSyntax

[varname=]object.ReadString([string1[,string2...,stringn]][,timeoutSeconds][bCaseInsensitive])

ExampleReadStringhasthefollowingthreeusagescenarios:1.Returnsdataassoonasitisavailablefromtheremote,

onecharacteratatime.Thesyntaxforthisscenariois:varname=crt.Screen.ReadString

Example:char=crt.Screen.ReadString

2.Capturedatauntilaspecificstringisdetectedfromtheremote(similartohowWaitForStrings()isused,exceptthatitcapturesdata).Thesyntaxforthisscenariois:varname=

crt.Screen.ReadString(StringToWaitFor[,

TimeOutSeconds])

Example:str=crt.Screen.ReadString("home",10)

3.Capturedatauntiloneofalistofmultiplestringsisdetectedfromtheremote(similartohowWaitForStringsisused,exceptthatitcapturesdata).Thesyntaxforthisscenariois:varname=

crt.Screen.ReadString(StringToWaitFor[,

StringToWaitFor[,...]][,

TimeOutSeconds])

orvarname=

crt.Screen.ReadString(StringsArray[,

TimeOutSeconds])

Examples:str=crt.Screen.ReadString("home",

"work",...,10)

orstr=

crt.Screen.ReadString(arrayOfStrings,10)

PythonSyntax

[varname=]object.ReadString([stringarray][,timeoutSeconds][,bcaseInsensitive])

ExampleReadStringhasthefollowingthreeusagescenarios:1.Returnsdataassoonasitisavailablefromtheremote,

onecharacteratatime.Thesyntaxforthisscenariois:varname=crt.Screen.ReadString()

Example:char=crt.Screen.ReadString()

2.Capturedatauntilaspecificstringisdetectedfromtheremote(similartohowWaitForStrings()isused,exceptthatitcapturesdata).Thesyntaxforthisscenariois:varname=

crt.Screen.ReadString(StringToWaitFor[,

TimeOutSeconds])

Example:str=crt.Screen.ReadString("home",10)

3.Capturedatauntiloneofalistofmultiplestringsisdetectedfromtheremote(similartohowWaitForStringsisused,exceptthatitcapturesdata).Thesyntaxforthisscenariois:

varname=

crt.Screen.ReadString(StringsArray[,

TimeOutSeconds])

Example:str=crt.Screen.ReadString(["home",

"work"],10)

Send

DescriptionSendsastringofcharacters.

RemarksAttemptingtosendastringwhilenoconnectionisopenreturnsanerror.

NotesTheSendinterfaceworkswithMBCSlanguages,andworkscorrectlyregardlessofwhetherthedisplayfontcanrepresentthecharactersornot,aslongastheselect"CharacterEncoding"forthesessioncanrepresentthecharacters.

VBScriptSyntax

object.SendstringPython

Syntaxobject.Send(string)

SendKeys

DescriptionSendskeystrokestotheactivewindow.

RemarksTheSendKeysmethodcansendmorethanonekeystrokeatatimebyusingcompoundstringarguments.Forexample,tosendthekeystrokesa,b,andc,youwouldsendthestringargument"abc".TheSendKeysmethodalsousessomecharactersasmodifiersofcharacters.Thissetofspecialcharactersconsistsoftheplussign(+),caret(^),percentsign(%),tilde(~),parentheses,brackets,andbraces.Thecharacters"+","^",and"%"performthefunctionsofSHIFT,CTRL,andALT,respectively.

Thesecanbecombinedtoaffectonekeyasin"^%c"whichistheequivalentoftheCTRL+ALT+Ckeycombination.Parenthesischaractersareusedtogroupcharactersformodifiers,forexample,"+(ec)"willsend"EC".SendKeyscanuseuptothreenestedparenthesis.Tosendbracketcharacters,sendthestringargument"{[}"fortheleftbracketand"{]}"fortherightone.Tosendbracecharacters,sendthestringargument"{{}"fortheleftbraceand"{}}"fortherightone.Somekeystrokesdonotgeneratecharacters(suchasENTERandTAB).Somekeystrokesrepresentactions(suchasBACKSPACEandBREAK).Tosendthesekindsofkeystrokes,sendtheargumentsshownintheSendKeyskeystroketable.

VBScriptSyntax

object.SendKeysstringExample#$language="VBScript"

#$interface="1.0"

SubMain()

crt.Screen.Clear

crt.screen.sendkeys("mc~")

crt.Sleep2000

crt.screen.sendkeys("{f1}")

crt.Sleep2000

crt.screen.sendkeys("{esc}0")

crt.Sleep2000

crt.screen.sendkeys("{esc}0")

crt.Sleep2000

crt.screen.sendkeys("y")

EndSub

PythonSyntax

SendKeysisnotcurrentlysupportedforPython.

SendSpecial

DescriptionSendsabuilt-inSecureCRTcommand.SendSpecialcansendanyoftheMenu,Telnet,andVTfunctionslistedontheMapSelectedKeydialog(accessedbyselectingakeyintheKeymapEditorandclickingontheMapSelectedKey...button).

RemarksThestringparametertoSendSpecialshoulddescribeoneofthespecialSecureCRTorprotocolfunctions.AttemptingtouseSendSpecialwhilenoconnectionisopenedwillresultinanerror.

VBScriptSyntax

object.SendSpecialstringExamplescreen.SendSpecial"MENU_PASTE"

screen.SendSpecial"TN_BREAK"

screen.SendSpecial"VT_PF1"Python

Syntaxobject.SendSpecial(string)

Examplecrt.Screen.SendSpecial("MENU_PASTE")

crt.Screen.SendSpecial("TN_BREAK")

crt.Screen.SendSpecial("VT_PF1")

WaitForCursor

DescriptionWaitforthecursortochangeposition.

RemarksTheoptionaltimeoutparameterspecifiesthenumberofsecondstowaitforthechange.IfachangeofcursorpositionisdetectedWaitForCursor()returnsTrue.IfatimeoutoccursthefunctionreturnsFalse.IfnotimeoutisspecifiedthenWaitForCursor()willnottimeout.Anerrorwillbereturnedifthereisnoconnectionopen.

VBScriptSyntax

[result=]object.WaitForCursor[timeout]Python

Syntax

[result=]object.WaitForCursor([timeout])

WaitForKeyDescription

Waitforakeypressevent.Remarks

Theoptionaltimeoutparameterspecifiesthenumberofsecondstowaitforakeyevent.IfkeyeventisdetectedWaitForKey()returnsTrue.IfatimeoutoccursthefunctionreturnsFalse.IfnotimeoutisspecifiedthenWaitForKey()willnottimeout.Anerrorwillbereturnedifthereisnoconnectionopen.

VBScriptSyntax

[result=]object.WaitForKey[timeout]Python

Syntax[result=]object.WaitForKey([timeout])

WaitForString

DescriptionWaitforastring.

RemarksWaitforthestringtoappearintheinput.Thetimeout(seconds)parameterisoptional.WhenthestringisdetectedintheinputWaitForString()returnsTrue.IfatimeoutoccursthefunctionreturnsFalse.Anerrorwillbereturnedifthereisnoconnectionopen.

NoteThismethodtakesanoptionalbCaseInsensitiveparameterthatdefaultstofalse(case-sensitivewaitstringmatching).ItalsotakesanoptionallWaitTimeoutparameter,whichdefaultsto"0"ifnotspecified.TospecifythebCaseInsensitiveparameter,youmustalsoexplicitlyspecifythelWaitTimeoutparameterwhenusingthisfunctioninascript.

VBScriptSyntax

[result=]object.WaitForStringstring[,timeout][bCaseInsensitive]

ExampleIfcrt.screen.WaitForString("ogin:",10)<>TrueThen

MsgBox"Failedtodetectlogin!"

ExitSub

EndIf

PythonSyntax

[result=]object.WaitForString(string[,timeout][,bCaseInsensitive])

Exampleif(crt.Screen.WaitForString("ogin:",10)!=

True):

crt.Dialog.MessageBox("Failedtodetect

login!")

WaitForStrings

DescriptionWaitforoneofseveralstringstoappearintheinput.

RemarksWaitsforoneofthestringsgivenasargumentstoappearintheinput.Whenoneoftheargumentstringsismatchedintheinput,WaitForStrings()returnstheargumentindexofthestringthatwasfound(theindexofthefirststringgivenasanargumenttoWaitForStrings()is1).Iftheoptionaltimeoutparameterisspecifiedandatimeoutoccursbeforeanyofthestringsarefound,WaitForStrings()returns0.IntheabsenceofatimeoutparameterWaitForStrings()willblockwithouttimingoutandwillnotreturn0.Anerrorwillbereturnedifthereisnoconnectionopen.

NotesIfyouareusingVBScript,WaitForStrings()willacceptanarrayofstringsasitsfirstargumentfollowedbyanoptionaltimeout.ThevaluereturnedbyWaitForStrings()willbetheindexofthestringfoundinthearray(1stelementinthearray=1).Avalueof0willbereturnedifnostringswerefoundwithinthetimeoutperiodifspecified.TheWaitForString(s)interfaceworkswithMBCSlanguages,and

dependsonlyonthe"CharacterEncoding"forthesessionbeingabletorepresentthecharactersbeingwaitedfor,notonthecharactersbeingdisplayedcorrectlyonthescreen.ThismethodtakesanoptionalbCaseInsensitiveparameterthatdefaultstofalse(case-sensitivewaitstringmatching).ItalsotakesanoptionallWaitTimeoutparameter,whichdefaultsto"0"ifnotspecified.TospecifythebCaseInsensitiveparameter,youmustalsoexplicitlyspecifythelWaitTimeoutparameterwhenusingthisfunctioninascript.

VBScriptSyntax

[result=]object.WaitForStringsstring1,[string2,...,stringn][,timeout][bCaseInsensitive]

ExampleDimresult

result=crt.screen.WaitForStrings("foo","bar","quux","gee",10)

MsgBoxresult

Ifresult=3Then

MsgBox"Gotquux!"

EndIf

Ifresult=0Then

MsgBox"Timedout!"

EndIf

PythonSyntax

[varname=]object.WaitForStrings(StringsArray[,timeout][,bcaseInsensitive])

Exampleresult=crt.Screen.WaitForStrings(["foo",

"bar","quux","gee"],10)

crt.Dialog.MessageBox(str(result))

if(result==3):

crt.Dialog.MessageBox("Gotquux!")

if(result==0):

crt.Dialog.MessageBox("Timedout!")

SessionObject

Description

TheSessionobjectprovidesaccesstothestateandpropertiesthatexistforthecurrentconnectionorsession.

Syntax

session.Property[=expression]session.Method([arglist])

Remarks

SecureCRT'sSessionobjectisaccessedthroughthetop-levelobject’sSessionproperty.

SessionObjectPropertiesandMethodsProperties Methods

Config ConnectConnected ConnectInTabLocalAddress DisconnectLogFileName LogLogging LogUsingSessionOptionsPath PrintRemoteAddress SetStatusTextRemotePort Properties

ConfigDescription

Returnstheconfigurationassociatedwiththesession.Remarks

Thisconfigurationwillnotbesaveabletoanewname.VBScript

SyntaxSetobjectvarname=object.Config

ExampleSetconfig=crt.Session.Config

PythonSyntaxobjectvarname=object.Config

Exampleconfig=crt.Session.Config

Connected

DescriptionReturnsaBooleanvalueindicatingwhetherthecurrentsessionisconnectedornot.

RemarksBooleanread-onlyproperty.

VBScriptSyntax

[varname=]object.ConnectedPython

Syntax[varname=]object.Connected

LocalAddress

DescriptionReturnstheIPaddressofthelocalmachineintheformofastring.

RemarksLocalAddressisaread-onlystringproperty.TheLocalAddresspropertyshouldonlybeaccessedifthesessionisconnected.AttemptingtoaccessLocalAddresswhilenotconnectedisanerror.

VBScriptSyntax

[varname=]object.LocalAddressPython

Syntax[varname=]object.LocalAddress

LogFileName

DescriptionReturnsorsetsthenameofthecurrentlogfile.

RemarksIffilenameisinvalidaruntimeerrorisgenerated.Seealso:session.Log

Ifthelogfilenamecontainsparametersubstitutionsthatareknownwhenthefunctioniscalled,theyarefilledin.Otherwise,theliteralstringisreturned.

VBScriptSyntax

[varname=]object.LogFileName[=filename]Python

Syntax[varname=]object.LogFileName[=filename]

Logging

DescriptionReturnsaBooleanvalueindicatingwhetherthecurrentsessionisloggingornot.

RemarksBooleanread-onlyproperty.

VBScriptSyntax

[varname=]object.LoggingPython

Syntax[varname=]object.Logging

Path

DescriptionReturnsthepathforthecurrentsessionstartingfromlocationofthesessionINIfiles.

RemarksPathisaread-onlystringpropertythatreturnsthepathforthecurrentsessionstartingfromlocationofthesessionINIfiles.Ifnosessionhasbeenselected,thisfunctionwillreturnthename"Default".

VBScriptSyntax

[varname=]object.PathExample

Ifcrt.session.path="work\server0"Thenmyprompt="linux"EndIf

PythonSyntax

[varname=]object.PathExample

ifcrt.Session.Path=="work\server0":myprompt="linux"

RemoteAddress

DescriptionReturnstheIPaddressoftheremotehostintheformofastring.

RemarksRemoteAddressisaread-onlystringproperty.TheRemoteAddresspropertyshouldonlybeaccessedifthesessionisconnected.AttemptingtoaccessRemoteAddresswhilenotconnectedisanerror.

VBScriptSyntax

[varname=]object.RemoteAddressPython

Syntax[varname=]object.RemoteAddress

RemotePort

DescriptionReturnstheportnumberoftheremoteport.

VBScriptSyntax

[varname=]object.RemotePortPython

Syntax[varname=]object.RemotePort

MethodsConnect

DescriptionConnectstoasession.

RemarksTheConnectmethodtakesastringparameterthatspecifieshowaconnectionistobemade.TheformatofthestringparametermatchestheformatofthecommandlineargumentstoSecureCRT.TheConnectmethodcanacceptanemptyargumentset.Thecommandcrt.Session.Connect()means"connecttothecurrentsession".Ifaconnectionhasnotbeenmadebefore,thecommandwillfail.Ifaconnectionalreadyexists,nothinghappens,otherwise,thiscommandisequivalenttopressingtheReconnectbutton.Examples:

Connectusingapredefinedsession:crt.session.Connect("/smysession")

Connectto"myhost"onport2345usingtheTelnetprotocolandDefaultsessionparameters:

crt.session.Connect("/telnetmyhost2345")TheConnectmethodtakesaparameter(TrueorFalse)thatdetermineswhetherornotthescriptshouldwaitfortheconnectiontofullyauthenticatebeforecontinuing.Forinstance,theconnectcallintheexamplesbelowwillwaituntiltheconnectionhasbeenfullyauthenticatedbeforereturningandallowingthescripttoexecutetheerrorcheckjustbelowtheconnectcall.ThisparameteronlyappliestoSSH1andSSH2connections.Whereas,passingFalsewouldallowtheerrorchecktoexecutebeforetheconnectionhasachancetofinish.YouwillprobablywanttouseFalseonlyincaseswhereyouwanttoscriptthelogonprocessforthesessionyouareattemptingto

connectto.ThedefaultvalueforthisparameterisTrue.TheConnectmethodalsotakesanoptionalparameter(TrueorFalse)thatspecifieswhetherornottosuppresspop-upmessages.ThisparameterdefaultstoFalse(don'tsuppress).

VBScriptSyntax

object.Connect[arg[,True|False][,True|False]]Examples#$language="VBScript"

#$interface="1.0"

OnErrorResumeNext

crt.Session.Connect"/SSH2/PASSWORDpassword

username@hostname",True

IfErr.Number<>0Then

MsgBox"ConnectionFailed"

Else

MsgBox"ConnectionSuccessful"

EndIf

Thefollowingisanexamplescriptthatusesthe/ENCRYPTEDPASSWORDcommand-lineoption.#$language="VBScript"

#$interface="1.0"

setconfig=crt.OpenSessionConfiguration("

<sessionname>")

CRT.dialog.messagebox(config.GetOption("Password"))

crt.Session.Connect"/SSH2/ENCRYPTEDPASSWORD

"&config.GetOption("Password")&"

<username>@<hostname>",True

PythonSyntax

object.Connect(arg[,True|False][,True|False])Examples#$language="Python"

#$interface="1.0"

errcode=0

try:

crt.Session.Connect("/SSH2/PASSWORD

passwordusername@hostname",True)

exceptScriptError:

errcode=crt.GetLastError()

iferrcode!=0:

crt.Dialog.MessageBox("ConnectionFailed")

else:

crt.Dialog.MessageBox("Connection

Successful")

Thefollowingisanexamplescriptthatusesthe/ENCRYPTEDPASSWORDcommand-lineoption.#$language="Python"

#$interface="1.0"

importSecureCRT

setconfig=crt.OpenSessionConfiguration("

<sessionname>")

crt.Dialog.Messagebox(config.GetOption("Password"))

crt.Session.Connect("/SSH2/ENCRYPTEDPASSWORD

"+config.GetOption("Password")+"

<username>@<hostname>",True)

ConnectInTab

DescriptionConnectstoasessioninatabortiledsessionwindow.

RemarksTakesthesameargumentsasConnect.ThisalsoreturnsaTabobject.TheConnectInTabmethodalsotakestwooptionalparameters(TrueorFalse).Thefirstdetermineswhetherornotthescriptshouldwaitfortheconnectiontofullyauthenticatebeforecontinuing.ThefirstparameteronlyappliestoSSH1andSSH2connections.Thesecondoptionalparameterspecifieswhetherthecallfailssilentlyorraisesanexception.Ifthesecond

parameterisFalseandtheconnectionattemptfails,anexceptionisraisedandthemethodreturnsanemptyobject.IfthesecondparameterisTrueandtheconnectionattemptfails,themethodreturnsavalidTabobject,whichcanthenbeusedtocheckforconnectionstatusinordertodetermineiftheconnectionattemptwassuccessful.SeetheConnectmethodaboveforadditionalexamples.

VBScriptSyntax

SetobjTab=object.ConnectInTab[arg[,True|False][,True|False]]

ExamplesConnectinatabusingapredefinedsession:Settab=crt.session.ConnectInTab("/s

mysession")

Connectinatabto"myhost"onport2345usingtheTelnetprotocolandDefaultsessionparameters:Settab=crt.session.ConnectInTab("/telnet

myhost2345")

Closetabifattempttoconnectfails:SetobjNewTab=

crt.Session.ConnectInTab("Host_Does_Not_Exist",,True)

MsgBox_

"ScriptTab'sindex:"&

crt.GetScriptTab().Index&vbcrlf&_

"NewTab'sindex:"&objNewTab.Index

IfNotobjNewTab.Session.ConnectedThen

'Makesurewe'renotre-using

disconnected

'tabs,wedon'twanttoclosethe

script

'tab,justanynewtabsthatget

createdby

'callstoConnectInTab(),but

whichdon't

'resultinasuccessful

connection.

Ifcrt.GetScriptTab().Index<>

objNewTab.IndexThen

crt.Dialog.MessageBox("Closing

failedtab")

objNewTab.Close()

EndIf

EndIf

PythonSyntax

objTab=object.ConnectInTab[arg[,True|False][,True|False]]Example

Connectinatabusingapredefinedsession:crt.Session.ConnectInTab("/smysession")

Connectinatabto"myhost"onport2345usingtheTelnetprotocolandDefaultsessionparameters:crt.Session.ConnectInTab("/telnetmyhost

2345")

Closetabifattempttoconnectfails:objNewTab=

crt.Session.ConnectInTab("Host_Does_Not_Exist",

failSilently=True)

crt.Dialog.MessageBox(

"ScriptTab'sindex:"+

str(crt.GetScriptTab().Index)+"\n"+

"NewTab'sindex:"+

str(objNewTab.Index))

ifobjNewTab.Session.Connected!=True:

#Makesurewe'renotre-using

disconnected

#tabs,wedon'twanttoclosethe

script

#tab,justanynewtabsthatget

createdby

#callstoConnectInTab(),butwhich

don't

#resultinasuccessfulconnection.

ifcrt.GetScriptTab().Index!=

objNewTab.Index:

crt.Dialog.MessageBox("Closing

failedtab")

objNewTab.Close()

Disconnect

DescriptionDisconnectsthecurrentsession.

RemarksIfthecurrentsessionisnotconnected,Disconnectdoesnothing.

VBScriptSyntax

object.DisconnectPython

Syntaxobject.Disconnect()

Log

DescriptionEnablesordisableslogging.

RemarksStartsorstopsloggingdependingontheBooleanstateofthe"start"parameter.WhenloggingisbeingstartedtheoptionalBoolean"append"and"raw"parametersmaybesettoTruetoopenthelogfileforappendingortolograwcharactersrespectively.Theappendandrawparametersareoptionalandarefalseifnotspecified(When"start"isfalsethevaluesofappendandrawareignored).

VBScriptSyntax

object.Log(start[,append[,raw]])Python

Syntaxobject.Log(start[,append[,raw]])

LogUsingSessionOptions

DescriptionTurnsonloggingusingtheloggingoptionsforthecurrentsession.

RemarksIfthesessionisanadhocsession,theDefaultsession'sloggingoptionswillbeused.

VBScriptSyntax

object.LogUsingSessionOptionsPython

Syntaxobject.LogUsingSessionOptions()

Print

DescriptionStartsorstopsautoprint.

RemarksStartsorstopsautoprintdependingontheBooleanstartparameter.

VBScriptSyntax

object.Print(start)Python

Syntaxobject.Print(start)

SetStatusText

DescriptionAllowsyoutosetthetextwithinthestatusbarforaspecificsession.

RemarksSetsthestatusbarmessagetothespecifiedtextstring.

VBScriptSyntax

object.SetStatusText(text)Python

Syntaxobject.SetStatusText(text)

SessionConfigurationObject

DescriptionTheSessionConfigurationobjectprovidesmethodsforaccessingsessionconfigurationthroughscripting.

SyntaxSessionConfiguration.Method([arglist])

RemarksCanbeusedinthefollowingcases:•Changesettingsinanexistingsessionbeforeconnecting.•ConvertanExcelspreadsheettosaveSecureCRTorSecureFX(if

installed)sessions.

SessionConfigurationObjectMethodsMethods ConnectInTab GetOption Save SetOption

MethodsConnectInTab

DescriptionConnectstoasessioninatabortiledsessionwindow.

RemarksThismethodreturnsaTabobject.

VBScriptSyntaxSetobjTab=object.ConnectInTab

ExampleSetobjConfig=

crt.OpenSessionConfiguration("Test")

objConfig.SetOption"Hostname","host"

SetobjTab=objConfig.ConnectInTab

PythonSyntaxobjTab=object.ConnectInTab()

ExampleobjConfig=

crt.OpenSessionConfiguration("Test")

objConfig.SetOption("Hostname","host")

objTab=objConfig.ConnectInTab()

GetOption

DescriptionGetsthevalueofthespecifiedoption.

RemarksOptionNameisastringparameterthatisthenameoftheoption.Thismethodreturnsthevalueofthespecifiedoption.Iftheoptionisastringtype(S),astringisreturned.Iftheoptionisamulti-string(Z),anarrayofstringsisreturned.IftheoptionisaDWORD(D),anintegerisreturned.

VBScriptSyntaxvarname=object.GetOption(OptionName)

ExampleSetobjTab=crt.GetScriptTab

SetobjConfig=objTab.Session.Config

szUsername=objConfig.GetOption("Username")

szSessionName=objTab.Session.Path

MsgBox"Usernameforcurrentsession("&_

szSessionName&")="&szUsername

vPortForwards=objConfig.GetOption("Port

ForwardTableV2")

nElements=UBound(vPortForwards)

IfnElements=-1Then

MsgBox"Noportforwardconfigurationdefined"

Else

MsgBoxnElements+1&_

"portforwardentriesexistinthissession

("&_

objTab.Session.Path&")"

EndIf

Inthefollowingexample,thecurrentsession’sDescriptionisdisplayed.

SetobjTab=crt.GetScriptTab

SetobjConfig=objTab.Session.Config

strDescription=

Join(objConfig.GetOption("Description"),

vbcrlf)

crt.Dialog.MessageBox"CurrentSession's

Description:"&vbcrlf&_

strDescription

PythonSyntaxvarname=object.GetOption(OptionName)

ExampleobjTab=crt.GetScriptTab()

objConfig=objTab.Session.Config

szUsername=objConfig.GetOption("Username")

szSessionName=objTab.Session.Path

crt.Dialog.MessageBox("Usernameforcurrent

session("+

szSessionName+")="+szUsername)

vPortForwards=objConfig.GetOption("Port

ForwardTableV2")

nElements=len(vPortForwards)

ifnElements==0:

crt.Dialog.MessageBox("Noportforward

configurationdefined")

else:

crt.Dialog.MessageBox(str(nElements)+

"portforwardentriesexistinthissession

("+objTab.Session.Path+")")

Inthefollowingexample,thecurrentsession’sDescriptionisdisplayed.

objTab=crt.GetScriptTab()

objConfig=objTab.Session.Config

formattedDescription=[]

arrDescription=

objConfig.GetOption("Description")

nElements=len(arrDescription)

forindexinxrange(nElements):

formattedDescription.append(arrDescription[index])

formattedDescription.append("\n")

strDescription=

''.join(formattedDescription)

crt.Dialog.MessageBox("CurrentSession's

Description:\n"+strDescription)

Save

DescriptionSavestheconfiguration.

RemarksIfSessionPathisnotprovided,theconfigurationwillbesavedtothe.inifilethatisassociatedwiththeConfigobjectused.IftheSessionPathprovidedisthesameasanexistingsessionconfiguration,theexisting.inifilewillbeoverwrittenwiththesettingscontainedintheConfigobjectused.IftheSessionPathprovideddoesnotexist,anewsessionofthatnamewillbecreatedinthesessionpathspecified.Notethatthesessionpathisnotafullfilesystempath,ratheritisthepathrelativetothefoldersastheyappearwithintheSecureCRTConnectdialog,withthebuilt-in"Sessions"folderbeingthe"root"path.Inthegraphicbelow,thepathtotheselectedsessionwouldbeRedhat8-SSH2\redhat.

VBScript

Syntaxobject.Save[SessionPath]

Example'Saveconfigurationtoanewsession.

objConfig.Save"Redhat8-SSH2\redhat-PF"

PythonSyntaxobject.save([SessionPath])

Example#Saveconfigurationtoanewsession.

objConfig.Save("Redhat8-SSH2\redhat-PF")

SetOption

DescriptionSetsthespecifiedoptiontothespecifiedvalue.

RemarksOptionNameisastringparameterthatisthenameoftheoption.Valueisthevaluetosettheoptionto.Iftheoptionisastringtype(S),astringshouldbespecifiedforthevalue.Iftheoptionisamulti-string(Z),anarrayofstringsshouldbespecifiedforthe

value.IftheoptionisaDWORD(D),thevalueshouldbenumeric.Ifthereisanerrorthismethodwilldisplayaerrormessagebox.Iftheerrorsarenotbeingdisplayed,theerrormessagecanberetrievedbyusingcrt.GetLastErrorMessage.

VBScriptSyntaxobject.SetOptionOptionName,Value

ExampleConfig.SetOption"TerminalProtocolName",

"SSH2"

Inthefollowingexample,thecurrentsession’sDescriptionischanged.SetobjTab=crt.GetScriptTab

SetobjConfig=objTab.Session.Config

strNewDescription=_

"Thishostislocatedinroom304."&vbcrlf

&_

"RequiresSSH2publickeyauthentication."

'UpdatetheConfigobject'sdescription;

'convertstringtoarrayusingSplit()

objConfig.SetOption"Description",

Split(strNewDescription,vbcrlf)

'Displayupdatedconfiguration

strDescription=

Join(objConfig.GetOption("Description"),

vbcrlf)

crt.Dialog.MessageBox"Session'sUpdated

Description(New):"&_

vbcrlf&_

strDescription

'Savetheconfiguration

objConfig.Save

Thefollowingshowshowtouseapasswordinascript.TheexampleusesServer1'spasswordtoconnecttoServer.

Note:Whenset,thePasswordparametermustbeencoded.TheSessionPasswordSavedparametermustbesettotrueforthePasswordparametertobeused.

SubMain()

setconfig=

crt.OpenSessionConfiguration("Server")

setconfig1=

crt.OpenSessionConfiguration("Server1")

config.SetOption"SessionPasswordSaved",1

config.SetOption"Password",

config1.GetOption("Password")

config.ConnectInTab

EndSub

PythonSyntaxobject.SetOption(OptionName,Value)

Exampleconfig.SetOption("TerminalProtocolName",

"SSH2")

Inthefollowingexample,thecurrentsession’sDescriptionischanged.

objTab=crt.GetScriptTab()

objConfig=objTab.Session.Config

arrNewDescription=[]

arrNewDescription.append("Thishostislocated

inroom304.")

arrNewDescription.append("RequiresSSH2

publickeyauthentication.")

#UpdatetheConfigobject'sdescription;

objConfig.SetOption("Description",

arrNewDescription)

#Displayupdatedconfiguration

formattedDescription=[]

arrDescription=

objConfig.GetOption("Description")

nElements=len(arrDescription)

forindexinxrange(nElements):

formattedDescription.append(arrDescription[index])

formattedDescription.append("\n")

strDescription=''.join(formattedDescription)

crt.Dialog.MessageBox("Session'sUpdated

Description(New):\n"+strDescription)

#Savetheconfiguration

objConfig.Save()

Thefollowingshowshowtouseapasswordinascript.TheexampleusesServer1'spasswordtoconnecttoServer.

Note:Whenset,thePasswordparametermustbeencoded.TheSessionPasswordSavedparametermustbesettotrueforthePasswordparametertobeused.

defmain():

config=

crt.OpenSessionConfiguration("Server")

config1=

crt.OpenSessionConfiguration("Server1")

config.SetOption("SessionPasswordSaved",

1)

config.SetOption("Password",

config1.GetOption("Password"))

config.ConnectInTab()

main()

TabObject

DescriptionTheTabobjectprovidesaccesstothetabfunctionsthatexistforthecurrentconnectionorsession.TheTabobjectcanalsobeusedtoworkwithtiledsessionwindows.

SyntaxobjTab.Property[=expression]

objTab.Method([arglist])

TabObjectPropertiesandMethodsProperties Methods

Caption ActivateIndex CloneScreen CloseSession ConnectSftp

PropertiesCaption

DescriptionReturnsorsetsthecaptionofthespecifiedtabobject.

RemarksSettingthispropertysetsthecaptionofthetabortiledsessionwindowandsetsthecaptionofthemainapplicationwindowifthetabortiledsessionwindowisactive.

VBScriptSyntax[varname=]tab.Caption

tab.Caption=newCaption

PythonSyntax[varname=]tab.Caption

tab.Caption=newCaption

Index

DescriptionReturnstheindexforthetabobjectreferencedbyobject.

RemarksWhensessionsaretabbed,theindexforeachtabobjectmatchesitspositioninthetabbar.Whensessionsaretiled,theindexesofthetabobjectsmaynotmatchtheindexeswhentabbed,butwillremainconsistentwhilethesessionsaretiled.

VBScriptSyntaxobject.Index

PythonSyntaxobject.Index

Screen

DescriptionReturnsareferencetotheScreenobjectassociatedwiththetabobject.

RemarksObjectvariablesassignedfromthescreenpropertyrequirethe"Set"syntax.SeetheScreenobjectdocumentationforadescriptionofitspropertiesandmethods.

VBScriptSyntaxSetobject=tab.Screen

PythonSyntaxobject=tab.Screen

Session

DescriptionReturnsareferencetotheSessionobjectassociatedwiththetabobject..

RemarksSeetheSessionobjectdocumentationforadescriptionofits

propertiesandmethods.VBScript

SyntaxSetobject=tab.Session

PythonSyntaxobject=tab.Session

MethodsActivate

DescriptionBringsthetabortiledsessionwindowreferencedbyobjecttotheforeground.

RemarksAtabcanreceiveandsendtextwhetheractiveornot.Thismethodsimulatesauserclickingonatabortiledsessionwindowtoactivate.

VBScriptSyntaxobject.Activate

PythonSyntaxobject.Activate()

Clone

DescriptionReturnsareferencetoatabobjectclonedfromthespecifiedobjecttabreference.

RemarksClonedsessionsbenefitfromtheirparentsessionalreadyhavingbeenauthenticatedtotheserver.Therefore,clonedsessionsrequirenoadditionalauthentication.

VBScriptSyntaxSetcloneTab=object.Clone

Python

SyntaxcloneTab=object.Clone()

Close

DescriptionClosesthetabortiledsessionwindowreferencedbyobject.

RemarksAnyactiveconnectionassociatedwiththetab(ortiledsessionwindow)referencedbyobjectisterminatedwhenthetab(ortiledsessionwindow)isclosed.Thetabortiledsessionwindowrunningthescriptcannotbeclosed.

VBScriptSyntaxobject.Close

PythonSyntaxobject.Close()

ConnectSftp

DescriptionCreatesanSFTPtabbasedonthistab.Whenintiledmode,createsanSFTPsessionwindowbasedonthistiledsession.

RemarksSFTPsessionsbenefitfromtheirparentsessionalreadyhavingbeenauthenticatedtotheserver.Therefore,SFTPsessionsrequirenoadditionalauthentication.

VBScriptSyntaxSetsftpTab=object.ConnectSftp

PythonSyntaxsftpTab=object.ConnectSftp()

WindowObject

Description

TheWindowobjectprovidesaccesstopropertiesandmethodsrelatingtoSecureCRT'swindowsuchasthewindow’svisiblestate,caption,etc.

Syntax

Window.Property[=expression]Window.Method([arglist])

Remarks

SecureCRT'sWindowobjectisaccessedthroughthetop-levelobject’sWindowproperty.

WindowObjectPropertiesandMethodsProperties Methods

Active ActivateCaption ShowState Properties

ActiveDescription

ReturnsTrueifSecureCRT'swindowistheactivewindow,otherwiseFalse.

RemarksBooleanread-onlyproperty.OnLinux,FalsemaybereturnedeveniftheSecureCRTiconisflashing.

VBScriptSyntax

[varname=]crt.Window.ActivePython

Syntax[varname=]crt.Window.Active

Caption

DescriptionReturnsorsetsthetitleorcaptionofSecureCRT'sapplicationwindowandtheactivesessiontabortiledsessionwindow.

RemarksRead/writestringproperty.

VBScriptSyntax

crt.Window.Caption[=string][varname=]crt.Window.Caption

PythonSyntax

crt.Window.Caption[=string][varname=]crt.Window.Caption

State

DescriptionReturnsanumberindicatingthestateofSecureCRT'sapplicationwindow.

RemarksRead-onlynumericproperty.ThestatemaybeoneofthefollowingvaluesdependingonSecureCRT'swindowstate:

0-hidden1-visible(normal)2-minimized3-maximized

VBScriptSyntax

crt.Window.StatePython

Syntaxcrt.Window.State

Methods

Activate

DescriptionGivesfocustotheSecureCRTwindow,bringingthewindowtothetopofthedesktop.

RemarksOnLinux,callingActivate()fromascriptmaycausetheSecureCRTicontoflashinsteadofraisingSecureCRTtothetop.Thisistherequiredbehaviorforthisoperatingsystem.

VBScriptSyntax

crt.Window.ActivatePython

Syntaxcrt.Window.Activate()

Show

DescriptionShows,hides,minimizes,ormaximizesSecureCRT'sapplicationwindow

RemarksThestatemaybeoneofthefollowingvalues:

0-Hide1-Show(Normal)2-Minimize3-Maximize

VBScriptSyntax

crt.Window.ShowstatePython

Syntaxcrt.Window.Show(state)

ExampleScripts

ExampleVBScriptscanbefoundintheSecureCRTinstallationfolder.Ifyouwouldliketomodifyanexamplescript,pleasemodifyacopyofthescriptfilebecauseiftheoriginalscriptsareupdated,theinstallerwilloverwritetheexamplescripts.Thefollowingaredescriptionsoftheexamplescripts:

•AddCommentToLogFile.vbs–ThisexamplescriptallowsyoutoaddacustomlineoftexttoyourSecureCRTlogfile.

•AutoResponder.vbs–Demonstrateshowtosetupalistofcommands/textthatgetsenttotheremoteassoonasacorresponding"trigger"string/textisdetectedfromtheremotesystem.

•BasicReadStringExample.vbs–Thisexamplescriptcapturestheoutputofacommand(ls-l)senttoaremotemachinebyusingtheScreen.ReadString()method.Thecapturedtextisthendisplayedinamessageboxwindow.

•ConnectToMultipleSessionsAndSendCommands.vbs–Readsinsessionsfromafile(onesessionperline)andconnectstoeachone(oneatatime)andsendsaseriesofcommandstotheremote,thendisconnectsfromthesessionandmovesontothenextsession.

•CopyOutputToClipboard.vbs–ThisscriptexampleisdesignedtorunwhileconnectedtoaCiscoPixfirewallorotherrouterdevice.

•GoogleSelectedText.vbs–Whenthisscriptislaunched,thetextselectedwithintheterminalwindowisusedasthesearchtermforawebsearchusinggoogle.com.

•LogOutputOfSpecificCommand-UseReadString.vbs–Sendscommandsonebyoneaslistedintheg_vCommands()arraytotheremotemachine.Theresultsofeachcommandarecapturedintoavariable,andthenwrittentoanindividuallogfile(onelogfileforeachcommand).Onceallthecommandshavebeenrun,WindowsExplorerislaunched,withthefirstcommandoutputfileselectedwithintheexplorerwindow.

•SaveSelectedTextToFile.vbs–Ifnon-whitespacetextisselectedwithintheterminalscreen,theuserwillbepromptedforalocationandfilenameinwhichtostoretheselectedtext.Theselectedtext

willthenbesavedtothefilespecifiedbytheuser.•SendCommandToAllTabs.vbs–Thisexamplescriptshowshowto

sendthesamecommandtoalltabsthatcurrentlyhaveanactiveconnection.

•UseIEAsCustomDialog.vbs–ThissamplescriptshowshowtheInternetExplorerautomationobjectcanbeusedtocreatecustomdialogthatcanbeusedwithinaSecureCRTscript.

•UseIEAsListOutput.vbs–ThisexamplescriptshowshowtocreateacustomdialogusingtheInternetExplorer.ApplicationActiveXobject.ThisexamplealsoshowshowdatacanbepassedbetweentheInternetExplorerobjectandSecureCRT.

IntroductiontoSystemAdministrationIssues

ThetopicsincludedinthissectioncontaininformationthatmaybeusefultosystemadministratorswhofinditnecessarytoconfigureSecureCRTforusebyalargenumberofdifferentusers.Thesetopicsinclude:

SpecifyingtheConfigurationDirectory: HowtospecifythedirectoryinwhichtheSecureCRTconfigurationfileswillbestoredorloaded.

CachingPassphrases: HowtoconfigureSecureCRTtorememberpassphrasesusedwithpublic-privatekeyauthentication.

AdministrativeTemplate HowtoconfigureadministratoroptionsfromMicrosoftManagementConsol.

FIPSMode HowtoenableFIPSmode.

SpecifyingtheConfigurationFolder

ThistopicexplainshowtospecifythefolderSecureCRTwillusetostoreandloadtheinitializationfilescontainingthesettingsforglobalandsessionoptions.IfthisisthefirsttimeyouhaveinstalledSecureCRTIfthisisthefirstinstallationofSecureCRTonyoursystem,theBrowseforFolderdialogwillappearwhenSecureCRTisrunforthefirsttimeafterinstallation.IntheBrowseforFolderdialog,selectthefolderinwhichyouwouldliketostorethesettingsforglobalandsessionoptionsandthenclickontheOKbutton.IfyouareinstallingSecureCRToverapreviousversion:IfyouhaveanearlierversionofSecureCRTinstalledonyoursystemaswellasa5.0versioninstalled,theMigrateSecureCRTSettingsdialogwillappearthefirsttimeyourunthe5.0version.Inthisdialog,youareaskedifyouwanttomigratetheoptionssettingsfromyourearlierversionofSecureCRT.IfyouwouldliketomigratetheconfigurationsettingsfromthepriorversiontothenewerversionofSecureCRT,youmustalsospecifytheconfigurationfolderatthistime:1.Specifytheconfigurationfolderbyenteringthefullfolderpathorby

clickingontheBrowsebutton andselectingthepathfromtheBrowseforFolderdialog.

2.Onceyouhavespecifiedtheconfigurationfolder(ifdifferentthanthedefaultconfigurationfolder),clickontheYesbutton.Yourconfigurationsettingswillbemigratedandstoredintheconfigurationfolderthatyouspecifiedinthefirststepabove.Note:IfyoudonotwanttomigrateyourconfigurationsettingsfromtheolderinstallationofSecureCRT,clickontheNobuttonintheMigrateSecureCRTSettingsdialogandtheBrowseforFolderdialogwillappear,inwhichyouwillbeabletospecifytheSecureCRTconfigurationfolder.

ChangingtheConfigurationFolderTochangetheconfigurationfolder,completethefollowingsteps:1.StartSecureCRT.

2.OpentheOptionsmenuandclickonGlobalOptions...toopentheGlobalOptionsdialog.

3.ClickontheGeneralcategory.4.IntheConfigurationfolderentrybox,enterthepathtothedesired

configurationfolder.5.ClickontheOKbuttontoexittheGlobalOptionsdialogandrestart

SecureCRTtoinstatethechangeoffolders.Note:ChangestotheconfigurationfolderwillnottakeeffectuntilSecureCRTisrestarted.

SpecifyingaConfigurationFolderfromtheCommandLineThecommand-lineoption/FfolderallowsyoutospecifyanalternateconfigurationfolderwhenyoustartSecureCRTfromthecommandline.WhenSecureCRTisstartedwiththe/Foption,thespecifiedfolderwilloverridethedefaultsettingforthecurrentinstanceofSecureCRT.EachinstanceofSecureCRTcanuseadifferentconfigurationfolder.Tospecifyaconfigurationfolderfromthecommandline,enterthefollowingcommand:

SecureCRT/FfolderNote:Ifthefolderpathnamecontainsspaces,youmustenclosetheargumentinsidequotationmarks.

LockingaSession

SessionscanbelockedorunlockedbyselectingtheLock/UnlockSessionoptionontheFilemenu.Whenthisoptionisselected,theLockSessionorUnlockSessiondialogappears,asappropriate,allowingyoutoassignapasswordandlockthesession,orgivetheoriginalpasswordtounlockthesession.TheLockSessionorUnlockSessiondialogsalsoallowyoutolockorunlockallsessionssimultaneouslyusingasinglepassword.Whenasessionislocked,actionsthatwouldaffectthesessionaredisallowed,includingthefollowing:

•Keyboardinput•Startingandcancelingscripts•Disconnectingandreconnectingthesession•Startingafiletransfer•Closingthesession•Editingthesessionoptions

Scriptsthatarestartedbeforeasessionislockedwillcontinuetorun,butcanonlyaccesstheirownsessionandanyunlockedsessions.Thismeansthatascriptthatisrunninginonesessioncannotaccessadifferenttabthatislocked.AMENU_TAB_LOCKmenufunctionisavailableforuseincustomkeymaps,toolbars,andtheuserbuttonbar.

OverviewofYmodem

Ymodemisasimplefiletransferprotocolthatsupportsbasicerrordetectionmethodstoensurethatinformationisnotlostorcorruptedduringatransfer.YmodemisbasedonXmodemandisessentiallythesameexceptthatYmodemsendsthefile'sname,size,andtimestampbeforeactuallytransferringthefile.TheSecureCRTYmodemimplementationsupportsboth128-byteandYmodem-1K(1024-byte)packetsizes.UnlikeXmodem,Ymodemsupportsmultiple-file(“batch”)transfers.Topicsforthissectioninclude:

ChangingtheDefaultFileTransferDirectories

DownloadingaFilewithYmodem

UploadingaFilewithYmodem

UsinganExportedPublicKey

Inordertouseapublickeythathasbeenexported,youwillneedtocompletethefollowingsteps:1.ConfiguretheSSH2servertorecognizeyourpublic-keyfile(e.g.,

Identity.pub).InstructionsareprovidedforconfiguringVanDykeSoftware'sVShell®server,OpenSSH,SSHCommunications,andDataFellowsservers.

2.ConfigureSecureCRTtousethecertificatestorewiththeexportedpublickey(s).a.OpentheSessionOptionsdialogandnavigatetothe

Connection/SSH2category.b.IntheAuthenticationgroup,enablePublicKeyauthentication.c.SelectPublicKeyfromintheAuthenticationlistandclickonthe

Propertiesbutton.d.SelectUseidentityorcertificatefileandentercapi::rawkey::myintheentrybox.

Ifyouwouldlikethistobethedefaultforallsessions,opentheGlobalOptionsdialog,navigatetotheSSH2category,andrepeatStepd.

ReturntotheToolsMenu

SSH2QuickConnectOptions

Whenssh2isselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:HostnameThehostnameorIPaddressoftheremotemachinethatprovidestheSSH2service.PortTheportnumberoftheSSH2serviceontheremotemachine.ForSSH2,thedefaultportis22.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.UsernameTheusernameusedtologontotheremotemachine.

AuthenticationgroupSecureCRTsupportsseveralauthenticationmethodsforconnectingtoSSH2servers,andwillattempttoconnectusingthemintheorderthatyouspecify.

Passwordauthenticationtransmitstheuser'spasswordtotheservertoauthenticatetheconnection.Thetransmittedpasswordisprotectedfromnetworkeavesdropping,duetothecipherencryptionofthedatachannel.

Note:IftheremotemachinesupportsboththeSSH2protocolandchangingpasswordsattheprotocollevel,thepasswordforanSSH2sessioncanbechangedfromthePasswordPropertiesdialog,whichisaccessedbyselectingPasswordintheAuthenticationgroupandclickingonthePropertiesbutton.

PublicKeyauthenticationusesapublic/privatekeypairtoauthenticatetheconnection.Duringtheauthenticationprocess,theclientandtheservernegotiateapublickeytousefortheconnection.Onceapublickeyhasbeendetermined,theclientusesthecorrespondingprivatekeytoperformasignatureoperationoverauniqueconnectionidentifier.Thissignatureisthensenttotheserverforverification.Ifverificationissuccessful,theclientisgiven

permissiontoconnecttotheserver.Thesecurityofthemechanismrequiresthatnoonebuttheownerhaveaccesstotheprivatekey.Theprivatekeyisstoredlocallyinanidentityfile.Also,priortousingpublic-keyauthentication,thepublickeymustbemadeavailabletotheSSH2server.Formoreinformationongeneratingprivate-publickeypairs,seePublic-KeyAuthenticationforSSH2.KeyboardInteractiveauthenticationallowsyoutousethekeyboardtorespondtochallengesputforthbytheserver.GSSAPI(GenericSecurityServicesApplicationProgramInterface)isagenericAPIforperformingclient/serverauthentication.GSSAPIallowsSecureCRTtoauthenticatewithaserverwithoutknowinganythingaboutthespecificauthenticationmechanisminuse.FormoreinformationaboutusingGSSAPI,seetheGSSAPIPropertiesdialog.SecureCRTalsosupportstheuseofX.509certificates.

SSH1QuickConnectOptions

Whenssh1isselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:HostnameThehostnameorIPaddressoftheremotemachinethatprovidestheSSH1service.PortTheportnumberoftheSSH1serviceontheremotemachine.ForSSH1,thedefaultportis22.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.UsernameTheusernameusedtologontotheremotemachine.AuthenticationSecureCRTsupportsthreetypesofauthenticationforconnectingtoSSH1servers:password,RSA,andTIS.

Passwordauthenticationtransmitstheuser'spasswordtotheservertoauthenticatetheconnection.Thetransmittedpasswordisprotectedfromnetworkeavesdropping,duetothecipherencryptionofthedatachannel.Forthisreason,someSSH1serversrejecttheuseofpasswordauthenticationifthecipherissettoNone.RSAauthenticationusesapublic/privatekeypairtoauthenticatetheconnection.ThegeneralmechanismbehindRSAauthenticationisthattheSSH1server"challenges"theclienttodecryptamessageencodedusingtheuser'spublickeystoredontheserver.Uponconnecting,theSSH1servergeneratesarandomvalue,encryptsthevalueusingtheuser'spublickeyandsendstheencryptedchallengetotheclient.Theclientauthenticatestheconnectionbysuccessfullydecryptingthechallengeusingtheuser'sprivatekey.Thesecurityofthemechanismrequiresthatnoonebuttheownerhaveaccesstotheprivatekey.Theprivatekeyisstoredlocallyinanidentityfile.ThefirsttimeyouconnecttoanSSH1serverusingRSAauthentication,SecureCRTwillpromptyouforthelocationofthisfile.Also,priortousingRSAauthentication,the

publickeymustbemadeavailabletotheSSH1server.Note:RSAauthenticationisonlysupportedbytheSSH1protocolandisnotanavailableoptionfortheSSH2protocol.SeePublic-KeyAuthenticationforSSH1tolearnmoreaboutgeneratingidentityfilesandothersetupissues.

TISfirewallauthenticationusestheTISfirewallservertoprovideachallengephrase/responsecombination.SSH1serversmustbeconfiguredtoofferTISauthentication.

TelnetQuickConnectOptions

WhenTelnetisselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:HostnameThehostnameorIPaddressoftheremotehost.PortTheportnumberofaserviceonaremotemachine.ForTelnet,thedefaultportis23.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

Telnet/SSLQuickConnectOptions

WhenTelnet/SSLisselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:HostnameThehostnameorIPaddressoftheremotehost.PortTheportnumberofaserviceonaremotemachine.ForTelnet/SSL,thedefaultportis992.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog..

RLoginQuickConnectOptions

WhenRLoginisselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:

HostnameThehostnameorIPaddressoftheremotehost.UsernameTheusernameusedtologontotheremotemachine.

SerialQuickConnectOptions

WhenSerialisselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:

PortTheserialport(COM1,COM2,etc.)usedbythesession.BaudrateSelectthebaudrateforthedevice.Thedefaultvalueis38400.ThebaudratecanbechangedfromtheSessionOptions/Connect/Serialdialogwhileasessionisconnected.DatabitsThenumberofcommunicationdatabits.Thedefaultvalueis8.ParityChoosetheparitysettingsupportedbytheconnecteddevice.ThedefaultsettingisNone.StopbitsThenumberofstopbitssentaftereachcharacter.Thedefaultvalueis1.DTR/DSRSelectthisoptiontousetheDTR/DSR(data-terminal-ready/data-set-ready)signalswiththeconnecteddevice.Bydefault,thisisnotselected.RTS/CTSSelectthisoptiontouseRTS/CTS(request-to-send/clear-to-send)hardwareflowcontrol.Bydefault,thisoptionisselected.XON/XOFFSelectthisoptiontouseXON/XOFFsoftwareflowcontrol.Bydefault,thisoptionisnotselected.

TAPIQuickConnectOptions

WhentapiisselectedastheProtocolintheQuickConnectdialog,theconnectionoptionsareasfollows:DialusingSelectthemodemyouwouldliketousefromtheDialusinglistofmodems.Ifyouhaveamodeminstalled,youcanalsoconfigureitwhileintheSessionOptionsdialogbyselectingthemodemandclickingontheConfigurebutton.CountrycodeEnterthecountrycodeassociatedwiththenumberyouaredialing.AreacodeEntertheareacodeforthenumberyouaredialing.PhonenumberEnterthephonenumberthatyouaredialing.SecureCRTalsoallowsyoutospecifyanyalternatephonenumbersyouwishtodialusingthesamesession.

RawQuickConnectOptions

WhenRawisselectedastheProtocolintheQuickConnectdialog,theoptionsareasfollows:HostnameThehostnameorIPaddressoftheremotehost.PortTheportnumberofaserviceonaremotemachine.FirewallIfyourconnectioninvolvesafirewall,selectyourfirewallfromthelistoffirewallsthathavebeenconfiguredintheGlobalOptions/Firewalldialog.

UsingCompression

DatathatistobetransferredoveranSSHconnectioncanbeautomaticallycompressedbeforeitisencryptedandsent.Thedataisthenautomaticallyuncompressedafteritisreceivedanddecrypted.Compressingdatacanimprovetransferspeedoverslowernetworklinks.ToconfigureSecureCRTtocompresssessiondataforanSSH1session,followthesesteps:1.SelecttheSecureCRTsessionforwhichyouwanttocompressdata.2.OpentheOptionsmenuandselecttheSessionOptions…command.3.SelecttheConnection/SSH1/Advancedcategory.4.IntheOptionsgroup,selectthetypeofCompressionthatyouwant

(thisoptionisNonebydefault).5.YoucanthenchoosethecompressionLevelsetting.TheLevel

rangesfrom0(minimalcompression)to9(maximumcompression).AhigherLevelmeansbettercompressionbutslowerperformance.Thedefaultvalueis5.

ToconfigureSecureCRTtocompresssessiondataforanSSH2session,followthesesteps:1.SelecttheSecureCRTsessionforwhichyouwanttocompressdata.2.OpentheOptionsmenuandselecttheSessionOptions…command.3.SelecttheConnection/SSH2/Advancedcategory.4.IntheOptionsgroup,selectthetypeofCompressionthatyouwant

(thisoptionisNonebydefault).5.YoucanthenchoosethecompressionLevelsetting.TheLevel

rangesfrom0(minimalcompression)to9(maximumcompression).AhigherLevelmeansbettercompressionbutslowerperformance.Thedefaultvalueis5.

UsingNTLM

TouseNTLANManager(NTLM)(aWindowsauthenticationprotocol)withSecureCRTTelnetandTelnet/SSLsessions,youmusthaveavalidWindowssecuritycontextforNTLMauthenticationtosucceed.Typically,inaWindowsnetwork,thismeansthatthelocalmachineandremoteserverwouldbemembersofthesame(ortrusted)ActiveDirectoryDomains.OnceauserauthenticatestoWindowsontheclientside,theuserthenhasasecuritycontextthatcanbeusedtoauthenticatetheclienttotheremoteserver(assumingthatthesecuritycontextisvalidbetweenboththeclientandserver).Asanexample,theremotemachinemusthaveausernameandpasswordassociatedwiththesessionthatisattemptingtoaccesstheTelnetserver.Theserver'smachinemusthavethatsameusernameandpasswordlistedunderitsUsersandPasswordsfacilityintheWindowsControlPanel.

Note:Ifauser'spasswordischangedonthelocalmachine,itmustalsobechangedontheTelnetserver.

InSecureCRT,NTLMauthenticationisenabledbydefault.YoucandisableNTLMbyuncheckingtheEnableNTLMauthenticationoptionontheSessionOptions/Connection/Telnetdialog.

SendingaSerialBreak

WhenusingaSerialconnection,thereareseveralwaystosendabreak-linecondition.

•IftheVT220keymapisselected,youcanusetheF5key.•WhenusinganyofthekeymappingssuppliedwithSecureCRT,you

cangenerateabreakbyusingtheCTRLplusPAUSE/BREAKkeycombination.

•YoucanalsousetheButtonBarorKeymapEditortoarbitrarilymaptheTelnetfunctionTN_BREAKtoabuttonortoanykeyyoulike.

AnswerbackSubstitutions

WhentheAnswerbackoptionhasbeenselected,SecureCRTwillrespondtotheENQcharacterwiththespecifiedanswerbackmessagedefinedintheTerminal/Emulation/AdvancedcategoryoftheSessionOptionsdialog.YoucanincludethefollowingsubstitutionvariablestobesenttotheremoteserverwhentheserversendstheENQ(controlbyte5)command:

\a-IPv6addressofthefirstadapteronthelocalmachine(theclient)\b-Break\c-ComputerNameofthelocalmachine(theclient)\e-Escape\i-IPv4addressofthefirstadapteronthelocalmachine(theclient)\l-WindowsloginnameassociatedwiththeSecureCRTprocessrunningonthelocalmachine(theclient)\m-MACaddressofthefirstadapteronthelocalmachine(theclient)\n-Newline\p-Pause\r-Carriagereturn\t-Tab\u-Usernameusedtologintotheremoteserver\v-Sendthecurrentcontentsofthepastebuffer

Forexample:\i;\m;\l

willbesenttotheremoteserveras:127.0.0.1;01-02-03-04-05-06-07-08;jdoe

MenuConfigurationCommandStrings

SeveralexamplemenufilescanbefoundintheSecureCRTinstallfolderintheMenussubfolder.Thefiledefault.mnucontainsmostofthecurrentlysupportedcommands.Itisrecommendedthatyouuseoneoftheexamplesasatemplateforcreatingacustommenu.

WARNING:Beforemodifyinganexamplemenufile,itshouldberenamedorcopiedtoadifferentlocationbecauseotherwise,itwillbeoverwrittenwhenanupdateofSecureCRTisinstalled.

Thefollowingarecommandstringsthatcanbeusedinthemenuconfigurationfileinadditiontothoseinthedefault.mnuexamplemenu.Formoreinformation,seeCustomizingtheUserInterface.

MENU_WINDOW_NEXT Changesfocustothenextapplicationwindow

MENU_WINDOW_PREV Changesfocustothepreviousapplicationwindow

MENU_WINDOW_CLOSE_ALL Closeallopenapplicationwindows

MENU_WINDOW_LIST1 Showlistofwindows

MENU_TAB_LIST1 Showlistoftabsincurrentwindow

MENU_LOAD_DEFAULT_MAIN_MENU Loadthedefaultmainmenu

MENU_LOAD_DEFAULT_SYS_MENU Loadthedefaultsystemmenu

MENU_LOAD_DEFAULT_CONTEXT_MENU Loadthedefaultcontextmenu

MENU_LOAD_DEFAULT_TOOLBAR Loadthedefaulttoolbarmenu

Theseitemsshouldonlybeusedinthesystemmenu

SYS_MENU_RESTORE ThesystemmenuRestoreitem

SYS_MENU_SIZE ThesystemmenuSizeitem

SYS_MENU_MOVE ThesystemmenuMoveitem

SYS_MENU_MINIMIZE ThesystemmenuMinimizeitem

SYS_MENU_MAXIMIZE ThesystemmenuMaximizeitem

SYS_MENU_CLOSE ThesystemmenuClose/Exititem

AcceptingaHostKey

TheNewHostKeydialogappearswhenSecureCRTattemptstoconnecttoanSSHserverwhosehostkeyisnotcontainedinthehostkeydatabase.ThiscanhappenwhenSecureCRTfirstencountersanSSHserverorwhenthehostnamegivenisanaliasthatresolvestoseveraldifferentIPaddresses.

Note:SecureCRTwillwarnyouaboutaliaseswherepossible.However,ifyouareconnectingthroughafirewall,thiswillnotbepossible.becausethefirewallpreventsSecureCRTfromdiscoveringthepossibilityoftheexistenceofanalias.

ForSSH2connections,theNewHostKeydialogdisplaystheserver'spublickeyinafingerprintformatforeasierverification.YoushouldcheckthisfingerprintagainsttheactualserverfingerprinttoverifythattheservertowhichyouhaveconnectedislegitimateChooseoneoftheoptionsbelowtoproceedwiththeconnection

·Acceptonce:ChoosingthisoptioncausesthehostkeyfromtheSSHservertobeaccepted,butthehostkeyisnotsavedinthedatabase.

·Accept&save:ChoosingthisoptioncausesthehostkeyfromtheSSHservertobeacceptedanditissavedinthedatabase.

·Cancel:Choosingthisoptioncausesthehostkeytonotbeacceptedandtheconnectionprocessisterminated.

HostKeyDatabaseSecureCRTkeepsthehostkeysthatyouacceptinthehostkeydatabase.Todeterminethedefaultlocationforthisdatabase,SecureCRTqueriesthesystemfortheApplicationDatafolder;generally,thisistheC:\DocumentsandSettings\<username>\ApplicationDatafolder.ThisisalsowhereSecureCRTtriestoinstalltheConfigfolder.ThelocationofthehostkeydatabasefoldercannotbechangedintheSecureCRTuserinterface,butcanbechangedmanuallybyeditingtheSSH2.inifileintheConfigfolder.Ifyouhaveanysavedhostkeys,youwillhavetomovethemtothenewlocationoracceptthemagain.

DownloadingaFilewithYmodem

Todownloadafilefromaremotemachine,completethefollowingsteps:1.Ontheremotemachine,issuetheappropriateYmodemcommandto

instructtheYmodemsoftwaretosendthefilethatyouwanttodownload.Theremotemachinesoftwareshouldthenpromptyoutoinitiatethetransfer.

2.ToinitiatetheYmodemdownload,opentheSecureCRTTransfermenuandselectReceiveYmodem.Thefilewillbetransferredandsavedtothedefaultdownloaddirectorywhenyouselectthecommand.

UploadingaFilewithYmodem

Touploadafiletoaremotemachine,completethefollowingsteps:1.Ontheremotemachine,issuetheappropriateYmodemcommandto

instructtheYmodemsoftwaretoreceivethefilethatyouwanttoupload.ThiswillcauseSecureCRTtoopentheSelectFilestoSendusingYmodemdialog(shownbelow).NotethatYmodemmustbeinstalledontheremotemachinetotransferfileswithYmodem.Note:AnotherwaytoopenthisdialogistoopentheTransfermenuandselectSendYmodem.

2.IntheSelectFilestoSendusingYmodemdialog,selectthefile(s)thatyouwanttouploadtotheremotemachineandclickontheAddbuttontoaddthefile(s)totheFilestosendlist.Youcanalsochoosetosendyourfile(s)inASCIIinsteadofbinarybycheckingtheUploadfilesasASCIIcheckbox.

3.Whenyouhavefinishedaddingallthefilesthatyouwanttoupload,clickontheOKbutton.

SelectFilestoSendusingYmodemDialog