<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/"><channel><title>Focused Systems</title><link>https://focused-systems.pages.dev/</link><description>Exploring modern cloud workflows. DevOps, APIs, Git, serverless architectures, pipelines, and software integrations, alongside personal tech solutions.</description><language>en</language><generator>Hugo</generator><image><url>https://focused-systems.pages.dev/images/social.png</url><title>Focused Systems</title><link>https://focused-systems.pages.dev/</link></image><lastBuildDate>Mon, 13 Apr 2026 09:29:26 +0000</lastBuildDate><atom:link href="https://focused-systems.pages.dev/index.xml" rel="self" type="application/rss+xml"/><item><title>ASBMUtil app</title><link>https://focused-systems.pages.dev/asbmutil-app-launch/</link><guid isPermaLink="true">https://focused-systems.pages.dev/asbmutil-app-launch/</guid><pubDate>Mon, 13 Apr 2026 09:29:26 +0000</pubDate><dc:creator>Rod Christiansen</dc:creator><category>macos</category><category>mdm</category><category>swift</category><category>devops</category><description>The Swift CLI for Apple School &amp; Business Manager API now has a native SwiftUI app. Same credentials store, same API client, same bulk operations — inside a native app.</description><content:encoded><![CDATA[<p><img src="https://github.com/rodchristiansen/asbmutil/raw/main/resources/main.png?raw=true" alt="ASBMUtil app"><p>When Apple finally released the API for Apple Business &amp; School Manager last year I was thrilled. I took it as an opportunity to try and create a Swift CLI for it which ended up being <a href="https://github.com/rodchristiansen/asbmutil">asbmutil</a>, a Swift binary that directly communicates with the <a href="https://developer.apple.com/documentation/apple-school-and-business-manager-api">Apple School &amp; Business Manager API</a>. I posted it in the MacAdmins Slack, didn't think much about it, and it ended up getting used by folks — along with <a href="https://github.com/rodchristiansen/asbmutil/issues?q=is%3Aissue%20state%3Aclosed">requests to make it better</a>.</p><p>Today I'm shipping <strong>ASBMUtil.app</strong>, a native SwiftUI front-end on top of the same engine. Same credentials store, same API client, same bulk operations — inside a native Liquid Glass Tahoe app.</p><figure class="kg-card kg-image-card"><img src="ASBMUtil-2-1.png" class="kg-image" alt="ASBMUtil app" loading="lazy" width="256" height="256"></figure><p>Not every Mac admin wants to live in the terminal. Even a well-built CLI carries its own friction — &quot;here's the command, make sure the profile is set, redirect jq somewhere, don't forget the <code>&ndash;mdm</code> flag…&quot;</p><p>Hence the GUI app. Same engine underneath, same credentials store, same API client.</p><figure class="kg-card kg-image-card kg-width-wide"><img src="https://github.com/rodchristiansen/asbmutil/raw/main/resources/bulk.png?raw=true" class="kg-image" alt="ASBMUtil app" loading="lazy" width="4052" height="2210"></figure><h2 id="whats-in-the-app">What's in the App</h2><p>The main view is a single native table with every managed device in your Apple Business &amp; School Manager account — Macs, iPads, iPhones, Apple TVs, all of it — right next to each other. Click a row and a sidebar slides in with the full device details: serial, order, status, MDM assignment, AppleCare coverage, MAC addresses, the works. Select a handful, right-click, reassign.</p><ul><li><strong>Device browser</strong> — every managed device in one paginated, sortable table with a details sidebar. AppleCare coverage enrichment is a toggle away.</li><li><strong>Powerful filters</strong> — filter by device status, by order number, by model family, by MDM server — stack filters to narrow to exactly the specific devices you want.</li><li><strong>MDM server list and assignments</strong> — see every server and what's assigned to it.</li><li><strong>Bulk assign / unassign</strong> — multi-select in the table, pick a destination server, go. Or import a CSV if that's how your desired state arrives.</li><li><strong>Export to CSV or JSON</strong> — selection or filtered results out through the macOS share sheet.</li><li><strong>Multi-profile switching</strong> — flip between Apple Business &amp; School Manager instances from the sidebar; manage credentials in settings.</li></ul><figure class="kg-card kg-gallery-card kg-width-wide"><div class="kg-gallery-container"><div class="kg-gallery-row"><div class="kg-gallery-image"><img src="https://github.com/rodchristiansen/asbmutil/raw/main/resources/profiles.png?raw=true" width="1344" height="782" loading="lazy" alt="ASBMUtil app"></div><div class="kg-gallery-image"><img src="https://github.com/rodchristiansen/asbmutil/raw/main/resources/export.png?raw=true" width="604" height="504" loading="lazy" alt="ASBMUtil app"></div></div></div></figure><h2 id="filters">Filters</h2><p>The filters match the web — same categories, same stacking behaviour — so if you already use the ABM filters, you already know how these work. The difference is that here they run against a native table with every device already loaded, so stacking is instant, the selection carries into bulk assign/unassign in one click, and the filtered set exports to CSV or JSON through the share sheet.</p><p>Filter by order number, device status, model family, or MDM server — and stack them, so <em>&quot;unassigned iPads from the last PO that haven't been routed to Intune yet&quot;</em> is three clicks.</p><figure class="kg-card kg-gallery-card kg-width-wide"><div class="kg-gallery-container"><div class="kg-gallery-row"><div class="kg-gallery-image"><img src="https://github.com/rodchristiansen/asbmutil/blob/main/resources/filter_orders.png?raw=true" width="934" height="796" loading="lazy" alt="ASBMUtil app"></div><div class="kg-gallery-image"><img src="https://github.com/rodchristiansen/asbmutil/blob/main/resources/filter_status.png?raw=true" width="936" height="792" loading="lazy" alt="ASBMUtil app"></div></div></div></figure><p>Once you've narrowed to the right cohort, export (CSV/JSON) or bulk-reassign works on the filtered selection — not on the whole fleet.</p><h2 id="what-you-get">What You Get</h2><ul><li><strong>Pure Swift 6 binary</strong> — no external runtime dependencies.</li><li><strong>Credentials stored in the macOS Keychain</strong> — data-protection class, no per-app ACL prompts.</li><li><strong>Multiple profile support</strong> — manage several AxM instances (school-district-east, business-unit-3, whatever) from a dropdown instead of <code>&ndash;profile</code> flags.</li><li><strong>Automatic OAuth 2 client-assertion handling</strong> — token lifecycle handled for you.</li><li><strong>Paginated device fetch</strong> — walks the full inventory without you worrying about page cursors.</li><li><strong>Bulk operations</strong> — CSV import <em>or</em> multi-select directly in the GUI table.</li><li><strong><code>StrictConcurrency</code> enabled</strong> — actor-isolated, race-free by design.</li><li><strong>Bulk device-to-server resolution</strong> — server-side device listing gets the whole fleet in 4–5 API calls regardless of size, instead of per-device lookups.</li><li><strong>Bulk AppleCare enrichment</strong> — <code>list-devices &ndash;include-applecare</code> runs a two-pass fan-out across the whole fleet, no CSV required.</li></ul><h2 id="recent-api-coverage">Recent API Coverage</h2><p>I've kept the tool caught up with the AxM API as Apple has shipped new fields:</p><ul><li><strong>API 1.5</strong> — MAC addresses now support multiple values (array format) for devices with multiple network interfaces.</li><li><strong>API 1.4</strong> — Wi-Fi, Bluetooth, and built-in Ethernet MAC addresses for macOS.</li><li><strong>API 1.3</strong> — AppleCare coverage lookup for devices (single-serial via <code>get-devices-info</code>, whole-fleet via <code>list-devices &ndash;include-applecare</code>).</li><li><strong>API 1.2</strong> — Wi-Fi and Bluetooth MAC addresses for iOS, iPadOS, tvOS, and visionOS.</li></ul><h2 id="running-in-the-cloud">Running in the Cloud</h2><p>Alongside the GUI app, the other side of the coin — fully cloud, headless operations — has gotten a lot of work too. Fully static Swift runtime via <code>&ndash;static-swift-stdlib</code>, URLSession fixes for musl, and keychain-less credential provisioning from env vars so the same codebase runs cleanly on Ubuntu. One Swift 6 binary, one data model, one API client — running unchanged inside <strong>Azure Functions, AWS Lambda, or any Linux container</strong>.</p><p>Cloud automations that the Linux binary offers:</p><ul><li><strong>Reconciliation (inventory → Apple)</strong> — a trigger fires off a desired-state list (a CSV, a DB query, an event), the function asks <code>asbmutil</code> what Apple Business &amp; School Manager currently shows, diffs the two, and issues <code>assign</code>/<code>unassign</code> calls to close the gap. Anything the inventory system considers authoritative — MDM server, department, ownership tags — can drive the comparison.</li><li><strong>Enrichment (Apple → inventory)</strong> — a timer pulls the full device list plus AppleCare coverage via <code>asbmutil</code>, hashes the normalised payload per serial, stores the fingerprint in blob storage, and only writes back to inventory when the Apple-side data has actually changed. Warranty months, coverage status, order number, MDM assignment — all flow in automatically, and the hash cache keeps API traffic and downstream write-load proportional to real change, not fleet size.</li></ul><p>Outcome: inventory and Apple Business &amp; School Manager stay in lockstep without anyone opening either UI. Warranty data flows in one direction, MDM assignments in the other, both driven by the same Swift binary you'd run on your Mac.</p><p>I plan to write in more detail how I'm running these and the code behind them in follow-up posts.</p><h2 id="how-to-use-all-three">How to Use All Three</h2><p>The CLI has its place. It's the thing I'll use to check which MDM a device is assigned to when I need quick operations — <code>asbmutil list-devices-servers &ndash;mdm &quot;Intune&quot;</code> piped through <code>jq</code> and <code>grep</code>, done in a second.</p><p>For bulk operations I reach for the GUI app — load a CSV, select in the table, hit the button. Being able to <em>see</em> what's assigned, what's unassigned, and peruse the fleet side-by-side catches mistakes before they ship and surfaces clean-up opportunities you'd miss on the command line.</p><p>And for the continuous, unattended work — nightly syncs, warranty enrichment, inventory reconciliation — the Linux binary inside a serverless function quietly does it in the background, no interaction, automated.</p><p>Same data model, same trust store, same API calls underneath.</p><figure class="kg-card kg-image-card kg-width-wide"><img src="https://github.com/rodchristiansen/asbmutil/raw/main/resources/servers.png?raw=true" class="kg-image" alt="ASBMUtil app" loading="lazy" width="4052" height="2210"></figure><h2 id="grab-it">Grab It</h2><p>Repo: <a href="https://github.com/rodchristiansen/asbmutil">github.com/rodchristiansen/asbmutil</a></p><p>Grab the latest <code>.pkg</code> or <code>.dmg</code> from the <a href="https://github.com/rodchristiansen/asbmutil/releases/latest">releases page</a>. The installer drops both the app into <code>/Applications</code> and the <code>asbmutil</code> CLI into <code>/usr/local/bin</code>.</p><p><strong>A note on signing:</strong> the released artifacts are unsigned and not notarized. On first launch Gatekeeper will complain — clear the quarantine attribute and you're good:</p><pre><code class="language-bash">xattr -dr com.apple.quarantine /Applications/ASBMUtil.app
xattr -dr com.apple.quarantine /usr/local/bin/asbmutil
</code></pre><p>Or build and sign it yourself from source — <code>make build</code> in the repo will do the whole signing + notarization dance if you drop your own Developer ID into <code>.env</code>. As Mac admins you know the drill.</p><p>Requirements: macOS 14+, and an AxM API account with a client ID, key ID, and PEM. If you already have the CLI configured, the app reads the same keychain profiles — nothing to migrate.</p><p>More posts coming on the specific things this tool makes trivial that ABM's web UI makes painful — starting with the bulk device-to-server resolver, which I think is the most interesting piece of the codebase. For now: v1 of the app exists, it works, and I'd love to hear where it breaks for you.</p></p>
]]></content:encoded></item><item><title>YAML Quick Look</title><link>https://focused-systems.pages.dev/yamlquicklook/</link><guid isPermaLink="true">https://focused-systems.pages.dev/yamlquicklook/</guid><pubDate>Sun, 01 Mar 2026 09:00:00 +0000</pubDate><dc:creator>Rod Christiansen</dc:creator><category>devops</category><category>macos</category><category>swift</category><category>yaml</category><description>QuickLook in the Mac doesn't support YAML files. All you get is the default app icon. I got tired of that and built a Quick Look extension.</description><content:encoded><![CDATA[<h2 id="a-native-macos-extension-for-yaml-files">A Native macOS Extension for YAML Files</h2><p>QuickLook on the Mac doesn&apos;t support previewing the contents of YAML files. You&apos;re digging through repos, config files, CI pipeline files, playbooks, terraform plan and you want to peek at a YAML file without opening it.</p><p>You hit Space.</p><p>Nothing. Just the generic document icon staring back at you.</p><p>QuickLook on the Mac supports text files, plists, JSON&#x2014;but YAML? Nothing out of the box. I fixed that with <a href="https://github.com/rodchristiansen/yamlquicklook">YAML Quick Look</a>.</p><figure class="kg-card kg-gallery-card kg-width-wide"><div class="kg-gallery-container"><div class="kg-gallery-row"><div class="kg-gallery-image"><img src="yamlQuickLook-2.png" width="1024" height="1024" loading="lazy" alt srcset="https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w600/2026/03/yamlQuickLook-2.png 600w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w1000/2026/03/yamlQuickLook-2.png 1000w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/2026/03/yamlQuickLook-2.png 1024w" sizes="(min-width: 720px) 720px"></div><div class="kg-gallery-image"><img src="Finder-2026-03-02-11.56.05-1.png" width="1856" height="1922" loading="lazy" alt srcset="https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w600/2026/03/Finder-2026-03-02-11.56.05-1.png 600w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w1000/2026/03/Finder-2026-03-02-11.56.05-1.png 1000w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w1600/2026/03/Finder-2026-03-02-11.56.05-1.png 1600w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/2026/03/Finder-2026-03-02-11.56.05-1.png 1856w" sizes="(min-width: 720px) 720px"></div><div class="kg-gallery-image"><img src="Screenshot-2026-03-02-at-11.56.20-1.png" width="1766" height="1400" loading="lazy" alt srcset="https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w600/2026/03/Screenshot-2026-03-02-at-11.56.20-1.png 600w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w1000/2026/03/Screenshot-2026-03-02-at-11.56.20-1.png 1000w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/size/w1600/2026/03/Screenshot-2026-03-02-at-11.56.20-1.png 1600w, https://storage.ghost.io/c/7d/ec/7dec1a6c-13d6-4927-b0f1-9d39fe1b152c/content/images/2026/03/Screenshot-2026-03-02-at-11.56.20-1.png 1766w" sizes="(min-width: 720px) 720px"></div></div></div></figure><h2 id="what-it-does">What It Does</h2><p>It&apos;s a native macOS Quick Look extension that does two things:</p><ol><li><strong>Preview</strong>: Hit Space on any <code>.yaml</code> or <code>.yml</code> file, and you get a clean, scrollable plain-text view&#x2014;same experience as <code>.txt</code> or <code>.plist</code>.</li><li><strong>Thumbnails</strong>: Finder shows file content in the icon itself, so you can tell files apart without opening them.</li></ol><p>Dark mode works. Large files are handled (truncated at 10 MB so it doesn&apos;t eat your RAM). It uses a shared <code>YAMLFileReader</code> module backing both extensions, so the behaviour is consistent.</p><p>It&apos;s not a syntax highlighter&#x2014;that was a deliberate choice. Quick Look is for <em>glancing</em>, not editing. Plain text, monospace, scrollable. That&apos;s it.</p><h2 id="why-i-wrote-this">Why I Wrote This</h2><p>Honestly, it was scratching my own itch. I spend a lot of time in repos and Terraform configs, and the missing YAML preview was a small but consistent annoyance.</p><p>There are third-party alternatives, but most of them are either abandoned, use Homebrew, or are bundled inside larger editor apps. I wanted something clean, native, and deployable via a single pkg.</p><p>It&apos;s available on GitHub under MIT. It requires macOS 14 Sonoma or later.</p><h2 id="the-app">The App</h2><p>The app is three targets:</p><ul><li><code>YamlQuickLook</code> &#x2014; A lightweight container app. You open it once to register the extensions, then mostly ignore it. I added Status, Preview, and Settings tabs to make it feel like a real app rather than a hollow shell.</li><li><code>YamlQuickLookExtension</code> &#x2014; The Quick Look preview extension</li><li><code>YamlQuickLookThumbnailExtension</code> &#x2014; The thumbnail generator</li></ul><p>The shared module (<code>YamlQuickLookShared</code>) handles all the file reading logic, so both extensions stay thin. The test suite covers 38 cases across the reader&#x2014;everything from empty files to malformed YAML to files at the size limit.</p><h2 id="installing-it">Installing It</h2><p>The simplest path: grab the latest zip from <a href="https://github.com/rodchristiansen/yamlquicklook/releases">Releases</a>, move the app to <code>/Applications</code>, and run the post-install script to strip quarantine and activate the extension:</p><pre><code class="language-bash">xattr -cr /Applications/YamlQuickLook.app
pluginkit -a /Applications/YamlQuickLook.app/Contents/PlugIns/YamlQuickLookExtension.appex || true
pluginkit -a /Applications/YamlQuickLook.app/Contents/PlugIns/YamlQuickLookThumbnailExtension.appex || true
qlmanage -r
qlmanage -r cache
</code></pre><h2 id="building-with-code-signing">Building with Code Signing</h2><p>The release build isn&apos;t code-signed&#x2014;I don&apos;t have (yet) a Developer ID. You can sign and notarize with your own cert for your environment. I plan to release it onto the Mac App Store.</p><p>If you want a properly signed and notarized build&#x2014;which I&apos;d recommend for org-wide deploys&#x2014;clone the repo and configure signing in Xcode for all three targets:</p><pre><code class="language-bash">xcodebuild -scheme YamlQuickLook \
  -configuration Release \
  -derivedDataPath build \
  CODE_SIGN_IDENTITY=&quot;Developer ID Application: Your Name (TEAM_ID)&quot; \
  DEVELOPMENT_TEAM=&quot;TEAM_ID&quot; \
  clean build
