PACli Commands for Third-Party Integration
Focus
Focus
Prisma Access Agent

PACli Commands for Third-Party Integration

Table of Contents

PACli Commands for Third-Party Integration

Learn about the Prisma Access Agent commands for third-party integration with other apps.
Where Can I Use This?What Do I Need?
  • Prisma Access (Managed by Strata Cloud Manager)
  • Prisma Access (Managed by Panorama)
  • NGFW (Managed by Panorama)
  • Check the prerequisites for the deployment you're using
  • macOS 14 and later or Windows 10 and later desktop devices
  • Contact your Palo Alto Networks account representative to activate the Prisma Access Agent feature
Use the following commands when integrating a third-party application with Prisma Access Agent to programmatically control authentication and connectivity. The commands are listed in the order you use them during the integration lifecycle. Append --json to any command to return a structured response with an error_code field (0 for success, non-zero for failure) and an error_message field.
CommandDescriptionKey JSON Fields
pacli epm address set <EPM_ADDRESS>Sets the endpoint manager server address. Use this as the first step when configuring the agent for programmatic control.error_code, error_message
pacli epm auth set [ui | cli]Sets the authentication mode. Use cli to suppress automatic browser pop-ups so a third-party application can control authentication programmatically. Use ui to restore standard behavior. If you click Connect while in cli mode, the mode automatically switches to ui; the third-party application must explicitly run pacli epm auth set cli to return to cli mode.error_code, error_message
pacli epm auth statusReturns the current authentication mode (ui or cli).authentication_mode, error_code, error_message
pacli epm auth --geturlStarts enrollment or authentication if needed and returns the SAML URL for the identity provider authentication flow. The third-party application must open this URL in a browser so the user can authenticate. During first enrollment, the URL challenge is active for 3 minutes.saml_url, error_code, error_message
pacli status --epmReturns EPM-specific status fields. Poll this command after the user authenticates in the browser. When epm_configuration returns Full Config, the agent has a valid token and is ready to connect.authentication_status, epm_configuration, epm_address, access_token_expiry, error_code, error_message
pacli connect --bestConnects to the best available gateway using the stored token. No additional user interaction is required.status, gateway, internal, error_code, error_message
pacli gateway <gateway_name>Connects to a specific gateway by name or address using the stored token.status, gateway, internal, error_code, error_message
pacli disconnectDisconnects the active tunnel.error_code, error_message