Apple Platform Deployment
- Welcome
- Intro to Apple Platform Deployment
- What’s new
-
-
- Declarative status reports
- Declarative app configuration
- Accessibility declarative configuration
- Apple Intelligence declarative configuration
- App settings configuration
- Audio accessory declarative configuration
- Authentication credentials and identity asset declaration
- Background task management declarative
- Calendar declarative configuration
- Certificates declarative configuration
- Contacts declarative configuration
- Content caching declarative configuration
- DNS settings declarative configuration
- DNS proxy declarative configuration
- Exchange declarative configuration
- Extensible SSO declarative configuration
- External intelligence declarative configuration
- Google Accounts declarative configuration
- Keyboard declarative configuration
- LDAP declarative configuration
- Legacy interactive profile declarative configuration
- Legacy profile declarative configuration
- Mail declarative configuration
- Math and Calculator app declarative configuration
- Managed Migration Assistant declarative configuration
- Network relay declarative configuration
- Packages declarative configuration
- Passcode declarative configuration
- Passkey Attestation declarative configuration
- Safari bookmarks declarative configuration
- Safari browsing management declarative configuration
- Safari extensions management declarative configuration
- Screen Sharing declarative configuration
- Service configuration files declarative configuration
- Siri declarative configuration
- Software Update declarative configuration
- Software Update settings declarative configuration
- Storage management declarative configuration
- Subscribed Calendars declarative configuration
- Web content filter plugin declarative configuration
-
-
- Accessibility payload settings
- Active Directory Certificate payload settings
- AirPlay payload settings
- AirPlay Security payload settings
- AirPrint payload settings
- App Lock payload settings
- Associated Domains payload settings
- Automated Certificate Management Environment (ACME) payload settings
- Autonomous Single App Mode payload settings
- Calendar payload settings
- Cellular payload settings
- Cellular Private Network payload settings
- Certificate Preference payload settings
- Certificate Revocation payload settings
- Certificate Transparency payload settings
- Certificates payload settings
- Conference Room Display payload settings
- Contacts payload settings
- Content Caching payload settings
- Directory Service payload settings
- DNS Proxy payload settings
- DNS Settings payload settings
- Dock payload settings
- Domains payload settings
- Energy Saver payload settings
- Exchange ActiveSync (EAS) payload settings
- Exchange Web Services (EWS) payload settings
- Extensible Single Sign-on payload settings
- Extensible Single Sign-on Kerberos payload settings
- Extensions payload settings
- FileVault payload settings
- Finder payload settings
- Firewall payload settings
- Fonts payload settings
- Global HTTP Proxy payload settings
- Google Accounts payload settings
- Home Screen Layout payload settings
- Identification payload settings
- Identity Preference payload settings
- Kernel Extension Policy payload settings
- LDAP payload settings
- Lights Out Management payload settings
- Lock Screen Message payload settings
- Login Window payload settings
- Managed Login Items payload settings
- Mail payload settings
- Network Usage Rules payload settings
- Notifications payload settings
- Parental Controls payload settings
- Passcode payload settings
- Printing payload settings
- Privacy Preferences Policy Control payload settings
- Relay payload settings
- SCEP payload settings
- Security payload settings
- Setup Assistant payload settings
- Single Sign-on payload settings
- Smart Card payload settings
- Subscribed Calendars payload settings
- System Extensions payload settings
- System Migration payload settings
- Time Machine payload settings
- TV Remote payload settings
- Web Clips payload settings
- Web Content Filter payload settings
- Xsan payload settings
-
- Glossary
- Document revision history
- Copyright and trademarks
Advanced smart card options on Mac
Smart card configuration settings
You can view and edit specific smart card configuration settings and logs on a Mac computer by using the command line for the following options:
List tokens available in the operating system.
pluginkit -m -p com.apple.ctk-tokenscom.apple.CryptoTokenKit.setoken(1.0)com.apple.CryptoTokenKit.pivtoken(1.0)Allow, disallow or list smart card tokens that can’t be used.
sudo security smartcards token [-l] [-e token] [-d token]Unpair the smart card.
sudo sc_auth unpair -u jappleeedDisplay available smart cards.
sudo security list-smartcardsExport items from a smart card.
sudo security export-smartcardSmart card logging.
sudo defaults write /Library/Preferences/com.apple.security.smartcard Logging -bool truePrevent built-in PIV tokens.
sudo defaults write /Library/Preferences/com.apple.security.smartcard DisabledTokens -array com.apple.CryptoTokenKit.pivtoken
In addition to using the command line, the following options can also be managed using the Smart Card payload. For more information, see the Smart Card device management payload settings.
Suppress prompt to pair on token insertion.
sudo defaults write /Library/Preferences/com.apple.security.smartcard UserPairing -bool FALSELimit user account pairing to a single smart card.
sudo defaults write /Library/Preferences/com.apple.security.smartcard oneCardPerUser -bool TRUEPrevent smart card user for login and authorization.
sudo defaults write /Library/Preferences/com.apple.security.smartcard allowSmartCard -bool FALSENote: When preventing
allowSmartCard, smart card certificates identities can still be used for other operations such as signing and encryption and in supported third-party apps.Manage smart card certificate trust behavior.
sudo defaults write /Library/Preferences/com.apple.security.smartcard checkCertificateTrust -int <value>The value can be one of the following:
0: Smart card certificate trust isn’t required.
1: Smart card certificate and chain needs to be trusted.
2: Certificate and chain needs to be trusted and not receive a revoked status.
3: Certificate and chain needs to be trusted and revocation status is returned valid.
Certificate pinning
It’s possible to specify which Certificate Issuing Authorities are used for the trust evaluation of smart card certificates. This trust, which works in conjunction with Certificate Trust settings (1, 2, or 3 required), is known as certificate pinning. Place SHA-256 fingerprints of Certificate Authorities (as string values, comma delimited, and without spaces) in an array named TrustedAuthorities. Use the example /private/etc/SmartcardLogin.plist file below as guidance. When certificate pinning is used, only SmartCard certificates issued by Certificate Authorities in this list are evaluated as trusted. Note that the TrustedAuthorities array is ignored when the checkCertificateTrust setting is set to 0 (off). Verify that the ownership is “root” and permissions are set to “world read” after editing.
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>AttributeMapping</key> <dict> <key>dsAttributeString</key> <string>dsAttrTypeStandard:AltSecurityIdentities</string> <key>fields</key> <array> <string>NT Principal Name</string> </array> <key>formatString</key> <string>Kerberos:$1</string> </dict> <key>TrustedAuthorities</key> <array> <string>SHA256_HASH_OF_CERTDOMAIN_1,SHA256_HASH_OF_CERTDOMAIN_2</string> </array></dict></plist>