Skip to main content

ONCat Proxy

We've developed a proxy for ONCat which allow tools to have easy authentication and access to the ONCat system. The proxy leverages the OIDC tokens that are available in Galaxy to perform authentication and forwards requests to ONCat.

Getting your OIDC tokens​

An example of how to retrieve your OIDC tokens can be found in the biosans_reduce tool. Also reference the exposing oidc tokensdocumentation for more details on how to configure your tool to retrieve OIDC tokens.

Using pyoncat in your tool​

To use the ONCat proxy, you will use the pyoncat library as normal with two exceptions. First, you must configure the tool to point at the proxy url. Next, you must set the api_key to your oidc id token. When configuring the pyoncat client, your tool's code will likely look something like this:

    proxy_oncat_client = ONCat(
        url=PROXY_URL, # https://calvera.ornl.gov/oncat
        api_token=USER_OIDC_TOKEN, # User's OIDC token passed as api_token
    )