https://github.com/petarov/apple-mdm-clients
(WIP) Apple MDM Clients for Java
https://github.com/petarov/apple-mdm-clients
apple dep device-management mdm vpp
Last synced: 6 months ago
JSON representation
(WIP) Apple MDM Clients for Java
- Host: GitHub
- URL: https://github.com/petarov/apple-mdm-clients
- Owner: petarov
- License: mit
- Created: 2024-07-19T20:24:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-19T20:55:37.000Z (7 months ago)
- Last Synced: 2025-03-19T21:40:56.447Z (7 months ago)
- Topics: apple, dep, device-management, mdm, vpp
- Language: Java
- Homepage:
- Size: 216 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Apple MDM Clients for Java
Java clients for Apple Mobile Device Management (MDM) services.
Among other technical goals, this library aims to use as few external dependencies as possible.
## Device Assignment Client (Automated Device Enrollment)
> Status: Testing ...
Manage your organization's Apple Business Manager (`ABM`) devices. ADE, previously known as "The Device Enrollment
Program `(DEP)`" allows for creating device enrollment profiles and assigning them to your organization's devices.
In order to use the Java client it is required that you already have created a valid device assignment token on ABM.
The private key with which the token must be decrypted is also required.
### Client Example
```java
var builder = DeviceAssignmentClient.newBuilder();
builder.setUserAgent("apple-mdm-device-assignment-v1");
builder.setServerToken(DeviceAssignmentServerToken.create(
Path.of("/token_file_smime.p7m"),
DeviceAssignmentPrivateKey.createFromDER(
Path.of("/private.der"))
// Use tunneling (HTTP CONNECT) proxy
builder.setProxyOptions(MdmClientProxyOptions.ofHttp("proxy-server", 3128, "user", "pass"));
var client = builder.build();
// Display account information
System.out.println(client.fetchAccount());
// Create a new profile and assign 2 device serial numbers to it
var response = client.createProfile(new Profile.ProfileBuilder()
.setProfileName("mdm-server-01-sales-profile")
.setUrl("https://mdm-server-01.local")
.setDepartment("Sales")
.setAwaitDeviceConfigured(true)
.setMdmRemovable(true)
.setSupportPhoneNumber("555-555-555")
.setSupportEmailAddress("sales-it@example.org")
.setDevices(Set.of("A9C1R3Q8KJA9", "B112R4L8KJC7"))
.setSkipSetupItems(EnumSet.of(ProfileSkipItem.ENABLE_LOCKDOWN_MODE,
ProfileSkipItem.TAP_TO_SETUP, ProfileSkipItem.ICLOUD_DIAGNOSTICS,
ProfileSkipItem.ICLOUD_STORAGE)).build());
System.out.println(response.profileUuid());
```
See the complete list of service API calls on Apple's [Device Assignment](https://developer.apple.com/documentation/devicemanagement/device-assignment) web page.
## Legacy App and Book Management Client
Manage apps and books for students and employees. This Apple API is still perfectly functional, however it has been
deprecated and it's no longer maintained.
> Status: Work in progress ...
# Logging
The libraries utilize SLF4J, so you can plug debug and trace logs into your own logger. Here is a simple `log4j2.xml` example:
```xml
```
# Build
Requires [Java 21](https://adoptium.net/temurin/releases/) or later
./gradlew clean build
# License
[MIT License](LICENSE)