FAQ Category: Muse Proxy
How do I add a new vendor resource into my proxy application?
There are several methods for adding new resources into the Muse Proxy Application for handling the rewriting of vendor platforms, the recommended method is by using the Muse Proxy Administrator Console. The rewriting definitions for a vendor platform are stored in XML files, which we call Muse Proxy Sources. Mainly the steps for adding a…
How can I configure a SSL certificate for Muse Proxy?
We strongly recommend to access the Muse Proxy service securely over HTTPS. This is required because almost all content vendor platforms accessed through Muse Proxy rewriting are using the secure protocol, and the same level of security must be matched by Muse Proxy as well. Furthermore, the rewriting of some platforms may not work without…
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.