Skip to main content

Authentication

Access token​

Communication between clients and ITX servers is facilitated through an access token, comprising three essential components: tokenv2, rcntrl, and ccntrl. To access your access token in ITX, simply go to your user profile and click on the "Advanced" tab.

NameTypeDescription
tokenv2stringRandomly generated token
rcntrlintegerUser ID of the connected user
ccntrlintegerCorporation group

Usage​

ITX offers two ways of authentication with your token; Query parameters or HTTP Headers.

Query parameters​

To authenticate your session using query parameters, simply apply all three parts to the URL as shown below:

https://<endpoint>/rest/api/state?tokenv2=XXX&rcntrl=YYY&ccntrl=ZZZ

HTTP Headers​

To authenticate your session using HTTP Headers, simply apply theese key-value pairs:

Header nameHeader value
tokenv2XXX
rcntrlYYY
ccntrlZZZ