Home

Hidden Automatic Navigator

1. Use persistent cookies for login Validation hours 0 al e Service configuration Parameter Value DBUser DSN hanusers UserField usemame TableName users DBPasswd ry me eT Afa usergroup MOD_ AUTH VARI When using the ODBC service the Import parameter is used to import a value which is then written in an environment variable The value before the equals sign is the field name the subsequent value must be the name of the environment variable in which the imported value is written On the Global page of the Global section the HAN Settings specify the environment variable in which the cost center is stored in the HAN environment In this example the environment variable is called MOD AUTH VAR1 Hidden Automatic Navigator 2014 H H Software GmbH 135 Event Logging and Statistical Analysis HAN Settings a lol WG S E HAN Save Save and Login EZB Tools close HAN Tasks Configuration HAN server name FOON of the HAN server DOCUDIV2008 ENG DOCUDOMAIN LOKAL Browser session timeout minutes Servers that are not to be addressed over HAN HAN 2 kernel only J Global document types a Accounting by cost center Environment variable for setting the cost center MOD_AUTH_VAR 1 The value stored in the variable is case sensitive Daily automatical update at hh mm Amount of memory MB Once the authentication service and environment have been configure
2. The Parameter fields show the parameter name on the left and the HAN variable which will replace it on the right 4 Click on OK to have the session ID made flexible in the URL in accordance with your settings AJAX Login If a particular e journal requires AJAX login the e script must be manually edited before it can implement the login correctly Simply recording the login procedure will not produce the desired result because with AJAX a Java script processes the response from the server and makes the required functions available on the web page When a simple login is performed by HAN the client side JavaScript methods are not activated and the browser cannot provide the corresponding functions This chapter describes how to edit the e script manually so that it can perform the AJAX login The first step is to edit the script and the next is to initiate a login on the client end using a Java script with dummy data which data are then replaced by the HAN server when it processes the request This technique ensures that the login data remain hidden The procedure is as follows 1 In E Script Administration create a new e script and begin the script recording process then begin recording in the Script Editor d If you know the URL of the login page you can use it as the root URL In any case the login URL must be the last URL in the script 2 Navigate to the login page and stop the recording function In this example we ar
3. lt xml version 1 0 encoding UTF 8 gt lt bor auth gt lt error gt Error in Verification lt error gt lt session id gt Y7LJFB4NEBI5Y97S0397GVQMGHRGG2S 9MXI5UG1 4C 9YDEBAG20 lt session id gt lt bor auth gt XML response to valid login lt xml version 1 0 encoding UTF 8 gt lt bor auth gt lt z304 gt lt id gt PWD000000010 lt id gt lt date from gt 20 10 2005 lt date from gt lt date to gt 07 08 2015 lt date to gt lt z304 gt lt session 1i1d gt SEDE618IAT4NKDLXFHEHL1KNAEB12YC2K3DPMURHMLOII4M4Kx lt session id gt lt bor auth gt XML response to invalid login lt xml version 1 0 encoding UTF 8 gt lt bor auth gt lt z304 gt lt id gt PWD000000016 lt id gt lt date from gt 04 10 2001 lt date from gt lt date to gt lt date to gt lt z304 gt lt session i1d gt LIRNG3G6XA9GL1S2X8G4VOFIIIVYQ6YNUYA5SYGD7HJVK2BFTI6 lt session id gt lt bor auth gt Hidden Automatic Navigator 2014 H H Software GmbH Appendix 146 Values for the Type Query Criterion You can use the Type query criterion to query the method with which e scripts were made This is a decimal value The following values are possible Type Value Description User 0 Created by a user EZB 1 Imported from the EZB EBSCO 2 Imported using EBSCO SUMMON 3 Imported using SUMMON For an example of the use of the Type query criterion see EZB and HAN Automatic Collating
4. Complete all fields and then click Next to confirm 5 Select Create a certificate request for an official certificate authority In the Password field for the private key of the certificate enter a password and then repeat your input in the subsequent field Hidden Automatic Navigator 2014 H H Software GmbH 33 Configuration HAN Server Certificate Create a New Server Certificate You can create a self signed cetificate for example for a test installation or a request for an official certificate authonty recon jed Type of certificate Create a certificate request for an official certificate authority lssue a self signed certificate walid urtil i 5 0 days Password for the private key of the certificate Please select a complex password to protect the private key for this certificate Password z rer Repeat password a ee tN c o After you click on Finish the Certificate Wizard creates two files server csr which contains the public key and is sent as a certificate request to the certificate authority and server key which contains the private key Do not allow unauthorized persons to access this private key al Certificate authorities sometimes offer a choice of HASH encryption keys HAN requires a method that is supported by Apache 2 2 for example SHA 2 and later SHA 2 techniques or even SHA 1 For optimum security select the newest Apache 2 2 compatible method available 6 The su
5. 0 9 A to E Query the title H 4 5 a yy E seripts 1 of 5 Query lt no query loaded gt A standard script is automatically created for the e script which in this case is completely adequate for the purpose because no further user input is required The new e script is fully functional as soon as it has been saved and can be called using the URL http lt HAN server FQDN gt han financial times assuming you did not modify the HAN ID in Step 3 above d Alternatively you can test the e script in the E Script Administration program by clicking on Test in the ribbon If the test is not successful then the automatic recording function did not obtain all of the data required for the script This may be the case for example if parts of the website are loaded from other domains which had not yet been recorded at the conclusion of automatic recording When a script made with automatic recording fails in testing you will generally find that you have to use manual script recording to provide the desired resource For details on manual script recording see Using Manual Script Recording Script with login To create a script that performs a login on the origin server with an HTTP login dialog only one Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 58 additional step is required Create a new e script and select the then open e script properties option in the Create fiel
6. 2014 H H Software GmbH 119 Event Logging and Statistical Analysis You can also save a new view without first opening the Views window and clicking on New Any time you are working in the Selection window and modify the selection of criteria simply click on Save as a View in the task bar to save the new View Creating reports Reports save current calculation results You can archive them and at the same time make them available to others To save a report click on Report in the task bar of the table you are working on A report includes all of the calculations created at the time the button is clicked but does not save graphs or charts Once you save a report it is automatically listed in the Report window To open the Report window click on Reports in the menu bar H H HAN Statistics Windows Internet Explorer Home Views Selection ables Reports Settings June 2013 Monthly calculation June 2013 Main table 16 07 2013 13 37 59 HH Click on Load to load the selected report The Table type column shows the type s of table contained in the report Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 120 Total Usage You can carry out statistical analyses on usage data with HAN Statistics The type of table used to display total HAN usage is called a main table This chapter shows you how to run standard and user defined
7. 456 4 2 HAN New x Properties E script Form Login HTTP Login sessionmanagement Session Management ata 0 Ca Columns Fai Load Reset BaBa amp Import E scripts that have been imported amp Never used f E scripts that have never been used P Bpringerlink f E scripts 4 Query no query loaded Select the desired query and click on the Use this query button in the toolbar in the Query sidebar section of the Ribbon The E Script Selection now shows only those e scripts which match the query criteria For more on the options available in the query sidebar see Providing Online Resources with HAN E Script Administration Defining Queries Queries are defined in the E Script Administration program All commands for editing queries are available in the Query section of the ribbon 1 In E Script Administration click on the New button in the Query section of the ribbon 2 In the User defined e script query dialog enter a name for the query in the Query field Entering a description in the Description field is optional Hidden Automatic Navigator 2014 H H Software GmbH 99 Managing HAN Resources aan i x User defined HAN e script query Query H H E scripts Description All e scripts from H H Software Query definition 3 Define filter expressions in the Filter expressions table Click on the New button at the top of the table t create a new expression a
8. Click on Finish to close the Certificate Wizard Once you have received the certificate from the certificate authority open the Certificate Wizard again to import the certificate d As a rule the certificate will be sent to you in plain text in the body of an e mail The certificate consists of everything between the text markers BEGIN CERTIFICATE and END CERTIFICATE as well as these two markers themselves Copy the text including the text markers 1 In the Certificate Wizard select Import a server certificate from text e g e mail d Ifyou received the certificate in the form of a file rather than plain text select Import a server certificate and import the file For details on importing a certificate file skip to Step 3 Hidden Automatic Navigator 2014 H H Software GmbH 35 Configuration HAN Server Certificate HAN Server Certificates For secure connections between your H H product and a web browser over SSL you need a server certificate You can either create request a new server certificate or import a server certificate ma jd 2 Paste the certificate text into the input field and click Next Hidden Automatic Navigator 2014 H H Software GmbH Configuration 36 HAN Server Certificate Import a Server Certificate Please copy the certificate text in the box below A certificate file crt is generated and used for import Certificate as text FoG UDC YEB
9. No input possible HAN parameter Value _HANURL USER _ Value non encoded _HANURL USER _ has a predefined value The value for this parameter is predefined and does not change It is passed as is to resource provider s server is used for login user HANURL_USER_ The parameter is for the login name the value is replaced by the predefined HAN variable for the login name _HANURL_USER_ is used for login password HANURL_PASSWORD _ The parameter is for the login password Hidden Automatic Navigator 2014 H H Software GmbH 67 Providing Online Resources with HAN the value is replaced by the predefined HAN variable for the password HANURL PASSWORD _ Example We shall create an e script for a fictitious online resource which we shall call onlinejournal com This site requires user authentication with user name and password It also has a hidden form field __VIEWSTATE Main script Xx Vanable Value http www onlinejoumal com El hitp anww_onlinejoumal com home aspx p VIEWSTATE HANUR cthHeader T4 Search ctiNavigation Login bt UserlD _HANURL_USER_ ctiNavigation LoginttPassword HANURL_PASSWORD_ hdnJoumallD 4712 Resut GID ctiNavigation LoginimgbtnOKx 14 ctiNavigation LoginimgbtnOKy amp The two values in the parameters for login credentials are replaced by variables as described above The value forthe VIEWSTATE parameter is made flexible by using an unbound
10. Public Web Site with Links to Protected Pages Using Conditional Scripts in Logins Example of a login protected publication The Abstract is freely accessible with no login required and no fees charged Users can check here before clicking on the Publication link to make sure they have found the desired publication The Publication link opens the full version of the publication and is password protected There are different methods used for implementing the login method The ID for the session is appended as a URL parameter This open a page with excerpts and publications 3 For each title a freely accessible abstract and a password protected full publication are listed Click on one of the Publication links and perform the login Title HAN The Technical Principles Abstract 5a ation Title HAN 3 What s new Abstract Publication Once this is accomplished the HAN test site reports successful login 4 Click on Close in the recording window to stop the recording function The script recorded is now shown in the Script Editor Hidden Automatic Navigator 2014 H H Software GmbH 79 Providing Online Resources with HAN 5 Click on Save in the ribbon to save the results At this point the script is functional but has two disadvantages First it will always perform the login and second the target page is always the same publication To have the login performed only when it is required we now create a condit
11. Queries d scripts that use conditional s E Collate Si Import e scripts and remove listings of e scripts that no longer exist In the Import from EZB dialog specify which e journals to import with which settings Hidden Automatic Navigator 2014 H H Software GmbH 109 EZB and HAN n HAN Import from EZB l xX EZB Import fuse global settings z In this example a full import from the EZB is performed You can also use the EZB import function to import only e journals that match specified criteria To perform this type of selective import choose the use selected settings option in the Import type field Type of import Import type Then specify your preferences in the Publisher Anchor and Subject fields Input in the Anchor field is user definable and the wildcard is permitted In the Publisher and Subject fields choose from existing data objects Data objects are created and managed in the HAN Data Editor For details on working with the Data Editor see Managing HAN Resources Data Editor Input in these fields is optional you can use some or all of the fields Once you have defined your settings click on the Import button The import begins The Progress bar indicates the progress of the import operation When the import operation is completed click Exit to exit the EZB import function a For a complete description of all options see the online help on EZB imports If you want to assi
12. The following sections describe the use of the EZB interface in detail e EZB Configuration in HAN provides details on configuring the EZB interface in the HAN Settings program e Manual Import from EZB explains how to initiate EZB imports manually e Automatic Collation of HAN E Scripts wth the EZB describes how to configure HAN so that existing e scripts are automatically collated with the data pool at the EZB e Discussion Rules for EZB Updates explains the rules by which HAN determines whether an e journal has been modified requiring an update of the associated e script Hidden Automatic Navigator 2014 H H Software GmbH EZB and HAN 106 EZB Configuration in HAN Settings for the interaction between HAN and the EZB are configured in the HAN Settings Open the HAN Tools desktop shortcut and select HAN Settings HAN Settings Configure HAN settings In the ribbon at the top of the HAN Settings click on the EZB button in the Configuration section Settings HAN Save Saveand Global Login Tools close HAN Tasks Configuration Settings for the EZB interface are divided into the following pages e Global e Preferences Global page Configure your EZB access on this page fi HAN Settings Si tt Settings a ial bor amp HAN Save Saveand Global Login Tools clase HAN Tasks Configuration feces MTriiiiiit Show This is the default page following installation Pr
13. URL Rewriting Variables This section lists the variables that HAN uses for its URL Rewriting feature Specifically you can use the variables listed below to have HAN make situation dependent replacements in your URLs Which set of variables is valid in your system depends on whether your HAN installation uses the HAN 2 or HAN 3 kernel Make sure you use the variables that are valid for your HAN kernel version HAN 3 Variable Replacement HanServer FQDN of the HAN server Y Server Address of the target server Hanld Current HAN ID HAN 2 Variable Replacement BaseUrl Becomes the HAN 2 base URL han lt current HAN ID gt BaseUrlExt Becomes the HAN 2 extended base URL for secure URL calls i e using HTTPS han lt current HAN ID gt https Y Server Address of the target server A Host Address of the HAN server Hanld Current HAN ID Hidden Automatic Navigator 2014 H H Software GmbH 147 Glossary Glossary A Ato ZList The A to Z List or alphabetical list is HAN s native online catalog of all e journals provided through HAN The list is published by the HAN web server You can easily create links to this list from wherever you access the Internet Furthermore the A to Z List has an advanced search function for locating specific e journals Query In HAN the term query refers specifically to a database query that retrieves certain e scripts from the HAN database At the same time a query is an
14. to choose between these two options select Open to hawe the license automatically registered in the Activation wizard or Save to save the license file If you save the license file it will have to be imported into the Activation wizard afterward For details on importing a licensing file see Activating HAN Hidden Automatic Navigator 2014 H H Software GmbH 25 Installation Updating from HAN 2 To update from HAN 2 to HAN 3 being by installing v3 parallel to v2 Following the installation of HAN 3 run the Migration Wizard program to add your existing e scripts to the new system To run the Migration Wizard select the Convert data from version 2 x to version 3 0 option at the end of installation d Data can be migrated only from HAN 2 because the database format was changed in that version If you have an earlier version you need to update it to v2 before the data can be imported HAN 3 InstallShield Wizard H Te de nN InstallShield Wizard Complete Autom ati C The InstallShield Wizard has successfully installed H H HANZ Navigator Click Finish to esit the wizard M Convert data from version 2 to version 3 0 A un the HAN Achvaton wizard Back Fante You can import the following data from a HAN 2 installation e HAN accounts e scripts e Permissions e Configured authentication services e Data objects e Sequential database e Log data importing log data is possible but not recommended because it
15. 82 84 85 86 88 89 93 95 97 98 102 103 105 106 107 108 110 113 113 115 116 120 130 131 2014 H H Software GmbH Contents Usage per Cost Center HAN Components HAN Web Service Appendix Authentication Services and their Modules Values for the Type Query Criterion URL Rewriting Variables Glossary Index Hidden Automatic Navigator 134 136 137 138 138 146 146 147 150 2014 H H Software GmbH 5 Introduction Introduction Thank you for choosing HAN the software suite that revolutionizes management of Internet resource access This manual gives you step by step instructions on installing and configuring the components you need and explains both how HAN works and how you can work with HAN This introductory chapter looks at the basic operating principles of your HAN system HAN as Reverse Proxy Among the various functions of a proxy server Such as caching web pages that of a reverse proxy is most relevant in the HAN context Sing When a client requests content from the web server of an online content provider also referred to as the origin server the request is received by the reverse proxy which communicates with the origin server and then passes its response for example the requested content back to the client In other words the client communicates only with the reverse proxy not with the origin server The reverse proxy receives the requested content directly from th
16. 9 Activate the selection tool and click on the object in the web page that has the code you wish to examine in this example the Username input field Hidden Automatic Navigator 2014 H H Software GmbH P roviding Online Resources with HAN 74 f gt IRM Log In Windows Internet Explorer Oj x ha S Bing pl a wa 4 Ly Favorites S22 Suggested Sites Web Slice Gallery 3PM Log In Ay gt Bl r Page Safety Tools Lore UNI Style Trace Styles Layout Attributes E jinherited div BM main i W color ece9d aM om be ee E Bn sail The analysis window shows that the input field is identified by both a name name username and an ID id username In the example we select the id identifier d Use the id field if possible because the name identifier is frequently used for a range of different elements in web pages HAN offers the option of defining two different name elements but using the id identifier gives you the greatest possible flexibility 10 Open the e script properties in the Script Editor go to the Login page and select the GetElementByID option under User in the AJAX login data section Enter the value determined previously for the id identifier in this example username E script properties Journal of Reproductive Medicine HAN 3 kernel default General eit Legin A Information Meta Information Login by AJAX Obj
17. A information Meta record IDs ince Selected None 101 Questions about Blood and 101 Questions about Your Immun Selected All 101 Questions about Your Skin 101 Questions Your Brain Has A User meta IDs Selected None Single record view You can open a complete breakdown of the data in any element ID in the main table Origin is the Hidden Automatic Navigator 2014 H H Software GmbH 127 Event Logging and Statistical Analysis default selection which shows the origin of the data record each instance of usage listed separately The other options are breakdown by periods and depending on your basis of calculation by record ID user station or cost center To view the data broken down into individual line items click on the arrow next to the desired ID The details are generated when you open the single record view If you change the calculation basis the record view must be closed and then opened again to generate a view of the corresponding breakdown The breakdown shows details on the usage total number of calls etc sorted by the selected item In the following example Elsevier Science electronic journals is the chosen item iN Elsevier Science electronic jo 1405 28 14 6166 22 965 460 660 00 13 37 3 711 292 Record ID Started Ended User station Bytes Elsevier Science electronic jo 06 06 2006 10 36 40 06 06 2006 10 40 07 UNI LIBRARY 194 229 157 206 69 730 Elsevier Science electronic jo 06 06 2006 10 31 01
18. HAN test site http www hh han com testhan has a frame based page you can use to see this mechanism in action 1 Create an e script with http www hh han com testarea frame index cfm 1g 0 as the starting URL and select then begin recording in the Script Editor in the Create field to start the script recording program automatically aan j x Information to create an new e script Title Website with frames Root url http fwww hh han com testarea frame index cfm7lg 0 and start url recording for the e scrip 2 When the frame based page is opened click on Close to stop the recording function The Script Editor shows the following script HAN Script Editor HANID website with frames Title Website with frames fj En ot t tom HAN eel Test Create Start Close Tools be Save and clase Fai conditional script Fal hi HAN E Script URL Recording Main script Xx Vanable Value El http www hh han com Aestarea Trame index citm g 0 http www hbh han com testarea rame left cfm El http www hh han comtestarea Trame main cim Da m When you run this script only the last frame main cfm is opened 3 To open the entire frameset using HAN delete all URLs except the frameset definition file in this example index cfm Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HA
19. Introduction Documentation Conventions Terms frequently used in this manual that have a special meaning in the context of HAN are listed together with their definitions in the glossary A PDF version of the HAN manual is available on the installation CD ROM You can use the search function in the Adobe Reader version 3 or later to find specific terms in the PDF file The HAN documentation uses the following text conventions to highlight certain content d Note Designates critical information that must be taken into account d Tip Designates useful tips and suggestions for working with HAN Tips show you how to simplify tasks or how to avoid problems before they occur Definition Marks passages that explain a particular term or provide details on a certain topic Text formatting conventions e Control elements e Title name e User input PC output Example of code e Reference No drives letters are specified by name for the installation directory because you can install HAN on your choice of drive The default drive is used in the examples given here HH HAN If your installation is in a different directory be sure to adapt your input accordingly Values between angle brackets lt and gt in this text are placeholders and must be replaced by the actual values valid in your HAN environment Example lt HAN server gt Name of your HAN server lt Path to temp directory gt Directory for temporary files e
20. Not all certificate authorities will issue wildcard SSL certificates For a non exhaustive list of certificate authorities that issue wildcard certificates see Certificate authorities for wildcard certificates below The following steps are required for certification of your web server with a wildcard certificate 1 Create a certificate request 2 Send the certificate request to a certificate authority 3 Import the wildcard certificate from the certificate authority into your HAN system You can use the Certificate Wizard to create a wildcard certificate request Open the Certificate Wizard from the HAN System Settings 1 In the Windows Control Panel select System and Security H H HAN HAN Web Service B H H HAN 4j HAN Database HAN Web f ervice HAN Service Hidden Automatic Navigator 2014 H H Software GmbH 31 Configuration 2 In the HAN System Settings on the HAN web service page click on the Edit button to the right of the File input field FA HAN System Settings cay a Ea os 7 HAN Save Save and stat Stop Restart Tools clase HAN Tasks Service Information w httpd exe 2 2 21 0 mod_han3 dll 3 1 0 499 DE Configuration EAHHIHAN Bin WebSrv ssl server crt 3 This opens the HAN Certificate Wizard Select Create or request a new server certificate and click Next HAN Server Certificate HAN Server Certificates For secure connections between your H H product and a we
21. Script Editor is for recording and editing your scripts The Script Editor is a separate program opened from the E Script Administration interface Scripts are recording using your default browser Data Editor The new Data Editor is for editing HAN data objects These include for example licenses permissions and document types The ribbon in the E Script Administration program has a button that starts the HAN Data Editor Report Center The new HAN Report Center is a collection of web based monitoring and reporting tools such as the Event Log and the Statistics program Web based statistics The HAN Statistics features have been repackaged in a new web based application provided by the HAN web server Now you can quickly access the statistical analyses of HAN usage even over the Internet Event Log The new Event Log gives you an overview of all system events in your HAN system such as internal events and licensing errors HAN Diagnostics The HAN Diagnostics tool shows all information describing the HAN system environment such as license information versions of the installed modules and an overview of the installed HAN components E scripts Filter The Groups concept with one to one allocations in HAN has been discarded The Views mechanism has been developed further and now takes the form of HAN queries The database can be queried for e scripts by specified criteria A given e script can match any number of queries You
22. T Click on the Test button in the ribbon to test the e script The web page called now shows the current values of the CFID and CFTOKEN parameters Options for defining parameters in URLs The method outlined above for making parameters flexible involved straight replacements We double clicked to open parameter properties and replaced the values for login with the predefined HAN variables for user ID and password Your HAN system also lets you replace a random value with a variable that is not bound to a particular purpose You can replace not only parameter values but also session IDs in URLs with variables HAN can replace a value with a variable only if HAN recognizes the value Some web pages however contain parameters in hidden form fields A common example is the Viewstate parameter used in ASP pages If a variable is used to send data over HAN to the origin server using the POST method HAN sends the wrong value Solution Use the GET method to call the web page first and then use POST to send the variable defined for the value Parameter used for login Double click to open parameter properties and replace the login values with the predefined HAN variables _HANURL USER_ for the user ID and HANURL_ PASSWORD _ for the password The Parameters field under Define how the parameter is used in the script offers the following options CL HAN Script Editor Edit URL Parameter X Farameter ctiNavigation Login txtUserID
23. The newest data record is at the top Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 116 HAN Access Log Windows Internet Explorer a http docudiv2008 eng doqudemain lokal HANProtDetailed war HANProtDetailed hi HAN Access log Legios 17 09 2007 08 37 32 62 206 234 68 62 206 234 68 5 389 200 www legios de img_main erman_bgb gif Legios 05 09 2007 20 26 14 62 206 234 68 62 206 234 68 812 200 www legios de img_main iinie_bl_w gif Legios 05 09 2007 20 25 52 62 206 234 68 62 206 234 68 43 200 www legios de img_main trans gif Legios 05 09 2007 20 25 52 62 206 234 68 62 205 234 68 78 200 www legios de img_main trennh_08 gif Legios 05 09 2007 20 25 47 62 206 234 68 62 206 234 68 590 200 www legios de img_main aktion_05 gif Legios 05 09 2007 20 25 29 62 206 234 68 62 206 234 68 143 200 www legios de include genprint css Legios 01 09 2007 17 54 26 62 206 234 68 62 206 234 68 17 267 200 www legios de img_main startseite_170x80 gif E Use the navigation buttons to scroll through the data records PE aay Records per 20 2253557 225 page J The access log contains all data records The summarized log on the other hand shows all usage data sorted by session ID You can analyze the usage data with the HAN Statistics application For details on using the Statistics application see Statistics Statistics The HAN Statistics application is a tool
24. Yes to confirm the license agreement and continue 4 On the Choose Destination Location path enter the path in which you wish to install HAN Hidden Automatic Navigator 2014 H H Software GmbH 17 Installation HAN 3 InstallShield Wizard x Choose Destination Location Select folder where setup will install files i Install HAN 3 to i C HH HAN Change InstallShield 5 On the Select Features page select the components to be installed with HAN The Core System is automatically selected and cannot be deselected HAN 3 InstallShield Wizard q xj Select Features Select the features setup will install Select the features you want to install and deselect the features you do not want to install ae HAN Core System Description Sim Interfaces to online resources Installation of the HAN basic eel EZB component W Summon Serials Solutions WI EBSCO 192 684 MB of space required on the C drive 17191 24 MB of space available on the C drive InstallShield Back Cancel HAN A to Z List installs a component that lets you manage your HAN e scripts in an alphabetical Hidden Automatic Navigator 2014 H H Software GmbH Installation 18 list which can simplify administration considerably especially if you have a large number of e scripts EZB installs a component that implements automatic access to the Elektronischen Zeitschriftenbibliothek electronic journal library at the Un
25. a long period of validity may in fact be the more economical option The two most widely used validation methods are company validation and domain validation Domain validation is sufficient for HAN s requirements With this method the certificate provider checks whether the domain really belongs to the requesting party With company validation the certificate provider checks whether the request is from a properly registered firm To do this they generally contact the company personally e g by phone and run a background check The result is a high quality certificate that meets even the standards applied for financial transactions over the Internet The maximum level of encryption is usually 256 bit the minimum 40 These are standard values offered by almost all providers A number of providers accept payments only through systems such as credit card companies or PayPal Some accept cash on delivery COD Time to issue is the amount of time it takes an authority to issue a certificate This varies from one provider to the next and depends in part on which validation method you select With domain validation the certificate is usually issued within a few hours Providers often insure their certificates against misuse Insured sums range from tens of thousands to millions of dollars This criterion is not relevant for certification of your HAN web server The following are two examples of certificate authorities that offer cost effect
26. a URL or a parameter to change the properties stored for it Alternatively you can right click and then select Edit from the shortcut menu Click on the New button in the ribbon to add a URL Click on the Delete button to delete the selected item d The URL shows the protocol used to call it To change the protocol manually double click on the URL and edit it Then change the protocol in the server node properties Optimizing a script Unlike a script used for programming such as a Java or Visual Basic script for example a HAN script may contain steps that are not relevant for the intended process There are two reasons for this e The information recorded may include elements that have nothing to do with the intended purpose of the script but were recorded because they were part of the web page contents e The path to the target page can go through a number of forwarding operations Following the recording process they script includes all the steps that were carried out to arrive at the target Afterwards you can optimize the script so that the e script opens only the relevant page s These can include for example login pages target pages and any intermediate pages that are required for subsequent processing The goal is to limit scripts to the essentials and keep them as short as possible The shorter the script the faster HAN can process it d Before optimizing an e script we recommend making a backup copy of it This way
27. and configuration options e HAN Web Service describes the functions and operation of the HAN web service Customizing HAN user interfaces Most of the user interfaces in HAN are error messages Another user interface is the HAN login dialog You might need to customize these dialogs for example to if you wish to offer users a language option that is not yet available from H H software or if you wish to alter the error messages supplied with the software All of the error messages and other user dialogs are stored in the HH HAN Bin System web htdocs_user directory Program files for the web based HAN program are stored in the HH HAN Bin System web htdocs directory Do no make any changes in these directories All files in these directories are overwritten during program updates Available languages All HAN user interfaces and web based programs are supplied in English and German If you require another language contact H H software SupportHAN hh software com If you can send us the user interface files in the language you need we can easily send you customized system files Hidden Automatic Navigator 2014 H H Software GmbH 137 HAN Components HAN Web Service The HAN web service implements all of the web related functions in HAN It is installed automatically when you install your HAN software HAN s web service is configured in the HAN System Settings The HAN System Settings are accessed from the Windows Control P
28. automatically deletes the corresponding HAN e scripts d In automatic collating the global settings for EZB imports are applied Automatic collating is a property configured for each e script With the default settings HAN automatically collates e scripts imported from the EZB with online EZB data If you do not want a particular EZB e script to be updated automatically activate the option that disables automatic updates in the e script s properties Hidden Automatic Navigator 2014 H H Software GmbH 111 EZB and HAN E script properties AAPG Bulletin Bulletin American Association of Petroleum Geologists HAN kernel 3 x E Ez Information Meta Information EZB ID Figi Object Properties ZDB number 2008 165 0 Te Domain List Anchor C Login W EZB interface does NOT update this e script automatically 3 Global Control Document types Alternate IF Address URL Rewriting Restricted Addresses Motes If you wish to deactivate automatic collating for a number of e scripts at once use the cumulative properties function HAN offers the option of assigning cumulative properties to e scripts For details on this function see Managing HAN Resources Using Queries Allocating Properties Using queries is the easiest way to view a particular group of e scripts For details on using queries see Managing HAN Resources Using Queries To deactivate automatic collating for a
29. calculations on the total usage data It also provides details on aggregating metadata using the single record view to get more information on a particular dataset comparing calculations using cross tables creating reports to archive results creating charts and graphs of your data and saving a selection of criteria as a View for later calculation Performing a standard calculation of the total usage The four predefined options in HAN all calculate total usage over all record IDs users and stations broken down into four different time periods You can use these options at any time for a quick tally of usage 1 Open the HAN Tools desktop shortcut and select the Report Center 2 In the Report Center select Statistics to open the Statistics application 3 The Statistics main window lists the predefined options for data evaluation under Direct calculation of your data In this example we select the evaluation of the day s data Direct calculation of your data Year s evaluation the current year 4 In the Calculate a table dialog we select Main Table Calculate a table lL Table of concurrent use 5 HAN now calculates the total usage for the current day and shows the results in the main table Hidden Automatic Navigator 2014 H H Software GmbH 121 Event Logging and Statistical Analysis H H HAN Statistics Windows Internet Explorer http docudiv2008 eng docudomain lokal HANStatistics wa
30. can select your choice of criteria for queries and define query objects yourself You can use queries to assign cumulative properties to all e scripts in a given query AJAX login To preclude the need for users to manually adapt e scripts login is still performed using AJAX as in HAN 2 This expands the options available for login scripts for example to use them as properties of HAN e scripts HAN Inspector Previously a change in the starting URL of an e script was not noticed until it resulted in an error message Now the new HAN Inspector module checks the links in existing e scripts for consistency and saves a report on the results E Script Properties The e script properties have been re structured All properties of the earlier HAN accounts are still available for all e scripts Editable data fields have been added to the script properties and can be used to create object properties for use in e script database queries Imports from the EZB are automatically provided with a hidden data field containing the EZB anchor Thus the EZB anchor can now be used as a criterion for database queries User defined URL Rewriting A new property of e scripts is the option of user defined replacements to complement automatic URL rewriting An editor for regular expressions enables user defined URL rewriting and also checks for errors The dialog page for configuring URL Rewriting is in the E Script Properties editor Discussion New features in t
31. determined from the IP addresses of the computer workstations in the library Access from outside the library requires LDAP authentication The assigned LDAP permission allows only library employees to access library resources from outside the library Login from outside is performed on the central system so it is clear from the outset Hidden Automatic Navigator 2014 H H Software GmbH 53 Configuration whether the request comes from an employee or a student Thus there is no need in this example to have a login page opened Anyone outside the library who cannot be authenticated as an employee will be denied access Rather than a login page the configurations in this example open an HTML page explaining that the library resources can be accessed only on the computers located inside the library To this end we created an informational page called accessOnlyInLibrary html en HAN Data Editor xX is IPv4 192 168 72 1 192 168 73 225 and is CN HAN Admins OU HAN DCSdaptest DCSocal or Customizing HAN for Your Company HAN offers a number of ways to integrate your corporate identity or your organization s logo e On login pages e In error messages In both cases you can adapt the existing HTML pages and create new ones Login pages are stored in the HH HAN Bin System web htdocs_user login directory Error pages are stored in the HH HAN Bin System web htdocs_ user haninfo directory d Program files for the web based HAN program a
32. dll d The list of supported authentication services shown on the HAN Settings program includes additional services which are not described here These are services that have been specifically adapted for special areas of use and for internal functions Hidden Automatic Navigator 2014 H H Software GmbH 139 Appendix Authentication services and their parameters Configuration for NT4 WinNT DomainName ObjectName className or WinNT ComputerName computer Authentication is performed over ALEPH auth_aleph cll tee System data source name for the database DBUser User name DBPass Password wa Configuration Prerequisite for the ALEPH authentication module is functioning ODBC interface to the database containing the user information The ODBC connection must be set up as a system data source Further a user account with read access to the required tables must be set up in the database The password for the designated user must be stored in the database in plain text As ALEPH uses an Oracle database you might have to install an Oracle client on the computer Parameters DSN Data source name name of the ODBC data source DBPass Password wa Configuration Prerequisite for the Elektra authentication module is functioning ODBC interface to the database containing the user information The ODBC connection must be set up as a system data source Further a user account with read access to th
33. for quick access to standard calculations For example you can select Day s evaluation to view a main table of the current day s usage Under Calculate the most recently used Views is a list of the sets of data most recently calculated Further options are available in the horizontal menu H H HAN Statistics Windows Internet Explorer T http docudiv2008 eng docuda Home The menu is the same on every page of the Statistics program but the options available may vary The menu contains the following commands Home Shows the Welcome page Views Lets you select an existing View A View is a selection of criteria which defines a particular set of data and which can be saved and reused so you can calculate statistics for the same set of data without having to define the criteria again For details on creating views see Creating views Selection Opens the Selection window in which you can choose criteria to define the data you wish to calculate if you wish to run a user defined calculation rather than using a standard template For details on selecting criteria see Selection window Tables Lets you choose from a list of all tables calculated in the current browser session You can switch from one table to another quickly and easily Reports Saves the results of the current calculation as a report which you can archive and share For details on creating reports see Creating reports Settings Settings for the Statistic
34. g C Temp lt HAN ID gt Designation of the HAN e script Support If you have questions regarding support please contact your software vendor You can send technical questions about the HAN software to the following e mail address supportHAN hh software com Before you submit a support request please read the relevant sections of the manual and refer to the on line Help in the HAN program if you are not sure where to look check the Help index If you still need help please provide the following information when you send us your question or have it on hand when you call your software vendor e The text of any error messages as well as any relevant data from the H H Trace Monitor e The steps required to reproduce the problem Hidden Automatic Navigator 2014 H H Software GmbH Introduction 12 e A diagnostics file created using HAN Diagnostics Ideas and Suggestions We are always happy to hear your ideas and comments and any suggestions you may have for improvements or additions Please send them to H H Software GmbH Attn HAN Product Manager Maschmuhlenweg 8 10 37073 Gottingen Germany Or send e mail to supporthan hh software com with HAN in the subject line New in HAN 3 This chapter describes the new features in HAN 3 System e New kernel HAN 3 kernel With the new kernel the URL structure is no longer modified when storing the HAN ID and the provider s server name Instead these data are
35. in charts and graphs d Prerequisite for graphical evaluations in HAN Statistics is a current version of Adobe Flash player To create a graph click on Graph in the task bar and select the desired calculation basis from the menu HAN creates the desired graph of the current calculation To change the type of graph used click on Graph types in the menu bar and select the desired type In this example Total calls has been selected To keep the graph to a manageable size only those e journals are selected that were called at least 20 times in June 2006 The resulting graph appears as follows Hidden Automatic Navigator 2014 H H Software GmbH 129 Event Logging and Statistical Analysis Total calls SerSol r Jacqueline Kennedy Onassis Journal of Applied Physi Royal Society of Chemistry IEEE TEE Electronic Librar Knovel Views The options activated in the Selection window specifying which data are to be included in the next calculation can be saved in the form of a View This is useful when you Know you will want to perform the same calculations on future data sets for example 1 To store a set of calculation options in the form of a View select the desired criteria in the Selection window and click on Save as a View in the task bar 2 In the New View dialog enter a name for the View and if desired a brief description as well 3 Click on OK to confirm the settings The View is created
36. in the Activate data logging checkbox and enter your choice of record ID in the input field You also have the option of making this the default setting for all new e scripts so that it is automatically active when a new e script is created To do this open the HAN Settings select the Global section and open the E Scripts page fl HAN Settings lolx f EJ 7 J 1 HAN Save Save and Login Tools close HAN Tasks Configuration Global Global Default settings for creating e scripts Information W Activate data logging for e scripts with title as ID i E script is deactivated by default Tick the checkbox next to Activate data logging for e scripts with title as ID Usage of all e scripts created subsequently will be recorded in the access log using the e script title as record ID With the HAN default settings that are active immediately following installation this setting is activated Even when this setting is active you can use your choice of record ID rather than the e script title To do this simply specify the record ID in the e script s properties The record ID you select overwrites the global setting The HAN Access Log gives you a direct overview of all usage data We also refer to this display as the raw data To open the HAN Access Log select it in the Report Center Access is The HAN Access Log lists all instances of e script access Each record is given a sequential number
37. managing HAN resources 85 e scripts 86 manual import from EZB title lists 108 manual script recording 58 migrating HAN 2data 25 monitoring 39 N new features in HAN 3 12 p providing online resources 54 Q queries 97 102 define 98 querying e scripts 97 R registering your HAN software 19 replacing URL parameters 63 rules for EZB update 113 S Statistics program 116 suggestions 12 Support 11 system monitoring 39 system requirements 15 T total usage 120 type 146 U updating from HAN2 25 URL Rewriting variables 146 usage statistics 116 V variables for URL Rewriting 146 views 97 W Web service 137 wildcard certificate 29 wildcard configuration 29 wildcard DNS record 29
38. met when an e script is called In addition to these standard attributes document types can also function as attributes in this sense For details on creating document types see Managing HAN Resources Data Editor Document Types 6 The Periodicity section lets you select the type of period to be covered in the calculation You can select months quarters half years years or no periodicity T Under Period you can select the period within the parameters of your chosen periodicity that will form the basis of the calculation d If you select None for periodicity you can specify a starting date and ending date using the calendar buttons to the right of the corresponding input fields 8 Under Minimum maximum you can define additional filter arguments to specify which e scripts are included in the calculation This filter lets you set maximum and minimum values for the total number of times an e script was called the duration of use and the number of bytes transferred Thus you can exclude e script calls that did not entail any actual usage Hidden Automatic Navigator 2014 H H Software GmbH 123 Event Logging and Statistical Analysis Calle from Calls to a Usage tom ie un Ase Record IDs licane to ile N Selected All usage to tbe Faun Esee Grouped record ara Selected None Selected All Selected None Selected All Selected None Selected All Document types Sel
39. object you can save and in which you can specify the exact criteria to be used for retrieval of e scripts from the database You can use regular expressions to define and combine even complex query sets Because the queries are saved they are permanently available in the gt E Script Administration program for viewing defined selections of e scripts This helps keep your e scripts well organized In combination with the assignment of gt cumulative properties queries are an important tool for assigning common properties to multiple e scripts Data Editor The Data Editor is for managing creating and editing gt data objects Data objects There are a number of data objects in HAN which you can manage and edit in the gt Data Editor Data objects are allocated to e scripts in the form of properties Specifically data objects in HAN are licenses permissions publishers subjects sources and document types EBSCO EBSCO is the provider of an extensive database with online resources and associated administrative tools HAN can import the online resources provided by EBSCO and save them as gt e scripts making them available from within your HAN system HAN s EBSCO module is an auxiliary component that requires separate installation during the setup of your HAN software E Script A HAN e script is a script that calls an online resource via the HAN server Each e script can have various properties The central element of the e scri
40. of the frameset is linked in the script otherwise only a frame is Hidden Automatic Navigator 2014 H H Software GmbH 63 Providing Online Resources with HAN displayed rather than the entire web page For details on integrating frame based web pages see Frames Example In our example the login page and target page are the relevant pages This is what the script looks like directly following the recording process Main script Varnable Value http www hh testinghar El http www hh han com testares HANIogin cfm g 0 El http www hh han com testarea Tonnlogin index cim g 0 El http www bh han comtestarea Tonnlogin result cfm ig 0 name han pword han submitingx 0 submiting y 0 After optimizing the script looks like this Main script X Vanable Value http www hh han com testinghan El http www hh han com testarea HANogin cifm g 0 El hitp www hh han com testarea Tonnlogin index cim 4 g 0 E hitp www_ bh han comtestarea Tonnlogin result cfm ig o name han Using Flexible URL Parameters When a web page is called session specific values in the URL may be sent to the web server for example to verify the validity of a session When you record a script in HAN these values are fixed in URL parameters If you test it right away the script will work When used later to call a page however the parameter values may have expired in which case the script f
41. on the HAN Settings program includes additional services which are not described here These are services that have been specifically adapted for special areas of use and for internal functions For details on the settings for each of the authentication services see the appendix entitled Authentication Services and their Modules This chapter shows you the settings for authentication and how to configure an authentication service Authentication settings Settings for authentication are configured in the HAN Settings Open the HAN Settings from the HAN Tools desktop shortcut In the HAN Settings select the Authentication page in the Login section Hidden Automatic Navigator 2014 H H Software GmbH Configuration 42 H HAN Settings Save Save and close Tasks Information w Use HAN authentication HTML form login Failed HAN login Use HTTPS for login Tis Services lEI altt _ Service Label Parameter 222 O Use HAN authentication Activates the authentication requirement for accessing HAN We recommend using this option HTML form login Defines the HTML form to be used for HTML login on HAN Failed HAN login In the event of login failure the HTML page specified will be opened to inform the user and depending on your configurations to enable a renewed login attempt Use HTTPS for login Uses HTTPS for logging in on HAN Authentication services Lists all configured authentication services HAN distingu
42. page indicated and if necessary and if the e script is so programmed logs in on the provider s server Provider Browser 4 HAN delivers the target page to the user Provider This method has the following advantages Fixed point of access for e journals Independent of a given website s URL the URL used to call the e journal remains constant and can be permanently stored for example in a library s OPAC system Access control Every time a user calls a HAN URL the HAN server can determine whether that user has permission to access the requested resource For more on the Access Control functions see Authentication and Authorization in HAN Metering Every time a user calls a HAN URL HAN can store statistical data regarding the usage of the e script For details on the statistics functions in HAN see Statistics License Management HAN can monitor and control parallel usage of online resources Help Desk You can configure HAN to open an HTML page of your choice in the event of error for example to provide an explanation or background information e g Login failed or No license available Protection of login data Login on and communication with the content provider involve only HAN and the origin server not the HAN user Login data and other sensitive information is not shown Hidden Automatic Navigator 2014 H H Software GmbH Introduction to users e Location independence lf the requeste
43. predefined value D the parameters with separator has a predefined value The value for this parameter is predefined and does not change It is passed as is to resource provider s server may contain different values replace only if parameter name and value are identical HAN replaces the value in all instances in which this parameter name is paired with this exact value may contain different values replace only if values are identical HAN replaces the value in all instances in which it is found regardless of the parameter in which it is stored In the Replace in field define the position in which the value is to be replaced Replace if parameter names and values are identical To have HAN replace the values for the selected parameter in every instance in which the specified parameter has the specified value select may contain different values replace only if parameter name and value are identical in the Parameter field In the Value field the value is automatically replaced by a variable O HAN Script Editor Define URL Parameter for a Script X Farameter Value Der Parameter Replace in the URL the parameters with separator Replace only if values are identical With this option HAN replaces the value of the selected parameter even when it is found in a different position e g within a URL or as a component of a value in a different parameter Only the value itself must match the selec
44. they are opened Thus a wildcard DNS record is required for correct addressing of the HAN server To enable the HAN web server to process SSL connections without a certificate warning the web server needs a wildcard SSL certificate For details on creating a wildcard DNS record and on requesting and importing a wildcard certificate see Wildcard Configuration HAN 3 Kernel EZB data logging The EZB data logging function creates a daily log of EZB access events if you have installed the EZB module If you wish to use the EZB module without EZB data logging deactivate this function in the EZB settings For details on how to deactivate EZB data logging see Deactivating EZB Data Logging Disk space monitoring A certain amount of free disk space is required to ensure optimum performance and availability of your HAN system The HAN System Monitor tool helps you keep an eye on your system s capacity The System Monitor checks the available disk space continually and automatically sends an e mail message when a certain lower limit is exceeded For details on using the System Monitor to monitor available disk space see Disk Space Monitor Configuring authentication services Authentication services restrict access to your HAN system in accordance with rules that you define For this purpose HAN supports a number of authentication services for example to bind login to a particular IP address or an ADS login For details see Configurin
45. unchanged e The root URL has changed e The licensing period has changed e The anchor and the URL have changed Exception If no licensing period has been defined i e the corresponding field is empty and the anchor and URL have changed a new e script is created In all other cases a new e script is created z When EZB updating is blocked for a certain e script it is also blocked for the entire e journal that the e script accesses The journal is identified by its EZB ID This means that no changes are made for a blocked journal not only is no update performed no new e script is created for a new licensing period either nor will the e script be deleted if it no longer exists in the EZB Furthermore the E Script Administration program detects whether an EZB e script has been modified manually in the administration program such as a change in the root URL or the addition of URLs and if so informs the user that this change will be overwritten during the next update if updating is not disabled for this e script The only way to prevent such modifications to an e journal from being overwritten is to disable automatic updating for the e script in question Event Logging and Statistical Analysis This chapter describes how to maintain records of the usage of your HAN system and how to run statistical analyses of the recorded data The results of these analyses provide you with well founded reliable usage statistics The statistical ev
46. use Hidden Automatic Navigator 2014 H H Software GmbH HAN Components 138 d Self signed certificates should be used for test purposes only For details on importing certificates see HAN System Settings HAN Webservices Requesting and Importing Certificates in the HAN online help For details on creating self signed certificates see HAN System Settings HAN Web Services Creating Self Signed Certificates in the HAN online help Configuration In the Configuration section specify the HTTP and HTTPS ports for HAN and define the IP addresses that HAN listens on Appendix The Appendix contains additional information about HAN much of it in the form of tables Specifically the following information can be found here e Authentication Services and their Modules A table listing all of the authentication services compatible with HAN with descriptions and parameters e Values for the Type Query Criterion A list of all values for the Type query criterion Authentication Services and their Modules HAN supports the following authentication services Authentication service Module ADS login auth_ads dll ALEPH login auth_aleph dll Elektra login auth_elektra dll IP address host name check auth_ip dll LDAP login auth_Idap dll NT login auth_nt dll ODBC interface to existing auth_odbc dll databases ODBC SHA 1 interface auth_sha1 dll SIP2 login auth_sip2 dll SISIS login auth_sisis dll xServer login auth_xserver
47. variable For details on using flexible values for this type of parameter see Parameter has a random value The script still fails to execute however because HAN cannot detect the current value of the VIEWSTATE parameter If the home aspx page is loaded separately beforehand using the GET method HAN can read the HTML code and detect the required parameters Main script Xx Variable Value http www onlinejoumal com O http www _onlinejoumal com h Spx El http www onlinejoumal com home aspx VIEWSTATE _HANURL_O_ cthHeader xt Search ctiNavigation LoginttUserlD _HANURL_USER_ ctiNavigation LoginttPassword _ HANURL_PASSWORD_ hdnJoumallD 312 Result QID ctiNavigation LoginimgbtnOKx 14 ctiNavigation LoginimgbtnOKy amp Parameter has a random value lf a parameter has a random value such as a session ID you can replace it with the predefined _HANURL_N_ HAN variable The procedure is similar to that described for making parameters flexible Rather than double clicking to open the properties however in this case you need to right click on the parameter in the Script Editor and select Hexible parameter from the shortcut menu The following options are available in the Parameter field Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 68 E HAN Script Editor Define URL Parameter for a Script X Farameter time Value Der Parameter has a
48. well as how to optimize manually recorded scripts Using Flexible URL Parameters explains how to make your e scripts more flexible by inserting variables in place of session specific parameters Conditional Scripts provides details on customizing e scripts for reliable use with web pages that have both blocked and accessible areas and for logins that are required only when a user attempts to access a blocked area Frames describes how to optimize your e scripts for use with frame based web pages Allocating Licenses describes how to have HAN associate licenses with your e scripts to ensure licensing compliant use of the online resources you provide Hidden Automatic Navigator 2014 H H Software GmbH 55 Providing Online Resources with HAN Creating E Scripts a e A HAN e script contains a script that calls an online resource via the HAN server In addition to that script each e script stores a number of properties For details on what properties an e script can have see Managing HAN Resources E Scripts The central element of an e script is the script which both initiates the call of an online resource and defines certain behaviors or conditions associated with the call This script can include an automatic login on the origin server for example or can navigate the user to a particular HTML page Further definable properties may include licenses or permissions which can optionally be associated with the e script
49. 0 This table shows that a total of 831 PDF documents with a volume of more than 30 MB each were called The Database source detail single record view shows that the Elsevier Science electronic journal magazine was called five times by the UNI LIBRARY user which is actually an ID under which all users located in the library are grouped Total calls Bytes Bytes per call Percentage of IDs in total calls Percentage of IDs in total bytes Started Ended User Station Bytes Attribute Document types 05 06 2006 13 11 40 05 06 2006 15 16 26 UNILIBRARY 194 29 49 713 992 HTM Total calls 3 Bytes 22 944 PDF Total calls 226 02 06 2006 14 09 14 02 06 2006 15 49 10 UNILIBRARY 194 29 69 598 753 PDF Total calls 142 Bytes 62 053 760 GIF Total calls 02 06 2006 11 26 45 02 06 2006 12 25 13 UNILIBRARY 194 29 78 148 363 PDF Total calls 158 Bytes 75 730 239 HTM Total calls 02 06 2006 11 03 08 02 06 2006 11 25 30 UNILIBRARY 194 29 38 566 380 GIF Total calls 17 Bytes 19 259 JPG Total calls 1 Byt 01 06 2006 11 08 10 01 06 2006 12 10 50 UNILIBRARY 194 29 44 533 255 GIF Total calls 31 Bytes 78 102 PDF Total calls 85 B 01 06 2006 10 18 59 01 06 2006 11 53 48 UNILIBRARY 194 29 58 141 863 GIF Total calls 59 Bytes 41 845 JPG Total calls 1 Byt In each call at least one PDF with at least 30 MB was loaded On 2 June 2006 14 09 to 15 49 168 PDFs were called for a total data transfer of
50. 0 00 400 00 The single record view by origin shows details on the use of PDF documents For example SerSol was used on 1 June 2006 by the user called E1815U for just under an hour from 00 34 27 hours half past midnight to 01 22 00 hours A total of approximately 2 3 MB was transferred as shown in the Bytes column 2 387 527 bytes The Document types column PDF Total calls 28 Bytes 1654538 shows that PDF was the only type of document transferred This column shows the following data lt document type gt Total calls lt number of documents gt Bytes lt size in bytes gt Other types of documents may be accessed during a given call where this was the case these are indicated in the Document types column as well as shown in this example GIF Total calls 34 Bytes 123637 JPG Total calls 1 Bytes 8677 PDF Total calls 2 Bytes 569073 As listed in this table user E1815U called 28 PDF documents with a total volume of approximately 1 6 MB while using the SerSol HAN account The next example shows how to determine which users loaded particularly large PDF documents To do this the Bytes from setting Maximum minimum in the selection pane to the left is now set to 30 000 000 bytes 30 MB Hidden Automatic Navigator 2014 H H Software GmbH 133 Event Logging and Statistical Analysis Detailed inf on G10 317 722 756 382 343 100 00 100 00 6310 O17 22 756 ao2 0d0F 100 00 100 0
51. 06 06 2006 10 46 37 UNI LIBRARY 194 29 157 2 1 907 426 Elsevier Science electronic jo 06 06 2006 10 31 01 06 06 2006 10 42 53 UNI LIBRARY 194 279 152 161 5 035 035 Elsevier Science electronic jo 06 06 2006 10 42 15 06 06 2006 10 43 02 UNI LIBRARY 194 279 172 116 5 909 147 Elsevier Science electronic jo 06 06 2006 10 19 47 06 06 2006 10 43 49 UNI LIBRARY 194 229 133 171 4 320 352 Elsevier Science electronic jo 06 06 2006 10 06 16 06 06 2006 10 10 36 E5343U 62 179 0 15 246 053 Cross table You can use cross tables to carry out additional calculations Data can be cross calculated as follows in this example Record ID is the calculation basis e Record ID Periods e Record ID Users e Record ID Stations To calculate a cross table click on the Cross table icon in the sidebar to the left of the main table HAN calculates a cross table from the selected data cre Record ID Cross table Elementa Journal of Slavic St Elsevier Science electronic jo Emerald Management Xtra Energy and Buildings Energy Economics Energy Journal The Energy Journal Elementary School Guidance and Energy Conversion and Manageme To change the calculation basis of the cross table click on Cross table in the task bar and select the desired basis Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 128 d You can also calculate the cross table directly as follows select the desired cri
52. EZB dialog page to the Global section Enter the data for access to the EZB here HAN Settings 2 jox Settings a HAN Save Saveand Global Login Tools clase HAN Tasks Configuration Library login data Information w Preferences Library ID urii Use eoo ee ee ma Show displays the password in plain text Make sure you save your settings by clicking on Save in the Ribbon before closing or navigating away from this page After that you can quit the settings program or configure other settings d Click on Save and close to have the HAN Settings program close automatically after saving your settings Configuration The first step following the installation of HAN is the configuration of the global settings General settings are configured in the HAN Settings program The options in the HAN Settings program are grouped in various sections on the following dialog pages Global e Global e E Script e Help Desk e Proxy e System Monitor e Restricted Domains e Global Document Types Hidden Automatic Navigator 2014 H H Software GmbH Configuration 28 e URL Rewriting e Recording Authentication e Authentication e LDAP EZB e Global e Preferences Basic configuration steps in HAN The following steps are required directly after installation of HAN Wildcard configuration With the new HAN 3 kernel the HAN URL rewriting engine modifies the structure of the e journal URLs when
53. Fa The new setting is effective immediately The HAN License Monitor shows the number of licenses in use Open the HAN License Monitor from the Windows Start menu by selecting All Programs H H HAN HAN License Monitor Managing HAN Resources This chapter describes the optimum methods for managing your HAN e scripts E script management tasks are implemented in the E Script Administration program The chapters linked below provide details on managing your e scripts e E Scripts describes the general functions of e scripts and how to work with them in the E Script Administration program This chapter provides details on all e script properties and explains how to import and export e scripts e Data Editor describes how to use the Data Editor for editing certain properties which are then assigned to e scripts These can include for example licenses permissions and subjects In addition you can manage queries in the Data Editor e Using Queries describes how to work with HAN database queries to organize your e scripts Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 86 and how to group them so you can assign common properties e A to Z List provides details on the functions of the A to Z List which lists all of your e scripts alphabetically E Scripts T AHAN e script is a script that calls an online resource via the HAN serwer Each e script can have different properties The central element
54. H H Software Hidden Automatic Navigator Version 3 2 H H Software GmbH Maschuehlenweg 8 10 37073 Goettingen Phone 49 0 551 52208 0 Fax 49 0 551 52208 25 E mail hh hh software com Internet www hh software com Contents Introduction Documentation Conventions Support Ideas and Suggestions New in HAN 3 System Requirements Contents of This Manual Installation Installing HAN Registering Your HAN Software Updating from HAN 2 Configuring EZB Access Configuration Wildcard Configuration HAN 3 Kernel Deactivating EZB Data Logging Disk Space Monitoring Configuring Authentication Services Defining Permissions Customizing HAN for Your Company Providing Online Resources with HAN Creating E Scripts No Manual Recording Required Using Manual Script Recording Using Flexible URL Parameters AJAX Login Conditional Scripts Frames Allocating Licenses Managing HAN Resources E Scripts Exporting E Scripts Importing E Scripts Data Editor Licenses Using Queries Defining Queries Allocating Properties A to Z List EZB and HAN EZB Configuration in HAN Configuring HAN Settings in EZB Administration Manual Import from EZB Automatic Collating Discussion Rules for EZB Udate Event Logging and Statistical Analysis Access Log Statistics Total Usage Concurrent Use Document Types Hidden Automatic Navigator Contents 11 11 12 12 15 15 16 16 19 25 2 27 29 38 39 41 48 53 54 55 56 58 63 11 76
55. N 84 Main script xX Variable Value E O http www bh han_ comtestarea trame index cim gt eS ee When you test the script it now opens the complete web page Allocating Licenses You can configure HAN to restrict parallel usage of online resources For example you could enter the number of licenses purchased for a particular e journal as the maximum parallel instances permitted in your system 1 In E Script Administration double click on an e script to open the e script properties 2 In the e script properties select the Control page 3 Tick the box next to Activate licensing Licensing is now active for the selected e script E script properties Onlinejournal com HAN kernel 3 Global O Licensing Meta Infarmation J Activate licensing License ID gt Object Properties W Activate data logging onlinejournal com Domain List E Licensing W Activate licensing lt License ID gt Data logging W Activate data logging onlinejournal com 5 In the License selection dialog select a license d Licenses are created in the Data Editor For details on creating licenses see Managing HAN Resources Data Editor Licenses Hidden Automatic Navigator 2014 H H Software GmbH 85 Providing Online Resources with HAN 6 Click on OK to confirm The license is assigned to the e script EJ Licensing s _ _oH H SS SS STS Information w W Activate licensing Oniinejournal com E
56. N system Hidden Automatic Navigator 2014 H H Software GmbH Configuration 48 Defining Permissions Your HAN program can restrict access to certain resources based on Permissions that you define Permissions define the conditions that users or client machines must meet before they can access the requested HAN resource If the defined conditions are not met an error message and or a login page of your choice is opened Permissions can be allocated based on any of the following e Host name e P address e Variables LDAP group or OU e AD user account e AD user group e User OU Each condition must be checked by a corresponding Authentication Service When login is successful the authentication service can store user specific data in envronment variables When an e script is called the user s or client s permissions are checked against the corresponding values configured in the e script before the access to the resource is permitted If the user client does not qualify for the permission the specified error page or login page is shown For details see Configuring Authentication Services Creating permissions Permissions are created edited and managed in the Data Editor The ribbon in the E Script Administration program has a button that starts the Data Editor 1 To start the E Script Administration program use the HAN Tools desktop shortcut ll d For details on working with the E Script Administration progra
57. This chapter describes how to create and edit e scripts There are two ways to create a new e script e Without manual recording e g when authentication is based on IP address or when login uses an HTML login form e With manual recording e g when explicit login is required on the origin server E scripts created without manual recording lf the root URL of the online resource is also the target URL in the e script then no manual recording is required when you create the script Simply create a new e script and write in the root URL for the online resource the e script is functional right away For details on creating an e script without manual recording see No Manual Recording Required E scripts created with manual recording Manual recording is required whenever the root URL and target URL for the e script are not the same for example because a login or other manual user activity is required The first step as for the method without manual recording is to create the e script Then you initiate the recording process and begin navigating to the desired target page handling whatever steps are required for access to the resource Once you reach the target page you end the recording mode and save the script You also have the option of running HAN s testing utility to check the functioning of the script For details on creating an e script using manual script recording see Using Manual Script Recording Optimizing a scrip
58. To manage your Views and use them for calculations click on Views in the menu bar Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 130 Concurrent Use The concurrent use table lets you compile data on simultaneous usage of online resources provided by HAN This can be useful in determining the number of licenses you should acquire for a given e journal Open the HAN Statistics application and select the criteria for calculation For details on the predefined calculation options and on selecting the criteria manually see Total Usage In the Calculate a table dialog select Table of concurrent use a If you have already calculated a main table simply click on the Table of concurrent use icon in the table selection sidebar to calculate the concurrent use statistics from the data in the main table Calculate a table The table has the following columns e Record ID For concurrent use tables the record IDs is always the basis of calculation e Licenses Optional value the number of licenses allocated by HAN e Max Highest number of simultaneous users e Days Number of days on which the maximum concurrent use was reached e Duration The longest period of concurrent use The five next lower values after Max are shown as well to help you distinguish trends and anomalies In the example below the data from the examples in the Total Usage chapter form the basis for a
59. WJSJRPSRUEKUSVZ5KOwEA YI Kw YBBAGCNXUBBAMCAQAwDO YJ Ko Zl hycNAGEFBGADggIBAMURTOMB6YN IdUhF3 7K Neiybb 0t YI 1cEwO2HCL6BAM1 tshj Jp Hby lt 01AxBLEmASap UGigvN K4bszD6aztac 14rH Ors YONsGb Pmw4 TOMO MBINoyb UVMA 63a ToQN De kbQ Uu ToVUWw2zb1TS7Ku UKSSeimgh Ij Aw EwbO FibUVDuVG 1 FiQuVNFSQFO KaJ6hbgr3su 7Alllgc WxWs6UTOG0OIS6VA loPILY YY 7hr TbboMLAhyp RLS Kg A kwsj2nwiFsRCABJCcrSwC3nRircl yElKeDwtoDl0 JlegmShyn TNW 24C99d6 TnjpiWiG54ohVHbkGsMGJaysx acMZRaE0Mmg2vavary 5A4ra69c Mw PeS yxe40 RM4oj be KFVmod GLBOOKgv 1Fmop T 1 EpamlhBr rcwkisy BEASOCxRDaKbnCk sy 44IC VitGiziGsJAM gUisp bASRiAzZ fv V fsa 7 302 lad laBC d Y4dcexithtWe y bilAGkO Bi X b MI VmjAAGsdtOy 2k 6i V 24u 20d r S5bd k 1h UweABbFDxpy Yk Stesuo YTS6C WIIKKSFDKSkwid lEPudjeahhAuz ImyezoMT AGJppSSoypZin gET TCSPW4hFCHJPeDD YpmUrotaGdmUNSP Da END CERTIFICATE 3 The Certificate Wizard creates a certificate file from the certificate and enters its name in the File with the certificate crt input field If you a received a file rather than plain text in an e mail browse to the CRT file you received and select it Enter the password Select Alternative file with the private key key only if you did not create the certificate request using the HAN Certificate Wizard The program expects the certificate and key files to be in the DER format This is also the format used when you create the certificate request using the HAN Certificate Wizard Hidden Autom
60. a wildcard certificate must be requested from a certificate authority and imported into HAN Creating a wildcard DNS record A wildcard DNS record ensures both correct resolution of the HAN server name and that the name resolution functions properly even when any number of other server names or parts of names precede the HAN server name in the URL In practical terms this means not only that the HAN server can be addressed by its actual name but also that its name can be resolved correctly even if there is no explicit entry for it in the DNS Thus the wildcard DNS record is necessary because when HAN 3 rewrites a URL it moves the e journal provider s server name to the first position http lt provider server name gt lt HAN ID gt lt HAN server gt page html Configure the wildcard DNS record in the DNS as follows Create a new host in the relevant domain with the following data New Host X Name uses parent domain name if blank lt ceryer name gt Fully qualified domain name FQDN lt server name gt docudom local IP address 192 164 1 65 Create associated pointer PTR record Allow any authenticated user to update DNS records with the Same owner name acevo conc Name your HAN server lt HAN server name gt This yields the following as fully qualified domain name lt HAN server name gt lt domain gt In the IP address field enter the IP address of the HAN server Kee
61. age for setting up a license account A link will be e mailed to you to verify the account before you can use it Hidden Automatic Navigator 2014 H H Software GmbH Installation 22 Product activation Windows Internet Explorer Ioj xj oy A f https www hh software com hanlogon ing Y a k 4 0X Bing Pie qir Favorites q3 Suggested Sites E Web Slice Gallery Product activation T Gl gt E a Pag Safety Tods i https wew hh software com hanlogon a H H Software GmbH Product activation H H HAN License account log in You can use your E Mail hanuser mail com license account to manage your product keys aggregate your Password license codes and request test licenses Forgot password If you don t have an account please Log IW s3 register Sign in fnaniogonjindex cfm Internet Protected Mode OfF 2 Add Click on the Add key button in your license account to add a new product key H H Software GmbH Product activation Hidden Automatic Navigator H H HAN Product activation Subscription Product key Product key ID Productkey Version License type CALS Valid until extend Download license aoe Hidden Automatic Navigator 2014 H H Software GmbH 23 Installation 3 Enter the product key Enter the product key you received on purchasing HAN in the Product key field and click Save d The produ
62. aging HAN Resources 88 Exporting E Scripts You can export existing e scripts at any time in XML format hanex for archiving or exchange E script export is handled in the E Script Administration program 1 In E Script Administration select the e scripts you wish to export 2 Open the program menu and select Tasks Export Ty HAN E Script Administration ee Task Assignments gv CSV Import ES Importing scripts from a CSY file Tasks ga Import Auz Import the selected e scripts from the exchange gg Utilities b folder Esi Diagnostics E script exchange folder 2 Language b Onen the avrhannae folder fnr a_errinte in the ae E A oats f te HAN Tools Options 4 Information Help lea Exit HAN saves the selected e scripts in the E script exchange folder id To open the E script exchange folder at a later point select Tasks E script exchange folder from the program menu 3 At the end of the export operation you are prompted to open the E script exchange folder if desired Be sure to check whether all e scripts have been exported correctly Hidden Automatic Navigator 2014 H H Software GmbH 89 Managing HAN Resources Importing E Scripts This chapter describes how to import e scripts For details on exporting e scripts see Exporting E Scripts For details on importing e scripts from the EZB see EZB and HAN HAN permits e script import from two sources e An e script exchange fi
63. ails This is why HAN offers the option of using flexible parameters which store their values in variables With this feature HAN does not send the parameter value saved in the script but rather the current value used by the origin server valid in the session from which the URL is called The following demonstration illustrates this technique 1 Create a new e script with http www hh han com testarea cookie index cfm Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 64 1g 0 as starting URL and the then begin recording in the Script Editor option selected in the Create field For details on creating e scripts see Creating E Scripts No Manual Recording Required 2 Enter the user credentials HAN HAN and click on Login 3 Click on Exit to stop the recording process On conclusion of recording the script is shown in the Script Editor as follows d We have already optimized this script by removing unneeded URLs For details on optimizing scripts see Creating E Scripts Using Manual Script Recording Main script Variable Value El O http www _hh han comestarea cookie index cim ig 0 E http waw hhhan comtestarea cookie result cfm ig 0 CFID 1131302 CFTOKEN 566159014 name han The CFID and CFTOKEN entries are URL parameters that have different values each time the page is opened d When you create an e script you might not know which parameters have d
64. aluation tools include options for selecting time periods generating custom charts of usage data and analyzing aggregate data using metadata objects All statistics functions can be accessed through the HAN Report Center The Report Center gives you a range of web based tools for monitoring and evaluating usage of your HAN system Open the Report Center from the HAN Tools desktop shortcut a HAN Report Center mie Analysis of e script usage Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 114 The starting screen of the Report Center shows the tools available lf a certificate error is reported when loading the Report Center or the Statistics program that means no valid certificate has been registered for the web server For details on requesting and importing certificates see HAN System Settings HAN Web Server Requesting and Importing Certificates Still there is no harm in loading the page at this point simply select Continue loading the page gt H H HAN Report Center Windows Internet Explorer Joj x a y r g http idocudiv2008 eng deqidomain okal HANWebApps HANWebApp z X Bing lt we Favorites es Suggested Sites Web Slice Gallery H H HAN Report Center fy Gl gt E a Page Safety Tods H H HAN Report Center Statistics program Access log il Po Summarized iog A Event log xl E NEE Statistics progra
65. anel under System and Security H H HAN Pa H H HAN et HAN Database HAN Web Service HAN Service Open the HAN System Settings or to open the HAN web service directly select HAN Web Service On the HAN Web Services page you can configure settings for the HAN web service Ox a i FA HAN System Settings tt ka Settings HAN Save Save and Start Stop Restart Tools close HAN Tasks Service System settings Information w a Version information HAN Web Services httpd exe 22 210 d Bran Web Services mod han3 dll 3 0 0 406 b DE configuration Cal Certificates _________________ File E HHHAN Bin Websrv ssl server crt Z l Configuration P HAN Service Use reverse name resolution for IP addresses Bound IF addresses W Use all available IP addresses 10 210 1 59 ui The following settings are configured here Service Controls for the web service are in the ribbon The Start Stop and Restart buttons start and stop the web service The Error log and Access log buttons in the lower portion of the dialog open those logs and the Delete log button deletes the log files Certificates The File field specifies which certificate file is used Click on the Edit button to the right of this field to open a wizard for importing an official certificate or creating a self signed temporary certificate Click on the Information link to view detailed information on the certificate currently in
66. at match the isbn parameter value throughout the entire script Once all variables have been added the script appears as follows in the Script Editor Main script X Variable Value http www onlinemag com http Aww onlinemag com johnson_basic hitps ogin onlinemag com E hitps Aogin onlinemag com login login call Login Weblet email HANURL_USER_ password _HANURL_ PASSWORD _ goto_un sites HANURL_O view0 etemal chrome sites HANURL_O_ chrome vm E _HANURL_C Replacing a session ID in a URL In some cases the session ID is not appended to the URL but rather is a fixed part of the URL itself With HAN you can replace this URL section if desired Here is an example 1 In the URL http server directory 908735cd12 file htm the Session ID is 908735cd12 Select the URL and right click to open the shortcut menu 2 In the shortcut menu select Hexible parameter 3 In the Replace a part of a URL in this script with a flexible parameter dialog select that portion of the URL which precedes the desired value so that HAN can detect which part of the URL is to be replaced Hidden Automatic Navigator 2014 H H Software GmbH 71 Providing Online Resources with HAN DN HAN Script Editor x _ Replace a part of a URL in this script with a flexible parameter http fp server com http fp server com directory http fp server com directory 908735cd 12
67. ate IP Address Submit getElementById lt HTML ID name of the Submit feld gt URL Rewriting Insert scriptin the following page URL lt URL in reg expressions gt Restricted Adresses indudel int Notes send login data to the following domain 6 Under General login data enter the login name and password 2 General login data User Password TELITI T Click on OK to save the settings The next step is to define the AJAX login First you need to know what type of identifier is used to address the HTML elements in the web page that save the login data and perform the login To find out examine the code in the web page Open the login page by selecting the page s URL in the Script Editor and clicking on Browser in the ribbon d Use a browser that has a developer view This example uses Internet Explorer 9 but other browsers offer comparable functions The browser you use must be set as the Windows default browser HAN Script Editor HANID journal of reproductive medicine title Journal of Reproductive Medicine Editor Wp l A d l a 4 se 6 8 is HAN New Save Save and Properties Test Create Edit Delete Create Start Exit Tools close conditional serip E Script URL Recording Main script Variable Value http www reproductivemedicine com 8 Open the browser s developer view in Internet Explorer 9 press F12
68. ate or deactivate a service as needed while its configuration settings remain stored 5 The parameters you can configure for the selected service are listed under Service configuration A parameter is configured by entering a value for it In our example a file is required as the value thus the Select button opens a File Dialog for selecting a file a Parameter names written in red indicate required parameters those written in black are optional tis Service configuration Parameter For our example we specify a CFG file that contains the permitted IP addresses Hidden Automatic Navigator 2014 H H Software GmbH Configuration 46 Tia Service configuration Panes Value Ct File C HH HAN Bin System iweb bin ipranges ctg 6 Your HAN program lets you set an expiration time for the validity of login credentials This function is activated by selecting the Use persistent cookies for login option When this option is active you can set the period in hours of validity for a login d To use this option the user s browser must accept cookies from the HAN server If no persistent cookie is set the login credentials remain valid until the user closes the browser T Under IP configuration you can define permitted and excluded IP addresses d The IP login option is the only authentication service that has a section for configuring permitted and excluded IP addresses This section
69. ated To activate HAN you need to import a license file The license file is obtained by downloading it from your license account This chapter explains how to activate your HAN software If you do not have a license file see below for details on registering the product key in your H H license account and downloading a license file Activating HAN d If you have not already downloaded a license file check the box labeled Go to activation page in the Activation wizard Alternatively you can log in directly to your licensing account For details on how to download a license file see Downloading a license file To run the Activation wizard at a later point navigate to the All Programs H H HAN folder in the Windows Start menu and select the wizard d If you download a license file at this point rather than importing an existing file HAN will import the downloaded file automatically 1 To have the Activation wizard open automatically after installation select the Run the HAN Activation wizard option at the end of the installation process Hidden Automatic Navigator 2014 H H Software GmbH Installation 20 HAN 3 InstallShield Wizard H Te de nN InstallShield Wizard Complete Autom all C The InstallShield Wizard has successtully installed H H HANS N Click Finish to esit the wizard Navigator Convert data from version 2 x to version 3 0 M Aun the HAN Activation wizard 4 Back ance Alternatively you can run t
70. atic Navigator 2014 H H Software GmbH 37 Configuration NetMan Server Certificate Import a Server Certificate Please specify the file containing the certificate to be imported The automatically generated private key will be applied Atematively you can specify a separate file containing the private key to be used Altemative file with the private key key Password for the Private Key of the Certificate 4 Click Finish to import the wildcard certificate Once the import has been completed you need to restart the web service to integrate the certificate FA HAN System Settings Following the reboot your HAN server and all of the sub domains created by the addition of provider addresses to URLs are certified Certificate authorities for wildcard certificates To select the right certificate for your needs consider each of the options available Wildcard certificates have various attributes e Time span Period of validity e Validation method Hidden Automatic Navigator 2014 H H Software GmbH Configuration 38 e Level of encryption e Payment methods e Time to issue e Insurance Financial guarantees The shorter the period of validity the lower the price when the certificate expires however you will need to renew or replace it Some certificate providers also offer discounts on longer time spans such as a low annual price for example thus if you need the certificate for a long time choosing
71. b browser over SSL you need server certificate You can either create request a new server certificate or import a server iificate Task ie Create or request a new server certificate Import a server certificate 4 Under Specifications enter the specifications of the required wildcard certificate Check with the certificate authority concerning their requirements for a certificate request in Hidden Automatic Navigator 2014 H H Software GmbH Configuration 32 particular with regard to the key size last field Otherwise your request might fail in which case you would have to create and send a new request HAN Server Certificate Create a New Server Certificate Please enter all required information for your server certificate Input is required in all fields Please do not use umlauts or other special characters Wildcard DN example acmeco com HANSERVER com Name of the company example Acme Company Inc ACME Co Name of the department example Data proc dept Development City not abbreviated example Anaheim Anaheim State not abbreviated exa a Calfomia Country code 2 letters example US 2 Jus E mail address example intof acmeco com dev acmeco com Key size bts N Under Wildcard DN enter the name of your web server using the asterisk as the wildcard for sub domains In the Key size bits field select the key size specified by the certificate authority
72. cal titles but gives it a new HAN ID e will be overwritten note the root URL will not be overwritten HAN overwrites the existing e script Note that the root URL cannot be overwritten thus the root URL in the existing script is retained Hidden Automatic Navigator 2014 H H Software GmbH 93 Managing HAN Resources e will be skipped If a dublicate is found in the target location the e script is not imported 6 Click on Import to continue HAN imports the CSV file and saves the data records as e scripts The Import e scripts from a CSV file dialog shows a progress bar indicating the progress of the import operation CSV record 2 CSV data had no HAN ID new HAN ID hantest created based of title HANTest CSV record 2 New e script with ID hantest created CSV record 3 CSV data had no HAN ID new HAN ID hantest3 created based of title HANTest3 CSV record 3 New e script with ID hantest3 created CSV record 4 CSV data had no HAN ID new HAN ID hantest4 created based of tite HANTest CSV record 4 New e script with ID hantest4 created 4 new e scripts created CSV Import finished In this example the e scripts already exist so HAN creates a temporary HAN ID Because this ID already exists in the database the second step is for HAN to create a new ID by adding a sequential numeral to the temporary HAN ID In the last step the e script is created Following the import operati
73. calculation of concurrent use statistics for the month of June 2006 H H HAN Statistics Selection Tables Settings H H HAN Statistics _ i Ja Cross table Print gt Export Current selec Periods h CEI CCI Record ID Max Days Duration Max 4 Days 1 Duration 1 Max 2 Days 2 Duration 2 Max 3 Da b EEE EE Electronic Library 4 1 00 04 13 3 2 00 02 08 2 1 00 14 29 1 4 gt Elsevier Science electronic jo 4 2 00 10 13 3 1 00 15 56 2 2 00 18 04 0 E gt Springer ICM 3 1 00 05 20 2 1 00 01 21 1 3 00 43 44 0 P CRC Press ENGnetBASE Enginee 3 1 00 01 59 1 3 00 17 45 0 0 00 00 00 0 gt Wiley InterScience 2 1 00 01 28 1 4 02 27 25 0 0 00 00 00 0 gt SerSol 2 4 00 27 55 1 1 00 20 57 0 0 00 00 00 0 gt Scopus 2 3 00 11 52 1 2 00 19 11 0 0 00 00 00 0 gt SCI Science Citation Index 2 1 00 02 40 1 3 01 09 15 0 0 00 00 00 0 gt Royal Society of Chemistry 2 1 00 00 06 1 3 00 05 13 0 0 00 00 00 0 P Knovel 2 3 00 19 45 1 1 00 47 38 0 0 00 00 00 0 gt INSPEC 2 1 00 02 44 1 4 01 09 03 0 0 00 00 00 0 The table shows concurrent usage of the Elsevier Science electronic journal e script on 4 occasions on each of 2 days for a period of 10 minutes 13 seconds It can also be seen that this concurrent use was not an exceptional occurrence as the following peak shows concurrent use 3 Hidden Automatic Navigator 2014 H H Software GmbH 131 Event Logging and Statistical Analysis times on one day for a total of more
74. can activate your HAN 3 program For details on activating HAN 3 see Registering Your HAN Software 11 Click on Finish to close the installation program HAN is then installed in accordance with your Hidden Automatic Navigator 2014 H H Software GmbH 19 Installation settings If you selected further tasks during configuration of the installation the corresponding programs are launched If you installed the EZB module the HAN Settings program is opened to the EZB page so you can configure your EZB access Following installation you need to configure your HAN program For details on configuring HAN see Configuration For details on configuring EZB access see Configuring EZB Access Before you can use HAN you need to register the software Otherwise HAN will stop working at the end of the 30 day period For details on registering HAN 3 see Registering Your HAN Software d You can modify or add to the installed components at any time To do this open the Windows Control Panel and under Programs Programs and Functions select H H HAN 3 and click on the Modify button This opens the Installation wizard for adding and removing components Registering Your HAN Software HAN can be registered and activated only if you placed an order for the software When your order is received a HAN 3 product key is sent to you with which you can register HAN in your H H license account Following installation the HAN program has to be activ
75. cannot be updated to HAN 3 If you have been using the beta version you need to deinstall it first before you install HAN 3 Use the e script export function to save your e scripts called HAN accounts in the previous version and import them into HAN 3 For details on exporting e scripts see the user manual Managing HAN Resources E Scripts Exporting E Scripts The procedure for installing and licensing HAN is explained in detail in the following sections Installing HAN describes how to install HAN on your servers Registering Your HAN Software describes how to license HAN following installation Updating from HAN 2 describes how to update from HAN 2 to HAN 3 Configuring EZB Access describes how to configure HAN for access to the EZB This is prerequisite for use of the EZB module Installing HAN This chapter describes how to install HAN Install HAN on the console of your server d A valid HAN license is required before you can complete the installation z When installing HAN on Windows Server 2008 or later keep in mind that with the default settings Microsoft restricts user privileges in the ProgramFiles directory HAN installs by default in the C HH HAN directory If you wish to install HAN in the Windows program directory instead remember that you will need to assign privileges accordingly 1 Run the Setup exe file to start the HAN installation program 2 When the Welcome page opens click on Next 3 Click
76. cial Times Root URL http www ft com home us HAN ID financial times Create and do nothing else The name in the HAN ID field is generated automatically by HAN you can edit the HAN ID if desired d The HAN ID has to be unique as it is the primary identification criterion within HAN In the Create field you can choose an action to be executed by HAN automatically after creating the e script e and do nothing else No further actions are automatically carried out after the e script is Hidden Automatic Navigator 2014 H H Software GmbH 57 Providing Online Resources with HAN created e then open e script properties The e script properties dialog is opened automatically e then open it in the Script Editor The newly created e script is automatically opened in the Script Editor e then begin recording in the Script Editor The e script is opened in the Script Editor and the recording mode is activated Because we are creating a script for which no manual recording is required i e which we do not need to edit we select and do nothing else 4 Click on OK to confirm your input The new e script is saved and is displayed in the E Script Selection HAN E Script Administration Organize aA f Load an 0 T Reset HAN New Properties Edit Reload Test Tools ras e scriptst EH Fi HAN E script Query EZB 0 to 9 Query the title E fe 0 9 ne g4 Titles starting with
77. conditional script The last part of the example shows how to define flexible parameters for the conditional script Creating a conditional script requires the following steps 1 Recording 2 Creating a conditional script Hidden Automatic Navigator 2014 H H Software GmbH T7 Providing Online Resources with HAN 3 Define flexible parameters for the specified condition 4 Optimizing and testing the script See Define flexible parameters for the URL below for details on defining flexible parameters for a condition that has a value in the URL This example uses the H H HAN test site to illustrate the procedure Recording 1 Create an e script with http www hh han com testarea scriptlogin index cfm 1g 0 as the starting URL and select then begin recording in the Script Editor under Create x Tite Conditional Skript Root url http fwww hh han com testarea scriptogin index ctm lg 0 HAN ID conditional skript Create and start url recording for the e script 2 Click on the Login control using an ID appended as URL parameter link Hidden Automatic Navigator 2014 H H Software GmbH P roviding Online Resources with HAN Hidden Automatic Navigator Windows Internet Explorer Kray ey a http www hh han oom testarea scriptogin index ctm E bkd x b Bin r Favorites on Suggested Sites Web Slice Gallery amp Hidden Automatic Navigator fn R Hidden Automatic Navigator
78. could be a very large amount of data d For groups a filter is created in HAN 3 1 Enter the path to your HAN 2 installation and a path for the conversion log file Hidden Automatic Navigator 2014 H H Software GmbH Installation 26 E3 HAN 3 Migration Wizard x amp _ HAN 2 installation Home path find hh han C HH HAN2 Bin E HAN 3 installation Home path CHHIHANBin ES Options Copy e scripts Copy sequential database aia Copy raw database cia Copy permissions Copy linceses Copy document types Copy publishers Copy sources Copy subjects lt a a a a a a Copy authentication services 2 Specify whether you wish to import the log files HAN statistics data as well This option is not available in HAN 3 Beta d When log files are converted from earlier versions HAN 3 log files are automatically deleted 3 Click on Start to begin converting the HAN accounts e scripts and statistics data to the HAN 3 format Hidden Automatic Navigator 2014 H H Software GmbH 27 Installation d Important Do not copy the databases from HAN 2 to HAN 3 Always use the update function for this purpose HAN 3 uses a totally new database format that is not compatible with files from the earlier version For a detailed description of the options in the Migration Wizard see Migration Wizard Configuring EZB Access Following installation the HAN Settings program automatically opens its
79. ct key is made up of five groups of five characters separated by dashes It contains only capital letters and numbers no lower case letters H H Software GmbH Product activation Hidden Automatic Navigator H H HAN Product activation Product key The product key is stored in your license account Downloading a license file You can download license files to activate your products at any time from the license account associated with your H H products For details on how to associate products with your license account see Registering the product key above You can create and download a license file as follows 1 In your license account click on the download link next to the product key Hidden Automatic Navigator 2014 H H Software GmbH Installation 24 H H Software GmbH Product activation Hidden Automatic Navigator NetMan Desktop Manager H H HAN Product activation Product key ID Product key Version License type CALS Valid until Download license T2 Product key 3 0 concurrent 10 unlimited Base license Add key 2 Click on the Download license file link to store the license file locally Product key Product key License file Download y file The stored license file is saved Your HAN program also imports the license automatically into the Activation wizard and activates HAN i Some browsers offer the choice of either opening or saving the license file If you are prompted
80. ctional and a login is prompted only when a full publication is requested Defining flexible parameters for the URL in the condition 1 If the URL of the condition contains a value that needs to be made flexible right click on it to open the shortcut menu and select Hexible condition 2 In the Make URL Condition Flexible dialog replace the value with the wildcard HAN E Script Editor Alexibilze URL Condition http fp server com directory file htm 3 Click on OK to confirm The condition is now flexible HAN also automatically makes the script flexible as well Main script Conditional script File X Varnable Value H Dx zip CO fd Econ J Ail gt F l hitp Ap server com HANURL CONDITION_TEMPLATE_ Frames Web page structures can vary widely In addition to the use of tables or containers the use of frames is widespread A frame based page is actually a number of web pages displayed together as each frame is a web page in itself A definition file called a frameset controls how the frames are displayed on the page that is called When using HAN it is important to make sure that the last URL in the e script contains the definition Hidden Automatic Navigator 2014 H H Software GmbH 83 Providing Online Resources with HAN file for the frameset If the last URL points to a page that is a single frame in the set then the user will see only that frame when the e script is called The H H
81. d In the e script properties open the Login page and enter the login data E script properties Financial Times HAN 3 kernel default i x ea Login _ _ _ J_ Information 6 Meta Information Login by form login default General Object Properties pa user Domain List Fiz sssssssel Showy agin data Control r T AET User oetElementById z iname of the Login feld Document Types Password getElementById af lt HTML ID name of the Submit field gt Alternate IP Address Submit oetElementByid a URL Rewriting Insert script in the following page URL Restricted Adresses Indude logon script once gt Motes Send login data to the following domain For further information on the properties of e scripts see Managing HAN Resources E Scripts When logging in using an HTTP login dialog data is encrypted before it is sent by the browser For this reason data for the access script is not relevant HAN sends the data when it is requested by the origin server To create an e script that performs login in the background or guides the user to a specific HTML page you need to record a script manually For details on creating an e script using manual script recording see Using Manual Script Recording Using Manual Script Recording In this example we will create an e script that opens a page at the H H HAN testing site http www hh han com testi
82. d the user s cost center is logged in the data records on e journal usage Statistical usage per cost center To calculate usage by cost center in the Statistics program begin by creating a main table In the main table open the Break down by menu and select Cost centers S H H HAN Statistics Windows Internet Explorer Home Table loaded Tasks Now open the Detailed Information view for any data record The details shown include which cost centers used the e journal for how long as well as the volume of data transferred Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 136 ACH 401 02 47 13132 Cost centers Total usage Total calls Bytes Use per call Bytes per call Percentage of IDs in total use 005629 00 00 02 2 148 757 00 00 01 f4 376 0 00 006838 00 00 09 569 424 00 00 09 569 424 0 00 00B741 00 13 50 13 16 858 010 00 01 03 1 296 616 0 06 OOBF42 00 03 55 2 3 396 909 00 00 47 679 381 0 02 OOBTa2 00 00 22 781 934 00 00 22 781 934 0 00 The example shows that the cost center called 00B741 used the ACM e journal for a total of thirteen hours and fifty minutes There were a total of thirteen calls during which some 16 8 MB of data were transferred The average usage time per call was one hour and three minutes with an average of about 1 3 MB of data transferred per call HAN Components This chapter describes the components of the HAN system and provides details on their use
83. d content is authorized for access only by local computers for example you can use a masking IP address so that HAN can serve your users no matter where they login to HAN from particularly useful for campus licensing schemes e No modifications on the client The use of resources provided by HAN is independent of the client s operating system HAN is suitable for use even in heavily regulated environments since no installation or component configuration is required on the client side Authentication and authorization in HAN When a HAN resource is called HAN can check whether the user has the permissions required for access to the requested content In the process an important distinction is made between authentication and authorization e Authentication is part of the login process the system addressed determines the user s identity and checks it for authenticity e Authorization on the other hand is the allocation of permissions privileges or rights to the identified user HAN supports the authentication of individual users and permits an administrator to restrict or permit access to resources on the basis of user privileges This can be done on two levels Browser Browser Access permitted Browser Access denied 1 Define which users can access HAN authentication 2 Define which HAN resources a given user is permitted to call authorization HAN supports the use of existing user management too
84. d to the e scripts The Cumulative E Script Properties function stores the properties for the given script and not as a cumulative property The next time you open cumulative e script properties it will appear as though the setting you have just configured has not been set because property is in fact only stored in individual scripts A to Z List The A to Z list in HAN gives you a web based interface for vewing and searching for HAN e scripts In this interface e scripts can be sorted alphabetically or opened directly using the search function You can also integrate the A to Z list in existing HTML pages To do this embed the following URL http lt HANserver gt HAN AtoZ atoz php To modify the appearance of the A to Z list edit the base style css file stored in the apache hh han HAN AtozZ directory For details on how to change functionalities in the alphabetical list such as language defaults for example please contact H H Software To open the A to Z list in Windows select All Programs H H HAN HAN A to Z List in the Windows Start menu Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 104 gt Hidden Automatic Navigator Windows Internet Explorer Kl al Ty en g http docudiv 2008 eng HAN Atoz atoz html z x Sano ej sup Favorites q Suggested Sites E Web Slice Gallery Hidden Automatic Navigator fy B v Pag Safety Toos Ato Z L
85. ddress Motes 5 Click on OK to confirm your settings Automatic EZB collating is now disabled for the selected e scripts d it may take a few minutes for HAN to set this option depending on how many e scripts are selected Once the automatic EZB updating has been switched off the scripts affected will no longer be found using the same query Any new imports from the EZB however will be found using this query Thus you can use the same method later to deactivate automatic updating of new EZB e scripts as well Hidden Automatic Navigator 2014 H H Software GmbH 113 EZB and HAN Discussion Rules for EZB Udate This section explains the rules by which automatic EZB collating is performed in HAN This background information is provided for anyone interested it is not required for operation or administration of your HAN system One of the basic difficulties in collating data between HAN and the EZB is determining when an e script has been modified or when a new e script should be created for a new licensing period Because there is no unambiguous criterion HAN needs a set of rules that forms a basis for interpreting the data received during updates Four properties in EZB e scripts are designated as fixed criteria title anchor licensing period and URL The rules are as follows If any of the following apply the e script will be updated rather than replaced e Three of the four criteria title anchor license URL are
86. e creating an e script for access to the on line Journal of Reproductive Medicine http www reproductivemedicine com Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 7 A IRM Log In Windows Internet Explorer GA FE htip GA www reproductivemedidne com login login gp le x jo Bing og ir Favorites er Suggested Sites Web Slice Gallery yy The Journal of Reproductive ABOUT US INSIDE JRM RESOURCES SUBSCRIBERS SEARCH Username Status Now recording o x sato pe Zz oh i 7 3 bal a amp E amp t Oa m am alt ys Down il HAN New Save Saveand Properties Test Create Edit Delete Create Start Exit Tools close conditional script Browser k HAN E Script URL Recording Main script x 4 Open the e script properties by clicking on Properties in the ribbon 5 In the e script properties open the Login page and select by AJAX in the Login field 2 Hidden Automatic Navigator 2014 H H Software GmbH 73 Providing Online Resources with HAN E script properties Journal of Reproductive Medicine HAN 3 kernel default General Meta Information Object Properties Domain List Contral getElementByld F lt HTML ID name of the Login field gt Document Types Password getElementByld lt HTML ID name of the Password field gt Altern
87. e origin server and delivers it to the browser where it appears and is handled as though it originated in the reverse proxy Your HAN server provides URLs http lt provider server name gt lt HAN ID gt lt HAN server gt page htm1 for each e journal you make available to your users To access a particular e journal the user simply enters the corresponding HAN URL in the browser address line The HAN server then initiates communication with the content provider and executes any associated scripts for example to log in on the origin server Once the resource has been located the requested page is delivered by HAN to the user Thus HAN is a reverse proxy in the sense of the definition given above because clients communicate only with the HAN server not with the provider of the requested online resources Hidden Automatic Navigator 2014 H H Software GmbH Introduction 6 Browser Explicit login over http or https Provider ma Provider pr j Provider The following diagrams illustrate this process 1 The user calls an online resource Provider Browser 2 HAN checks whether the user has permission to access this resource Provider Browser If the user does not have the required permissions a login page opens or depending on your Hidden Automatic Navigator 2014 H H Software GmbH Introduction configurations an error message is shown Provider Browser 3 HAN opens the home
88. e required tables must be set up in the database The password for the designated user must be stored in the database in plain text Hidden Automatic Navigator 2014 H H Software GmbH Appendix 140 IP Address Host Name Check Description Authentication is assessed on the basis of the client s IP address and or host name Module auth_ip dll Parameters CFGFil Path to configuration file which stores permitted excluded IP e addresses and or host names Configuration Values are edited in the HAN Settings in the Edit Authentication service dialog opened from the Authentication page and stored in a CFG file Configuration file structure This is an INI file with the following structure Section Include The permitted IP addresses and host names are specified in this section Each entry can be associated with a user name The entries have the following form Adr x lt IP address or host name gt lt username gt The keys in this section are numbered sequentially beginning with 1 You can use wildcards when entering IP address and host name You can enter a range of IP addresses if desired rather than a single IP address If you enter an address range use a hyphen to separate the beginning and ending addresses Example Include Adr 1 62 225 136 HH Adr 2 hh software com HH Adr 3 62 225 136 1 62 225 136 100 HH Section Exclude The IP addresses and host names that are not granted access are specified in th
89. eb content and web based programs such as the License Monitor is determined by the relevant HTML files If a file exists in the same language used by the operating system that file is used HAN components e E scripts What in HAN 2 were called HAN accounts are now referred to as e scripts as this better describes the functioning of these elements E scripts have all the same functions and configuration options as the earlier HAN accounts e E Script Administration The HAN Administration program has been thoroughly revised All e scripts are managed in the new E Script Administration program Here you have access to the Hidden Automatic Navigator 2014 H H Software GmbH 13 Introduction new query function which replaces the Groups and Views of the previous version With it you can query the database for e scripts that match your choice of a wide range of criteria and maintain the resulting groups for further processing For example you can use these queries to assign cumulative properties to e scripts The E Script Properties editor lets you edit various properties of your e scripts on several dialog pages Unlike the prevous HAN Administration program the new version has a separate Data Editor for editing data objects The recording and editing of scripts is now handled by a separate Script Editor The interfaces for E Script Administration have been completely revised and the display design updated Script Editor The new
90. ect Properties u5 General login data User user Domain List C Control Document Types Alternate IF Address 11 Determine the identifiers for the password input and the send button in our example these are Password and Submit respectively Enter these as above In our example the result is as follows d The Submit button in our example does not have an ID it has only the name identifier So we select the getElementsByName 0 option under Submit Hidden Automatic Navigator 2014 H H Software GmbH 15 Providing Online Resources with HAN T AJAX login data a 12 To define the page on which login takes place enter the URL of the login page as a regular expression under Insert script in the following page URL in this example http www reproductivemedicine com login login php username password Send login data to the following domain lt Domain gt Er The Include login script option defines whether the login script is sent only once or each time the e script is called The with each call option is useful for testing purposes but should not be active during regular operation When this option is active the login script is sent again every time the login screen reopens following a logout The result is an endless login loop that makes it impossible to log out 13 The next step is to determine the name of the server to which the login is sent lt To ensure that the login data a
91. ected All Selected None Periodicity Months September 2007 Minimum maximum 9 Once you have configured the desired settings click on Calculate in the task bar 10 In the Calculate a table dialog select Main table HAN calculates the usage statistics in accordance with your settings and displays the results in a table Data groups With data groups on record IDs users and stations you can automatically aggregate the values of individual data records The resulting values are shown in the spreadsheet under the name of the data group Data groups are created in the HAN Data Editor 1 Open the Data Editor from the NetMan Tools desktop shortcut 2 In the Data Editor select the desired type of data group from the Groups that are used by Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 124 statistics category on the left In our example we create a data group for record IDs and select Record IDs Groups that are used by statistics rg User f Station 3 To create a new data group click on New in the ribbon Ri HAN Data Editor m EN g Copy era Refresh Filter Data View that by statistics a MS Protocol ID groups 0 4 In the HAN Group dialog enter a name for the group in the Group field and if desired a description in the Description field Hidden Automatic Navigator 2014 H H Software GmbH 125 Event Logging and Stati
92. eferences page Configure your preferences for EZB imports on this page Hidden Automatic Navigator 2014 H H Software GmbH 107 EZB and HAN HAN Settings i tty gt Settings D bd baal HAN Save Saveand Global Login Tools clase rey i HAN Tasks Configuration Fa Import Preferences A Information w Log EZB import Use settings for imported e scripts Permission i Global Log by Use custom settings for e script anchor Preferences based on anchor You can configure whether HAN writes a log file of import operations whether certain settings such as permissions are automatically set in imported e scripts and whether anchor specific settings are applied to imported e scripts For details on the various options available for the settings see the description of HAN Settings in the online help To view the online help regarding this dialog click on the Information link in the upper right hand corner of the page Configuring HAN Settings in EZB Administration This chapter describes how to configure your EZB access in the EZB administration settings for use with HAN 1 In EZB Preferences under Settings on the left click on the Library Settings link 2 Click on Edit settings for HAN server pages 3 Under HAN Server Settings enter http lt HAN server gt ezb start Replace the expression lt HAN server gt with the name of your HAN server HAN server settings HAN
93. g Authentication Services Defining permissions Permissions restrict the access of authenticated users to particular HAN resources i e e journals and online databases You can define permissions in advance and then allocate them as needed for example when you add a new resource Permissions are defined in the HAN Data Editor For details see Defining Permissions For more information on working with the Data Editor see Data Editor Customizing HAN for your company environment There are two areas in which you can integrate your corporate identity in HAN login pages and error messages For details on adapting these pages to reflect your firm or organization see Customizing HAN for Your Company Hidden Automatic Navigator 2014 H H Software GmbH 29 Configuration Wildcard Configuration HAN 3 Kernel With the new HAN 3 kernel the HAN URL rewriting engine modifies the structure of the e journal URLs as follows when the URL is opened Rather than saving the HAN server name and HANID in the URL the new HAN 3 version saves this data in the server name This entails two new prerequisites for correct functioning of the HAN system e A wildcard DNS record must be created for correct resolution of the HAN server name in the DNS even though the address of the e journal provider is at the beginning of the URL e To resolve web addresses over SSL using the HAN web server without showing a certificate warning every time
94. g nslookup and entering the client IP address The nslookup program should return the client s host name If this works then you can activate name resolution in the web server If the host name is not returned do not activate name resolution in the web server 8 If you changed the setting for reverse name resolution the web service has to be restarted before the new setting is applied for user authentication If your changes affect only the definition of IP address ranges however it is not necessary to restart the web service To restart the web service begin by opening the HAN System Settings program from the Windows Control Panel under System and Security H H HAN HAN Web Service Click on the Restart button in the ribbon to restart the web service FA HAN System Settings f i l ol X Settings A Gi La a COS HAN Save Save and Start Stop Restart Tools close HAN Tasks Service System settings oo Version information AAO Information w b HAN Service HAN Web Services httpd exe 2 2 20 P EHan Web Services mod_han3 dll 3 0 0 406 d DE configuration Cal Certificates File C HH HAN Bin WebSrv ssl server ct I Use reverse name resolution for IP addresses Bound IF addresses Prise all available IP addresses For details on working with the HAN System Settings program see HAN System Settings Once the web server has been restarted the new authentication service settings are applied for login on the HA
95. gn common properties to the e scripts imported from the EZB configure the corresponding settings before you run the import For details on defining global preferences for e scripts see EZB Configuration in HAN To assign common properties to multiple e scripts after import use the query functions For details on using queries see Managing HAN Resources Using Queries Hidden Automatic Navigator 2014 H H Software GmbH EZB and HAN 110 You can have HAN write a log of the import operation which is then stored in the HH HAN Bin System Logs EZB directory To do this activate the corresponding function in the HAN Settings as follows In the EZB section of the HAN Settings open the Preferences page and activate the Log EZB import option settings HAN Save Save and Global Login Tools close HAN Tasks After your first EZB import you can configure HAN to update and collate EZB titles automatically For details on configuring HAN for automatic collation see Automatic _Collating Automatic Collating In addition to the function for importing EZB titles manually you can configure HAN to collate EZB e scripts with online EZB data automatically at regular intervals During automatic collation HAN updates existing e scripts and checks whether any e journals have been added to or deleted from EZB license administration For new e journals HAN automatically creates e scripts When e journals are deleted from the EZB HAN
96. he Activation wizard at any time by selecting All Programs H H HAN HAN Activation wizard in the Windows Start menu 2 In the Activation wizard click on Import license file 3 Select your license file in the File dialog and click Open The required data is imported and HAN is activated Hidden Automatic Navigator 2014 H H Software GmbH 21 Installation if HAN Activation g x Name Max Mustermann Organization Musterfirma Product Hidden Automatic Navigator 3 0 CALS 10 concurrent Valid until Unlimited Product keys 10 concurrent base license Go to activation page 3 Click on Close to close the Activation wizard Registering HAN Registering the product key When you purchase the HAN software you are provided with a product key Like the familiar Microsoft product key this has five groups of five characters consisting of numbers and letters with each group separated by dashes To simplify entering the code all of the letters are upper case You can manage all of your H H product keys in your H H license account Register your products here by entering the product key and then downloading a license file The web address for H H product activation is https www hh software com hanlogon Ing 0 You are prompted to log in before you can access your license account 1 Enter your e mail address and license account password d If you do not have a license account click on Sign in This opens a p
97. he Authentication page Hidden Automatic Navigator 2014 H H Software GmbH A Hidden Automatic Navigator endix 14 Authentication is performed over an SIP2 server In addition the module stores the values from the database in HAN environment variables thus enabling it to check user rights auth_sip2 dl Server IP address name of the SIP2 server Parameters User name for login on the database Password for login on the database d Configuration Prerequisite for login over the SIP2 server is the ability to build up a socket connection to the that server Values are edited in the HAN Settings in the Edit Authentication service dialog opened from the Authentication page and stored in the HAN database The login module stores data from the database user data in HAN environment variables These can be used to check for user rights Environment SIP2 ST Status of the user This is a 14 character string Each position variables ATUS can have either a Y or an N auth_sisis dl Parameters Configuration Environment variables Authentication is performed over a SISIS database using ODBC In addition the module stores the values from the database in HAN environment variables thus enabling it to check user rights DSN System data source name for the database Database user who has read rights in the database Password for reading the database ord Prerequisite for login over the SIP2 server is the abili
98. he HAN 3 kernel In the first two HAN versions the data required by HAN for serving the resource were stored in the provider URL Original URL http lt provider server name gt index html Hidden Automatic Navigator 2014 H H Software GmbH Introduction 14 After HAN 2 URL rewriting http lt HAN server gt han lt HAN ID gt lt provider server name gt page html This ensured both that the end users received the requested resource from the HAN server and that the HAN server processed the request correctly on the basis of the HAN ID Disadvantages of the HAN 2 kernel For simple links Such as the HTML tags href src etc in a web page this procedure did not present a problem The URLs were identified and modified by the HAN engine The fundamental paradigm shift in web technology from static web pages to dynamic web applications however has led to widespread use of Java script In static web pages it was easy to identify requests for further resources such as images style sheets and so on In dynamic web pages this is not possible Today URLs are often called or even constructed by Java scripts In such cases whether the URL needs to be modified or not cannot be determined from its syntax This increases the risk of producing web pages that do not function properly and require manual modification which in turn entails manual adaptations in the URL rewriting engine Another consequence of having HAN modify URLs is
99. ica Chimica 01 06 2006 10 1 01 06 2006 10 3 UNI LIBRARY 194 2 1 269 341 GIF Total calls 6 Bytes 27 592 PD Elsevier Science 01 06 2006 10 1 01 06 2006 10 2 UNI LIBRARY 194 2 675 558 GIF Total calls 15 Bytes 36 585 J Eastman Chemica 01 06 2006 10 1 01 06 2006 10 5 UNILIBRARY 194 2 6 457 492 GIF Total calls 313 Bytes 447 699 International Jour 01 06 2006 10 1 01 06 2006 10 2 UNILIBRARY 194 2 1 987 648 CSS Total calls 5 Bytes 20 700 GL Springer ICM 01 06 2006 10 1 01 06 2006 10 3 UNILIBRARY 194 2 939 420 GIF Total calls 19 Bytes 3 169 PD Elsevier Science 01 06 2006 09 1 01 06 2006 10 1 UNILIBRARY 1942 2 322 248 GIF Total calls 34 Bytes 123 637 SerSol 01 06 2006 08 5 01 06 2006 09 0 E5444U 1572 579 222 CSS Total calls 1 Bytes 7 630 GIF Elsevier Science 01 06 2006 08 5 01 06 2006 08 5 E3132U 1942 897 038 PDF Total calls 6 Bytes 842 788 International Jour 01 06 2006 08 2 01 06 2006 08 3 UNILIBRARY 194 2 2 195 782 GIF Total calls 6 Bytes 19 946 PD Elsevier Science 01 06 2006 08 2 01 06 2006 08 2 E3132U 194 2 652 859 POF Total calls 4 Bytes 599 000 Analytica Chimica 01 06 2006 02 1 01 06 2006 02 2 E4578U 193 2 1 590 660 GF Total cals 7 Bytes 27 927 PD z SerSol 01 06 2006 00 3 01 06 2006 01 2 E1815U 83 31 2 387 527 PDF Total calls 28 Bytes 1 654 538 gt Sum 2963 816 025 336 275 405 40
100. icking on OK HAN Data Editor x TP address to be checked IP address 192 168 72 1 192 168 73 255 cancel T The procedure is similar for our next step We click on New and this time select LDAP d To perform authorization through an LDAP server that server must be set up on the LDAP Configuration page of the HAN Settings For details on setting up an LDAP server refer to the HAN online help 8 The LDAP Group Selection dialog opens We select the desired LDAP group and click on OK to confirm 9 You can link conditions with logical ANDs and ORs if desired You can also define whether a condition must be met or not met by selecting is or is not To configure these links and requirements click on the corresponding line in the desired column For our example we link the conditions with a logical or EHF address is 10 The last step is to specify the page to be opened in case of error in the HTML page field The page specified previously was newlogin html which gives the user an opportunity for another login attempt Depending on the level of permission required you might want to have a login page opened that provides information on the type of login required d These HTML pages are stored in HH HAN Bin System web htdocs_user haninfo Example In this practical example all library users have unrestricted access to library resources as long as they are inside the library User location is
101. iewO extemal chrome sites O00 390464 ichrome vm gt isbn 0073902647 The parameters for login have already been replaced with variables and the script is fully functional The page it opens however always shows the issue that was current when the e script was created rather than the latest issue The value for the isbn parameter must be made flexible in such a way that it is changed not only in the isbn parameter but also within the goto_url and chrome parameters where the identical value appears The parameter separator in this example is Right click to open the shortcut menu for the isbn parameter and select Hexible parameter In the Define URL Parameter for a Script dialog select the may contain different values replace only if values are identical option in the Parameter field Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 70 C HAN Script Editor Define URL Parameter for a Script X Parameter isbn Value _HANURLO_ R Determine how the parameter value is defined in the script Der Parameter may contain different values replace if values are identical Replace in the URL V the parameters with separator j Under Replace in select the parameters and enter as the separator You do not need to select the URL because there is no value from the isbn parameter in the URLs With these settings selected HAN replaces all parameter values th
102. ifferent values each time the URL is called In such cases it can be helpful to create the script again later under a different name and then compare the parameters values in the second version of the script with those in the first 4 Double click on the CFID parameter in the Script Editor to open the parameter properties 3 In the Edit URL Parameters dialog set the option for Parameter to is used for login user _HANURL_USER_ and click OK Hidden Automatic Navigator 2014 H H Software GmbH 65 Providing Online Resources with HAN O HAN Script Editor Edit URL Parameter a8 URL parameter Parameter CFID No input possible HAN parameter Value _HANURL_USER_ n Value non encoded _HANURL_ USER _ d HAN replaces this parameter value both in the selected URL and in all other instances in the script 6 Open the properties of the CFTOKEN parameter and set the option for Parameter to is used for login password _ HANURL_PASSWORD _ O HAN Script Editor Edit URL Parameter Parameter CFTOKEN No input possible HAN parameter Value _HANURL_ PASSWORD _ pa Value non encoded _HANURL PASSWORD _ a After you click on OK HAN replaces all instances of the CFTOKEN parameter with _HANURL_ PASSWORD Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 66 El hitp aew bh han comtestares cookie result cfm ig 1 CFID _HANURL_USER_ name
103. ining reliability and availability of HAN That is why HAN offers automatic monitoring of available disk space You can define a lower limit to specify when you wish to be notified by e mail of critically low available space 1 Open the HAN Settings using the HAN Tools desktop shortcut 2 Open the Global section of the System Monitor page to modify settings for monitoring d Do not enter any values lower than the default values given as these are the absolute minimum amounts of available disk space required to keep your HAN system stable Hidden Automatic Navigator 2014 H H Software GmbH Configuration 4 HAN Settings AE tt Settings aD me Save Save and Tools close Login EZB HAN Tasks Configuration Global J HAN behavior when available disk space is low _ Information Global Send warning at MB i E scripts Stop HAN at MB GD Hep desk D HAN error page error html E Aly system Monitori i E mail account data Restricted domains sii aaa Global document types aN Not encrypted x isi P URL Rewriting Sender han3 Lecipient administrator han P Recording Recipien istrator han com Domain handom User Administrator Send warning at When the available disk space drops below this level an e mail warning is sent to the administrator The warning is repeated every 1000th time the system is accessed thereafter Stop HAN at When this level is reached a
104. ional script that prompts a login only when login is required Creating a conditional script 1 Determine which URL represents the condition for login In the current example the login prompt opened when you clicked on the Publication link In our example from the HAN test site the URL in question passes a parameter with the value pub to the web server Furthermore this URL contains an identifier for the requested publication id 5 7889 d As a rule the last URL shown before the login which usually uses the POST method contains the condition to be used in your conditional script ol x Editor i oat Lal EF a a ti _ ah s vs 4 gt F HAN Script Editor HANID conditional skript Title Conditional Skript Properties Test Start Close HAN Create Tools conditional script HAN E Secript URL Recording l Main script o Variable Value El O http www _hh han com estares scriptlogin index cim g 0 El http www hh han comtestarea scriptlogin indexPara clm 2 To create a conditional script select the URL which is the condition and click on Create conditional script in the ribbon Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 80 a Editor HAN E RE Test Start Close Tools E y HAN E Script Recording Main script x Vaike Te EH http www bh han com Atestareas scri
105. is section The structure corresponds to that of the Include section except that the entries cannot be associated with user names Section ReplaceIP When troubleshooting you might wish to use the IP address of the computer that is having the problem rather than that of your test computer For this purpose you can define an IP address translation in this section Each entry in this section has the following structure lt actual IP address gt lt new IP address gt Hidden Automatic Navigator 2014 H H Software GmbH 141 Appendix Authentication is performed over an LDAP interface auth _Idap dl Data in the database see Configuration below Configuration Values are configured in the HAN Settings on the LDAP page In the Login section on the LDAP page enter the following values Name of the LDAP server Port on the LDAP server over which login is performed Distinguished name of the directory in which users are stored User name for login on the LDAP server Password for login on the LDAP server Use SSL Defines whether SSL encryption is used for transfer of login encryption data LDAP Specifies the LDAP interface in use either version 2 or interface version 3 User Attribute with which the user is displayed in the DN attribute Group Name of the attribute attribute Value that defines whether the user is a group Members Attribute in which the members are defined Authentication is to the defaul
106. ishes between implicit and explicit login With implicit login the user does not enter credentials for explicit login the user enters a user name and a password for authentication Implicit login is based on client IP address or host name and is independent of user identity The explicit login uses an HTML form login Hidden Automatic Navigator 2014 H H Software GmbH 43 Configuration Hidden Automatic Navigator User name Password Login This login page can be edited and if desired adapted for example to match your intranet pages For details on adapting the login page see Customizing HAN for Your Company If you call the login page over HTTPS data are encrypted before being sent to the HAN server To use HTTPS activate the Use HTTPS for login option Configuring an authentication service The following steps demonstrate how to configure an authentication service using the IP Authentication service as an example Authentication services are configured in the HAN Settings 1 Click on Login in the ribbon and select the Authentication page 2 On the Authentication page click on the New button at the top of the Authentication services list Hidden Automatic Navigator 2014 H H Software GmbH Configuration 44 fi HAN Settings o ox Settings A ip a Save and acs Mejra close HAN Tasks Configuration Information w login html E loginerror html E d The list of authentica
107. ist Search ABC DEFGHIJKLMNOPQRSTUVWXY2Z098 Search in HA HB Page s 1 Results 1 Results per page 10 20 30 40 HAN Login Publisher Subject Source E ISSN HAN Login Wol 1 Fowered by Hidden Automatic Nawigator E fT Localintranet Protected Mode Off Wa Amo 4 The A to Z List has two options for viewing e The A to Z list shows all existing e scripts in alphabetical order e The search function opens a view in which you can search for specific e scripts You can switch from one display to the other using the A to Z List and Search buttons Search function view Search in title Keyword Hanf Search type f Starts with contains exact spelling Page s 1 Results 1 Results per page 10 20 30 40 HAN Login Publisher Subject Source E ISSN HAN Login Vol 1 Hidden Automatic Navigator 2014 H H Software GmbH 105 Managing HAN Resources EZB and HAN HAN has an interface to the Elektronischen ZeitschriftenBibliothek or EZB the electronic journal library at the University of Regensburg This means your HAN server can provide direct access to your institution s pages at the EZB With this interface you can have a HAN e script created or updated every time one of your users calls a journal from the EZB page Options are also available for manual and automatic import of EZB links Furthermore HAN v2 and later offers optional support for licensing
108. ive packages appropriate for your HAN system e RapidSSL http www rapidssl com index html e GoDaddy http www godaddy com ssl ssl certificates aspx ci 9039 Resellers for SSL certificates offer certificates from various providers which gives you an overview of the different products available Checking with resellers is definitely worthwhile as they often have very economically priced offers One recommended reseller for wildcard SSL certificates is SSL 247 in the US https www ssl247 com ssl certificates type wildcard in Germany https www ssl247 de ssl zertifikate kategorie wildcard other countries languages also available Deactivating EZB Data Logging With the default settings EZB data logging is active as p One log file is created per day This is a web based log which you can open from the HAN Tools desktop shortcut If you do not wish to log EZB data this function must be deactivated To deactivate EZB data logging begin by opening the HAN Settings from the HAN Tools desktop shortcut 1 In the HAN Settings click on the EZB button in the ribbon Hidden Automatic Navigator 2014 H H Software GmbH 39 Configuration on aree Er i bd a F Save Save and Global Login E clase HAN Tasks Configuration EZB Global T Use settings for imported e scripts The EZB data logging is now inactive Disk Space Monitoring Available disk space is an important factor in mainta
109. iversity of Regensburg Summon Serials Solutions installs an interface to the Summon servce from Serials Solutions EBSCO installs an interface to the EBSCO Publishing database 8 Click on Next On the HAN server name page enter the fully qualified domain name of the HAN server and confirm by clicking on Next HAN 3 InstallShield Wizard xX HAH server name MA The fully qualified domain name FODN of the HON server iz required for corect functioning of HAN Please check the value or enter the the corect name Installshield Back Cancel d To enable the HAN 3 kernel to make replacements directly in the server name you need to create a wildcard DNS record for HAN servername and the corresponding IP address no PTR reverse lookup This applies to both Windows and Linux 9 On the Ready to Install Program page click Install to start the HAN installation 10 On the InstallShield Wizard Completed page choose from the following two steps to continue e Convert data from version 2 x to version 3 0 If you select this option HAN will automatically start the Migration Wizard at the end of installation for loading all the user data from your old HAN 2 installation into HAN 3 For details on using the Migration Wizard to update HAN 2 to HAN 3 see Updating from HAN 2 e Run the HAN Activation wizard If you select this option HAN will automatically start the Activation Wizard at the end of installation so you
110. le that was exported from HAN hanex This lets you re import your e scripts to replace lost data or to add them to a new HAN installation For details on importing e scripts from an exchange file see mporting from an e script exchange file e A CSV file This enables exchange of HAN e script data outside of HAN 3 For details on importing data from an CSV file see mporting from a CSV file E scripts are imported in E Script Administration Importing from an e script exchange file 1 In E Script Administration open the program menu and select Tasks Import w HAN E Script Administration ee Task Assignments gO CSV Import Importing scripts from a CSY file F a rT al mae HAN Tools g Utilities e Polder i Export 5 f Export the selected e scripts to the exchange Ed Diagnostics folder amp E script exchange folder Bi 2 Language a nean the avrhannae falaer far eaerrinte im the in oe B Options 4 Information Help Ea Exit 2 In the Select the e script exchange files dialog select the e scripts you wish to import under E script exchange files Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 90 x E script exchange file Delete the exchange file after the e script was succe Overwrite existing e scripts Delete the exchange file after the e script has been successfully imported Deletes all imported exchange files from the e
111. ll of the e scripts in HAN at one time proceed as follows 1 In the E Script Administration program create a new user defined query that finds all e scripts for which automatic EZB collating is active x User defined HAN e script query Query EZB Update Hidden Automatic Navigator 2014 H H Software GmbH EZB and HAN 112 For example the expression Type is 1 finds all e scripts that were imported from the EZB Fora list of Type values and their descriptions see Appendix Values for the Type Query Criterion The expression EZB update is false checks whether automatic updating has been disabled With this value set to false the query returns e scripts for which the option disabling EZB updates is not activated 2 Apply the query as described The E Script Selection now shows only those e scripts for which automatic EZB collating is active 3 Select all e scripts in the E Script Selection and click on Properties to open the e script properties This may take a few minutes depending on how many EZB e scripts have been imported 4 On the EZB page activate the The EZB interface does NOT update this journal ezbid automatically option E script properties lt Multiple selection gt g x Global Fike EB i Information Meta _Information 3 EZE interface does NOT update this e script automatically Object Properties Domain List Control Document types Alternate IP A
112. ls and settings for authentication In the development of HAN uncomplicated administration of resources was one of our main objectives That is why HAN is specifically designed to leverage existing configurations such as ADS and OPAC Hidden Automatic Navigator 2014 H H Software GmbH 9 Introduction settings for authentication to eliminate redundant user management operations For details see Configuring Authentication Services Statistics HAN can collect statistical data on every client access operation which means you can analyze all usage data pertaining to your online resources In addition to analysis of the total usage HAN gives you the option of evaluating parallel use of e journals and online databases The results can help you determine the optimum number of concurrent use licenses for e journal subscriptions Furthermore HAN can run web counter compatible evaluations on use statistics For details on using the HAN Statistics functions see Event Logging and Statistical Analysis HAN web server The HAN web server leverages Apache web server technology and builds on its reverse proxy functionality HAN also uses Windows modules for example for the E Script Administration and HAN Settings programs The web based statistics features are also provided over the HAN web server Due to the close interaction between the web server and the HAN modules some modifications in HAN settings are not active until after a web server
113. m Statistical evaluation of usage data with numerous analytical functions Access log Overview of raw data on e script usage Summarized log E script usage data by session Event log All events in your HAN system sorted by relevance For details on data logging and statistical evaluation see the following chapters e Data Logging describes the configuration and use of data logging functions e Statistics provides details on working with the Statistics application e Total Usage explains how to calculate data on the overall usage of your HAN system e Concurrent Use describes how to calculate data on parallel usage of e scripts in your HAN system e Document Types explains how to calculate data on the e script usage by document type e Usage per Cost Center describes how to calculate e journal usage per cost center Hidden Automatic Navigator 2014 H H Software GmbH 115 Event Logging and Statistical Analysis Access Log This chapter describes in detail how to activate data logging and how to work with the HAN Access Log Whether or not usage data is logged each time a given e script is called Data logging is configured in e script properties For each e script you can define whether access data are logged and if so which record ID the data are assigned E script properties Online Magazine HAN kernel 3 f x General Meta Information Object Properties Domain List Login ce pas Document Types Click
114. m see Providing Online Resources with HAN E Script Administration 3 In the Data Editor open the Permissions page Hidden Automatic Navigator 2014 H H Software GmbH Configuration ie A Organize A 1 AFA 2 E HAN Mew Edit Copy Delete Refresh Filter Tools HAN Data View aN Permissions 0 4 Click on the New button in the ribbon to create a new Permission 5 Define the new Permission in the HAN Permission dialog HAN Data Editor LDAP OU DomainAdmins DC docudomain DCSakal and LDAP OU HAN Admins OU HAN DC docudomain DC and ma ee Hidden Automatic Navigator 2014 H H Software GmbH Configuration 50 6 Click on OK to confirm The new Permission is added to the list of permissions To use it allocate the Permission to an e script Allocating permissions You can associate a Permission with your choice of e scripts Permissions are allocated in an e script s properties To open the e script properties for editing select the desired e script in the E Script Administration program and click on Properties in the ribbon HAN E Script Administration Organize E HAN Mew Copy Rename Delete HAN E script On the Global page activate the use of permissions by clicking in the checkbox next to Permission so the checkmark appears In the input field next to the box enter the name of a permission manually or click the Select button to open a dialog for selecting an existi
115. matic Navigator 2014 H H Software GmbH 15 Introduction System Requirements The following software and hardware specifications are required for operation of HAN e Windows Server 2008 64 bit Windows Server 2008 R2 or Windows Server 2012 e CPU quad core recommended e 4 GB RAM minimum 8 GB RAM recommended e 50 GB minimum available disk space 100 GB recommended depending on your organization s needs e Up to date PDF reader e Wildcard DNS record FDQN of the HAN server pointing to the HAN server in the local DNS e Wildcard SSL certificate FDQN of the HAN server recommended e Prerequisite for hypervsors Paravirtual network adapter The HAN setup program installs the following components e HAN web server built on Apache 2 2 e HAN components e Self signed root certificate for correct recording from web pages over HTTPS d The HAN web service is updated by the HAN update module For administration of the HAN suite a good working knowledge of the following is recommended e HTML e HTTP and HTTPS e Networks Contents of This Manual The chapter entitled Introduction contains a general introduction to the software information you will need prior to installation and notes on the use of the documentation Installation describes the procedures for installing HAN registering your HAN software and updating from an earlier HAN version Configuration shows the initial basic steps required when you put HAN into
116. mmary shows the path and file name under which HAN has saved the certificate request Hidden Automatic Navigator 2014 H H Software GmbH Configuration 34 HAN Server Certificate New Certificate Request The certificate request was created successfully Once you receive the certificate from the certificate authonty CA you need to import the certificate with this program BEGIN NEW CERTIFICATE REQUEST MIICSDCCACOCAG Awg YxGDAWBgNVBAMT Dyou SEFO UOVS Vk V SLmNvb TERMASGATUE ChMIGUNNASBDby4xFOASEgNVBAs TCORMdmVsb3bt7WV S0MOswlQ YDVGGQGEwJVUZEQ MASGA1UEBxMHQW ShaGVpb TETMBEGATUECBMKG2FsaW vcem5p 1T EdMBsGCSqGSib3 DGRJARTYO2ZG V2GGFbW VibyabAlwoagbMAQGCSqGS b3DGEBAGUAASIBDwAwggEK Ao IBAQDN4lc md3UbURhGSMu4wly2cpmHFOKyUKCegg SctFo0z2NCR YU zUS b clea TSC SghBBqj Orly swuvwewjAkdp4 Wicsy NwhzgCMtS74d0 MOgkeAxCpsrlas kuPSmkkSigC T det eVig oazlAeEgg4b0ebOsert zj2rKdolEss KAywOJnSOnkk FRKatgouPoFyglrsVHcCOGR YaS4aPlvZV0bbworRskgeBRew lagldclW MH YgkHN RvpOshvrl MiNL6dgCtpt4y HIA Aca Vs 7GTNs USH WBS50 Sekt ADT 246 SydoAlm UZsJj o Xpp KLKr JN3e3PSHS9c6 bAgMBAAGGADANEBgkghkiGSw0BAGUFAAOCAGEA ub YL arot IrM DJtpd SL 1 Fewilz2 Eu NGG SbSsWe vB Ypjaw TAR ZK YY BwM Some certificate authorities also have an on line form for requesting certificates and some expect an e mail text containing the request To use either of these options copy the text in the Certificate request box and paste it into the form or e mail
117. n AJAX login will be performed for this e journal To test your e script click on Test in the ribbon of the Script Editor Conditional Scripts The main purpose of the e scripts created in the prevous examples was performing an immediate login When such an e script is called the user is logged in on the content provider s web server This solution is ideal for accessing on line resources that require user login Such resources can include on line databases archives and others For websites that offer both freely accessible and password protected resources however you need e scripts that perform login only when a protected area is accessed Such sites might include on line magazines that provide free access to abstracts but require user login before full articles can be read With HAN you can create e scripts that perform login only when a specified URL is encountered This is done using conditional scripts which supplement main scripts To create a conditional script begin by creating an e script that performs login to access the password protected area For details on creating an e script using manual script recording see Creating E Scripts Using Manual Script Recording A conditional script executes only when a certain condition is met e g when a specified URL is called The login is made a part of the conditional script The following example shows how to define the condition for login in the main script and then use this to create a
118. nd or 4 In the Add a field to the filter dialog specify the property to be queried in the e scripts In our example we select the title Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 100 HAN Data Editor 5 In the Filter expressions table define the new expression d This is a regular expression If you use control characters make sure the syntax is correct HAN f x User defined HAN e script query Query H H E scripts Description jail e scipts from H H Software Query definition Filter expressions SKI att Fitter by Rule Value and or In the Rule column we select begins with and in the Value column we enter H H to find all e Hidden Automatic Navigator 2014 H H Software GmbH 101 Managing HAN Resources scripts that have titles beginning with the characters H H even if other characters follow The backslash is important as it defines the as a regular character otherwise it would be handled as a control character 6 Define further filter expressions if desired Once all expressions have been defined click on OK The new query is shown in the query sidebar of the E Script Administration window on the User page Scripts E E scripts that use a script to navi i User defined queries H Changed today E scripts that have been modified H H E scripts aa All e scripts from H H Software Import E scripts that ha
119. ng permission Click on the Edit button if you want to edit the specified permission E script properties Administrative Tasks HAN kernel 3 g x Global BB Information Meta Information Title Administrative Tasks Description gt Object Properties oo administrative tasks Domain List HAN start URL http DOCUDIV2008 ENG DOCUDOMAIN LOKAL han administrative tasks Root URL http Awww han com TF HAN kernel used by the e script Document types iji Use HAN 3 kernel default Alternate IP Address Set lability of the 3 URL Rewriting The e script is activated f2013 wii Login Control Restricted Addresses Information page Notes Example The instructions below show how to create a permission This example demonstrates configuration of a permission that grants access only to users at computers that are located in the library IP Address Check An exception for library staff will also be configured here Library employees in this example are members of the HAN Admins group and will be granted location independent access 1 First of all you need to select the authentication services that can determine the relevant conditions In this example these are the auth_ip dll and auth_Idap dll modules 2 The next step is to check whether these authentication services have been configured If they have Hidden Automatic Navigator 2014 H H Software GmbH 51 Configurati
120. nghan The first steps are the same as those for creating an e script without manual recording For details on creating e scripts without manual recording see No Manual Recording Required The home page of the test site lists the test areas available and shows the login credentials to be used Click on the Login va HTML form link This open a login form Enter HAN without quotations marks for both user name and password and click on Login This opens a page that offers congratulations on your successful login and shows an overview of the HAN automation feature This will be the target page of the e script created in the following example 1 Create a new e script title Login with http www hh han com testinghan as the root URL d Because we are using HTTP there is no need to specify the protocol when entering the URL When using HTTPS however the protocol must be entered Hidden Automatic Navigator 2014 H H Software GmbH 59 Providing Online Resources with HAN aan jj x Information to create an new e script Title Login Root url www hh han com testinghan HAN ID E login 2 In the Create field select the option then begin recording in the Script Editor and click OK HAN creates the e script and automatically starts the manual script recording process The Script Editor runs in the background Manual script recording runs in your browser specifically in the default browser as defined in the operating
121. no longer has to search for HTML tags to identify and modify a URL Which domains URLs need to be opened by HAN are indicated in an e script specific list of domains The syntax of the URLs as stored the Java script or the HTML source code is not relevant for the modification e Thanks to the new kernel model the structure of the URL is not changed Java scripts function correctly without manual editing and relative URLs automatically point to the right server The required information indicating to which e script the server belongs HAN ID is supplied in the call itself Thus all AJAX based web pages function with no manual modification e HAN 3 passes the protocol selected by the provider server to the user side Where in HAN 2 all communication with the HAN server was over HTTP and thus unencrypted HAN 3 passes on the change of protocol Specifically if the provder server communicates with HAN using HTTPS encrypted communication communication with both the HAN server and the browser is also over HTTPS e HAN 3 modifies only those URLs which are found in the e script specific list of domains to be called by HAN All other links as such as a link to Google automatically point outside of HAN and are opened directly Switching from one journal to another which can wolate licensing agreements is not possible This method also makes the statistical data more precise because HAN logs only the resources which are actually used Hidden Auto
122. nses 5 Soringerlink Once it has been created you can assign the license to the desired e script For details on assigning licenses see Assigning Licenses Using Queries lt With queries you can use your choice of e script properties as search arguments for finding e scripts You can also use queries to group the e scripts that match your choice of criteria and then adjust the properties of all e scripts in the group at once Unlike the results from a normal search operation a query is a persistent object and is available for use until you explicitly delete it At the same time queries are dynamic objects as well in that new e scripts the match a given query are automatically added to that query In combination with the selection of multiple e scripts you can assign common properties to the e scripts within a particular query Query objects however do not have individual properties See the following sections for details on working with queries e For details on defining queries see Defining Queries e For more on using queries and multiple e script selection to assign shared properties see Allocating Properties Queries can be selected from the query sidebar in E Script Administration F The query sidebar is visible only if the Query sidebar button in the Ribbon is activated Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources HAN E Script Administration Organize
123. ny further attempt to access HAN results in an error message and no access is possible HAN error page The page specified here is opened when the available disk space drops below the second value Stop HAN at Error pages are stored in HH HAN Bin WebSrv error You can modify the error pages stored here or add your own pages SMTP server The SMTP server used to send the warning e mail Port Port for the SMTP server Sender Address used as sender of the e mail Enter an e mail address here for use as the sender address Recipient Address to which the e mail warning is sent Enter an e mail address here for use as the recipient address 3 Define the values for the System Monitor and save your settings by clicking on the Save button on the ribbon Once saved the settings are effective immediately Hidden Automatic Navigator 2014 H H Software GmbH 41 Configuration Configuring Authentication Services You can restrict access to the HAN system by configuring authentication services a An authentication service is a predefined HAN module that detects user identity based on an authentication source HAN supports the following authentication services e IP address host name check e NT login SSPI e ODBC interface to an ODBC compatible database e ODBC login via SHA e LDAP login e ALEPH login e LBS login e SIP2 login e XServer login e SISIS login d The list of supported authentication services shown
124. o open the Selection window H H HAN Statistics Windows Internet Explorer 2 In the Selection window define the basis for the calculation of your main table Open Basis for calculation to define the basis for the statistical analysis record ID users or stations Your selection here determines which rows are included in the table Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 122 Home Selection Tables Reports Settings ld Reset SaveasaView E Cakcukte ir ID User Calculation basis ERR Record ID oe Record IDs Selected All 3 Click on Record ID to select the record IDs to be included in the calculation You can select some or all record IDs 4 The Users and Stations options let you choose which user and station data are included in the calculation 5 Click on Attributes to select which attributes are included in the calculation rs The attributes in questions are data record attributes A data record attribute is assigned to the record of an e script call when the corresponding condition is met e None E script calls without attributes are included in the calculation e NA The e script called was inactive e NL No license was available when the e script was called e NR The user did not have permission to use the e script The NA NL and NR attributes are automatically allocated by HAN if the corresponding condition is
125. o search for specific e scripts This E Script Administration program also has a pane for queries To open this pane click on the Query sidebar button in the Ribbon Hidden Automatic Navigator 2014 H H Software GmbH 87 Managing HAN Resources HA Reset Columns Import Em LE ER EN Ep we Ee a BW Query EZB HAN System Queries 1 Advanced scripts is E scripts that use conditional scripts Scripts aS E scripts that use a script to navi User defined queries H Changed today E scripts that have been modified Import E scripts that have been imported E Never used E scripts that have never been used springer In queries you can specify certain data elements to search for among the e scripts in your HAN database Queries are fixed HAN objects You can use them at any time to access the e scripts that match the criteria you have selected At the same time queries are dynamic objects in the sense that whenever you create a new e script it is automatically added to the results shown for any query that it matches E scripts have properties which you can edit either singly for each e script individually or for multiple e scripts at one time Double click on an e script to open a dialog for editing its properties For details on creating e scripts see the user manual Providing Online Resources wth HAN Creating E Scripts Hidden Automatic Navigator 2014 H H Software GmbH Man
126. of the dialog is not shown for other authentication services H H HAN E x W Activate service Label IP des for Validation hours 0 Parameter Value CtgFile remitted fal Lx IP address to_ User ID i a You can specify various ranges of IP addresses and or host names to define which clients are Hidden Automatic Navigator 2014 H H Software GmbH 47 Configuration permitted to access HAN resources and which are explicitly denied access You also have the option of defining a single user ID for a collection of IP address for purposes of statistical analysis For example you could create an IP authentication service for users whose IP addresses are located within the library and enter Library as the user ID in the Permitted section As a result all usage data originating from library computers is collected the statistics database with the user ID Library To check the host names of client computers the HAN web server has to perform reverse name resolution on the IP addresses This function is configured in the HAN System Settings on the HAN Web Services page After activating reverse name resolution the web service must be restarted by clicking on the Restart button in the ribbon before the change takes effect If reverse name resolution is not activated the handling of e script calls will be very slow Before you activate name resolution test your system s name resolution performance by runnin
127. of the e script is a script This is what initiates the call of the online resource and defines what happens when the resource is called This script can include an automatic login on the origin server for example or can navigate the user to a particular HTML page E scripts can also have a number of additional properties such as licenses and permissions which you can edit For details on creating e scripts see Providing Online Resources wth HAN Creating E Scripts E scripts are managed in E Script Administration The E Script Administration program shows all of the existing e scripts in your HAN system in the E Script Selection pane W HAN E Script Administration MEE Organize G 7 a T F Load Ee GA ae Re 2X fo gt EF 7 p i Load Le i 0 ue z Reset HAN New Copy Rename Delete Properties Edit Reload Test Filter Columns ery S Tools e scripts Dar E Til HAN E script View Query t h h han homepage H H HAN Homepage h h han testbereich H H HAN Testbereich h h homepage H H Homepage heise de Heise de httplogin HTTP Login online magazine Online Magazine onlinejournal com Onlinejournal com 0 to 9 Query the title a G 0 9 L Tites starting with 0 3 A to E Query the title 4 F E seripts 12 Query no query loaded gt There is a filter bar along the top of the E Script Selection pane which you can use t
128. om testinghan Status Recording Stop The Script Editor window shows all of the recorded steps F HAN Script Editor HANID login Title Login oli x Editor 40 o a J hol A Create r 4 Up gt E i s J Edit 4 Down HAN Save Save a Berr ard Create Start Close Tools close Fas Delete conditional script Fal Browser z HAN E Script URL Recording Main script X http www hh han com testinghan O http www hh han comtestarea HANogin cfm Ig 0 O http www hbh han comtestarea Tomlogin index cim 4 lg 0 ig 0 name han pword han submitimg x 0 be submit ye 5 Click on the Save button in the ribbon This saves the entire e script You now have a fully functional script that you can call using the testing function To test the script click on Test in the ribbon In some cases a script may contain calls that are not relevant for the desired process In such cases it is a good idea to optimize the script before releasing it for use Before going into details on script optimizing we shall outline the structure of a script in the following The subsequent section explains how to optimize a script Structure of a script A script shows the process that executes when a URL is called in HAN The steps are processed in the order shown from top to bottom Three levels are distinguished e URL e Parameters e Values The URL i
129. on not then both services must be set up before continuing with this example For details see Configuring Authentication Services The steps subsequent to configuration of the authentication services are as follows 3 Open the Data Editor select the Permissions page and click on the Create button 4 In the HAN Permission dialog enter a name for the permission in the Permission field in this example Library Entering a description in the Description field is optional in this example For users inside the library only staff exempt HAN Data Editor oe xi a Permission Library Description For users inside the library only staff exempt HTML page newlogin html A Permission definition 5 Click on the New button at the top of the Permissions list and select the condition that will define whether permission is granted For this example we begin by selecting IP address to define an IP address check x VU HAN Permissions Permission Library Description For users inside the library only staff exempt an Error page shown if there are NOT sufficent permissions HTML page newiogin htm Ss Variable LDAP AD user bol Pa E AD user group user OU l i T Hidden Automatic Navigator 2014 H H Software GmbH Configuration 52 6 In the IP address to be checked dialog we enter the IP address range of computers located in the library and confirm by cl
130. on a dialog opens to report where the log file of the operation is stored Data Editor In the Data Editor you can edit various data element types that are assigned to e scripts as global properties Open the Data Editor from HAN Tools HAN data editor E as Manage i data Permission publisher ete The main window of the Data Editor gives you access to following data element types Licenses Permissions Publishers Subjects Sources Document types Data groups in the Statistics program Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 94 Fl HAN Data Editor vty k Organize a i Ei 4 at oe Ji oh i m PS Pa i ap or N HAWN New See dit Copy Delete Refresh Filter Tools HAN Data Vig E script data A K License 0 The Data Editor consists of the following components A Program menu Access to program functions and utilities B Ribbon Access to the central tasks in the Data Editor C Data selection For selection of the property to be edited D Object list Lists the individual data objects of the selected data element type Commands in the Ribbon HAN Tools Opens the HAN Tools window New Creates a new object of the data element type selected in the Data selection pane on the left Edit Lets you edit the object selected in the Object list Copy Creates a copy of the object selected in the Object list Delete Deletes the object selec
131. on will be opened Define flexible parameters for the specified condition Select the id parameter in the condition right click to open the shortcut menu and select Hexible condition The value for the id is replaced by the wildcard and all instances of the id parameter in the subscript are given values that reference the id parameter in the condition in this example _HANURL_ id Main script Conditional script Restricted area login X E iO El htp waw hh han comtestarea scriptlogin publikation cfm lg 0 hype pub 4 id _HANURL id El http www hh han com estares scriptlogin publikation cfm g 0 t type pub id _HANURL id name han pword han submit Login The next step is to make the login parameters in the conditional script flexible in the same manner as it was done in previous examples for modifying the main script For details on how to make login parameters flexible see Using Flexible URL Parameters Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 82 Optimizing and testing the script The last step is to check whether the calls in the main script still work properly and to test the script by clicking on Test in the ribbon Be sure to save the script at this point if you have not already done so a You can begin recording again in the main script this will not affect existing subscripts In our example the test is successful the main script is fun
132. ons In addition to optimization you can associate licenses to e scripts If you simply provide online resources with HAN with no further configuration steps then theoretically any number of your users can access the online resources thus provided If this is undesirable however for example due to licensing conditions between your organization or firm and the original provider you can associate HAN licenses with your e scripts to prevent violation of those conditions For details on licensing your e scripts see Allocating Licenses No Manual Recording Required The simplest form of an e script is one in which the root URL for the online resource is the same as the target URL to be opened by the e script When this is the case the script does not require editing all required information is automatically stored in HAN when the e script is created In the following example we create an e script that opens the web edition of the Financial Times newspaper using the URL http www ft com home us 1 Open E Script Administration 2 Click on the New button in the ribbon to create a new e script 3 In the Information for creating a new e script dialog enter a name for the e script in the Title field and the root URL in the Root URL field d The HAN ID may contain only numbers and letters upper and lower case The length of the ID cannot exceed 256 characters HAN x E Information for creating a new e script Title Finan
133. operation such as configuration of the System Monitor and the Authentication Services Providing Online Resources with HAN explains how to create the e scripts that give your users access to the e journals and reference databases you provide over the HAN server This chapter provides details on how to use flexible parameters in URLs so that these are accessible outside the current browser session how to create conditional scripts that run only under the conditions you specify how to handle frames and cookies and how to allocate usage licenses Managing HAN Resources describes the administration of central HAN resources It also includes details on using the Data Editor and working with queries EZB and HAN describes the use of the EZB module Event Logging and Statistical Analysis describes how data are logged in HAN how you can view these data and how to create statistical evaluations of usage from these data using the HAN Statistics program Hidden Automatic Navigator 2014 H H Software GmbH Introduction 16 Appendix contains additional information for reference such as lists of all authentication services supported by HAN with their parameters Installation This chapter describes the procedures to follow when installing HAN The installation is in three stages carried out in the following order 1 Install HAN 2 License HAN 3 Import data from an earlier HAN version if installed d The HAN 3 beta version
134. ored in the database in plain text Values are edited in the HAN Settings in the Edit Authentication service dialog opened from the Authentication page Hidden Automatic Navigator 2014 H H Software GmbH 143 Appendix ODBC SHA1 Interface Description Authentication is performed over an ODBC compatible database using SHA1 Module auth_sha1 dll Parameters DBUser Database user who has read rights in the database DSN system data source name for the database UserFiel Column containing the login name d TableNam Table in which the authentication information is stored e where Version 3 0 0 11 and later Additional condition appended to the SQL statement DBPasswd Password for reading the database PasswdFi Column containing the user s login password eld Import Version 3 0 0 11 and later List of fields to be stored in environment variables Structure lt fieldname gt lt environmentvariable gt lt fieldname gt lt environmentvariable gt Configuration Prerequisite for the ODBC authentication module is a functioning ODBC interface to the database containing the user information The ODBC connection must be set up as a system data source Further a user account with read access to the required table must be set up in the database The password for the designated user must be stored in the database in plain text Values are edited in the HAN Settings in the Edit Authentication service dialog opened from t
135. ort csv ist property Imported from CSV Existing IDs will be created with a new unambiguous ID ts Structure of the CSV file Separator Specdfied character i The first data record in the CSV file contains the column headers LLES Gl avaiable nan fieis O O O ignore field gt a eISSN HAN ID ISSN Title Root URL 3 In the 1st property field you have the option of entering a property to be set for all e scripts imported which can then be used to group these e scripts in a query 4 Under Separator specify the character used in the CSV file to separate fields 5 Use the tables to specify which columns the CSV file contains The Title and Root URL columns are mandatory If your CSV file has column headers activate the The first data record in the CSV file contains the column headers option This forces HAN to ignore the first data record when reading the CSV file The buttons above the tables let you move the column names from one table to the other All column names listed in the CSV data columns table must be found in the CSV file and will be assigned to the corresponding HAN fields a Decide before activating the import how duplicate e scripts are to be handled Duplicates e scripts are data records with identical titles In the Existing IDs field you can choose from the following options e will be created with a new unambiguous ID HAN creates the e script in spite of the identi
136. p can be calculated by selecting the ID you assigned e g the department name Title bar The title bar of the Object list shows the total number of objects of the selected data element type Licenses These licenses are used in HAN to limit the parallel usage of HAN resources Licenses are data objects that you can define yourself for example based on the number of licenses you have obtained for a certain e journal This section provides details on how to define licenses Begin by defining License objects in the Data Editor Open the Data Editor from HAN Tools 1 In the Data Editor select Licenses in the Data selection pane Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 96 fl HAN Data Editor Organize a New Edit Copy Delete Refresh Filter Data View License 0 2 Click on the New button in the Ribbon fl HAN Data Editor oe qj A HAN Edit Tools HAN 3 In the HAN License dialog enter a meaningful name for the new license in the License field and select the desired number of licenses under of licenses HAN Data Editor 4 Click on OK to confirm The license is created and added to the Object list Hidden Automatic Navigator 2014 H H Software GmbH 97 Managing HAN Resources fl HAN Data Editor ity gt Organize A ET o TM a ap 4 ae N g e HAN New it Copy Delete aa Filter Tools HAN Data View ES License 1 of lice
137. p in mind that Create associated pointer PTR record must be deactivated Once you have added the host name your host may be display for example as follows Hidden Automatic Navigator 2014 H H Software GmbH Configuration 30 rt DNS Manager aae el io Mba ge Se fy DNS E g WIN TCOQJAOM2ZT same as parent folder Host A 192 168 1 65 ful Global Logs g Host A 192 168 1 65 El Forward Lookup Zones Er _msdcs docudom local El docudom local _msdcs _sites top _udp DomainDnsZones ForestDnsZones The following entries have been stored for the HAN server lt HAN server domain com gt Host A lt IP address gt lt HAN server domain com gt Host A lt IP address gt With the entries shown in the example both HAN docudom local and www informaworld com HANID1030 HAN docudom local point to the IP address 192 168 1 65 Requesting and importing a wildcard certificate With a wildcard SSL certificate the browser does not show a certificate error message every time a user calls a script that uses SSL The regular SSL certificate for your HAN web server is issued for lt HAN server gt lt domain gt Because the HAN 3 function for rewriting URLs puts the prowder s address in the first position however this web server certificate is not valid when e scripts run What you need is a wildcard certificate that covers all sub domains of a domain specifically lt HAN server gt lt domain gt d
138. property For details on defining queries see Defining Queries To assign common properties to e scripts proceed as follows 1 In the E Script Administration program select the e scripts to which you wish to assign cumulative properties and then click Properties in the ribbon in HAN E Script Administration Organize he G g G de amp Wi New Copy Rename Delete Tools HAN h h han homepage H H HAN Homepage h h han testbereich H H HAN Testbereich h h homepage H H Homepage 2 In the e script properties you can see the cumulative properties shared by all selected e scripts this is indicated by E script properties lt Multiple selection gt in the title bar Open the dialog page of the e script properties on which you wish to configure settings Hidden Automatic Navigator 2014 H H Software GmbH 103 Managing HAN Resources E script properties lt Multiple selection gt a x Information Meta Information Object Properties Domain List Control Document types Alternate IP Address Notes EZB In the example we assign Administrators permissions for all H H e scripts Configure the desired property The green icon to the left of the property indicates that the property applies to all currently selected e scripts The function for setting properties cumulatively is set automatically when you configure a property 3 Click on OK to confirm your input The cumulative properties are allocate
139. pt is a script This is what initiates the call of the online resource and defines what happens when the resource is called For example the script might execute a user login on the origin server or point the user s browser to a particular HTML page E scripts also have a number of additional properties such as licenses and permissions which you can edit E Script Administration The E Script Administration program is the central administration tool for e scripts All of your HAN e Hidden Automatic Navigator 2014 H H Software GmbH Glossary 148 scripts are shown here In addition gt queries are created edited and managed in E Script Administration Many of the functions for handling e scripts can be reached only from the E Script Administration program such as the e script properties the gt EZB import functions and the gt Script Editor program EZB EZB is the abbreviation for Electronic Zeitschriftenbibliothek the electronic journal library of the University of Regensburg which provides online access to e journals HAN can import access scripts for these e journals and save them as fully functional gt e scripts EZB import The EZB import function imports e journal access scripts from the gt EZB and saves them as gt e scripts EZB module The EZB module is an auxiliary component in HAN for importing e journals from the gt EZB Installation of the EZB module must be explicitly activated during the in
140. ptlogin index ctm g 0 El http www _hh han com estares scriptlogin indexPara ctm g 0 3 In the Create Conditional Script dialog enter a descriptive name in the Name of the conditional script field d Use a name that indicates the purpose of the script such as Restricted area login HAN Script Editor Create Comditional Script http www hh han com testarea scriptogin publikation cfmelg 08type pub amp id 57889 Er Name of the conditional script Name of the conditional script Restricted area login conce 4 Click on OK to confirm your input HAN modifies the existing script and moves the condition and all URLs that follow it to the subscript d The Script Editor highlights the condition in yellow for easy recognition Hidden Automatic Navigator 2014 H H Software GmbH 81 Providing Online Resources with HAN Main script Conditional script Restricted area login X E http www bh han com testarea scriptlogin publikation clm 4 ig 0 hype pub 4 id 57889 E http waw hh han comtestarea scriptlogin publikation cfm lg 0 t type pub t id 57889 name han pword han submit Login The script will now prompt a login only when the login is required but the problem that it always opens the same publication remains To solve this problem the condition must be made flexible so that calling any publication will match the condition and the requested publicati
141. r HANStatistics html locale en_EN Home Views Selection ables Reports Settings H H HAN Statistics 7 Table loaded Table 3 Tasks breakdown O Record ID Total usage Total calls Bytes Use per call Bytes per call Percentage c P 410 Minute Guide to Paying for 00 00 06 1 26 676 00 00 06 26 676 B P ACS American Chemical Society 00 34 40 5 7 941 647 00 06 56 1 566 329 gt African American Review 02 19 17 1 37 504 754 02 19 17 af 504 734 P African Americans 00 00 36 1 257 481 00 00 38 257 481 P Algorithmica 00 00 08 1 62 205 00 00 09 62 205 gt Analytical Biochemistry 00 00 05 1 229 621 00 00 05 279 621 P Analytical Chemistry 00 05 03 1 653 464 00 05 03 653 464 i 00 00 04 1 389 106 00 00 04 365 106 P 00 01 42 1 1 116 796 00 01 42 1 116 796 p 00 00 18 1 672 855 00 00 18 672 865 d 00 01 11 1 3 740 821 00 01 11 3 740 821 d 00 00 16 1 20 953 00 00 16 26 953 P Black American Literature Foru 00 00 49 1 335 811 00 00 49 335 811 P Cambridge Scientific Abstracts 00 00 19 2 65 926 00 00 09 42 964 o Sf me PDO eg ee a Performing a user defined calculation of the total usage You can create a user defined calculation any time the predefined standard calculation templates do not meet your needs for example if you want only the data pertaining to certain record IDs users or stations or if you want to chart data from other time periods 1 In the main window of the Statistics application click Selection in the menu bar t
142. re not sent to just any server the HAN server replaces the values only if the server name domain name is identical to the server domain name the of the e script s root URL If the names are not identical enter the required URL in the Send login data to this domain field again as a regular expression Return to the browser and use the selection tool to select the Submit button The code now shows the address to which the data are sent Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 76 File Find Disable View Qutine Images Cache Tools Validate Browser Mode IE8 Document HTML less seret Profiler cae a 2 E lt div align center gt m h post gt lt tbody gt H lt tr gt lt tr gt fl lt tr gt El lt tr gt Bl lt td class style gt El lt td class style gt El lt label gt lt input name Submit type submit value Submit gt Text Empty Text Node In our example the only value for the action attribute is process _login php which means the data will be passed to the root server No modification is needed here If a specific URL with a non matching server domain name is shown here enter that server domain name in the Send login data to this domain field 14 Click on OK to save your settings in the e script properties Then click on Save in the ribbon of the Script Editor to save the entire e script From that point on a
143. re stored in the HH HAN Bin System web htdocs directory Do no make any changes in these directories All files in these directories are overwritten during program updates Login and error message pages are available in various languages The language in each file is indicated by the country code appended to the file name e g error html de German or error html en English Selection dialogs show only those files which are in the same language as the operating system Thus when you create your own HTML pages for login or error messages it is essential to append the country code to the file name d Keep in mind when editing login pages that the following HTML text must be included unchanged in the page lt form action hhauth login method POST gt Hidden Automatic Navigator 2014 H H Software GmbH Configuration 54 Name amp nbsp lt input type text name User maxlength 30 gt Passwort amp nbsp lt input type Password name Password maxlength 30 gt lt input type submit value Login style width 96px gt lt form gt Providing Online Resources with HAN With HAN you can provide your users with access to a variety of online resources over a centralized interface The source of the resource provided cannot be detected by the client in your network because the client communicates only with the HAN server Validation of user credentials is also handled entirely by HAN To this end HAN uses sc
144. reboot Web services are configured in the HAN System Settings program Windows Control Panel System and Security H H HAN Web Service The following diagram illustrates the interaction between the individual HAN components Hidden Automatic Navigator 2014 H H Software GmbH Introduction Nindows OS y5 HAN web server Modules Apache Proxy other System Apache modules databases HAN License Monitor HAN Report Center metering and statistics HAN Authentication HAN alphabetical list HAN kernel Web database provider 10 User HAN management HAN Settings HAN Script Editor HAN Data Editor HAN E Script Administration HAN helper programs HAN database E scripts Permissions Access log Database queries Data objects HAN E script definitions E scripts E script properties Third party authentication services HAN installs a temporary server certificate DO NOT TRUST when the web server is installed Once HAN installation is complete this should be replaced by an official certificate issued by a certification authority The official certificate has to be a wildcard certificate that can cover multiple subdomains HAN also installs a root certificate which ensures the correct display of HTTPS pages in the Script Editor For details on creating a wildcard certificate request with HAN see Configuration Wildcard Confiquration HAN 3 Kernel Hidden Automatic Navigator 2014 H H Software GmbH 11
145. ripts to call the requested online resources These e scripts are specially adapted to carry out all the procedures that are necessary for calling the desired resource correctly This chapter describes details on how to prowde online resources for your users with HAN Online resources are made accessible in HAN through the use of e scripts An e script contains both a script that calls the online resource and all of the settings required for calling the e script correctly E scripts are created in HAN E Script Administration To run the E Script Administration program use the HAN Tools desktop shortcut Which is the best way to create a given e script depends on the degree of complexity involved e With automatic script recording If the root URL of the online resource is the same as the destination URL in the e script HAN can create an e script automatically with no further editing required In this case the root URL is the target URL if no redirection takes place for example no login is required or the login uses an HTTP dialog e With manual script recording If redirection is involved or login is carried out in the background of a web page the script must be recorded manually This entails a number of additional steps such as inserting variables in URL parameters The chapters linked below provide details on creating e scripts Creating E Scripts describes both the automatic and manual recording methods for creating e scripts as
146. s application Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 118 Selection window In the Selection window you can select your choice of criteria for the calculation of data H H HAN Statistics Windows Internet Explorer a http docudiv 2008 eng doqudomain lokal HANStatistics war HANStatistics html locale Home selection Tables Repo View loaded f Record ID EEG Calculation basis j E Station Record ID scat Selected All Select the type of criterion on the left and the setting itself on the right Once you have selected the desired criteria click on Calculate and select a table HAN does the rest Calculate a table ui Table of concurrent use For details on calculating a main table see Total Usage For details on calculating a table of concurrent use see Concurrent Use Creating views To create a view begin by clicking on Views in the menu bar In the Views window click on New in the task bar H H HAN Statistics Windows Internet Explorer http docudiv2008 eng decudomain lokal HANStatistics war HANStatisti Home Selection Tables Tasks The Views window now shows a list of existing views When you click New the Selection window opens and you are prompted to select the desired criteria In the Selection window select the desired settings for the new view and click on Save as a View Hidden Automatic Navigator
147. s the highest in this hierarchy Hidden Automatic Navigator 2014 H H Software GmbH 61 Providing Online Resources with HAN URLs can have any number of parameters Each parameter is assigned to the URL above it in the hierarchy g 0 E http www bh han_ comtestarea Tomlogin result cfm ig 0 name han t pword han submitimgx 0 submitimgy 0 name han pword han submitingx submiting y When the sample script was created Ses previous section a number of URLs were recorded These URLs do not all have the same number of parameters In accordance with the hypertext transfer protocol HTTP both URLs and parameters can be sent using the POST and GET methods HAN detects the correct method when the script is recorded and shows the result next to the URL lo ip www bh han com testarea HANIogin cfm 0 1 0 ip Jna hh han com testarea fomlogin index cfm lig 0 p wew bh han com testarea Tomlogin result cfm g 0 name han pword han submitingx 0 t submiting y 0 HAN stored the login data you entered while recording the script E http www bh han com testarea Tonnlogin result cfm ig name t pword Hidden Automatic Navigator 0 han han 2014 H H Software GmbH Providing Online Resources with HAN 62 This data is sent automatically when the script executes thus no user input is required for login You can modify scripts at any time Double click on
148. s to unknown domains This entry in the DNS is essential to ensure that HAN can provide access to e journals from a broad variety of providers Hidden Automatic Navigator 2014 H H Software GmbH Index Type query criterion 146 A Access Log 115 116 activation wzard 19 AJAX login 71 allocating licenses 84 allocating properties 102 appendix 138 A to Z List 103 authentication modules 138 authentication services 138 automatic collating of EZB data 110 C certificate wzard 29 concurrent use 130 conditional scripts 76 configuration 27 configuring authentication services 41 configuring EZB access 27 configuring HAN settings in EZB preferences 107 contents of this manual 15 creating e scripts 55 no manual recording required 56 using manual script recording 58 customizing HAN for your company 53 D Data Editor 93 licenses 95 deactivating EZB data logging 38 defining permissions 48 disk space monitoring 39 Document types 131 documentation conventions 11 E e scripts 86 export 88 e scnripts 86 import 89 event logging and statistical analysis 113 exporting e scripts 88 EZB collating data 110 EZB and HAN 105 EZB configuration 106 EZB title lists manual import 108 F frames 82 G glossary 147 H HAN Access Log 115 HAN components 136 HAN Web Service 137 ideas 12 importing data from HAN2 25 importing e scripts 89 installation 16 installing HAN 16 introduction 5 L licenses 95
149. script exchange folder Overwrite existing e scripts If there are e scripts in the exchange file that already exist identified by HAN_ID in the importing HAN system the existing e scripts are overwritten by the imported e scripts 3 Click on OK to confirm your selection The exchange file data are imported and are now available as e scripts Importing from a CSV file Use the CSV Import utility to import data from CSV files 1 In E Script Administration open the program menu and select Tasks CSV Import Hidden Automatic Navigator 2014 H H Software GmbH 91 Managing HAN Resources w HAN E Script Administration folder Export Export the selected e scripts to the exchange A Diagnostics folder y Import or Import the selected e scripts from the exchange E Utilities E script exchange folder 2 Language Omen the avrhannae folder far aerrinte in the ba Options i Information Help Ea Exit 2 Click on the Select button next to the CSV file field and select the desired file The CSV file must be accessible in Unicode format If the file is not Unicode formatted open it for editing e g in the Windows Editor and save it in Unicode format prior to import To open the file for editing click on the Edit button next to the CSV file field Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 92 x E gt Importing e scripts from a CSV file CSV file C Copy CSVImp
150. server s URL http HANServer gt ezh start In EZB License Administration select the e journals to be accessed through HAN Hidden Automatic Navigator 2014 H H Software GmbH EZB and HAN 108 After you have entered the HAN server in EZB Preferences you need to specify which e journals are to be called over the HAN server 1 In EZB Preferences under License Administration on the left click on the Edit link 2 Specify the desired criteria on the Search page and open the Results page You should see a new column with the header Journal via HAN Journal Selection New Delete Title orl oo i entry for edit License Traffic aan WWicense own licenses complete lights licenses BSHM Bulletin Journal of the British Society for the History of Mathematics Taylor amp Francis CES Discussion Paper Series y Center for Economic Studies Leuven Center for Economic Studies Leuven 3 Select the e journals that the EZB will provide over the HAN server Activate the All licenses over HAN checkbox if you wish to select all e journals for use with HAN Manual Import from EZB Use the manual EZB import function if you have not imported e journals from the EZB before or if you are looking for particular e journals Run the EZB import from the E Script Administration program by clicking on the EZB button in the ribbon and selecting the Import function from the drop down menu AE Load Reset En oe Ee Ese Query
151. sions licenses document types publishers sources subjects and authentication services Hidden Automatic Navigator 2014 H H Software GmbH 149 Glossary Report Center The HAN Report Center is a web based application for the statistics and metering functions Because this application is web based you can call it from any machine that has access to the HAN web server HAN administrator rights are required for use of this application S Script Editor You can use the Script Editor to edit e scripts Not all e scripts require manual editing Imported e journals for example do not need editing If an e script sends session specific values or if it requires a login using credentials managed by HAN then it will require editing The Script Editor can be opened from the E Script Administration program It also has a recording module so you can record e scripts in your browser Summon Summon is a product from the Serials Solutions company It is a program that provides libraries with an extensive index of online resources and makes the resources accessible in the libraries HAN can import the online resources provided by Summon and save them as gt e scripts making them available from within your HAN system HAN s Summon module is an auxiliary component that requires separate installation during the setup of your HAN software W Wildcard DNS record A wildcard DNS record is an entry in your DNS that enables HAN to provide acces
152. some 69 MB Further details can be analyzed in the Table of Users Record IDs or Stations Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 134 Usage per Cost Center You can define cost centers in HAN to create individual statistical analyses of usage per cost center This function lets you calculate the costs of e journal usage and assign them to the relevant departments at your institution Cost centers are user definable in HAN The definition is implemented as part of the user s authentication in the HAN system The cost center must be included in the attributes of the login To do this open the Global section of the HAN Settings select the Global page and define an environment variable in which the cost center will be stored The HAN Access Log will read the cost center from this variable and save this value with each data record Thus for purposes of statistical use analysis a cost center is a property of the data records This chapter describes how to configure and statistically evaluate cost center based data Configuring cost centers One of the parameters configured in the relevant authentication service must contain the cost center The following example shows an ODBC login with the cost center defined in the Import parameter d For details on configuring cost centers in another login service please refer to the documentation on that service x ODBC login ODBC
153. stallation of HAN You need to have authorized access to the EZB if you wish to use the HAN EZB module fe Flexible parameters The terms flexible parameter and making a parameter flexible refer to the replacement of the value in a specified HTTP parameter with a variable Such parameters include for example session IDs that change each time a page is called or login data managed by HAN When a script is recorded for use in an e script the values for such parameters have to be replaced by variables so that the resulting e script does not pass expired or invalid values in the parameters when it executes This is done in the HAN gt Script Editor HAN gt Hidden Automatic Navigator Hidden Automatic Navigator Hidden Automatic Navigator HAN is a software product developed by H H software With HAN you can provide your users with access to Internet resources e journals over the separate HAN web server Basically HAN is a reverse proxy In the HAN system users communicate only with the HAN web server rather than with the actual providers of the e journals HAN offers a variety of features for management of your online resources including access control through permissions license management metering and statistical analysis and help desk functions for troubleshooting Migration Wizard The Migration Wizard is for migrating data from HAN 2 to HAN 3 The following data are migrated Sequential database detailed database permis
154. stical Analysis HAN Data Editor 5 Under Group definition define the members of the data group In our example we want to calculate the usage data on all of the 101 Questions publications We click on the New button and select Dynamic expression from the menu to define the desired record IDs using a regular expression HAN Data Editor E j HAN Group Record id Group fiqesios Description 101 Questions series Group definition Members Selection criteria Add dedicated ids 6 After entering the expression we click on OK if If all of the desired record IDs begin with the same string simply enter the characters HAN automatically adds all record IDs that begin with this string Hidden Automatic Navigator 2014 H H Software GmbH E vent Logging and Statistical Analysis 126 Enter the wild card for dynamic selection wierd foo ti tewtC ee aa T The expression is added to the group definition Click OK to confirm and create the HAN data group HAN Data Editor ay Ge HAN Group Record id 101 Questions The new data group is shown in the object list and is available starting immediately for use in the HAN Statistics program To calculate a data group add it to the your selection to the Statistics program QQ sx QR i rs Meta record IDs Description ead Record ID No items to show Description Questions series Record IDs Additional 554 elected
155. stored as server names on the HAN server Prerequisite is a wildcard alias in the DNS of domain hosted by HAN The HAN 3 program supports both the HAN 3 and HAN 2 kernels The primary advantage of the new kernel is its improved compatibility with JavaScript e New database The central database in HAN 3 is now a No SQL database This new database offers significant advantages in speed over the previous HAN data structure For downward compatibility with HAN 2 the HAN 2 database can be integrated into the HAN 3 database e More reference databases supported In addition to the EZB HAN now supports the EBSCO EBSCO Industry Inc and Summon Serials Solutions reference databases as well The separate modules that provide support for each of these services can be selected during installation of the HAN software e Licensing Starting with v3 the HAN software is now licensed by yearly subscription Existing license contracts however can be extended in their current form e HAN System Settings The HAN System Settings now are configured using an application in the Windows Control Panel The System Settings include configuration and controls for all HAN services HAN service HAN web service and the database service e Language support The HAN programs can be displayed in various languages The control for switching languages is in the Program menu Selection in that menu does not affect the display of web content in HAN The language of HAN s w
156. system i Hidden J Automatic Havia Windows Internet Explorer z iol x http www hh han com te E fal Hx S srg ej if m7 k ue k Sar Favorites ae Suggested Sites Web Slice Gallery Hidden Automatic Navigator fay gt Gl a Pages Safety Toos Hidden Automatic Navigator HAN Test area Welcome This test site will give you an opportunity to see for yourself how HAN works The links below let you test the different accessing login mechanisms for password protected Internet resources Public web pages with links to protected pages e Frame based pages HAN E Skript Recording with URL fih arin J Please use the following account information Tite Login Root URL http www hh han com testinghan Name HAN Password HAN hinheminee II ere a ee ee 3 To record the script carry out all steps required i e login navigation to reach the target page In this example the steps include clicking the Login va HTML form link entering the user credentials and then clicking on Login The target page is now open for this example 4 In the recording window click on Exit to stop the recording process and return to the Script Editor Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 60 HAN E Skript Recording with URL filtering Title Login Root URL http www hh h han c
157. t Once a script has been recorded it should be streamlined so that only the only pages it opens are those relevant for HAN These can include for example login pages target pages and any intermediate pages that are required for subsequent processing The goal is to limit scripts to the essentials and keep them as short as possible The shorter the script the faster HAN can process it For a detailed demonstration of how a script can be optimized see Using Manual Script Recording Optimization options e Delete superfluous steps First you can delete any steps that are not directly connected with calling the target URL e Replace parameters This step makes session specific values in URL parameters flexible For details on how to make URL parameters flexible see Using Flexible URL Parameters e Creating conditional scripts For web sites that have both freely accessible and protected content you can create conditional scripts that perform a login only for the protected content For details on creating conditional scripts see Conditional Scripts e Adaptations for frame based web pages For frame based web pages the script must reference the definition file for the frameset otherwise only a frame is opened by the script rather than the whole web page For details on integrating frame based web pages see Frames Hidden Automatic Navigator 2014 H H Software GmbH Providing Online Resources with HAN 56 Additional opti
158. t domain auth_nt dll authntads dll Parameters DefaultDom This is applied when the user does not indicate a domain for ain login name Configuration Values are edited in the HAN Settings in the Edit Authentication service dialog opened from the Authentication page Hidden Automatic Navigator 2014 H H Software GmbH Appendix 142 ODBC Interface to Existing Databases Description Authentication can be performed using any ODBC compatible database Module auth_odbc dll Parameters DBUser Database user who has read rights in the database DSN system data source name for the database UserFiel Column containing the login name d TableNam Table in which the authentication information is stored e where Version 3 0 0 11 and later Additional condition appended to the SQL statement DBPasswd Password for reading the database PasswdFi Column containing the user s login password eld Import Version 3 0 0 11 and later List of fields to be stored in environment variables Structure lt fieldname gt lt environmentvariable gt lt fieldname gt lt environmentvariable gt Configuration Prerequisite for the ODBC authentication module is a functioning ODBC interface to the database containing the user information The ODBC connection must be set up as a system data source Further a user account with read access to the required table must be set up in the database The password for the designated user must be st
159. ted in the Object list Refresh Updates the Object list Filter Opens a filter bar so you can search for specific objects Object list The Object list shows the existing data objects of the type selected in the Data selection pane What columns are shown depends on the type of data element e Licenses License ID Number of licenses e Permissions Permission ID Description HTML page e Publishers Publisher Description e Subjects Subject Description e Sources Source Description Hidden Automatic Navigator 2014 H H Software GmbH 95 Managing HAN Resources e Document types Type Description d The individual rights within a Permission object are not shown in the Object list They are shown in the dialog that opens when you edit the permission object The Object list shows only the permission ID a description and the error page to be shown for failed logins Furthermore the group called Data groups contains data groups that aggregate data records in Statistics e User Groups the data by user e Station Groups the data by station e Record ID Groups the data by record ID The advantage of grouping data is in the aggregate calculation of data records that have something in common For example you can calculate the total usage data over all users in a particular department To do this create a User data group named for example after the department and add it to your users Data collected from the users in the grou
160. teria in the Selection window or open a predefined View template and in the Calculate a table dialog click on Cross table In this example the period from May to June 2006 has been selected The following cross table was calculated on the basis of this data record ID period usage Record ID May 2006 June 2006 Sum Electronic Packaging and Produ 0 00 0 00 0 00 Electronics Letters 0 00 0 00 0 00 Electronics Systems and Softwa 0 00 0 00 0 00 Electronics and Communications 0 00 0 00 0 00 Electrophoresis 0 04 0 04 0 08 Elementa Journal of Slavic St 0 00 0 00 0 00 Elsevier Science electronic jo 20 09 3 57 2365 Emerald Management Xtra 0 99 0 01 1 00 Energy Conversion and Manageme 0 01 0 00 0 04 Energy Journal 0 00 0 00 0 00 Energy Sources 0 00 0 00 0 00 This table shows that usage of the e script s with the record ID Elsevier Science electronic journal accounted for 23 65 of all HAN e script usage in those two months Breaking this data down we see that this record ID made up 20 09 of total usage in May 2006 and 3 57 in June 2006 Reports To store the result of a calculation or make it available to others you can save it in the form of a report To do this click on Report in the task bar The results of the current calculation are saved as a report and can be opened in the Report window at any time For details on working with reports see Statistics Graphical evaluation You can also use HAN to plot the usage data
161. than 15 56 minutes Document Types p Document types group the calls from URLs that match the specified URL pattern You can define any number of URL patterns for each document type The document type table shows the usage of HAN resources in accordance with criteria used by web counter programs For example you can view the number of times PDF files have been called The following must be configured to enable use of this feature e Document types must be defined Document types are defined in the HAN Data Editor e URL patterns must be defined for the document types URL patterns and document type assignments are defined in the HAN Settings program in the Global section on the Global document types page The usage of document types is calculated in the document type table in HAN Statistics Run the HAN Statistics program and select the desired calculation criteria For details on using standard calculations or selecting user defined criteria see Total Usage d In the selection window you can select a minimum or maximum value for downloaded bytes to further refine your search if desired In the Calculate a table dialog select Document type table as the table type F d If you already have calculated a main table select Document type table in the table selection sidebar on the left to calculate the document type table Calculate a table li Main table v i Table of concurrent use ee This example shows a calcula
162. that this alters the structure and level of the affected directories The use of relative paths in web pages and web applications is common The insertion of han lt HAN ID gt lt provider server name gt by HAN adds three directory levels to every URL which can cause Java scripts to construct URLs incorrectly New operating principle in the HAN 3 kernel In HAN 3 reverse proxy technology is still the technical basis so URL rewriting is still required The new kernel however uses a different technique for modifying URLs Rather than storing the required information in the URL in HAN 3 this information is stored in the server name Prerequisite is a wildcard DNS record that references the HAN server For details on creating a wildcard DNS record see Configuration Wildcard Configuration HAN 3 Kernel In addition the HAN web server needs a wildcard certificate from an official certification authority The procedure for creating a wildcard certificate request is also described in Configuration Wildcard Configuration HAN 3 Kernel The URL format in HAN is modified accordingly The required information is stored in the name of the HAN server and is no longer made a component of the URL HAN 2 URL http lt HAN server gt han lt HAN ID gt lt provider server name gt index html HAN 3 URL http lt provider server name gt lt HAN ID gt lt HAN server gt index html Advantages of the HAN 3 kernel e The URL rewriting engine
163. time periods as well as for managing multiple e scripts with different starting URLs for a single e journal d The EZB interface is available only if the EZB module was selected for setup when installing the HAN software suite HAN 3 Beta does not include the EZB module For details on installing HAN and the EZB module see nstalling HAN HAN supports the import and administration of e scripts from the EZB There are three methods for importing and updating EZB data e Manual import full or partial imports e Automatic import full or partial imports e Import update when EZB content is accessed When an e script is created automatically through an import operation it includes a data field containing the EZB anchor Thus the imported e script can be found using an anchor field query In HAN v2 and later you can have multiple different starting URLs for a single e journal The means that access to an e journal may consist of multiple e scripts You can also specify certain anchor based properties permissions data logging etc to be assigned automatically to new e scripts imported from the EZB Once the EZB module has been installed proceed as follows to enable its use in HAN 1 Configure the EZB access data in the HAN Settings 2 Import the EZB title list into HAN 3 Configure HAN settings in EZB Preferences 4 Select the e journals to be offered through HAN in EZB License Administration 5 Set up automatic data collation
164. tion With this option selected you need to define in the Replace in field just where the value is to be replaced Otherwise only the currently selected Parameter value will be made flexible Furthermore a separator for the parameter must be specified Select may contain Hidden Automatic Navigator 2014 H H Software GmbH 6 9 Providing Online Resources with HAN different values replace only if values are identical in the Parameter field In the Value field the value is automatically replaced by a variable Under Replace in put checkmarks in the checkboxes as needed depending on where you wish to have additional identical values replaced Enter the separator in the field next to the parameters with separator C HAN Script Editor Define URL Parameter for a Script i X Parameter Value Parameter may contain different values replace only if values are identical Replace in IY the URL I the parameters with separator i Example The home page of our fictitious online magazine onlinemag com shows their latest issue Thus the content on this page changes regularly The script that calls this resource appears as follows in the Script Editor Main script x Variable Value hitp www onlinemag com http www onlinemag com johnson_basic hitps ogin onlinemag com A hitps Aogin onlinemag com login login call Login Weblet email admin han password han goto_un sites D0073902647 v
165. tion of PDF usage All calls of PDF documents are grouped under the PDF document type using pdf as the URL template This means all instances in which PDF documents were called are included in the statistics regardless of the resource used to locate the document Hidden Automatic Navigator 2014 H H Software GmbH Event Logging and Statistical Analysis 132 H H HAN Statistics Windows Internet Explorer a http decudiv2008 eng doqudomain lokal HANStatistics war HANStatistics html locale en_EN Selection Tables Reports Document type Total calls Bytes Bytes per call Percentage of IDs in total calls Percentage of IDs in total bytes P PDF 2963 816 025 336 275 405 100 00 100 00 P Sum 2963 616 025 336 275 405 100 00 100 00 In our example a total of 2963 PDF documents were called in the month of June 2006 All documents together have a total data volume of approximately 816 MB The average data transfer volume was about 275 KB per call To simplify calculations 1 KB is defined as 1000 bytes in this example Open the single record view for detailed information on the effective usage of the PDF documents ow E Document type Total calls Bytes Bytes per call Percentage of IDs in total cals Percentage of IDs in total bytes PDF 2963 516 025 338 275 405 100 00 100 00 Record ID Started Ended User Station Bytes Attribute Document types nitions OTOT ZONT TOTT TANZA T I ET O TRE TETA or rvrarcars ss pyss I Analyt
166. tion services shows all of the authentication services you have configured If more than one authentication service has been defined they are processed in order from top to bottom until one service has successfully completed the login after which subsequent services are ignored You can use the Up and Down buttons to change the order of authentication services If an IP authentication service is defined this is the first service applied because IP based authentication does not require user input 3 In the Authentication services dialog select the desired authentication service H H HAN x Plo gin NT Login SSPT ODBC Lagin LDAP Login Aleph Login bsb Login AuthElektra_11857 Login AuthBSB_11857 Login AuthBSBNL_11857 Login AuthCookieNetan Login AuthNLLDAP_13480 Login 4 Click on the OK button The dialog for configuring an authentication service opens automatically when you select a service In the Authentication service field enter a name for the new authentication service in this example IP login The label in this example IP is required for internal processing Hidden Automatic Navigator 2014 H H Software GmbH 45 Configuration x a a eF W Activate service Description IF login Label IP Use persistent cookies for login Validation hours 0 Ffa i i Parameter Value E croFile a The Activate service checkbox activates or deactivates the service Thus you can activ
167. ty to build up a socket connection to the that server List of tables d02ben d02zus d61bgr Values are edited in the HAN Settings in the Edit Authentication service dialog opened from the Authentication page and stored in the HAN database The login module stores data from the database user data in HAN environment variables These can be used to check for user rights SisisGr User group database field d02bg oup SisisPL Zip code database field d02p1 Z1 Zip code database field d02z_plz Z2 4 2014 H H Software GmbH 145 Appendix XServer Login Description The ALEPH server offers a web based interface XServer that can be used to request user information There is an option available for user authentication Login data user name and password are passed in the form of a URL to the xServer as a request The response takes the form of an XML file and shows the user s status if login is successful or shows that the login failed When checking the user credentials a URL is called Module auth_xserver dll Parameters Server Name or IP address of the XServer Library Name or IP address of the XServer Configuration The response to the authentication request takes the form of an XML file When checking the user credentials the following URL is called https lt server gt X op bor auth library lt library gt amp bor id lt user id gt amp verification lt user password gt XML response to failed login
168. ve been imported Double click on the query to apply it To reset the use of the query click on the Reset button in the Query section of the ribbon Once this sample query is applied only those queries that have titles beginning with H H are shown Hidden Automatic Navigator 2014 H H Software GmbH Managing HAN Resources 10 HAN E Script Administration Organize oe a 7 w Tf Fal gt Y Filter EF Load ts f a ra w o R Reset 5 ai Ca Columns HAN New Properties Edit Reload Test Import o je HAN E script View Query EZB Tools fa e scriptst Scripts r h h han homepage H H HAN Homepage E scripts that USE a script to navi e h h han testbereich H H HAN Testbereich i h h homepage H H Homepage User defined queries ys Changed today E scripts that have been modified 4H E scripts e scipts from H H Software amp Import E scripts that have been imported Fil cia a a af E scripts 3 Quer H H E scripts All e scripts from H H Software Allocating Properties To assign cumulative properties to e scripts select the desired e scripts in E Script Administration and click on Properties in the ribbon It is useful to combine this procedure with the use of queries because a query can reduce the display to only a defined set of e scripts For example you can define a query the returns exactly the set of e scripts to which you wish to assign a common
169. you can edit the copy and still have the original in case anything goes wrong during optimization e g deleting one URL too many d When you click on Start in the ribbon to begin a new recording process this deletes the previous main script and replaces it completely with the new recording Optimization options 1 Delete superfluous steps First delete any steps that are not directly connected with calling the target URL 2 Flexible URL parameters When an HTML page is called parameters containing session specific values are often added to the URL These can lead to errors later when the page is called again using the script This can be avoided by replacing the parameter values with variables to make the parameters flexible For details on how to make URL parameters flexible see Using Flexible URL Parameters 3 Create conditional scripts for online resources that have password protection only in some areas Some web pages offer access to both protected content and freely available content To have a login performed only for the protected content HAN can use conditional scripts as a supplement to the main script The conditional script executes only when a defined condition is met e g when a protected resource is requested For details on creating conditional scripts see Conditional Scripts 4 Adaptations for frame based web pages Frame based web pages require additional processing to ensure that the definition file
170. you can use to analyze the usage of your HAN e scripts You can calculate exactly who used which online resources when how often and for how long HAN Statistics also tracks concurrent use or license usage providing you with invaluable data for budget planning The more you know about the number of licenses you need for a given online resource the better you can streamline your licensing costs Thus the Statistics utility can help your enterprise save money HAN Statistics is a web based application Open it from the HAN Report Center The main window of the Statistics application gives you access to the following basic functions Hidden Automatic Navigator 2014 H H Software GmbH 117 Event Logging and Statistical Analysis F H H HAN Statistics Windows Internet Explorer http docudiv2008 eng docudomain lokal HANStatistics war HANStatistics html locale en_EN Home Views Selection Tables Reports Settings H H HAN Statistics 7 Welcome to H H HAN Statistics This is where your statistical analyses are calculated Direct calculation of your data Help Topics iw Cal is th any see td Culates ine dd curent aay Calculating data Month s evaluation Creating views ut Calculates the data from the current month Calculates the data for the current quarter Year s evaluation ih Calculates the data for the current year pment rocco a Ao Direct calculation of your data lists options

Hidden Automatic Navigator

Contents

Download Pdf Manuals

Related Search

Related Contents