Zscaler Integration for SaaS Discovery
Configure the LeanIX-Zscaler integration to automatically discover and manage SaaS applications using Zscaler's ZIA API.
Overview
Zscaler is a cloud-based security platform that protects corporate networks and internet access. Through services like web security, firewall protection, data loss prevention, and secure web gateway functionality.
Once the LeanIX-Zscaler integration is configured, LeanIX uses Zscaler to discover the SaaS applications used within your organization. Discovered applications can then be automatically or manually linked to existing fact sheets in LeanIX or to create new fact sheets and connect them to catalog items.
LeanIX uses Zscaler's ZIA API to discover SaaS applications. To set up this integration, you must provide Zscaler credentials with the appropriate permissions.
Integration Details
Integration Categories | Authentication Mechanism | API Endpoints Used |
---|---|---|
Cloud Access Security Brokers (CASB) | REST API - API token auth | For API authentication: /api/v1/authenticatedSession For SaaS discovery: /api/v1/cloudApplications/lite /api/v1/shadowIT/applications/export |
Implementation Details
LeanIX uses Zscaler's ZIA API to discover SaaS application activity and list fact sheets directly within the LeanIX platform. The integration relies on the Shadow IT report, which provides detailed information on the applications being used across the corporate network and the extent of their usage. For usage adoption metrics, the total active unique users in Zscaler are calculated based on the user count of the past 7 days.
To cross-check the discovered services, in the Zscaler Admin portal, hover over Analytics on the left-side pane, and select Applications under the SaaS Security section.
Discovery Capabilities
Available Capabilities | Entity Description | Zscaler Resource |
---|---|---|
SaaS Discovery | SaaS discovery is the process of automatically identifying applications. | Shadow IT Report |
Configurations in Zscaler
-
Login to Zscaler ZIA portal.
-
Create a new user.
- Navigate to the Administration → Administrator Management → Administrators
- Add a new administrator by selecting + Add Administrator.
Tip
Assign only the necessary permissions to the role, as most are for dashboard access, and not for API access.
- Log out and log in again using the newly created user account.
- Create the API token. Note that each organization can only have one API key. For more details, see Zscaler Cloud Service API Key.
- Navigate to Administration → Cloud Service API Security.
- In the Cloud Service API Key tab, select + Add API Key to create a new key.
Configuring Integration of Zscaler in LeanIX
- In LeanIX, go to the administration area and select Integrations.
- Click Add integration. All available integrations are shown on the resulting page.
- Click Configure on the Zscaler integration.
- In the configuration, choose a name for the integration and the type of capabilities or data you want to get from Zscaler. Currently, only details of SaaS applications can be retrieved.
- In the final step, input the credentials from the ZIA portal that you have generated:
- API URL: URL where your Zscaler instance is deployed (e.g.,
https://zsapi.zscalerthree.net
). - Username: Username created and used on the ZIA portal.
- Password: Password of the user created on the ZIA portal.
- API Key: API key generated on the ZIA portal.
- API URL: URL where your Zscaler instance is deployed (e.g.,
- Click Finish and wait for the connection to be established.
Updated about 1 month ago