Skip to content

Jamf-Concepts/psso-utility

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

PSSO Utility

PSSO Utility is a native macOS app for inspecting and monitoring Platform Single Sign-On (PSSO) status. It queries the system app-sso tool and presents key metrics, IdP details, and raw JSON output in a clean interface. A menu-bar item is available for quick troubleshooting.

System Requirements

  • macOS 26+
  • Apple Platform SSO configuration

Installation

A macOS package installer is available from GitHub Releases. Note that the repository includes only documentation and the installation package.

The installer is signed and notarized by Jamf Software.

Technical Overview

  • The app runs /usr/bin/app-sso platform -s and parses the JSON output.
  • Results are decoded into Swift Codable models with optional fields to avoid crashes when keys are missing.
  • The raw JSON view is pretty-printed via JSONSerialization for readability.

Dependencies and Software Bill of Materials

PSSO Utility uses only Apple system frameworks. No third-party libraries are incorporated.

Troubleshooting

PSSO Utility includes a Logs & Diagnostics view (accessible from the sidebar) that displays the last 2 hours of system log entries from the com.apple.AppSSO and com.apple.AuthenticationServices subsystems.

For deeper investigation, the app's own debug output can be viewed in Console.app or via the log CLI by filtering for the subsystem com.jamf.concepts.psso-utility:

log stream --predicate 'subsystem == "com.jamf.concepts.psso-utility"'

Common issues:

  • No PSSO data shown — Platform SSO must be actively configured and deployed via MDM. The app-sso tool returns no data on unmanaged machines.
  • MDM Profiles view is emptysystem_profiler requires the device to be enrolled. Profile data will not appear on unenrolled machines.
  • Logs & Diagnostics is empty — Entries only appear if SSO activity has occurred in the last 2 hours.

MDM Note

Platform SSO profiles must be deployed via MDM for app-sso to return active configuration data.

Where to get help

If you encounter a bug or have a feature request, please open an issue via GitHub Issues. For more information about Jamf Concepts, please see the Jamf Concepts website.

Terms of Use

This project is offered under the Jamf Concepts Use Agreement. For information on how Jamf handles personal data, please see the Jamf Privacy Policy.

Copyright 2026, Jamf Software LLC

About

PSSO Utility - a macOS app for inspecting and monitoring Platform Single Sign-On (PSSO) status

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors