Live Connect architecture

concept brazil Updated Sep 10, 2026 2 min read sql-api-architecture.md
Raw file servicenow.com

Live Connect provides secure, read-only access to ServiceNow data for external BI platforms via industry-standard database APIs, while maintaining all existing security policies and role-based restrictions.

Architecture overview

Live Connect uses ServiceNow web services to provide a query-only interface. This architecture enables direct connections from ODBC and JDBC-compatible tools to your ServiceNow data without data export or replication.

The diagram illustrates how the Live Connect connects external BI tools to ServiceNow tables through ODBC and JDBC drivers, with security and access controls applied at the connection layer.

[Omitted image "sql-api-architechture.png"] Alt text: Architecture diagram showing SQL API interaction with ServiceNow system components

Key architectural components

The Live Connect architecture consists of the following key components:

  • Client applications

    External BI tools and data analysis platforms such as Pyramid Analytics,Power BI, Tableau, DBeaver, and DBvisualizer that connect using ODBC or JDBC protocols.

  • ODBC/JDBC drivers

    Industry-standard database drivers that enable client applications to establish connections and run the SQL queries against ServiceNow data.

  • ServiceNow Instance

    Three layers within the ServiceNow instance process each request:

Layer

Description

Security layer

Six controls are applied in sequence: - IP Access Policy

  • Rate Limit
  • Auth + Role check
  • egress_sql ACL
  • Strict Security Mode
  • WDF Token Metering

REST layer

Separate dedicated services exist for each driver (ODBC REST Service and JDBC REST Service). Both services are restricted to SELECT-only queries and rate limited, and are accessible only by the driver internally.

Database tier

Queries reach the primary database first (read-only, used as fallback if no replica), but are preferably routed to a read replica. The read replica isolates BI workload from the primary database and handles all JDBC/ODBC SELECTs.

## How the architecture works

When you connect your BI tool to ServiceNow through Live Connect, the following process occurs:

  1. Your BI tool establishes a standard database connection using either ODBC or JDBC APIs.
  2. The connection request is authenticated against ServiceNow user credentials configured for Live Connect access.
  3. After authentication, you can write SQL queries to retrieve data from authorized ServiceNow tables and fields.
  4. The Live Connect processes your queries through the security services layer, applying all security controls and access restrictions.
  5. Query results are returned in standard tabular format, which your BI tool can visualize, analyze, or export.

Parent Topic:Getting started with ServiceNow Live Connect

Search documentation
Search document titles and file paths on the brazil branch