FAQ Category: Muse Proxy

What are the correct ways to use a proxy URL?

The correct ways to use a proxy URL are listed below: 1) By source ID: http(s)://YOUR_PROXY_DOMAIN:PORT/APPLICATION_ID?groupID=PLACE_HERE_THE_GROUP_ID&action=source&sourceID=PLACE_HERE_THE_SOURCE_ID 2) By proxy prefix: http(s)://YOUR_PROXY_DOMAIN:PORT/APPLICATION_ID?qurl=PLACE_HERE_THE_ENCODED_URL_TO_PROXIFY or http(s)://YOUR_PROXY_DOMAIN:PORT/APPLICATION_ID?url=PLACE_HERE_THE_URL_TO_PROXIFY Using a followup rewritten URL which contain session information: ex: https://0d102vm5x-y-https-search-proquest-com.your_proxy_domain/databases is not recommended.

What URL format do you use to create a pearsistent URL to a specific article in a database, when using Muse Proxy?

You can use the following format: http(s)://YOUR_PROXY_DOMAIN:PORT/APPLICATION_ID?url=PLACE_HERE_THE_URL_TO_PROXIFY or http(s)://YOUR_PROXY_DOMAIN:PORT/APPLICATION_ID?qurl=PLACE_HERE_THE_ENCODED_URL_TO_PROXIFY where replace YOUR_PROXY_DOMAIN with the actual fully qualified domain name (FQDN) of your Muse Proxy system, PORT with the value of the port on which Muse Proxy runs, and APPLICATION_ID with the correct Muse Proxy application ID. Example: https://proxy.yourdomain.org/MuseProxyFoundation?url=https://www.jstor.org/stable/i20716440 or https://proxy.yourdomain.org/MuseProxyFoundation?qurl=https%3A%2F%2Fwww.jstor.org%2Fstable%2Fi20716440 Important observation: In order for…

Where are the Navigation Sessions used?

The Navigation Sessions are used only by the ‘Navigation Manager’ Web Context (the Muse Navigation Manager component) to store useful data regarding a specific link navigation using a certain target site authentication context (cookies, referrer, next proxy access details, encoding etc.) through Muse Navigation Manager. This type of session is managed using an ID (named…

Where are the Client Sessions used?

The Client Sessions are used by the Muse Proxy Web Contexts which perform authentication in order to store the client authentication status to that Web Context, as well as other user metadata. When a request comes to Muse Proxy (as a web server) without a Client Session cookie, a Client Session ID will be generated…

What is the Muse Proxy Authentication Token Filter role?

Muse Proxy Authentication Token authenticates a rewritten request with an authentication token generated by Muse Proxy. The authentication tokens are generated in the following cases: A) when a rewritten link is generated using the ‘Utilities >> Rewrite URL’ section from the Muse Proxy Administrator Console and the ‘Muse Proxy Authentication Token’ option is selected. The…

The Muse Proxy Windows Service is failing to start

We encountered cases on some Windows distributions when the Muse Proxy Windows Service fails to start, usually an error like below can be found in the Windows Event Viewer: “The LoadLibrary function failed for the following reason: The specified module could not be found.” The fix consists in adding into the Path system environment variable…

Why does the muse setup kit I downloaded from support.museglobal.com have a strange name and extension (efw)?

Certain kinds of Antivirus software automatically change the extension when downloading a file with exe extension via HTTP (eg. muse-win32.exe is renamed to muse-win32.1.2D0D17.efw). You should just rename the file to muse-win32.exe and run the executable. More details about the .efw extension are available here: http://www.fileinfo.net/extension/efw

I have 2 IPs on my interface card. How do I configure the Muse Proxy to listen only on one IP?

One can specify an IP address for Muse Proxy to listen on for connections. By default, Muse Proxy listens on all IP addresses, on all interfaces. This setting can be changed in the ${MUSE_HOME}/proxy/MuseProxy.xml file by specifying an IP address in the “<BINDADDRESS>” field.

What Muse Proxy setup kit should I use to install Muse Proxy on a 64 bit Windows architecture?

For Muse Proxy service to correctly work on Windows 64-bit systems you must install Muse Proxy either using the muse-proxy-setup.jar file or the executable file (muse-proxy-win32.exe). In the latter case you must set JAVA_HOME environment variable to the location of the 64-bit Java. If no JAVA_HOME is defined and there are both 32-bit JAVA and…

Is Muse Proxy supporting Transport Layer Protocol (TLS) 1.2?

The short answer is Yes, Muse Proxy support TLS 1.2. Muse Proxy runs on Java, hence it uses the Java Virtual Machine security settings, it does not rely on anything from the Operating System in this regard. Also it is not compiled with any specific SSL libraries versions like other software is. Starting with Java…