CINXE.COM

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>UsageLimit - OCLC Support</title> <link media="screen" type="text/css" rel="stylesheet" href="https://a.mtstatic.com/@cache/layout/legacy-0.css?_=54c3c8d632aa3c3aa1deb1e501b6ba5f_aGVscC5vY2xjLm9yZw==:site_10606" id="mt-screen-css" /> <link media="print" type="text/css" rel="stylesheet" href="https://a.mtstatic.com/@cache/layout/print.css?_=a87985e947b3b92ebec6cfe4689bceb3:site_10606" id="mt-print-css" /> <script type="text/javascript" nonce="5cd88e6080420797fd2d18ecf728b91f72545a44dc6104e63bfc86e5fd8e7fd4" src="https://a.mtstatic.com/deki/javascript/out/grape.min.js?_=76f77a33377b2f0da26a22ff3a2c3345f92f980b:site_10606"></script><script type="application/json" id="mt-global-settings" nonce="5cd88e6080420797fd2d18ecf728b91f72545a44dc6104e63bfc86e5fd8e7fd4">{"apiToken":"xhr_2_1732686594_07fcfbc6a9380d7b9d15d73a065007f8d1c1047e5ddc65eae0f866cb13c66c82","pageId":10092,"pageViewId":"e0112f28-553e-4679-a3a2-53bc1a72cba9"}</script> <link rel="stylesheet" href="https://use.typekit.net/gsk4dds.css"> <script src="https://www.oclc.org/apps/settings/wcm/designs/oclc/js/jquery/jquery.hoverIntent.minified.js"></script>  <script type="text/javascript" src="https://cdn.cookielaw.org/consent/999c7907-ac3c-4ce1-9125-172f53ec926f/OtAutoBlock.js"></script> <script src="https://cdn.cookielaw.org/scripttemplates/otSDKStub.js" data-document-language="true" type="text/javascript" charset="UTF-8" data-domain-script="999c7907-ac3c-4ce1-9125-172f53ec926f"></script> <script type="text/javascript">/*<![CDATA[*/ function OptanonWrapper() { } /*]]>*/</script>   <script type="text/javascript">/*<![CDATA[*/ (function() { var sz = document.createElement('script'); sz.type = 'text/javascript'; sz.async = true; sz.src = '//siteimproveanalytics.com/js/siteanalyze_6037648.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(sz, s); })(); /*]]>*/</script> <script type="text/javascript" nonce="5cd88e6080420797fd2d18ecf728b91f72545a44dc6104e63bfc86e5fd8e7fd4">(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)})(window,document,'script','//www.google-analytics.com/analytics.js','ga');ga('create','UA-69387992-20','https://help.oclc.org/',{allowLinker:true});ga('send','pageview');ga('create','UA-65721316-23','help.oclc.org',{name:'mtTracker',allowLinker:true});ga('mtTracker.require','linker');ga('mtTracker.set', 'anonymizeIp', true);ga('mtTracker.send','pageview');document.addEventListener('mindtouch-web-widget:f1:loaded',function(e){var t=e.data||{},d=t.widget;d&&''!==t.embedId&&document.addEventListener('mindtouch-web-widget:f1:clicked',function(e){var t=(e.data||{}).href;if(t){var n=document.createElement('a');n.setAttribute('href',t),'expert-help.nice.com'===n.hostname&&(e.preventDefault(),ga('linker:decorate',n),d.open(n.href))}})});</script> </head> <body class="columbia-page-main columbia-article-topic columbia-breadcrumb-home-librarymanagement-ezproxy-configureresources-usagelimit columbia-live no-touch columbia-lang-en-us columbia-skin-grape"> <div class="grape-messaging"> </div> <div class="grape-header-custom"><div class="header_microbar iparsys parsys"><div class="header_microbar iparsys parsys"><div class="sitebar parbase section"><section class="micro-bar" id="micro-bar"><div class="cont-page mod" id="sitebar-contents"><div class="elm-nav-container"><div id="oclc-return"><a title="OCLC.org Home" href="https://www.oclc.org" target="_blank" rel="external noopener nofollow" class="link-https">OCLC.org</a><ul id="sitebar-sites" style="display: none; "><li><a title="" href="https://www.oclc.org" target="_blank" rel="external noopener nofollow" class="link-https"><span class="oclc-return-home">OCLC.org Home</span></a></li><li><a title="" href="https://community.oclc.org/" target="_blank" rel="external noopener nofollow" class="link-https">Community Center</a></li><li><a title="" href="https://www.oclc.org/developer/home.en.html" target="_blank" rel="external noopener nofollow" class="link-https">Developer Network</a></li><li><a title="" href="https://www.oclc.org/research/home.html" target="_blank" rel="external noopener nofollow" class="link-https">Research</a></li><li><a title="" href="https://www.webjunction.org/home.html" target="_blank" rel="external noopener nofollow" class="link-https">WebJunction</a></li></ul></div></div></div></section></div></div></div><nav class="elm-nav mindtouch-header"><div class="elm-nav-container"><div class="company-logo-container"><a class="internal" href="https://help.oclc.org/" rel="internal"><img src="https://help.oclc.org/@api/deki/site/logo.png?default=https://a.mtstatic.com/skins/styles/elm/logo.svg%3F_%3D76f77a33377b2f0da26a22ff3a2c3345f92f980b:site_10606" alt="OCLC Logo" /></a></div><div><div class="selected-region-dd"><p class="selected-region"><a class="selected-region-title" id="selected-region-title">English</a></p><ul class="languagepicker"><a class="language" id="en" href="#"><li><span language="en">English</span></li></a><a class="language" id="fr" href="#"><li><span language="fr">Français</span></li></a><a class="language" id="de" href="#" style="display:none;"><li><span language="de">Deutsch</span></li></a><a class="language" id="it" href="#" style="display:none;"><li><span language="it">Italiano</span></li></a><a class="language" id="es" href="#" style="display:none;"><li><span language="es">Español</span></li></a><a class="language" id="nl" href="#" style="display:none;"><li><span language="nl">Nederlands</span></li></a></ul></div></div><ul class="mindtouch-site-nav"><li><a title="Find release notes for OCLC products and services." target="_blank" href="https://help.oclc.org/Librarian_Toolbox/Release_notes" rel="internal">Release Notes</a></li><li><a href="https://oclc.service-now.com/status" target="_blank" rel="external noopener nofollow" class="link-https">System Status Dashboard</a></li><li><a onclick="ga('send', 'event', 'External Link', 'Click', 'Contact OCLC Support', '0');" class="internal" href="https://help.oclc.org/Librarian_Toolbox/Contact_OCLC_Support" rel="internal">Contact OCLC Support</a></li></ul></div></nav> <script type="text/javascript">/*<![CDATA[*/ $(function() { $('.tool-tip-link').tooltip(); }); $(document).ready(function(){ /* OCLC sitebar menu */ $('#oclc-return').hoverIntent( function() { $('#sitebar-sites').show(); return false; }, function() { $('#sitebar-sites').hide(); return false; } ); });/*]]>*/</script> <script>/*<![CDATA[*/if (window.location.host == 'help.oclc.org' || window.location.host == 'oclc-sandbox.mindtouch.us') {var priorSelection='';}/*]]>*/</script> <script type="text/javascript">/*<![CDATA[*/ /** * Get a cookie by name * @param {string} cName - Cookie name * @returns cookie value */ function getCookie(cName) { var name = cName + "="; var decodedCookie = decodeURIComponent(document.cookie); var ca = decodedCookie.split(';'); for (var i = 0; i < ca.length; i++) { var c = ca[i]; while (c.charAt(0) == ' ') { c = c.substring(1); } if (c.indexOf(name) == 0) { return c.substring(name.length, c.length); } } return ""; } /** * Set a cookie * @param {string} cName - Cookie name * @param {string} cValue - Cookie value * @param {number} expDays - Expiration time in days */ function setCookie(cName, cValue, expDays) { var date = new Date(); date.setTime(date.getTime() + (expDays * 24 * 60 * 60 * 1000)); var expires = "expires=" + date.toUTCString(); document.cookie = cName + "=" + cValue + ";" + expires + ";path=/"; } /** * Get current site language from url */ const smartlingFr = 'fr-b1887160206b09594.getsmartling.com'; const smartlingDe = 'de-b18871602cd1cb2ef.getsmartling.com'; const smartlingEs = 'es-b18871602e48673f2.getsmartling.com'; const smartlingIt = 'it-it-b1887160218846635.getsmartling.com'; const smartlingNl = 'nl-b18871602833bab44.getsmartling.com'; var thisSiteLanguage = ''; // "help.oclc.org" is getting converted to other domains when in another language site // Separating help.oclc.org stops whatever is converting the string if ([('help' + '.oclc.org'), 'oclc-sandbox.mindtouch.us'].includes(window.location.host)) { thisSiteLanguage = 'en'; document.getElementById('selected-region-title').innerText = 'English'; } else if (['help-fr.oclc.org', smartlingFr].includes(window.location.host)) { thisSiteLanguage = 'fr'; document.getElementById('selected-region-title').innerText = 'Fran莽ais'; } else if (['help-de.oclc.org', smartlingDe].includes(window.location.host)) { thisSiteLanguage = 'de'; document.getElementById('selected-region-title').innerText = 'Deutsch'; } else if (['help-es.oclc.org', smartlingEs].includes(window.location.host)) { thisSiteLanguage = 'es'; document.getElementById('selected-region-title').innerText = 'Espa帽ol'; } else if (['help-it.oclc.org', smartlingIt].includes(window.location.host)) { thisSiteLanguage = 'it'; document.getElementById('selected-region-title').innerText = 'Italiano'; } else if (['help-nl.oclc.org', smartlingNl].includes(window.location.host)) { thisSiteLanguage = 'nl'; document.getElementById('selected-region-title').innerText = 'Nederlands'; } /** * Go to selected language and set cookie for that language */ function goToLanguage(language) { const path = window.location.pathname; setCookie("oclc_helpsite", language, 2); if (language == 'en' && thisSiteLanguage != 'en') { setCookie("oclc_helpsite", "en", 2); // "help.oclc.org" is getting converted to other domains when in another language site // Separating help.oclc.org stops whatever is converting the string window.location = 'https://help' + '.oclc.org' + path + '?sl=en'; } else if (language == 'fr' && thisSiteLanguage != 'fr') { setCookie("oclc_helpsite", "fr", 2); window.location = 'https://help-fr.oclc.org' + path + '?sl=fr'; } else if (language == 'de' && thisSiteLanguage != 'de') { setCookie("oclc_helpsite", "de", 2); window.location = 'https://help-de.oclc.org' + path + '?sl=de'; } else if (language == 'es' && thisSiteLanguage != 'es') { setCookie("oclc_helpsite", "es", 2); window.location = 'https://help-es.oclc.org' + path + '?sl=es'; } else if (language == 'it' && thisSiteLanguage != 'it') { setCookie("oclc_helpsite", "it", 2); window.location = 'https://help-it.oclc.org' + path + '?sl=it'; } else if (language == 'nl' && thisSiteLanguage != 'nl') { setCookie("oclc_helpsite", "nl", 2); window.location = 'https://help-nl.oclc.org' + path + '?sl=nl'; } } /** * Set cookie from prior language selection */ if (typeof priorSelection == 'undefined') { priorSelection = '' } if (priorSelection != '') { setCookie('oclc_helpsite', priorSelection, 2); } /** * Change language based on browser's preferred language */ var userPreferredLang = navigator.languages && navigator.languages[0] || navigator.language || navigator.userLanguage; // if (getCookie("oclc_helpsite") != thisSiteLanguage) {} if (getCookie("oclc_helpsite") == '' || getCookie("oclc_helpsite") == undefined) { if (userPreferredLang.toLowerCase().includes('en')) { goToLanguage('en'); } else if (userPreferredLang.toLowerCase().includes('fr')) { goToLanguage('fr'); } else if (userPreferredLang.toLowerCase().includes('de')) { goToLanguage('de'); } else if (userPreferredLang.toLowerCase().includes('es')) { goToLanguage('es'); } else if (userPreferredLang.toLowerCase().includes('it')) { goToLanguage('it'); } else if (userPreferredLang.toLowerCase().includes('nl')) { goToLanguage('nl'); } } $(function () { $('.selected-region-dd').hover(function () { var show = $('.languagepicker'); show.toggle(); }); /** * Change language on click of language selector */ $('.language li').click(function () { var clickedLanguage = $(this).children("span").attr('language'); goToLanguage(clickedLanguage); }); });/*]]>*/</script> </div> <div class="grape-header grape-wrapper"> <div class="grape-header-container grape-wrapper-container"> <div class="grape-site-logo"> <a class="logo-anonymous" href="/" title="OCLC Support"> <img class="mt-cdn" src="https://a.mtstatic.com/@public/production/site_10606/1510500640-logo.png" alt="OCLC Support" title="OCLC Support"> </a> </div> <div class="grape-site-navigation"> <ul class="mt-site-nav"> <li class="mt-login-sign-in"> <a class="mt-icon-quick-sign-in" href="https://help.oclc.org/@app/saml/login?returnto=https%3A%2F%2Fhelp.oclc.org%2FLibrary_Management%2FEZproxy%2FConfigure_resources%2FUsageLimit" title="Sign in"> Sign in </a> </li> <li class="mt-login-forgot-password"> <a class="mt-icon-login-forgot-password" href="https://help.oclc.org/Special:UserPassword" title="Retrieve lost password"> Forgot password </a> </li> </ul> </div> <div class="grape-site-search"> <div class="mt-quick-search-container"> <form action="/Special:Search"> <input name="path" id="mt-search-path" type="hidden" value="" /> <label class="mt-label" for="mt-site-search-input"> Search </label> <input class="mt-text mt-search search-field" name="q" id="mt-site-search-input" placeholder="How can we help you?" type="search" /> <button class="mt-button ui-button-icon mt-icon-site-search-button search-button" type="submit"> Search </button> </form> </div> </div> </div> <div class="grape-site-nav grape-wrapper-container"> <ul class="mt-breadcrumbs"> <li> <a href="https://help.oclc.org/"> <span class="mt-icon-article-category mt-icon-article-home"></span> Home </a> </li> <li> <a href="https://help.oclc.org/Library_Management"> <span class="mt-icon-article-category"></span> Library Management </a> </li> <li> <a href="https://help.oclc.org/Library_Management/EZproxy"> <span class="mt-icon-article-category"></span> EZproxy </a> </li> <li> <a href="https://help.oclc.org/Library_Management/EZproxy/Configure_resources"> <span class="mt-icon-article-guide"></span> Config.txt directives </a> </li> </ul> </div> </div> <div class="grape-content grape-wrapper"> <div class="grape-content-container grape-wrapper-container"> <div id="flash-messages"><div class="dekiFlash"></div></div> <h1 id="title" class="no-edit" style="visibility: visible;"> UsageLimit </h1> <div class="mt-last-updated"> <strong>Last updated:</strong> <span class="modified mt-last-updated-timestamp" data-timestamp="2024-10-18T19:00:34Z"></span> </div> <div class="mt-content-header"> <div id="machine-translation-message" class="highlight-box highlight-box--subtle" style="display:none;">The translation on this website may be generated by machine translation. The quality and accuracy of machine translation can vary significantly from one text to another. Read the page in original English <a onclick="goToLanguage('en')">here</a>.</div> <script type="text/javascript">/*<![CDATA[*/ // Determine if machine translation message should be shown function displayMachineTranslationMessage() { // Show if Italian, excluding certain pages if (thisSiteLanguage == 'it' && !document.querySelector('.columbia-page-home')) { document.querySelector('#machine-translation-message').style.display = null; } } displayMachineTranslationMessage();/*]]>*/</script> </div> <div class="mt-content-side"></div> <div id="mt-toc-container" data-title="Table of contents" data-collapsed="true"> <button class="mt-toggle mt-summary-toggle ui-button-icon mt-toggle-expand">Table of contents</button> <div class="mt-toc-content mt-collapsible-section mt-toc-hide"> <ol><li><a href="#Global_UsageLimit" rel="internal">Global UsageLimit</a></li><li><a href="#Selective_UsageLimit" rel="internal">Selective UsageLimit </a></li><li><a href="#Options" rel="internal">Options</a></li><li><a href="#Examples" rel="internal">Examples</a><ol><li><a href="#Monitoring_use" rel="internal">Monitoring use</a></li><li><a href="#Data_transfer_limit" rel="internal">Data transfer limit</a></li><li><a href="#Multiple_usage_limits" rel="internal">Multiple usage limits</a></li><li><a href="#Advanced_example" rel="internal">Advanced example</a></li></ol></li><li><a href="#Related_directives" rel="internal">Related directives </a></li></ol> </div> </div> <div id="page-top"> <div id="topic"> <div id="pageText"> <div class="mt-page-summary"><div class="mt-page-overview">Learn how to use the UsageLimit config.txt directive to set limits on EZproxy usage.</div></div> <p><strong>UsageLimits</strong> allow you to set limits on EZproxy usage to comply with content provider requests, minimize the potential for the illicit download of large amounts of content, and limit reductions in access speed.</p> <p>Content providers will sometimes place limits on the amount of content that users can download during a given time period due to licensing agreements they have with content owners. These limits can be enforced with the <strong>UsageLimit</strong> directive, which allows you to apply limits to individual resources without altering the amount of content your users can access from other resources.</p> <p>You can also proactively impose usage limits to keep intruders from downloading large quantities of information with compromised credentials. If content providers detect unusually large quantity downloads, they may block your access to their resources, causing interruptions for your legitimate users. To avoid this, you can set appropriate limits on users’ ability to access all resources as a preventative measure. As described in the example tab, it is best to monitor usage before setting these limits so you do not inadvertently prevent legitimate users from having appropriate levels of access to resources.</p> <p>Finally, if you put appropriate limits in place, high volume users who could potentially slow down access speeds for other users will be limited in how much they can download at one period of time, and thus free up bandwidth for other users to access resources.</p> <p><strong>UsageLimit</strong> is a position-dependent config.txt directive that interacts with database definitions. Any database following an open UsageLimit statement will be limited by the parameters set by this directive unless the directive is selectively applied. For more details about how to apply limits <a title="UsageLimit" class="mt-self-link" href="#global" rel="internal">globally</a> and <a title="UsageLimit" class="mt-self-link" href="#selective" rel="internal">selectively</a>, see below.</p> <p><strong>UsageLimit</strong> is used to detect when a user is downloading an excessive amount of content and automatically suspend the user's access. When a user's access is suspended and that user tries to access content through EZproxy, EZproxy sends the file suspend.htm, from the docs directory in the EZproxy installation directory, to the remote user. If you are going to enforce limits, you should create a suspend.htm file and provide information to tell users what to do if they have encountered this limit, particularly during early configuration when your limits may be too strict to meet the actual needs of your users.</p> <p>A <strong>UsageLimit</strong> is evaluated based on the username used to log into EZproxy and applied across all user sessions.</p> <p>The basic form for <strong>UsageLimit</strong> consists of the directive followed by parameters specifying the types of limits you are implementing, whether those limits will be enforced, and ending with a name you assign to that limit. A limit with all parameters would look as follows:</p> <pre> UsageLimit -enforce -expires=120 -interval=60 -local -MB=100 -transfers=100 All </pre> <p>Where you enter the specific numerical values for the limit options you would like to implement, and provide a unique name in place of "All" for the limit. The options each have a hyphen (-) in front of their names. You can include or omit any option. The only required component of a <strong>UsageLimit</strong> is that you provide a name at the end of the statement.</p> <p><span class="mt-icon-info2"> </span>Note: If you use CGI authentication, your CGI authentication must be configured to provide username information to EZproxy for UsageLimits to work properly.</p> <div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_1"><span id="Global_UsageLimit"></span><h5 class="editable"><a id="global" name="global"></a>Global UsageLimit</h5> <p>You can apply a global limit that will impact all databases by placing the directive statement at the beginning of your database configurations. The limits specified by this statement will apply to all databases that follow. The directive statement could look as follows:</p> <pre> UsageLimit -enforce -MB=100 Global </pre> <p>You can add as many limiting options as you want and enter any numerical value to define that limit. The name Global can be replaced with any name to identify this limit. For more details about how to construct a Global limit, see the Examples.</p> </div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_2"><span id="Selective_UsageLimit"></span><h5 class="editable"><a id="selective" name="selective"></a>Selective UsageLimit<strong> </strong></h5> <p>You can also apply limits so that they apply only to certain databases.</p> <pre> UsageLimit -enforce -expires=120 -interval=60 -transfers=100 Selective Title Some Database URL http://www.somedb.com D somedb.com UsageLimit -end Selective </pre> <p>Where you enter specific numerical values for the limit options. You can provide any name to designate the resources that will be controlled by this limit. For more details about how to construct a Selective limit, see the Example tab.</p> </div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_3"><span id="Options"></span><h2 class="editable">Options</h2> <table class="mt-responsive-table"> <thead> <tr> <th scope="col">Option</th> <th scope="col">Description</th> </tr> <tr> <td data-th="Option"><code>-end</code></td> <td data-th="Description">Specifies that this <strong>UsageLimit</strong> should not impact any of the databases that follow in <span class="cq-rte-sprinkles" name="Sprinkles:ezproxy/configtxt">config.txt</span>. Use this only if you want the limit to apply to certain databases as this works as a bracket to enclose the databases controlled by the given limit.</td> </tr> <tr> <td data-th="Option"><code>-enforce</code></td> <td data-th="Description">Specifies that any user account that exceeds set limit thresholds should be suspended. If this option is not specified, usage is monitored, but users who exceed the thresholds are not denied access. As a safety precaution, access for EZproxy administrators is never suspended.</td> </tr> <tr> <td data-th="Option"><code>-expires</code></td> <td data-th="Description">Specifies that any suspension to a user's account should automatically clear after the given number of minutes specified have elapsed. If -expires is not specified, a suspended account remains suspended until the EZproxy administrator clears the suspension. See <a title="EZproxy administration" href="https://help.oclc.org/Library_Management/EZproxy/EZproxy_Administration/010EZproxy_Administration_overview" rel="internal">EZproxy Administration</a> for information on how to access the EZproxy administration page.</td> </tr> <tr> <td data-th="Option"><code>-interval</code></td> <td data-th="Description">Specifies the interval over which to consider the -MB or -transfers limits. If no -interval is specified, the default is 1440 minutes, which is one day.</td> </tr> <tr> <td data-th="Option"><code>-local</code></td> <td data-th="Description">Specifies access limits to local EZproxy pages, including the menu page or pages served from the /public, /limited, or /loggedin directories.</td> </tr> <tr> <td data-th="Option"><code>-MB</code></td> <td data-th="Description">Specifies limits to the number of megabytes of data transferred.</td> </tr> <tr> <td data-th="Option"><code>-transfers</code></td> <td data-th="Description">Specifies limits to the number of HTTP requests.</td> </tr> </thead> </table> </div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_4"><span id="Examples"></span><h2 class="editable">Examples</h2> <p>The UsageLimit directive can be customized in a number of ways as necessary to monitor or enforce limits on your users' use of EZproxy.</p> <div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_5"><span id="Monitoring_use"></span><h5 class="editable">Monitoring use</h5> <p>To start out, you can simply monitor EZproxy by adding:</p> <pre> UsageLimit Global</pre> <p>The choice of global for the usage limit name is arbitrary, and you can assign any name that will help you identify why you created this particular limit or which databases to control. As configured, this limit will monitor usage information over the past 1440 minutes (day). Accounts will not be suspended. Requests for information that come directly from EZproxy will not be included. All information gathered from this directive statement will be recorded in the messages.txt log.</p> </div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_6"><span id="Data_transfer_limit"></span><h5 class="editable">Data transfer limit</h5> <p>If you decide to apply limits, for example a user should not transfer more than 100MB per day, you can start by using:</p> <pre> UsageLimit -MB=100 Global</pre> <p>This will only monitor use, not suspend access. If user exceeds this limit, a message like this will be recorded in messages.txt:</p> <pre> 2005-08-01 09:00:00 Global 0.001MB usage limit exceeded by rdoe </pre> <p>Once you are ready to enforce a limit, you need to add the -enforce option, such as:</p> <pre> UsageLimit -enforce -MB=100 Global </pre> <p>With this statement in place, if a user exceeds the 100MB limit, that user will be unable to access EZproxy until you clear his/her suspension through the EZproxy administration page. If you want the suspension to expire automatically after 360 minutes (six hours), you could use:</p> <pre> UsageLimit -enforce -expires=360 -MB=100 Global </pre> <p>When you specify an expiration period, you can still manually clear the suspension at any time using the administration page.</p> </div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_7"><span id="Multiple_usage_limits"></span><h5 class="editable">Multiple usage limits</h5> <p>In a more complicated example, we will impose two separate limits, one arbitrarily named Global and the other arbitrarily named Selective. Global will impose a 100MB limit on all databases. Selective will impose a limit allowing only a total of 500 transfers total from Some Database and Another Database. Some Database and Another Database are not adjacent. The Global limit will require manual resetting, but the Selective limit will automatically reset after 180 minutes (three hours). For this, you could use:</p> <pre> UsageLimit -enforce -MB=100 Global </pre> <pre> UsageLimit -enforce -expires=180 -transfers=500 Selective Title <span class="mt-color-c0392b"><em>Some Database</em></span> URL http://www.<span class="mt-color-c0392b"><em>somedb</em></span>.com/ D <span class="mt-color-c0392b"><em>somedb</em></span>.com UsageLimit -end Selective </pre> <pre> Title <span class="mt-color-c0392b">Other Database</span> URL http://www.<span class="mt-color-c0392b"><em>otherdb</em></span>.com/ D <span class="mt-color-c0392b"><em>otherdb</em></span>.com </pre> <pre> UsageLimit Selective Title <span class="mt-color-c0392b"><em>Another Database</em></span> URL http://www.<span class="mt-color-c0392b"><em>anotherdb</em></span>.com/ D <span class="mt-color-c0392b"><em>anotherdb</em></span>.com UsageLimit -end Selective </pre> <p>In this configuration, users who transfer more than 100MB of data from any combination of databases, or users who transfer more than 500 pages from a combination of Some Database and Another Database, will have their access suspended. The Selective limit will only apply to Some Database and Another Database, but not to Other Database, nor will it apply to additional databases that appear further down in config.txt.</p> <p>If you want to apply a limit selectively to more than one database, you only need to enter the specific options for the usage limit the first time you enter it in config.txt. For all subsequent databases that you would like to limit with those parameters, you only need to add UsageLimit with the name of the limit to set a starting point for the limit and UsageLimit -end with the name of the limit to close the limit.</p> </div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_8"><span id="Advanced_example"></span><h5 class="editable">Advanced example</h5> <p>An example of how to combine all of the security features of EZproxy can be found in <a title="Secure your EZproxy server" href="https://help.oclc.org/Library_Management/EZproxy/Secure_your_EZproxy_server" rel="internal">Secure your EZproxy server</a>.</p> </div></div><div mt-section-origin="Library_Management/EZproxy/Configure_resources/UsageLimit" class="mt-section" id="section_9"><span id="Related_directives"></span><h2 class="editable">Related directives </h2> <p><a title="Audit" href="https://help.oclc.org/Library_Management/EZproxy/Configure_resources/Audit" rel="internal">Audit</a></p> </div></div> </div> </div> <div class="mt-content-footer"> <p> </p> </div> <ol class="grape-meta-data grape-meta-article-navigation"> <li class="grape-back-to-top"><a class="mt-icon-back-to-top" href="#title" id="mt-back-to-top" title="Jump back to top of this article">Back to top</a></li> <li class="grape-article-pagination"><ul class="mt-article-pagination"> <li class="mt-pagination-previous"> <a class="mt-icon-previous-article" href="https://help.oclc.org/Library_Management/EZproxy/Configure_resources/URLRedirectAppendEncoded_(replaced_by_URL_-Redirect_-Append_-Encoded)" title="URLRedirectAppendEncoded (replaced by URL -Redirect -Append -Encoded)"><span>URLRedirectAppendEncoded (replaced by URL -Redirect -Append -Encoded)</span></a> </li> <li class="mt-pagination-next"> <a class="mt-icon-next-article" href="https://help.oclc.org/Library_Management/EZproxy/Configure_resources/Validate" title="Validate"><span>Validate</span></a> </li> </ul> </li> </ol> </div> </div> <div class="grape-footer grape-wrapper"> <div class="grape-wrapper-container"> <ol> <li class="grape-footer-copyright">© Copyright 2024 OCLC Support</li> <li class="grape-footer-powered-by"><a href="https://mindtouch.com/demo" class="mt-poweredby product " title="MindTouch" target="_blank"> Powered by CXone Expert <span class="mt-registered">®</span> </a></li> </ol> </div> </div> <div class="grape-footer-custom"><div class="footer iparsys parsys"><div class="footer section"><footer class="page-footer"><div class="divider blue-green"><div class="bar-1"></div><div class="bar-2"></div></div><div class="footer-banner"><div class="elm-nav-container"><div><h3>Stay in the know</h3><p>Get the latest product updates, research, events, and much more—right to your inbox.</p></div><a href="https://www.oclc.org/en/email.html?utm_campaign=email-subscription-web-organic&utm_medium=digital&utm_source=webpage-email-sub&utm_content=email-subscription-footer-button&utm_term=en" target="_blank" rel="external noopener nofollow" class="ui-button-primary link-https">Subscribe now</a></div></div><div class="elm-nav-container"><div class="parsyscolumncontrol section"><div class="parsys_column cq-colctrl-lt6"><div class="parsys_column cq-colctrl-lt6-c0"><div class="col0 parsys"><div class="text parbase section"><p><a title="OCLC.org Home" href="https://www.oclc.org/" target="_blank" rel="external noopener nofollow" class="link-https"><img src="https://www.oclc.org/content/dam/oclc/design-images/home-page/footer-logo.png" alt="OCLC logo" class="img-nobrdr" /></a></p></div></div></div><div class="parsys_column cq-colctrl-lt6-c1"><div class="col1 parsys"><div class="text parbase section"><div style="padding: 25px 0 0 0;"><div class="other-accounts" style="float: left;"><a title="Like us on Facebook" href="http://www.facebook.com/pages/OCLC/20530435726" target="_blank" rel="external noopener nofollow" class="external"><img class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-facebook.png" alt="Facebook" style="margin: 0 5px 0 0;" /></a><a title="Watch videos on YouTube" href="http://www.youtube.com/OCLCvideo" target="_blank" rel="external noopener nofollow" class="external"><img class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-youtube.png" alt="YouTube" style="margin: 0 5px 0 0;" /></a><a title="Connect with us on LinkedIn" href="https://www.linkedin.com/company/oclc" target="_blank" rel="external noopener nofollow" class="link-https"><img class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-linkedin.png" alt="LinkedIn" style="margin: 0 2px 0 0;" /></a><a title="Connect with us on Instagram" href="https://www.instagram.com/oclc_global/" target="_blank" rel="external noopener nofollow" class="link-https"><img class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-instagram.png" alt="Instagram" style="margin: 0 5px 0 0;" /></a><a title="Read our blog" href="https://blog.oclc.org/next/" target="_blank" rel="external noopener nofollow" class="link-https"><img class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-blog.png" alt="Next blog" style="margin: 0 5px 0 0;" /></a><a style="display: none" title="Subscribe to email updates" href="https://www.oclc.org/en/email.html" target="_blank" rel="external noopener nofollow" class="link-https"><img class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-mail.png" alt="Email" style="margin: 0 5px 0 0;" /></a><a href="https://www.oclc.org/en/rss.html" target="_blank" rel="external noopener nofollow" class="link-https"><img title="Choose your news with RSS feeds" class="img-nobrdr" src="https://www.oclc.org/content/dam/common/images/social-icons/footer/footer-rss.png" alt="RSS feeds" height="34" width="29" /></a></div></div><div style="clear: both;"> </div></div><div class="text parbase section"><div class="copyright"><p class="sl_swap" id="Copyright-Link"><a title="Read the OCLC copyright policy" href="https://www.oclc.org/en/policies/copyright.html" target="_blank" rel="external noopener nofollow" class="link-https">© 2024 OCLC</a></p><p class="sl_swap" id="Trademarks-Link"><a title="View the OCLC and Affiliate Trademarks and Service Marks PDF" href="https://www.oclc.org/en/policies/trademarks.html" target="_blank" rel="external noopener nofollow" class="link-https">Domestic and international trademarks and/or service marks of OCLC, Inc. and its affiliates</a></p><ul><li class="sl_swap" id="Cookies-Link"><a href="https://policies.oclc.org/en/privacy/cookie-statement.html" target="_blank" rel="external noopener nofollow" class="link-https">Cookie notice</a></li><li class="sl_swap" id="Cookies-List-Settings"><a href="https://policies.oclc.org/en/privacy/cookie-statement/oclc-org-cookie-list.html" target="_blank" rel="external noopener nofollow" class="link-https">Cookie list and settings</a></li><li class="sl_swap" id="Privacy-Link"><a href="https://www.oclc.org/en/policies/privacy.html" target="_blank" rel="external noopener nofollow" class="link-https">Privacy policy</a></li><li class="sl_swap" id="Accessibility-Link"><a href="https://www.oclc.org/en/policies/accessibility.html" target="_blank" rel="external noopener nofollow" class="link-https">Accessibility statement</a></li><li class="sl_swap" id="ISO-Link"><a href="https://www.oclc.org/en/trust/compliance.html#trust-certifications" target="_blank" rel="external noopener nofollow" class="link-https">ISO 27001 Certificate</a></li><li class="sl_hide"><a rel="custom nofollow" href="https://help.oclc.org/@app/saml/login?returnto=https%3A%2F%2Fhelp.oclc.org%2FLibrary_Management%2FEZproxy%2FConfigure_resources%2FUsageLimit">Sign in</a></li></ul></div></div></div></div></div></div></div></footer></div></div> </div> <script>/*<![CDATA[*/ $(document).ready(function() { // Expandable list var pageEdit = $("body").hasClass("page-mode-editor"); $('.expand-list').find('dd').hide(); $('.expand-list').find('dt').on('click', function() { $(this).toggleClass('expanded'); $(this).next().fadeToggle('fast'); }); }); // AEM redirect function // Total seconds to wait var seconds = 10; var editMode = $("body").hasClass("elm-user-pro-edit"); var countDown = $("#countdown").length; var redirectUrl = $(".redirect-aem-url").attr("href"); function countdown() { seconds = seconds - 1; if (seconds < 0) { // Change your redirection link here window.location = redirectUrl; } else { // Update remaining seconds document.getElementById("countdown").innerHTML = seconds; // Count down using javascript window.setTimeout("countdown()", 1000); } } if (editMode) { // Do nothing } else { if (countDown) { // Run countdown function countdown(); } }; /*]]>*/</script> <script src="https://help.oclc.org/@api/deki/files/2123/mylist-player.js?origin=mt-web"></script> </body> </html>