Remote Sign-In of Linux Devices to Private Access
  • 30 Jun 2025
  • 1 Minute to read
  • Contributors

    Remote Sign-In of Linux Devices to Private Access


      Article summary

      This allows administrators to remotely sign in Private Access (PA) users on Linux devices using Command Line Interface (CLI) tools, even during or immediately after installation.

      It enables user authentication to the Harmony SASE Agent, so the device can access private resources as defined in your Zero Trust Network Access policies.

      Prerequisites

      • Install the Linux version 10.0.3.933 or higher.
      • Users are fully registered to the tenant with both email and password.

      Use Case

      This feature enables administrators to remotely register and sign in Linux devices to Private Access (PA) using CLI commands, without requiring any user interaction. This helps manage unattended or remotely located devices.

      Using the Linux Agent CLI for Private Access Login and Troubleshooting

      After installation, the Linux agent runs as a background service. You can access its control interface through these commands:

      1. Login to Private Access:
        /usr/bin/p81-helper-daemon ctl login TENANT_ID USERNAME PASSWORD
        Replace,
        • TENANT_ID with your tenant ID.
        • USERNAME and PASSWORDwith the user’s login credentials.
          Note - The provided TENANT_ID must have database identity provider enabled.
      2. To view CLI help:
        /usr/bin/p81-helper-daemon ctl --help
      3. To view login-specific help:
        /usr/bin/p81-helper-daemon ctl login --help
      4. If login fails, the CLI displays a descriptive error message. For support, collect and provide:
        1. The full command used, excluding the password.
        2. CLI output or a screenshot of the error.
        3. Files from this location, compressed into .zip or .tar:
          /var/log/perimeter81helper*.log 

      Was this article helpful?

      What's Next