CalcTree for System Administrators

This page provides technical guidance for system administrators to ensure CalcTree functions reliably in enterprise environments with firewalls, proxies, or other network security controls.

Platform Overview

CalcTree is a cloud-based platform for managing, sharing, and automating engineering calculations using spreadsheets and Python. It uses modern web technologies, including:

• GraphQL over HTTPS

• Server-Sent Events (SSE) for real-time updates

• JSON-based payloads for data exchange and authentication

---

Authentication and Network Communication

Authentication requests in CalcTree are handled entirely via GraphQL. These requests commonly include the following fields:

• email

• password

• token

Example Authentication Request

Password reset

{
  "operationName": "VerifyForgotPasswordEmail",
  "variables": {
    "input": {
      "email": "[e-mail]",
      "code": 7114
    }
  },
  "query": "mutation VerifyForgotPasswordEmail($input: legacy_VerifyEmailDto_Input!) {\n  legacy_AuthController_verifyOtp(input: $input) {\n    token\n    __typename\n  }\n}"
}

Note that unlike traditional REST APIs, GraphQL requests use structured JSON bodies that may include fields typically associated with authentication.

---

Real-Time Communication

CalcTree does not use WebSockets. Instead, it relies on HTTP-based Server-Sent Events (SSE) for real-time updates.

Key points:

• All communication is over HTTPS (port 443)

• SSE is used to deliver real-time data streams (no WebSocket traffic)

---

Firewall and Proxy Considerations

If your organization enforces outbound traffic filtering or deep packet inspection, the following requirements must be met to ensure full functionality:

• Allow outbound HTTPS connections to:

  • https://app.calctree.com

  • https://api.calctree.com

• Permit GraphQL POST requests with JSON bodies

• Allow JSON fields such as email, token, password

• Enable HTTP SSE streams over port 443

Some firewalls or security appliances may incorrectly flag these payloads due to keyword matching or content inspection. Please ensure that valid GraphQL requests are not being blocked or modified.

---

Troubleshooting Tips

If users report issues with logging in, password resets, or collaborative tools, we recommend checking the following:

• Ensure GraphQL POST bodies are not being filtered or blocked

• Confirm that SSE connections are allowed and uninterrupted

• Check for firewalls or proxies performing deep packet inspection that may reject requests containing specific keywords

• Verify that proxy servers are not stripping authorization headers or tokens

---

Support

If further assistance is needed, your IT team or system administrator can contact the CalcTree team at:

[e-mail]

We are available to coordinate directly with your IT department to assist with configuration and ensure uninterrupted access to the platform.