</code></pre><p>Then notarize it with <code>xcrun notarytool</code> and staple the ticket. The <a href="https://github.com/rodchristiansen/yamlquicklook">README</a> has the full steps. A signed build skips the <code>xattr</code> step entirely and removes the quarantine friction for your users.</p><p>The Makefile also has a <code>make release</code> target that handles the signing and notarization flow if you&apos;ve set up your credentials in <code>.env</code>.</p><hr>
]]></content:encoded></item><item><title>Modern Munki DevOps</title><link>https://focused-systems.pages.dev/munki-devops/</link><guid isPermaLink="true">https://focused-systems.pages.dev/munki-devops/</guid><pubDate>Thu, 12 Jun 2025 17:31:28 +0000</pubDate><dc:creator>Rod Christiansen</dc:creator><category>devops</category><category>git</category><category>ci/cd</category><category>munki</category><category>azure</category><category>macadmin</category><description>How we transformed our Munki workflow into a DevOps-native system using Git, CI/CD pipelines, and Azure. Companion post to my MacDevOps YVR 2025 talk.</description><content:encoded><![CDATA[<blockquote><strong>MacDevOps YVR 2025 Companion Post</strong></blockquote><p>A year ago, we were managing Macs the way most orgs still do: one shared Mac, VNC&#x2019;d into, running a local copy of Munki with no real version control or workflow isolation. Git was an afterthought. Deployments were manual. It worked&#x2014;until it didn&#x2019;t scale.</p><p>We&#x2019;ve since inverted the model. Git is the gate. CI is the deployer. Each admin works from their own machine. And the Munki repo is fully DevOps-native.</p><p>Here&#x2019;s how we rebuilt everything using Git, Azure DevOps, Service Bus, pipelines, local caching servers, and inventory automation&#x2014;all open source and cloud-integrated.</p><div class="kg-card kg-file-card"><a class="kg-file-card-container" href="https://blog.focused.systems/content/files/2025/06/MunkiDevOps-1.pdf" title="Download" download><div class="kg-file-card-contents"><div class="kg-file-card-title">MunkiDevOps Presentation Slides</div><div class="kg-file-card-caption"></div><div class="kg-file-card-metadata"><div class="kg-file-card-filename">MunkiDevOps.pdf</div><div class="kg-file-card-filesize">89 MB</div></div></div><div class="kg-file-card-icon"><svg viewbox="0 0 24 24"><defs><style>.a{fill:none;stroke:currentColor;stroke-linecap:round;stroke-linejoin:round;stroke-width:1.5px;}</style></defs><title>download-circle</title><polyline class="a" points="8.25 14.25 12 18 15.75 14.25"/><line class="a" x1="12" y1="6.75" x2="12" y2="18"/><circle class="a" cx="12" cy="12" r="11.25"/></svg></div></a></div><h2 id="from-manual-to-devops">From Manual to DevOps</h2><p>The legacy flow was:</p><ul><li>GitLab running on-prem</li><li>One shared Mac as the deploy point</li><li>One central repo, updated by many hands</li><li>No pipeline. No hooks. No approval gates.</li><li>Everyone stepped on everyone&#x2019;s toes</li></ul><p>Now we have:</p><ul><li>Azure DevOps Git repos and pipelines</li><li>Git hooks that upload/download packages automatically</li><li>Separate working copies per admin</li><li>Local caching servers that sync intelligently</li><li>A full CI/CD system that integrates with inventory and deploys via pull requests</li></ul><h2 id="architecture-overview">Architecture Overview</h2><p>We&#x2019;ve split this into two core flows:</p><h3 id="munki-devops-infrastructure">Munki DevOps Infrastructure</h3><ul><li>Admins commit to a shared Azure DevOps repo with <code>manifests/</code> and <code>pkgsinfo/</code></li><li>Git hooks (post-commit/merge) run <code>azcopy sync</code> to upload or download packages</li><li>A pipeline (<code>munki-push-production.yml</code>) builds catalogs and updates Azure Storage</li><li>Local caching servers (like PLUTO and PROTEUS) are notified via Azure Service Bus</li><li>A daemon listens for commits and runs <code>git pull</code> and syncs assets</li><li>CDN serves files globally or from on-prem caches</li><li>It&#x2019;s fast, redundant, and observable</li></ul><h3 id="inventory-orchestrated-enrollment">Inventory-Orchestrated Enrollment</h3><ul><li>A polling script checks Snipe-IT for inventory changes and builds new CSVs</li><li>CSVs are committed to Git &#x2192; triggers DevOps pipelines &#x2192; runs <code>enrollment-munki</code>, <code>enrollment-intune</code>, <code>enrollment-sharepoint</code>, and more</li><li>Each system (Munki, Intune, Fleet, TDX, Papercut) gets updated data</li><li>Pull requests are the approval gate</li><li>Everything is traceable, auditable, and CI-driven</li></ul><h2 id="resources">Resources</h2><ul><li><strong>Presentation Repo</strong>: <a href="https://github.com/rodchristiansen/munki-devops">github.com/rodchristiansen/munki-devops</a></li></ul><p>Want to talk shop or ask questions? Connect with me on <a href="https://bsky.app/profile/rodchristiansen.net">BlueSky</a> or on the <a href="https://github.com/rodchristiansen">GitHub</a>.</p>
]]></content:encoded></item><item><title>Passwordless Git SSO with Git Credential Manager</title><link>https://focused-systems.pages.dev/git-sso-credential-manager/</link><guid isPermaLink="true">https://focused-systems.pages.dev/git-sso-credential-manager/</guid><pubDate>Tue, 10 Jun 2025 03:53:17 +0000</pubDate><dc:creator>Rod Christiansen</dc:creator><description>End the PAT era—step‑by‑step macOS and Windows guide to enable SSO for Azure DevOps and GitHub using Git Credential Manager.</description><content:encoded><![CDATA[<p>The Git ecosystem is phasing out long-lived personal-access tokens. Cloning with Personal Access Tokens are being retired, and new policies now let administrators block or tightly restrict PAT creation. Best-practice docs point to short-lived identity-provider tokens&#x2014;refreshed automatically and governed by conditional-access rules&#x2014;as the preferred way forward.</p><p>Wiring Git Credential Manager (GCM) into your local global Git helpers you trade fragile over-scoped PATs for one-hour tokens that renew silently and leave no secrets on disk or in build logs.</p><h3 id="what-this-guide-helps-you-with">What this guide helps you with</h3><ul><li>Enable seamless Single&#x2011;Sign&#x2011;On on <strong>macOS</strong> and <strong>Windows</strong> for:<ul><li>Azure DevOps (<code>https://dev.azure.com/ORG/&#x2026;</code>)</li><li>GitHub.com or GitHub&#xA0;Enterprise (<code>https://github.com/&#x2026;</code>)</li></ul></li></ul><hr><h2 id="macos">macOS</h2><p>How to setup GCM for password&#x2011;free access on macOS:</p><h3 id="prerequisites">Prerequisites</h3><ul><li>Homebrew</li><li>Git &#x2265; the version bundled with Xcode&#x202F;15</li><li>Git Credential Manager (installed below)</li></ul><h3 id="install-upgrade-components">Install&#xA0;/&#xA0;upgrade components</h3><pre><code class="language-bash">brew install --cask git-credential-manager
brew upgrade git
</code></pre><h3 id="configure-global-helpers">Configure global helpers</h3><pre><code class="language-bash">git config --global --replace-all credential.helper manager
git config --global --add credential.helper osxkeychain
git config --global credential.msauthFlow devicecode
git config --global credential.guiPrompt false
</code></pre><h3 id="persist-settings-for-shells-gui-apps">Persist settings for shells &amp; GUI apps</h3><pre><code class="language-bash">echo &apos;export GCM_MSAUTH_FLOW=devicecode&apos; &gt;&gt; ~/.zprofile
echo &apos;export GCM_GUI_PROMPT=0&apos; &gt;&gt; ~/.zprofile
<p>launchctl setenv GCM_MSAUTH_FLOW devicecode
launchctl setenv GCM_GUI_PROMPT 0
</code></pre><ul><li><strong>VS Code:</strong> add <code>&quot;git.terminalAuthentication&quot;: false</code> to <em>settings.json</em></li><li><strong>Git Tower:</strong> <code>defaults write com.fournova.Tower5 UseCredentialManager -bool true</code></li></ul><h3 id="first-run">First run</h3><pre><code class="language-bash">git fetch   # single device‑code prompt, then silent
</code></pre><hr><h2 id="windows">Windows</h2><p>And here's how to setup on Windows, leveraging the Entra ID broker for silent SSO with Azure DevOps and device‑code for GitHub.</p><h3 id="prerequisites-1">Prerequisites</h3><ul><li>Git for Windows ≥ 2.45 (bundles GCM v2)</li><li>Device joined to Entra ID (native, hybrid, or AAD‑registered)</li></ul><h3 id="clean-up-old-helpers">Clean up old helpers</h3><pre><code class="language-powershell">git credential-manager unconfigure
git credential-manager configure
git config &ndash;global &ndash;unset-all credential.helper
git config &ndash;global &ndash;remove-section credential
</code></pre><h3 id="enable-broker-sso-azure-devops-and-device-code-github">Enable Broker SSO (Azure DevOps) and Device Code (GitHub)</h3><pre><code class="language-powershell">git config &ndash;global credential.helper manager-core
git config &ndash;global credential.microsoft.sso true
git config &ndash;global credential.msauthUseBroker true
git config &ndash;global credential.msauthFlow broker
git config &ndash;global credential.githubAuthModes devicecode
</code></pre><h3 id="strip-hard%E2%80%91coded-usernames-from-remotes">Strip hard‑coded usernames from remotes</h3><pre><code class="language-powershell">git remote set-url origin <a href="https://dev.azure.com/ORG/PROJECT/_git/REPO">https://dev.azure.com/ORG/PROJECT/_git/REPO</a>
git remote set-url origin <a href="https://github.com/ORG/REPO">https://github.com/ORG/REPO</a>
</code></pre><h3 id="first-run-1">First run</h3><pre><code class="language-powershell">git fetch   # one Windows dialog, then silent
</code></pre><hr><h2 id="bulk%E2%80%91fix-existing-repositories-optional">Bulk‑fix existing repositories (optional)</h2><p>Replace the sample paths below with the folder that contains multiple repositories.</p><p><strong>PowerShell (Windows)</strong></p><pre><code class="language-powershell">Get-ChildItem C:\Dev\Repos -Directory | ForEach-Object {
git -C $<em>.FullName remote set-url origin (git -C $</em>.FullName remote get-url origin -replace '://.<em>@', '://')
}
</code></pre><p><strong>zsh (macOS)</strong></p><pre><code class="language-zsh">for d in ~/Dev/Repos/</em>(.); do
url=$(git -C &quot;$d&quot; remote get-url origin | sed 's#://.*@#://#')
git -C &quot;$d&quot; remote set-url origin &quot;$url&quot;
done
</code></pre><hr><h2 id="troubleshooting">Troubleshooting</h2><p>Run <code>git-credential-manager diagnose</code> for a quick health check. Erase stale tokens with:</p><pre><code class="language-bash">git credential-manager erase <a href="https://dev.azure.com">https://dev.azure.com</a>
git credential-manager erase <a href="https://github.com">https://github.com</a>
</code></pre><p>Need verbose output? Temporarily set:</p><pre><code class="language-bash">export GIT_TRACE=1
export GCM_TRACE=1
git fetch
</code></pre><p>If GCM prompts twice on macOS, <em>login.keychain-db</em> may be read‑only. Unlock and purge stale entries, then retry:</p><pre><code class="language-bash">security unlock-keychain ~/Library/Keychains/login.keychain-db
git credential-manager erase <a href="https://dev.azure.com">https://dev.azure.com</a>
git credential-manager erase <a href="https://github.com">https://github.com</a>
</code></pre><hr><p>By switching from long-lived PATs to short-lived tokens through Git Credential Manager, you lock down your supply chain while making everyday Git activity faster and quieter:</p><ul><li>MFA is enforced automatically and refreshed in the background.</li><li>Tokens rotate every hour, slashing the window for theft or replay.</li><li>No secrets leak into scripts, CI logs, or dotfiles—nothing to scrub later.</li></ul><p>Bake these GCM settings into your workstation images and onboarding scripts once, and every clone, fetch, and push runs hands-free from that point on. Stronger security, zero extra clicks, and no browser pop-ups—that’s a win on every front.</p></p>
]]></content:encoded></item><item><title>GitOps Your Ghost Publishing</title><link>https://focused-systems.pages.dev/ghost-gitops-publishing/</link><guid isPermaLink="true">https://focused-systems.pages.dev/ghost-gitops-publishing/</guid><pubDate>Fri, 16 May 2025 03:20:41 +0000</pubDate><dc:creator>Rod Christiansen</dc:creator><category>gitops</category><category>ghost</category><category>blogging</category><category>devtools</category><description>A Git-first workflow for publishing to Ghost that mirrors how you ship code versioned, stateless, and CI-friendly.</description><content:encoded><![CDATA[<p>Alright, let&#x2019;s get meta. This blog is about DevOps and Git&#x2014;so I&#x2019;m kicking it off by showing you how I <em>ship</em> this blog. With <code>ghostpost</code>, a tool I built that lets me publish to Ghost the same way I manage code: in Git.</p><h2 id="publishing-like-a-dev-meet-ghostpost">Publishing Like a Dev: Meet GhostPost</h2><p>You use <a href="https://ghost.org/">Ghost</a> because it&#x2019;s modern, open, and built for professional creators. It gives you newsletters, subscriptions, and a full publishing stack that doesn&#x2019;t sell your soul to adtech.</p><p>You use <a href="https://git-scm.com/">Git</a> because you want version history, branches, and working with the all mighty plain text.</p><p><code>ghostpost</code> is a GitOps-style CLI for managing Ghost posts.</p><p>Each post lives as a Markdown file in your repo. The front-matter stores all metadata&#x2014;including the Ghost <code>post_id</code>.</p><p>You edit locally. You commit. <code>ghostpost</code> publishes.</p><h2 id="why-i-built-this">Why I Built This</h2><p>I wanted a writing workflow that matched how one might ship code.</p><ul><li>No fragile CMS UI edits</li><li>No &quot;oops I deleted the draft&quot;</li><li>No back-and-forth between browser and source doc</li></ul><p>The Ghost GUI becomes just a preview tool. <em>Nothing gets edited in it.</em></p><p>Not necessarily a new idea&#x2014;<a href="https://www.how-hard-can-it.be/post2ghost/">post2ghost</a> laid out the same &quot;Articles as Code&quot; concept where content belongs in Git. <strong>The CMS should be a rendering layer, not an editing platform.</strong></p><p>That post nailed the philosophy:</p><ul><li>Keep Markdown files under version control</li><li>Write in your editor of choice</li><li>Automate publishing with API calls</li></ul><p>It was still a bit DIY and python based which is a dependency headache -- I love python, but not for cli tools...</p><p><code>ghostpost</code> takes that same idea and wraps it in a clean CLI. One command and simple.</p><h2 id="how-it-works">How It Works</h2><p>You write a post in Markdown, with front-matter like this:</p><pre><code class="language-markdown">---
title: Your title here
slug: your-slug
custom_excerpt: Short summary here
tags: [DevOps, Ghost]
feature_image: images/cover.jpg
status: draft
---
<p>Your content in Markdown.
</code></pre><p>Then you run:</p><pre><code>ghostpost publish -f /path/to/post.md &ndash;editor
</code></pre><p>The tool takes care of:</p><ul><li>Creating the post if it’s new</li><li>Updating the post if it already exists</li><li>Uploading and rewriting image paths to proper Ghost URLs</li></ul><p>There’s no runtime. No daemon. No need to open the CMS.</p><h2 id="what-you-get">What You Get</h2><ul><li><strong>Real version control</strong> Posts live in Git. You get <code>git log</code>, pull requests, inline diffs, CI checks.</li><li><strong>Stateless deploys</strong> Posts can be published from anywhere. Just point to the Markdown file. Or automatically with CI/CD.</li><li><strong>Front-matter is the truth</strong> Titles, tags, status, authors, descriptions—everything is stored right inside the Markdown file.</li><li><strong>Smart images</strong> Use local paths. <code>ghostpost</code> uploads and rewrites them for you.</li><li><strong>CI-ready</strong> Validate structure. Block merges on bad metadata. Push on deploy.</li></ul><p>Here’s a basic example using GitHub Actions:</p><pre><code class="language-yaml"># .github/workflows/publish.yml
jobs:
publish:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- run: ghostpost publish -f posts/hello-from-git.md &ndash;editor
</code></pre><h2 id="why-not-just-use-the-ghost-ui">Why Not Just Use the Ghost UI?</h2><p>Because once you’ve versioned your posts, previewed with Markdown, and deployed with a single command—there’s no going back.</p><p>No clunky editors. No missing history. No surprises.</p><h2 id="get-started">Get Started</h2><p>Check out the repo and the readme at <a href="https://github.com/rodchristiansen/ghost-gitops-publishing"><a href="https://github.com/rodchristiansen/ghost-gitops-publishing">https://github.com/rodchristiansen/ghost-gitops-publishing</a></a></p><p>Install the binary, connect it to your Ghost API, and start treating your writing like the rest of your infrastructure: reproducible, testable, and versioned.</p></p>
]]></content:encoded></item><item><title>Welcome to Focused Systems</title><link>https://focused-systems.pages.dev/welcome/</link><guid isPermaLink="true">https://focused-systems.pages.dev/welcome/</guid><pubDate>Sun, 11 May 2025 06:36:35 +0000</pubDate><dc:creator>Rod Christiansen</dc:creator><category>devops</category><category>Endpoint Management</category><category>ci/cd</category><category>macos</category><category>Windows</category><description>Exploring modern cloud workflows</description><content:encoded><![CDATA[<p>I&#x2019;ve been managing Macs since before MDM mattered&#x2014;when deployment meant NetBoot imaging, and local software deployment repos with a couple of on-prem Mac minis, login hooks, and ad-hoc ARD commands fired off through a GUI.</p><p>It worked&#x2014;until it didn&apos;t.</p><p>We moved from running local scripts on a shared Mac to each admin working from their own local repo, committing changes through Git, syncing packages with <code>az</code> git hooks. We used to push changes first, then capture them in Git after the fact. Now, Git is the gate. Commits and PRs drive the entire process. Pipelines run automatically, and the cloud becomes the source of truth. Our local caching servers listen for updates&#x2014;pulling down only when there are changes&#x2014;fully inverting the workflow into something distributed, reliable, and scalable. All of it version-controlled. All of it traceable. All of it running on infrastructure provisioned with Terraform.</p><p>Every config, every profile, every software assignment that matters tracked in Git. It&#x2019;s CI/CD deployed, reproducible by design, and logged automatically for traceability.</p><h2 id="what-this-blog-is-about">What This Blog Is About</h2><p>This blog is about the journey&#x2014;the migrations, the patterns that emerged, the decisions that held up, and the ones that didn&#x2019;t. And about the new tools and ideas I&apos;ll be building and using along the way.</p><p>If you work in endpoint management with DevOps, you&#x2019;ll find deep dives into:</p><ul><li>CI/CD pipelines that manage device tools, states, and configuration</li><li>Every cloud resource under Infrastructure as Code with Terraform</li><li>Inventory systems that drive deployment logic</li><li>And Git at the center of it all</li></ul><p>As I now manage both macOS and Windows endpoints, I&#x2019;ll be writing about how I&apos;m creating a cohesive, mirrored management system&#x2014;where both platforms are driven by open source tools, DevOps, and Git, and where admins speak the same language on both sides.</p><p><strong>Focused Systems. Grounded in what actually works and scales. Very opinionated.</strong></p><p>Let&#x2019;s get to it.</p>
]]></content:encoded></item></channel></rss>