Proxy Authentication

Follow

PLEASE NOTE: This information was updated in August 2023 following the Credo platform refresh. For more about the update see here, or contact support@credoreference.com 

https://credoreference.zendesk.com/hc/en-us/articles/5373033985819-2023-Credo-and-Source-Reference-Platform-Updates

 

Proxy authentication is supported by Credo Reference. We describe the set-up and configuration for OCLC's EZ Proxy and the WAM proxy from Innovative Interfaces below. Other proxy servers, such as Muse Proxy, can be used for authentication - contact support@credoreference.com for further information. 

EZ Proxy How-to

WAM Proxy How-to

EZ Proxy how-to

There are just a few steps to setting up EZ Proxy access:

1. Provide us with the proxy prefix and proxy IP. If you're using EZ Proxy v6 or above, please include the IPv6 format IP if available. If you don't have this information, the vendor should be able to provide it. 

2. Update your proxy configuration file as described below. More documentation on this process can be found on OCLC's site. Make sure this replaces any existing Credo stanza that you already have in your configuration file.

3. Add an SSL Certificate to support our secure site.  (If you've transitioned to https with other databases, such as ProQuest or Kanopy, you already have an SSL certificate.) Documentation can be found on OCLC's site here. There's also a free SSL certificate option available here. Credo now enforces the secure version of our site, so you must have the certificate in place to successfully proxy our links.

4. Configure your SSL certificate for Credo Reference. The pattern is https://search.credoreference.com.proxy.yourschool.edu. Many institutions configure their proxy to redirect their resources to a dashed version of the URL post-login, such as https://search-credoreference-com.proxy.yourschool.edu, so that you can simply add the wildcard *.proxy.yourschool.edu to cover all of your resources. OCLC support (support@oclc.org) is your best resource for the directions on setting this up. 

5. Test the proxied Credo link from home or off-network to ensure it's working, and add it to your database page. The base link is https://search.credoreference.com

Once the configuration is complete and tested, let us know and we'll add the proxy prefix to your Credo account so that it combines with your citations, MARC records, and third-party resource links. 

If you encounter access issues, visit our proxy/https troubleshooting FAQ, or email support@credoreference.com to let us know what error messages or other problems you're seeing.

Configuring your EZ Proxy server

This is the EZ Proxy (http://www.oclc.org/us/en/ezproxy/) configuration to use for Credo Reference:

#Everything below this line is the stanza for Credo Reference.

Option Cookie

Title Credo Reference
URL https://search.credoreference.com
DJ credoreference.com
HJ api.credoreference.com
HJ search.credoreference.com
HJ vle.credoreference.com
HJ credoreference.com
HJ www.credoreference.com
HJ https://api.credoreference.com
HJ https://search.credoreference.com
HJ https://vle.credoreference.com
HJ https://www.credoreference.com

NeverProxy assets.credoreference.com
NeverProxy cdn.credoreference.com
NeverProxy media.credoreference.com

NeverProxy iden5.infobase.com

#Everything above this line is the stanza for Credo Reference.

If you have been a Credo customer since before 2015, you may also have legacy subdomains in your catalog or research guides, so you may need to add the additional lines below:
HJ beagle.credoreference.com

HJ literati.credoreference.com
HJ login.credoreference.com

HJ public.credoreference.com
HJ public.literati.credoreference.com
HJ school.credoreference.com
HJ search.help.credoreference.com
HJ support.credoreference.com

 ____ This is the end of the EZ Proxy set-up info ____

 

 

WAM (III) Proxy how-to

Here are the steps for setting up WAM Proxy access. If you need Credo's port number, it is 443. 

1. Provide us with the proxy server name and proxy IP. If you don't have this information, the vendor should be able to provide it.

2. Update your WAM forward table (screenshot here) as described below

3. Implement and configure an SSL Certificate to support our secure site. Credo now enforces the secure version of our site, so you must have the certificate in place to successfully proxy our links. There are two options; if you've transitioned to https with other databases, such as ProQuest or Kanopy, you likely already have one of these options in place.

A) A  SAN (Subject Alternative Name) certificate (also known as a 'UC' (Unified Communications) or multi-domain certificate), which allows multiple domain names to use the same certificate. If you use this option, the Credo pattern is is 0-search.credoreference.com.proxy.yourschool.edu.

B) A wildcard certificate, which allows you to use a wildcard like *.proxy.yourschool.edu to cover all of your resources. To use this, you must configure the wam_sslhost_replace option, which converts the periods in the resource domain portion of proxied https URLs to hyphens. This allows the wildcard certificate to cover all proxied domains, and obviates the need for individual SAN entries for each proxied domain that uses https.

4. Test the proxied Credo link from home or off-network to ensure it's working, and add it to your database page. The base link is https://search.credoreference.com, or if you have set up a wildcard certificate, you may need to use http://search.credoreference.com.

Once these updates are complete, let us know and we'll add the WAM proxy  to your Credo account so that it combines with your citations, MARC records, and third-party resource links. 

WAM table updates for Credo

You should add the following value to your WAM forward table:

search.credoreference.com

If you have been a Credo customer since before 2015, you may also have legacy subdomains in your catalog or research guides, so you may need to add the additional lines below:
www.credoreference.com

literati.credoreference.com

Do not add http or https to the domains. Don't use a wildcard, as this will cause formatting issues in your account. If you are an Infobase customer, you may need to remove the wildcard *.infobase.com from your Infobase forward table and replace it with specific subdomains in order to facilitate access to Credo.

For further help or troubleshooting, email support@credoreference.com, or Innovative Interfaces Customer Support at:
Phone: 510-655-6200 
Email: helpdesk@iii.com
Support Site: http://csdirect.iii.com/

0 out of 0 found this helpful