Encoded Query String - Authentication Mode


Table of contents


The Octopus Web Portail is a very important element that allows users to open their requests on their own. To make it more user friendly, it is possible for users to launch the Octoups Web Portal without having to enter their username and password. 


  • The users will access Octopus with a link from a site that you control (typically your intranet)
    • Octopus's single sign on will not work if the user goes directly to the Web Portal: http://www.octopus-itsm.com/sites/mycompany/web, because the single sign on requires to access the application with a specific URL
  • The site used for the link must already know the identity of the curent user. Either you already have an SSO (single sign on) for this site or the user has authentified himself to the site. In short, you will need to "pass" the curent user of the site to Octopus

How it works?

  • In your site, you generate (with programming) a hyperlink that points to the aspx login page along with some encoded parameters. A typical URL would look like:
    • http://www.octopus-itsm.com/sites/mycompany/web/login.aspx?username=8dj37hdhj456gf9459fj
  • On your Web site, when the user clicks on the link containing the information to identify him, he is automatically redirected to the Web Portal's main page.

How to activate and configure?

  • You must contact your Octopus specialist or the Octopus Service Center to activate the single sing on authentication.
  • The encoded URL is built from 3 parts:
    • Windows Username
    • Secret encoding key (provided by Octopus)
    • Timeout value
  • The algorithm to compose the URL is simple and can be implemented in most programming languages.When you will ask for a single sign on mode, we will give you:​
    • An example of code in C#
    • Your secret encoding key
Help us improve our articles

Help us improve our articles