Platform SSO (PSSO)

Mit Relution ist es möglich, macOS Geräte so zu konfigurieren, dass sich Nutzer mit ihrem Microsoft Entra ID Konto direkt am Anmeldefenster anmelden können (Platform Single Sign-On). Dabei wird bei der ersten Anmeldung ein lokales Benutzerkonto erstellt, das mit der Entra ID Identität verknüpft ist.


Voraussetzung

  • macOS 13 (Ventura) oder höher für Extensible SSO, macOS 15 (Sequoia) oder höher für Login-, Entsperr- und FileVault-Richtlinie, die Karenzzeiten und SSO-Konten außerhalb der Plattform, macOS 26 (Tahoe) für Setup-Assistent-Registrierung und authentifizierten Gastmodus. Microsoft empfiehlt mindestens macOS 14 (Sonoma).
  • Mac mit Apple Silicon, wenn die empfohlene Methode Secure-Enclave-Schlüssel verwendet wird (siehe Authentifizierungsmethode wählen →). Auf Intel-Macs ist nur die Methode Passwort möglich.
  • Microsoft Entra ID Tenant
  • Berechtigung zur Geräte-Registrierung in Microsoft Entra ID für die Nutzer
  • Microsoft Company Portal für Mac muss als App verfügbar sein und installiert werden, bevor die Nutzer für PSSO adressiert werden. Für die Registrierung während des Setup-Assistenten (macOS 26+) wird 5.2604.0 (April 2026) benötigt. Empfohlen wird immer die aktuelle Version – sie erfüllt beide Anforderungen.
  • Netzwerkzugriff auf die Microsoft-/Apple-Anmelde-URLs (siehe Bereich Allgemein →). Diese URLs müssen erreichbar und von einer eventuellen TLS-Inspection ausgenommen sein, sonst schlägt die Registrierung fehl.

Für Platform SSO selbst muss Relution nicht mit Microsoft Entra ID verknüpft sein; die Konfiguration kommt ohne diese Anbindung aus. Die Verknüpfung wird nur benötigt, wenn zusätzlich Benutzer aus Entra ID synchronisiert oder Conditional Access → genutzt werden sollen: Relution mit Entra ID verknüpfen →. Für Conditional Access ist außerdem OIDC → erforderlich.


Vorbereitung in Microsoft Entra ID

Bevor die Konfiguration in Relution ausgerollt wird, sollten folgende Punkte im Microsoft Entra Admin Center geprüft werden:

  • Geräteeinstellungen: Unter Identität → Geräte → Geräteeinstellungen muss Benutzer dürfen Geräte mit Microsoft Entra ID verknüpfen auf Alle (oder auf die betroffene Zielgruppe) gesetzt sein.
  • Multifaktor-Authentifizierung: Ist auf dem Konto klassische Per-User-MFA aktiviert, kann die PSSO-Registrierung fehlschlagen. Für die MFA-Anforderung wird stattdessen Conditional Access verwendet.
  • Passwortkomplexität: Bei der Methode Passwort müssen die Komplexitätsanforderungen von lokalem Konto und Entra ID übereinstimmen, damit die Synchronisierung funktioniert.

Company Portal App hochladen

  1. Die aktuelle Version von Microsoft Company Portal für Mac (.pkg) wird bei Microsoft heruntergeladen → und anschließend unter Apps → App Store über Hinzufügen als Native App in Relution hochgeladen (siehe Native Apps für macOS →).
  2. Die App muss für die Zielgruppe bzw. Organisation freigegeben sein.
Die Company Portal App enthält die SSO-Extension com.microsoft.CompanyPortalMac.ssoextension, die für Platform SSO benötigt wird. Sie muss mindestens in Version 5.2404.0 vorliegen (für die Setup-Assistent-Registrierung unter macOS 26+: 5.2604.0).
Hinweis zu den Versionsnummern: Company Portal führt zwei Versionsangaben. Die Über diese App-Version folgt dem Schema 5.JJMM.x (z. B. 5.2604.0 = April 2026), während die im Paket bzw. per pkgutil sichtbare Build-Nummer anders aussieht – z. B. 4.83.26040910, wobei 260409 das Build-Datum (2026-04-09) ist. Beide bezeichnen dieselbe Version; ein Build aus 2026 erfüllt die PSSO-Anforderung problemlos.

Gerätegruppe und Richtlinien zuweisen

  1. Für die Mac-Geräte, auf denen PSSO ausgerollt werden soll, wird eine Gerätegruppe angelegt.
  2. Der Gerätegruppe wird im Bereich Richtlinien über Hinzufügen eine macOS-Richtlinie zugewiesen, die die beiden folgenden Konfigurationen enthält (eine gemeinsame Richtlinie oder zwei getrennte):
    • Erweiterbares Single Sign On (siehe Konfiguration der Richtlinie Erweiterbares Single Sign On →)
    • App Konformität: Unter Erforderliche Apps wird die hochgeladene Company Portal App über Hinzufügen eingetragen. Ist in der Spalte Auto Installation das Häkchen gesetzt (beim Hinzufügen Standard), installiert Relution die App automatisch. Ohne Auto Installation gilt das Gerät bei fehlender App lediglich als nicht konform.
  3. Die Konfigurationen gelangen erst auf die Geräte, wenn die Richtlinie veröffentlicht ist.
Ohne installierte Company Portal App kann sich die SSO-Extension nicht registrieren. Relution verteilt das SSO-Profil unabhängig von der App-Installation; eine Reihenfolge zwischen beiden wird nicht erzwungen.

Authentifizierungsmethode wählen

Die Authentifizierungsmethode bestimmt, wie sich die Nutzer am Gerät und an den Apps anmelden. Sie ist die wichtigste Entscheidung bei der Einrichtung und wird im Bereich Plattform SSO → der Konfiguration gesetzt.

MethodePasswortlosLokales PasswortMin. macOSGeeignet für
Secure-Enclave-Schlüssel (empfohlen)Ja, phishing-resistentbleibt unverändert13 / 14Personalisierte Geräte, nur Apple Silicon
PasswortNeinwird mit Entra ID synchronisiert13 / 14Intel-Macs, geteilte/Lab-Geräte
SmartcardJa (über CBA)bleibt unverändert14+Organisationen mit physischen Smartcards

Empfehlung: Für personalisierte Firmen-Macs (Apple Silicon) wird die Methode Secure-Enclave-Schlüssel empfohlen – sie ist passwortlos, hardwaregebunden und erfüllt phishing-resistente MFA. Für Intel-Geräte oder geteilte Geräte bietet sich Passwort an.

Wichtig: Smartcard wird während des Setup-Assistenten nicht unterstützt.

Registrierung im Setup-Assistenten (macOS 26+): Wird PSSO bereits im Einrichtungsassistenten registriert (Registrierung während des Einrichtungsassistenten aktivieren auf AN), muss auch Erstellen des ersten Benutzers während des Einrichtungsassistenten aktivieren auf AN stehen – unabhängig von der gewählten Methode. Andernfalls wird beim Setup kein lokales Konto angelegt und die Registrierung schlägt fehl (praktisch bestätigt):

  • Methode Secure-Enclave-Schlüssel: die Anmeldung landet in einem Login-Loop.
  • Methode Passwort: es erscheint Anmelden nicht möglich – Registrierung fehlgeschlagen.

Steht der Schalter auf AN, wird das erste lokale Konto über PSSO erstellt und die Anmeldung läuft in beiden Fällen durch.


Konfiguration der Richtlinie Erweiterbares Single Sign On

In einer Richtlinie für macOS wird die Konfiguration Erweiterbares Single Sign On hinzugefügt.

Bereich Allgemein

ParameterWert
Kennung der Erweiterungcom.microsoft.CompanyPortalMac.ssoextension
Verweigerte Bündelkennungenleer lassen (Standard)
Daten zur Erweiterung → AppPrefixAllowListcom.microsoft.,com.apple.
Daten zur Erweiterung → browser_sso_interaction_enabled1
Daten zur Erweiterung → disable_explicit_app_prompt1
Realmleer lassen
Registrierungs-Tokenleer lassen (für Entra ID nicht erforderlich – siehe Hinweis)
Verhalten bei gesperrtem BildschirmNicht handhaben (Standard: Abbrechen)
Team KennungUBF8T346G9 (Microsoft Team ID)
TypUmleitung (Standard: Anmeldedaten)
URLshttps://login.microsoftonline.com
https://login.microsoft.com
https://sts.windows.net

