Overview
What is the On-Premise Agent?
The OneEnterprise On-Premise Agent is a lightweight Windows service that runs on a machine inside your private network — such as a laptop, desktop, or internal server. It creates a secure, outbound-only tunnel between your on-premises environment and the OneEnterprise cloud platform, enabling integration flows to reach internal systems without opening inbound firewall ports or exposing those systems to the internet.
Think of the agent as a trusted bridge. Your internal systems — databases, ERP platforms, file shares, and internal APIs — remain inside your network and behind your firewall, exactly where they are now. The agent runs alongside them, listens for requests from OneEnterprise, and securely relays them to the appropriate internal resource. All outbound communication travels over HTTPS on port 443, the same port used for standard web browsing.
Each agent is identified on the platform by a unique authentication Key. Once the agent is installed and authenticated with its Key, it registers itself with OneEnterprise. It becomes available as a proxy route for any integration flows that need to reach on-premises systems.
Why do you need it
OneEnterprise is a cloud-hosted integration platform. By design, it runs in a data center and communicates with connected systems over the internet. This works seamlessly for cloud-based applications like Salesforce, SAP Business ByDesign, or Microsoft 365 — they are already accessible over the internet. But most organizations also run systems that are deliberately not accessible from the internet: on-premises ERP databases, internal REST APIs, legacy file servers, and local data stores.
Without the On-Premise Agent, OneEnterprise has no way to reach those internal systems. The agent solves this problem without requiring you to open inbound ports on your firewall or create network tunnels that increase your attack surface. It connects outbound — from inside your network to OneEnterprise — and the platform routes requests back through that established connection.
The On-Premise Agent is also the foundation for offline and mobile integration scenarios. When an agent runs on a laptop or desktop, it enables that machine to participate in integration flows even when it is not permanently connected to a central server. This is particularly relevant for field users, warehouse workers, and mobile teams who collect or update data locally and need that data to sync with enterprise systems.
What you can do with it
Once the On-Premise Agent is installed and running, it enables a range of integration scenarios that would otherwise require network reconfiguration or direct internet exposure of internal systems.
Connect internal systems to cloud flows
The agent’s primary purpose is to make on-premises systems available as targets or sources within OneEnterprise integration flows. After installing the agent and associating it with a system in OneEnterprise, any automation that references that system routes its traffic through the agent. Your database, ERP, or internal API receives and responds to integration requests as if the cloud platform were inside your network.
Enable laptop and desktop integration
Installing the agent on a personal machine makes that machine a participant in the integration network. This is useful for users who work with local data files, offline databases, or desktop applications that need to sync with enterprise systems. The agent runs as a Windows background service and starts automatically with Windows, so the user does not need to take any action to maintain the connection.
Route traffic securely without opening firewall ports
All agent communication is outbound on port 443. Your corporate firewall does not need any new inbound rules for the agent to work. This keeps your network perimeter clean and simplifies IT approval for deploying the agent on user machines.
Monitor and control the connection from the system tray
After installation, the agent appears as an icon in the Windows system tray. From this icon, you can start or stop the service, view the agent’s connection status, and access diagnostic information — all without opening Windows Services or any configuration file.
Support multi-agent environments
Organizations with multiple sites, regions, or business units can run separate agents for each environment. Each agent is independently named, described, and assigned to the systems it serves. This lets a single OneEnterprise project route traffic through the right agent for each system, regardless of physical location.
Before you install
The On-Premise Agent installs as a Windows service. Before starting, verify that your machine meets the requirements below. An installation on an undersupported system may result in service failures, connectivity issues, or an incomplete setup that requires manual cleanup to reverse.
Administrator privileges are required to install the On-Premise Agent. The installer must be run as an administrator — standard user permissions are insufficient to register the Windows service. Contact your IT team if you do not have local administrator rights.
Related Articles
Overview
Overview In OneEnterprise, a connector is a pre-built integration component that represents an external system — such as an ERP, CRM, or cloud application — within a project network. Connectors encapsulate the logic needed to communicate with a ...Overview
Overview The Business Partner section in OneEnterprise serves as the central platform for overseeing external organizations and service providers with whom you collaborate. Within OneEnterprise, a Business Partner is defined as any individual or ...Overview
Overview The Home Projects module is the central workspace in OneEnterprise where integration teams create, configure, and manage all integration projects. It brings together everything you need — project status, system connections, team access, and ...Home Overview
Overview The Home module is the central entry point in OneEnterprise. When you log in, you get a consolidated view of your entire integration environment — so you can manage entities, configure integrations, and monitor workflows from a single ...Edit Project Overview
Overview One of the great benefits of our project management is that it enables you to make changes to your existing project details as needed. If you need to make changes to your project details after it has been created, don't worry! You can easily ...