Zscaler Client Connector one-time passwords: log out or turn off ZIA

By Ashu Arun Sethi, Zscaler-certified (Zscaler ACE), HuCortex · Updated

When your app profile protects logging out of Zscaler Client Connector, or turning ZIA, ZPA or ZDX off, the user needs a password to do it. Rather than share a static password, an admin can give them a one-time password for that one device. Each device has its own set of codes, one per action, listed with the device in the Client Connector Portal.

Which code unlocks what

CodeLets the userTypical reason
LogoutLog out of Client ConnectorSigning in as a different user, re-enrolment, a stuck session
ZIA disableTurn Internet Security offTroubleshooting whether Zscaler is behind a site or app problem, a captive portal
ZPA disable / ZDX disableTurn Private Access or Digital Experience offIsolating a private app or monitoring issue
ExitQuit Client Connector entirelyRare: troubleshooting the client itself
Uninstall / RevertRemove Client Connector, or roll it back a versionReinstalls and bad upgrades
Anti-tampering disableTurn off tamper protectionVery rare, and worth a second approval

The codes only matter when your app profile asks for a password for that action. If it doesn't, the user can already do it without one.

Get a code from the Client Connector Portal

  1. Confirm who you're talking to. The person asking for a code to turn security off is exactly who an attacker would pretend to be.
  2. In the Client Connector Portal, open Enrolled Devices and search for the user.
  3. Pick the device they're actually using. Codes belong to one device, and users often have more than one enrolled.
  4. Open the device's details and read out the code for the action they need, and only that one.
  5. The user enters it in Client Connector: Logout for the logout code, or Turn Off on the Internet Security, Private Access or Digital Experience tab for a disable code.

Handle them like passwords

How Zmate does this from Slack

/zmate otp user@company.com zia-off (or logout, zpa-off, zdx-off, exit, uninstall) finds the user's Client Connector device and returns just that code. If they have several devices, you pick one from a list. The code is shown only to you and isn't saved in Slack, and the channel gets a note saying who fetched which code for whom, without the code. Only Zmate admins can fetch codes. Codes that turn a service off come back straight away; the rest need your MFA code first.

See all Zmate commands

FAQ

Where do I find the Zscaler Client Connector logout password for a user?
In the Client Connector Portal, open Enrolled Devices, find the user's device and open its details. The device's one-time passwords, including the logout code, are listed there. Your app profile may also set a static logout password, which is the same for every device it applies to.
Is a Zscaler Client Connector one-time password the same on every device?
No. One-time passwords belong to one enrolled device, so the code for a user's laptop won't work on their phone or on anyone else's machine. Look up the exact device the user is sitting at.
Can I get a Zscaler Client Connector OTP without opening the portal?
Yes. With Zmate, /zmate otp user@company.com zia-off returns the code in Slack, shown only to the admin who asked.