Pflichtfelder sind Kennung der Erweiterung, Team Kennung und beim Typ Umleitung die URLs. Beim Typ Anmeldedaten erscheint statt URLs das Feld Hosts.

Registrierungs-Token: Für Microsoft Entra ID wird im Extensible-SSO-Payload kein Registrierungs-Token benötigt; das Feld bleibt leer. (Das Feld ist für andere IdP-/Kerberos-Szenarien vorgesehen.)
URLs / TLS: Die drei Anmelde-URLs müssen im Netzwerk erreichbar und von einer TLS-Inspection ausgenommen sein.

Bereich Plattform SSO

ParameterWertHinweis
Name der Kontoanzeigeleer lassenoptional
Methode der AuthentifizierungSecure-Enclave-Schlüssel (im Portal: Benutzersicherer Enclave-Schlüssel)Empfohlen; für Intel/geteilte Geräte: Passwort (Standard bei neuen Konfigurationen)
├─ Login-Richtlinie– (entfällt)nur bei Methode Passwort sichtbar; macOS 15+
├─ Richtlinie entsperren– (entfällt)nur bei Methode Passwort sichtbar; macOS 15+
├─ FileVault Richtlinie– (entfällt)nur bei Methode Passwort sichtbar; macOS 15+
├─ Offline Karenzzeit– (entfällt)nur bei Methode Passwort sichtbar; macOS 15+
└─ Karenzzeit für die Authentifizierung– (entfällt)nur bei Methode Passwort sichtbar; macOS 15+
SSO-Konten außerhalb der Plattformnicht gesetztmacOS 15+
Häufigkeit der Anmeldung64800 (Sekunden, entspricht 18 Std.)Re-Auth-Intervall; Standard 64800, mindestens 3600
Shared Device-Schlüssel verwendenANFür die JIT-Kontoerstellung erforderlich, siehe Shared Device-Schlüssel und Kontoerstellung →; Standard: AUS
├─ Autorisierung einschaltenAN
└─ Benutzer bei der Anmeldung erstellen aktivierenANJust-in-Time-Provisioning des lokalen Kontos
Zusätzliche Gruppennicht gesetztoptional
Administrator-Gruppennicht gesetztoptional
Berechtigungsgruppennicht gesetztoptional
Neuer BenutzerautorisierungsmodusStandard
Modus der BenutzerautorisierungStandard
Gerätekennungen in Attestierung zulassenAUSmacOS 15.4+
Erstellen des ersten Benutzers während des Einrichtungsassistenten aktivierenAN (Standard)macOS 26+ — bei Registrierung im Setup-Assistenten erforderlich (sonst schlägt die Registrierung fehl)
Authentifizierungsmethoden für neue Benutzernicht gesetztmacOS 26+; Auswahl aus Passwort, Smartcard und Access Key. Bei Access Key erscheinen zusätzliche Felder für Lesegerät-Gruppenkennung, Terminalidentität, Ausstellerzertifikat und Expressmodus
Profilbild synchronisierenAUSmacOS 26+
Schnellanmeldung für den authentifizierten Gastmodus aktivierenAUSmacOS 26+
Registrierung während des Einrichtungsassistenten aktivierenANmacOS 26+
Kontonamecom.apple.PlatformSSO.AccountShortNamePlatzhalter für den lokalen Kurznamen
Vollständiger NamenamePlatzhalter für den vollständigen Namen

Bei der Methode Passwort blendet das Portal zusätzlich Login-Richtlinie, Richtlinie entsperren und FileVault Richtlinie ein. Jede dieser Richtlinien bietet die Optionen Authentifizierung versuchen, Authentifizierung erforderlich, Offline-Karenzzeit zulassen und Karenzzeit für die Authentifizierung zulassen; Richtlinie entsperren zusätzlich Touch ID oder Uhr zum Entsperren zulassen. Die Felder Offline Karenzzeit und Karenzzeit für die Authentifizierung (vorbelegt mit 0) sind erst bearbeitbar, wenn in mindestens einer der drei Richtlinien die zugehörige Option Offline-Karenzzeit zulassen bzw. Karenzzeit für die Authentifizierung zulassen gewählt ist. Bei den Methoden Smartcard und Benutzersicherer Enclave-Schlüssel werden diese Felder weder angezeigt noch übertragen.

