rohit/probo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Simplify macOS agent installer enrollment copy

Browse Source 
PKG users enroll in the browser at /enroll (or via
the menu bar icon), not through CLI install steps.
Shorten welcome and conclusion panes and drop path
inventories, MDM notes, and admin CLI setup.

Signed-off-by: Ludovic Vielle <ludovic@probo.com>
This commit is contained in:
Ludovic Vielle
2026-07-29 17:21:10 +02:00
parent c9fa85ac52
commit c597b13f73
3 changed files with 28 additions and 90 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
cmd/probo-agent/installer/macos/Distribution.xml.tmpl
View File

@@ -51,7 +51,7 @@
<choice id="default"/>
<choice id="@@IDENTIFIER@@"
title="Probo Device Posture Agent"
description="Installs probo-agent, the menu bar helper LaunchAgent, and Probo Agent.app for probo:// enrollment. The LaunchDaemon starts after enrollment.">
description="Installs the Probo agent and menu bar helper. Enroll after install at your Probo /enroll page.">
<pkg-ref id="@@IDENTIFIER@@"/>
</choice>
</installer-gui-script>

59
cmd/probo-agent/installer/macos/Resources/conclusion.html
View File

@@ -12,22 +12,17 @@
line-height: 1.45;
}
h1 { font-size: 18px; margin-bottom: 6px; }
h2 { font-size: 14px; margin-top: 18px; margin-bottom: 4px; }
code, pre {
code {
font-family: Menlo, Consolas, monospace;
background: #f5f5f7;
border-radius: 4px;
padding: 2px 4px;
}
code { padding: 2px 4px; }
pre {
padding: 8px 10px;
overflow-x: auto;
white-space: pre-wrap;
word-break: break-all;
}
ul { margin: 4px 0 8px 18px; padding: 0; }
li { margin: 2px 0; }
@media (prefers-color-scheme: dark) {
body { color: #f5f5f7; }
code, pre {
code {
background: #3a3a3c;
color: #f5f5f7;
}
@@ -38,36 +33,26 @@
<h1>Installation complete</h1>
<p>
The <code>probo-agent</code> binary is installed. The Probo icon should
appear in the menu bar (or at your next login). To enroll, open the menu
and choose <strong>Enroll via…</strong>, then pick
<strong>United States</strong>, <strong>European Union</strong>, or
<strong>Self hosted…</strong>. Finish enrollment in your browser; when
it succeeds, the menu shows <strong>Connected</strong> and the agent
service starts automatically.
Enroll this device in your browser, or click the Probo icon in your
menu bar:
</p>
<ul>
<li>United States:
<code>https://us.probo.com/enroll</code></li>
<li>European Union:
<code>https://eu.probo.com/enroll</code></li>
<li>Self-hosted:
<code>https://&lt;your-host&gt;/enroll</code></li>
</ul>
<p>
When enrollment succeeds, the menu bar shows
<strong>Connected</strong> and the agent starts automatically.
</p>
<p>
If MDM already enrolled the device during installation, the menu bar
helper should already show <strong>Connected</strong>.
</p>
<p>Administrators can also finish setup from a Terminal:</p>
<pre>sudo probo-agent install \
--server https://your-probo-host.example.com \
--enrollment-token &lt;ENROLLMENT_TOKEN&gt;</pre>
<h2>Inspect the agent</h2>
<pre>sudo probo-agent status
sudo probo-agent collect</pre>
<h2>Uninstall</h2>
<pre>sudo probo-agent uninstall</pre>
<p>
Logs are written to <code>/var/log/probo-agent.log</code>. The
installer's own log lives at
<code>/var/log/probo-agent-install.log</code>.
To uninstall: <code>sudo probo-agent uninstall</code><br>
Logs: <code>/var/log/probo-agent.log</code>
</p>
</body>
</html>

57
cmd/probo-agent/installer/macos/Resources/welcome.html
View File

@@ -12,70 +12,23 @@
line-height: 1.45;
}
h1 { font-size: 18px; margin-bottom: 6px; }
h2 { font-size: 14px; margin-top: 18px; margin-bottom: 4px; }
code, pre {
font-family: Menlo, Consolas, monospace;
background: #f5f5f7;
border-radius: 4px;
padding: 2px 4px;
}
pre { padding: 8px 10px; overflow-x: auto; }
ul { margin: 4px 0 8px 18px; padding: 0; }
li { margin: 2px 0; }
@media (prefers-color-scheme: dark) {
body { color: #f5f5f7; }
code, pre {
background: #3a3a3c;
color: #f5f5f7;
}
}
</style>
</head>
<body>
<h1>Welcome to the Probo Device Posture Agent</h1>
<p>
This installer adds <code>probo-agent</code>, the menu bar helper, and
the <code>probo://</code> enrollment app to your Mac. After enrollment,
the agent reports device posture &mdash; disk encryption, screen lock,
firewall, OS version, and similar signals &mdash; to your Probo
workspace over HTTPS.
This installer adds the Probo agent and menu bar helper to your Mac.
After you enroll, it reports device posture &mdash; disk encryption,
screen lock, firewall, OS version, and similar signals &mdash; to your
Probo workspace.
</p>
<h2>What the installer does</h2>
<ul>
<li>Installs the <code>probo-agent</code> binary to
<code>/usr/local/bin/probo-agent</code>.</li>
<li>Installs <code>Probo Agent.app</code> to
<code>/Applications</code> so browser enrollment deep links
(<code>probo://</code>) work.</li>
<li>Installs the privileged helper
<code>com.probo.agent.helper</code> so browser enrollment can
finish without a second admin password prompt.</li>
<li>Registers the menu bar helper LaunchAgent
<code>com.probo.agent.tray</code> in
<code>/Library/LaunchAgents</code>.</li>
<li>Creates the persistent state directory
<code>/var/lib/probo-agent</code> (root-owned, mode 0700).</li>
<li>Enrolls the device and starts the
<code>com.probo.agent</code> LaunchDaemon when an admin has
pre-staged <code>/tmp/probo-agent.conf</code> (typically via
MDM). Otherwise, finish enrollment from the menu bar icon.</li>
</ul>
<h2>What you will need</h2>
<ul>
<li>Administrator privileges on this Mac.</li>
<li>The Probo server URL for your deployment (the URL of your Probo
console, e.g. <code>https://your-probo-host.example.com</code>).
Hosted Probo workspaces use the URL shown in your browser when you
sign in.</li>
<li>A device enrollment token issued by a workspace administrator.</li>
</ul>
<p>
Click <strong>Continue</strong> to review the license, then
<strong>Install</strong> to proceed. After installation, enroll from
the menu bar unless MDM already staged a configuration file.
<strong>Install</strong>.
</p>
</body>
</html>