Welcome [documentation.help] · • Telnet supports Negotiate About Window Size (NAWS). • Telnet...
Transcript of Welcome [documentation.help] · • Telnet supports Negotiate About Window Size (NAWS). • Telnet...
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: [email protected]
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.
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
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:[email protected]: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
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:
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"[email protected]".SecureCRTwillmakethefollowingvariablesubstitutionsinthespecifiedSPNname:·$(HOST)-thehostnameasspecifiedintheSession
Options/Connection/SSH2category.·$(PORT)-theportasspecifiedintheSessionOptions/Connection/SSH2
categoryIftheserverisinadifferentKerberosrealm,therealmnamemayneed
tobeappended(e.g.,[email protected]@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.
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,[email protected].
[/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.
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.
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";}
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(
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()
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.