Die mit macOS 26+ markierten Felder wirken nur auf Geräten mit macOS Tahoe 26 oder neuer und setzen voraus, dass die Registrierung bereits während des Einrichtungsassistenten (Setup Assistant) erfolgt.

Relution: Konfiguration „Erweiterbares Single Sign On" (Beispiel mit Methode „Passwort")

Der Screenshot zeigt beispielhaft die Methode Passwort. Bei Secure-Enclave-Schlüssel (empfohlen, siehe Tabelle) blendet das Portal Login-Richtlinie, Richtlinie entsperren, FileVault Richtlinie sowie die beiden Karenzzeiten aus; die übrige Konfiguration ist identisch.


Weitere Konfiguration

  • Eine der Gerätegruppe zugewiesene Richtlinie muss zusätzlich die Konfiguration App Konformität für Company Portal enthalten, damit die Extension zum Registrierungszeitpunkt bereits verfügbar ist.
  • Für die Automatische Geräteregistrierung (ADE, im Portal: DEP) empfiehlt es sich, die Gerätegruppe mit den PSSO-Konfigurationen bereits in der Auto-Einschreibung zuzuweisen (Geräte → Auto-Einschreibungen, im Eintrag des Geräts Bereich Gerätegruppen → Statische Gerätegruppen), damit die Registrierung im Einrichtungsassistenten greifen kann (macOS 26+).

Shared Device-Schlüssel und Kontoerstellung

Shared Device-Schlüssel verwenden muss AN sein, weil in diesem Ablauf die lokalen Konten per Just-in-Time-Provisioning angelegt werden (Schalter Autorisierung einschalten und Benutzer bei der Anmeldung erstellen aktivieren). Ohne Shared Device-Schlüssel würden benutzergebundene Schlüssel benötigt – die sich aber nicht erzeugen lassen, solange das Benutzerkonto noch gar nicht existiert (Henne-Ei-Problem).

Autorisierung einschalten und Benutzer bei der Anmeldung erstellen aktivieren sind nur bei eingeschaltetem Shared Device-Schlüssel verwenden bedienbar. Ist der Schalter AUS, sind beide ausgegraut und werden nicht übernommen, auch wenn sie noch als AN angezeigt werden. Eine Kontoerstellung bei der Anmeldung findet dann nicht statt.

Methodenwahl je Gerätetyp:

  • Personalisiertes Gerät (empfohlen): Methode Secure-Enclave-Schlüssel – passwortlos, hardwaregebunden, Touch ID.
  • Geteiltes / Multi-User-Gerät (z. B. Klassenraum, Schichtbetrieb): Methode Passwort, da wechselnde Nutzer ohne vorab eingerichtete passwortlose Anmeldedaten auskommen. Solche Geräte werden ohne Benutzeraffinität registriert; Conditional Access wird auf geteilten Macs nicht unterstützt.

Hintergrundobjekte für Microsoft AutoUpdate freigeben

Ab macOS Ventura werden Hintergrundprozesse wie Microsoft AutoUpdate (MAU) standardmäßig blockiert bzw. Nutzer erhalten eine Benachrichtigung Hintergrundobjekt hinzugefügt und müssen das manuell bestätigen. Ohne diese Freigabe kann MAU nicht automatisch im Hintergrund aktualisieren – das betrifft auch Company Portal, da dessen Updates über MAU laufen.

Vorab freigeben lassen sich Hintergrundobjekte über ein Profil mit dem Payload com.apple.servicemanagement (verwaltete Anmeldeobjekte), z. B. mit einer Regel für die Team-ID von Microsoft (UBF8T346G9). Eine eigene Relution-Konfiguration für diesen Payload gibt es nicht; ein solches Profil lässt sich aber als .mobileconfig-Datei über die Konfiguration Apple Configurator 2 Konfiguration verteilen (siehe Apple Configurator 2 Konfiguration →).

Die Relution-Konfiguration Login-Elemente eignet sich dafür nicht: Sie legt fest, welche Apps bei der Anmeldung automatisch gestartet werden, genehmigt aber keine Hintergrundobjekte.

