Confluence Retirement

In an effort to consolidate USGS hosted Wikis, myUSGS’ Confluence service is scheduled for retirement on January 27th, 2023. The official USGS Wiki and collaboration space is now SharePoint. Please migrate existing spaces and content to the SharePoint platform and remove it from Confluence at your earliest convenience. If you need any additional information or have any concerns about this change, please contact Thank you for your prompt attention to this matter.
Skip to end of metadata
Go to start of metadata

Authenticating to ScienceBase and retaining your authentication for future requests using JOSSO.

To authenticate you must obtain a JOSSO session ID.  There are two ways to get this ID.  The first way is from the JOSSO signon page.  Username and password are sent in as request parameters.

JOSSO Signon Page Request
Request Parameters:

From this session, the value of the cookie with the name "JOSSO_SESSIONID" is your JOSSO session ID.

The second way to get the JOSSO session ID is from the JOSSO helper in ScienceBase Catalog.  Username and password are sent in an HTTP basic authentication header.

ScienceBase Catalog JOSSO Helper Request
    Basic Authentication header with username and password set
    [name: Accept, value: application/json]
    [name: Content Type, value: application/json]
Request Parameters:
    includeJossoSessionId: true

If successful, this will return JSON similar to the following:

ScienceBase Catalog JOSSO Helper Response
    "fullDisplayName":"John L Long []",
    "displayName":"John L Long",

The value of the jossoSessionId variable is the JOSSO session ID.

Once you have a JOSSO session ID, you can make requests on any page on ScienceBase that the authenticated user has access to by adding the parameter "josso=[JOSSO_SESSIONID]". Eg:[JOSSO_SESSIONID]



  • No labels