Environments

SSO-cluster

ITX operates through its proprietary SSO (Single Sign-On) solution, a centralized system designed to manage user authentication seamlessly. The SSO-cluster acts as the definitive point for authenticating users across multiple services.

A Single Sign-On (SSO) cluster is essentially a centralized authentication hub that allows users to access multiple applications or services using a single set of login credentials. This setup streamlines user authentication, enhancing security and convenience.

We maintain identical configurations for both production and test environments. These setups are invaluable for testing integrations comprehensively, enabling you to test the entire integration process from start to finish.

Environment	Endpoint
Production	https://app.itxuc.com
Development	https://dev.itxuc.com

Test environment

Utilizing a test environment offers several advantages when integrating systems. At ITX, we highly recommend employing a test environment, especially for all "write-integrations". These environments allow you to experiment, test, and validate the integrations without affecting the live or production systems.

The key benefits of using a test environment include:

1. Risk Mitigation: Testing in an isolated environment mitigates the risk of unintended consequences on live data or services.
2. Error Identification: It provides a controlled space to identify and rectify errors or bugs without impacting real users or critical operations.
3. Integration Validation: Allows comprehensive validation of integration processes from start to finish, ensuring seamless functionality before deployment.
4. Enhanced Development: Facilitates iterative development and experimentation to fine-tune integrations for optimal performance.

ITX will assist you in configuring a suitable test enviroement for your integration needs. Please contact us at support@itxuc.com if you don't already have a test environment

Production environment

ITX is deployed using a cluster of servers and has a separate SSO (single sign-on) solution for authentication. The SSO-cluster serves as the single source of truth for user authentication. All production users must access ITX services through https://app.itxuc.com. When creating API integrations, make sure to retrieve the active app endpoint by following the instructions below.

Retrieve active app endpoint

note

Remember to add your access token

GET https://<sso-endpoint>/rest/api/state

Example request:

curl \
--url "https://dev.itxuc.com/rest/api/state?tokenv2=...&rcntrl=...&ccntrl=..."

Example response:

{
	"endpoint": "https://app06.itxuc.com"
}

This endpoint will be your entry point to the REST API moving forward. All other REST requests should be sent directly to this endpoint, not the SSO-clusters endpoint.

You can cache the result and use it indefinitely, as long as you continue to receive responses from our server. However, in the event of no response (timeout), you must check if the endpoint has changed by making a new request to the endpoint mentioned above. This approach ensures minimal downtime in unforeseen fail-over situations and prevents additional delays caused by DNS propagation.

At this point you should be able to use the information gathered so far to retrieve the active user from the active endpoint:

GET https://<endpoint>/rest/core/activeuser

If successful, feel free to check out the OpenAPI specification, or see any of our integration guides.