Ohne diese Freigabe erscheinen bei den Nutzern wiederholt Systembenachrichtigungen zu neuen Hintergrundobjekten, und MAU aktualisiert die SSO-relevanten Komponenten ggf. nicht zuverlässig automatisch.

Registrierung durch die Endnutzer

Nachdem die Konfiguration auf dem Gerät angekommen und die Company Portal App installiert ist, läuft die Erstregistrierung so ab:

  1. Am Gerät erscheint die Benachrichtigung Registrierung erforderlich (Registration Required). Alternativ kann sie über die Systemeinstellungen ausgelöst werden.

  2. Direkt nach der ersten Anmeldung öffnet sich der Dialog Gesamtauthentifizierung für den Mac mit dem Punkt Account registrieren. Die Registrierung wird über Fortfahren fortgesetzt (sie erscheint bei den Methoden Passwort und Secure-Enclave-Schlüssel gleichermaßen).

    macOS: Dialog „Gesamtauthentifizierung für den Mac" mit „Account registrieren"

  3. Die Nutzer melden sich mit ihrem Microsoft Entra ID Konto an und bestätigen bei Bedarf die MFA (z. B. über Microsoft Authenticator).

  4. Das lokale Benutzerkonto wird mit der Entra ID Identität verknüpft. Ab jetzt greift Single Sign-On für Apps und Browser, die Entra ID nutzen.

Passkey-Autofill für Company Portal freigeben

Nach der ersten Anmeldung erscheint ein Hinweis Allow Company Portal to autofill to use your passkey. Damit die Anmeldung per Passkey (Platform Credential, insbesondere bei Methode Secure-Enclave-Schlüssel) funktioniert, müssen die Nutzer das automatische Ausfüllen für Company Portal einmalig aktivieren:

  1. Über Open System Settings (oder manuell) werden die Systemeinstellungen geöffnet.
  2. Dort wird Allgemein → AutoFill & Passwörter aufgerufen.
  3. Unter AutoFill von wird der Schalter für Company Portal aktiviert.

macOS: „Allow Company Portal to autofill to use your passkey" – Schalter für Company Portal unter „AutoFill von" aktivieren

Ohne diese Freigabe kann Company Portal den Passkey nicht zum Anmelden anbieten; die passwortlose Anmeldung schlägt dann fehl bzw. der Hinweis erscheint wiederholt.
Bei der Methode Secure-Enclave-Schlüssel bleibt das lokale Passwort unverändert; nach einem Neustart ist zunächst das lokale Passwort für die FileVault-Entsperrung nötig, danach kann Touch ID verwendet werden.

Verifizierung

So lässt sich prüfen, ob die Registrierung erfolgreich war:

  • Auf dem Gerät (Terminal): app-sso platform -s zeigt den Registrierungsstatus der Platform-SSO-Extension.
  • In Microsoft Entra: Unter Geräte erscheint das Gerät als registriert/verknüpft.
  • Company Portal: Der Gerätestatus wird als konform/registriert angezeigt.

Mögliche Fehler

  • Registrierungsprompt erscheint nicht → zu prüfen ist, ob Company Portal (Version 5.2404.0+) installiert ist und die App-Konformität bereits ausgewertet wurde.
  • Anmeldung schlägt fehl → Team Kennung, Kennung der Erweiterung und URLs sind auf Tippfehler zu prüfen; die URLs müssen von der TLS-Inspection ausgenommen sein.
  • Registrierung bricht bei der MFA ab → Per-User-MFA wird auf dem Konto deaktiviert und stattdessen Conditional Access verwendet.
  • Secure Enclave nicht verfügbar → betrifft Intel-Macs; dort wird die Methode Passwort verwendet.
  • Login-Loop bzw. Anmelden nicht möglich – Registrierung fehlgeschlagen → bei Registrierung im Setup-Assistenten (macOS 26+) muss Erstellen des ersten Benutzers während des Einrichtungsassistenten aktivieren auf AN stehen – unabhängig von der Methode. Steht der Schalter auf AUS, wird kein lokales Konto angelegt: mit Secure Enclave entsteht ein Login-Loop, mit Passwort die Meldung Registrierung fehlgeschlagen.

Weitere bekannte Probleme und Diagnosehinweise siehe: Microsoft Dokumentation →

Wie hilfreich war dieser Artikel?