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äteeinstellungenmuss 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
- 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 →). - Die App muss für die Zielgruppe bzw. Organisation freigegeben sein.
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).Ü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
- Für die Mac-Geräte, auf denen PSSO ausgerollt werden soll, wird eine Gerätegruppe angelegt.
- 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.
- Die Konfigurationen gelangen erst auf die Geräte, wenn die Richtlinie veröffentlicht ist.
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.
| Methode | Passwortlos | Lokales Passwort | Min. macOS | Geeignet für |
|---|---|---|---|---|
| Secure-Enclave-Schlüssel (empfohlen) | Ja, phishing-resistent | bleibt unverändert | 13 / 14 | Personalisierte Geräte, nur Apple Silicon |
| Passwort | Nein | wird mit Entra ID synchronisiert | 13 / 14 | Intel-Macs, geteilte/Lab-Geräte |
| Smartcard | Ja (über CBA) | bleibt unverändert | 14+ | 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.
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
| Parameter | Wert |
|---|---|
| Kennung der Erweiterung | com.microsoft.CompanyPortalMac.ssoextension |
| Verweigerte Bündelkennungen | leer lassen (Standard) |
Daten zur Erweiterung → AppPrefixAllowList | com.microsoft.,com.apple. |
Daten zur Erweiterung → browser_sso_interaction_enabled | 1 |
Daten zur Erweiterung → disable_explicit_app_prompt | 1 |
| Realm | leer lassen |
| Registrierungs-Token | leer lassen (für Entra ID nicht erforderlich – siehe Hinweis) |
| Verhalten bei gesperrtem Bildschirm | Nicht handhaben (Standard: Abbrechen) |
| Team Kennung | UBF8T346G9 (Microsoft Team ID) |
| Typ | Umleitung (Standard: Anmeldedaten) |
| URLs | https://login.microsoftonline.comhttps://login.microsoft.comhttps://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.
Bereich Plattform SSO
| Parameter | Wert | Hinweis |
|---|---|---|
| Name der Kontoanzeige | leer lassen | optional |
| Methode der Authentifizierung | Secure-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 Plattform | nicht gesetzt | macOS 15+ |
| Häufigkeit der Anmeldung | 64800 (Sekunden, entspricht 18 Std.) | Re-Auth-Intervall; Standard 64800, mindestens 3600 |
| Shared Device-Schlüssel verwenden | AN | Für die JIT-Kontoerstellung erforderlich, siehe Shared Device-Schlüssel und Kontoerstellung →; Standard: AUS |
| ├─ Autorisierung einschalten | AN | |
| └─ Benutzer bei der Anmeldung erstellen aktivieren | AN | Just-in-Time-Provisioning des lokalen Kontos |
| Zusätzliche Gruppen | nicht gesetzt | optional |
| Administrator-Gruppen | nicht gesetzt | optional |
| Berechtigungsgruppen | nicht gesetzt | optional |
| Neuer Benutzerautorisierungsmodus | Standard | |
| Modus der Benutzerautorisierung | Standard | |
| Gerätekennungen in Attestierung zulassen | AUS | macOS 15.4+ |
| Erstellen des ersten Benutzers während des Einrichtungsassistenten aktivieren | AN (Standard) | macOS 26+ — bei Registrierung im Setup-Assistenten erforderlich (sonst schlägt die Registrierung fehl) |
| Authentifizierungsmethoden für neue Benutzer | nicht gesetzt | macOS 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 synchronisieren | AUS | macOS 26+ |
| Schnellanmeldung für den authentifizierten Gastmodus aktivieren | AUS | macOS 26+ |
| Registrierung während des Einrichtungsassistenten aktivieren | AN | macOS 26+ |
| Kontoname | com.apple.PlatformSSO.AccountShortName | Platzhalter für den lokalen Kurznamen |
| Vollständiger Name | name | Platzhalter 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.

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).
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.
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:
Am Gerät erscheint die Benachrichtigung
Registrierung erforderlich(Registration Required). Alternativ kann sie über die Systemeinstellungen ausgelöst werden.Direkt nach der ersten Anmeldung öffnet sich der Dialog
Gesamtauthentifizierung für den Macmit dem PunktAccount registrieren. Die Registrierung wird über Fortfahren fortgesetzt (sie erscheint bei den Methoden Passwort und Secure-Enclave-Schlüssel gleichermaßen).
Die Nutzer melden sich mit ihrem Microsoft Entra ID Konto an und bestätigen bei Bedarf die MFA (z. B. über Microsoft Authenticator).
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:
- Über Open System Settings (oder manuell) werden die Systemeinstellungen geöffnet.
- Dort wird
Allgemein→AutoFill & Passwörteraufgerufen. - Unter AutoFill von wird der Schalter für Company Portal aktiviert.

Verifizierung
So lässt sich prüfen, ob die Registrierung erfolgreich war:
- Auf dem Gerät (Terminal):
app-sso platform -szeigt 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 MeldungRegistrierung fehlgeschlagen.
Weitere bekannte Probleme und Diagnosehinweise siehe: Microsoft Dokumentation →