Testing software updates with the AppleSeed for IT beta program
AppleSeed for IT is a program specifically designed for enterprise and education customers committed to testing each new version of Apple beta software in their organizations. This program provides IT professionals and technology managers with an opportunity to evaluate the latest prerelease software versions in their unique work environments, offer feedback directly to Apple engineering teams through a dedicated feedback submission process, and participate in detailed testing plans and forum discussions with other participants.
iOS 17.5, iPadOS 17.5, macOS 14.5, or later, make it easier than ever to manage beta program participation in an organization. Users can receive offers to enroll in beta programs even without an Apple Account in Settings or System Settings. Device management services can also automatically enroll devices during Setup Assistant when using Automated Device Enrollment, or remotely at a later time if the device is supervised and runs iOS 18, iPadOS 18, macOS 15, or later. If necessary, a device management service has the option to remove a supervised device from beta programs, and restrict a user from manually enrolling. This removes the need for the user to perform manual steps, and allows for a streamlined process throughout the beta testing life cycle.
To offer AppleSeed for IT beta versions without the need for an Apple Account, a user with the role of administrator in Apple School Manager or Apple Business Manager need to sign in to the AppleSeed for IT portal and accept the terms and conditions on behalf of their organization for the current beta period.
Although beta enrollment can be managed without the need for an Apple Account, organizations may want to consider providing participating users a Managed Apple Account so they can submit feedback directly to Apple. This also ensures submitted feedback is tied to their organization. If users select to submit their feedback for the team rather than as personal feedback, other users like the IT team can engage in submitted tickets and stay informed. For more information on team feedback, see Manage team feedback in Feedback Assistant on Mac in the Feedback Assistant User Guide.
Similar to software updates and upgrades, beta releases provided by those programs can be deferred on supervised devices and a declarative status report provides increased visibility and allows organizations to track beta program enrollments on managed devices.
Using the available configuration options, an organization can remotely enroll different devices into different beta programs and—combined with the option to defer beta and production releases—can be used to implement a phased testing and rollout approach starting right with the first beta release.
Note: The beta configuration and status report isn’t supported on devices using User Enrollment.
Enrolling a device in a beta program
To enroll a device in the Apple Beta Software Program or AppleSeed for IT, a device management service needs to retrieve a token from Apple and provide it to devices during Automated Device Enrollment or using the com.apple.configuration.softwareupdate.settings declaration.
The first step is for a user with the role of administrator in Apple School Manager or Apple Business Manager to enroll at https://beta.apple.com/for-it. After enrollment, a device management service can request available beta program tokens using the https://mdmenrollment.apple.com/os-beta-enrollment/tokens endpoint. Similar to other service endpoints available at mdmenrollment.apple.com, device management services need to authenticate using OAuth.
The HTTP GET request needs to include the following header fields (all required):
HTTP header field | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| The OAuth token to authenticate the request. For more information about the authentication process, see Authenticating with a Device Enrollment Program (DEP) Server on the Apple Developer website. | ||||||||||
| Needs to be set to value: 1 | ||||||||||
The service endpoint returns a JSON object with the following structure:
{ "betaEnrollmentTokens": [ { "token": "p3ySHD3CiWtpsH1DKS8sVdv9BgmFbRDh31xJH2584wJ5AngrYoReFB4MVY53rucW", "title": "macOS AppleSeed Beta", "os": "macOS" }, { "token": "35b68K477rAsry6dxiDJBnE7AvjRTueUXFa9jZ3ZhQSFpJZ3Jxz9M8mCt9UXK4Sg", "title": "iOS 18 AppleSeed Beta", "os": "iOS" } ]}To enroll a device into a beta program, the RequireBetaProgram dictionary needs to contain the keys shown below (all required strings).
Key | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| A human-readable description of the beta program. | ||||||||||
| The seeding service token for the organization that the device management service is part of. Use this token to enroll the device in the corresponding beta program. | ||||||||||
The following is an example response making use of the described keys:
{ "code": "com.apple.softwareupdate.required", "description": "AppleSeed enrollment required", "message": "This device needs to be enrolled into the AppleSeed Beta program", "details": { "OSVersion": "18.2", "RequireBetaProgram": { "code": "iOS 18 AppleSeed Beta", "token": "35b68K477rAsry6dxiDJBnE7AvjRTueUXFa9jZ3ZhQSFpJZ3Jxz9M8mCt9UXK4Sg"," } }}The token is unique for each organization and can’t be reused across different Apple School Manager and Apple Business Manager organizations. The token is also specific to a certain operating system upgrade seeding period. The title is a human-readable description of the beta release and os can contain the following values: iOS (includes iPadOS), macOS, tvOS, watchOS, or visionOS.
After enrolling an iPhone or iPad in device management, a device management service can enroll or unenroll supervised iPhone or iPad devices from beta programs using the Beta dictionary in the com.apple.configuration.softwareupdate.settings declaration.
