Skip to content
mSCP

DDM Component Layout

This page provides a detailed breakdown of a DDM payload for com.apple.configuration.passcode.settings. Each setting is explained to help you understand how to configure passcode requirements effectively.

Identifier

Section titled “Identifier”
  • Identifier: A unique string that identifies this configuration profile.
    Example: "org.mscp.all_rules.config.passcode.settings"

Type

Section titled “Type”
  • Type: Specifies the type of configuration.
    Example: "com.apple.configuration.passcode.settings"

Payload

Section titled “Payload”
  • Payload: Contains the actual settings for the passcode policy.

MaximumFailedAttempts

Section titled “MaximumFailedAttempts”
  • MaximumFailedAttempts: The number of failed passcode attempts allowed before the device is locked or wiped.
    Example: 3

MaximumGracePeriodInMinutes

Section titled “MaximumGracePeriodInMinutes”
  • MaximumGracePeriodInMinutes: The maximum time (in minutes) allowed after unlocking before the passcode is required again.
    Example: 15

RequireAlphanumericPasscode

Section titled “RequireAlphanumericPasscode”
  • RequireAlphanumericPasscode: If true, the passcode must include both letters and numbers.
    Example: true

CustomRegex

Section titled “CustomRegex”
  • CustomRegex: A custom regular expression that the passcode must match.
    Example: ^(?=.*[A-Z])(?=.*[a-z])(?=.*[0-9]).*$
    This requires at least one uppercase letter, one lowercase letter, and one digit.

PasscodeReuseLimit

Section titled “PasscodeReuseLimit”
  • PasscodeReuseLimit: The number of previous passcodes that cannot be reused.
    Example: 5

MaximumPasscodeAgeInDays

Section titled “MaximumPasscodeAgeInDays”
  • MaximumPasscodeAgeInDays: The maximum number of days a passcode can be used before it must be changed.
    Example: 60

MinimumLength

Section titled “MinimumLength”
  • MinimumLength: The minimum number of characters required for the passcode.
    Example: 15

RequireComplexPasscode

Section titled “RequireComplexPasscode”
  • RequireComplexPasscode: If true, the passcode must meet complexity requirements (such as including special characters).
    Example: true

MinimumComplexCharacters

Section titled “MinimumComplexCharacters”
  • MinimumComplexCharacters: The minimum number of complex (non-alphanumeric) characters required in the passcode.
    Example: 1

Complete Example

Section titled “Complete Example”
{
    "Identifier": "org.mscp.all_rules.config.passcode.settings",
    "Type": "com.apple.configuration.passcode.settings",
    "Payload": {
        "MaximumFailedAttempts": 3,
        "MaximumGracePeriodInMinutes": 15,
        "RequireAlphanumericPasscode": true,
        "CustomRegex": "^(?=.*[A-Z])(?=.*[a-z])(?=.*[0-9]).*$",
        "PasscodeReuseLimit": 5,
        "MaximumPasscodeAgeInDays": 60,
        "MinimumLength": 15,
        "RequireComplexPasscode": true,
        "MinimumComplexCharacters": 1
    }
}