Skip to main content

Apple ADE Enrollment

Benefits of ADE Enrollment


iOS, tvOS, and macOS can all take advantage of Apple ADE enrollment. ADE enrollments will force a specific set of preferences on the device and force enrollment to FileWave any time the device is Factory Reset. Another huge benefit of ADE is that ADE is the only enrollment option that prevents the end-user from removing the MDM Profile and unenrolling the device. These two aspects can be very helpful in device recovery situations since if the device is wiped after being lost or stolen, the device will automatically enroll back into FileWave where you can lockdown the device and collect Location Tracking information to report to the authorities.

If you have not already created your Apple Push Notification Service Certificate (APNS) or configured ADE to sync with FileWave, please review the Platform Integrations > Apple Integration section before continuing.

Creating ADE Profiles


The first step to enrolling your Apple devices via ADE is to create a ADE Profile. The ADE Profile is what will determine the initial settings applied to the device during enrollment and applies to all Apple platforms. Unless needing explicit seperation of the initial enrollment settings, one ADE Profile can suffice for all of your devices. This is partly possible since we can use FileWave Custom Fields to uniquely name the devices.

  1. Open FileWave Admin and navigate to "Assistants > ADE Association Management".
  2. Click the "[+]" button on the right-hand side under "Profiles".
  3. Fill out each tab according to your management preferences.

DEP Enrollment - Information.jpg

DEP Enrollment - Options.jpg

DEP Enrollment - Setup Assistant.jpg

DEP Enrollment - Account.jpg

DEP Enrollment - Anchor Certs.jpg

DEP Enrollment - Supervising Certs.jpg

DEP Enrollment - Device Naming.jpg

DEP Enrollment - Activation Lock Management.jpg

Assigning ADE Profiles


Assigning ADE Profiles is very easy within FileWave, especially if you only have one ADE Profile since you can set a Default ADE Profile. With a Default ADE Profile configured, anytime you assign a new device to the FileWave MDM Server from within Apple School Manager or Apple Business Manager, the ADE Profile will automatically apply and the device will be ready for ADE enrollment. However, if you have multiple ADE Profiles, FileWave will also enable you to create Rule-based ADE Profile assignments or you can always just drag-n-drop a ADE Profile onto a single device or multiple devices onto a ADE Profile.

The "Profile Status" field in the "Devices" pane tells you the current status of the ADE profile on the client device.

  • Empty - no ADE Profile assigned
  • Assigned - ADE Profile has been assigned but ADE enrollment has not occurred
  • Pushed - Setup Assistant setting has run and settings have been enforced on client device
  • Removed - ADE profile has been unassigned from device, will be changed to "Empty" after ADE sync

Setting Default ADE Profile

  1. Open FileWave Admin and navigate to "Assistants > ADE Association Management".
  2. Click "Edit Assignment Rules".
  3. Select your recently created ADE Profile from the "Default ADE Profile" dropdown menu.
  4. Click "OK".
  5. Click "Apply Assignment Rules" to save the changes.
  6. Hold the Option or Alt key on your keyboard and click "Synchronize (full sync)" button in lower right-hand corner
  7. You should now see that all of your devices have been "Assigned" to your ADE Profile.

Automatic DEP Profile Assignment.png

DEP Associations.png

Rule-based ADE Profile Assignment

  1. Open FileWave Admin and navigate to "Assistants > ADE Association Management".
  2. Click "Edit Assignment Rules".
  3. Click "[+]".
  4. Select the ADE Profile you'd like to assign based on rules.
  5. Drag-n-drop the Inventory data point the devices must meet to be assigned to the ADE Profile into the "Criteria" section.
  6. Verify the criteria is correct by viewing the returned devices in the "Fields" section.
  7. "Save" the query and "OK" to save rule definition.
  8. Click "Apply Assignment Rules" to save the changes.
  9. Hold the Option or Alt key on your keyboard and click "Synchronize (full sync)" button in lower right-hand corner.
  10. You should now see that your selected devices have been "Assigned" to your ADE Profile.

DEP Assignment Rule.png

Rule-based DEP Profile Assignment.png

Rule DEP Associations.png

As noted in the Screenshot, the first matching rule (top to bottom) will be honoured; automated rules will override a Default Profile.  Hence, Default Profile, if set, is considered the fallback if no rules are met.

Manually assign ADE Profile

  1. Open FileWave Admin and navigate to "Assistants > ADE Association Management".
  2. Select one or more devices from left pane and drag-n-drop onto a ADE Profile.
    • or...
  3. Select one ADE Profile from the right pane and drag-n-drop it onto one device.

Generate custom FileWave Client for macOS ADE enrollments


During a ADE enrollment, your macOS devices will automatically download and install the FileWave Client. Before enrolling a macOS device via ADE we must first upload a customized FileWave Client PKG to the FileWave Server. 

Custom PKG.png

Generate a custom FileWave Client PKG

  1. Visit FileWave Custom Installer Builder
  2. Change the following settings to match your FileWave Server.
  3. Click "Build" and wait for automatic download of ZIP.
  4. Extract ZIP.
  • Mandatory Settings
    • Product Version = Your FileWave Server Version
    • Sync Computer Name = macOS Hostname will be FileWave Client Name (recommended)
    • Server Name = Fully Qualified Domain Name of your FileWave Server
    • Server Port = 20015 (do not modify this as it will automatically go to the proper SSL port if you put in 20015)
    • Client Password = Password used to change individual Client Preferences and to start screen-sharing session
  • Optional Settings
    • Is Tracking = Is Location Tracking Enabled for macOS Clients
    • Monitor Port = Port used for FileWave Client Monitor (do not modify)
    • Overwrite Configuration = Overwrite any existing FileWave Client configuration with settings entered here (recommended)
    • Remotecontrol Enabled = Screen-sharing enabled for Windows Clients
    • Remotecontrol Prompting = Whether or not to Prompt the end-user before starting screen-sharing session
    • Server Certificate = Only upload certificate is using a Self-Signed Certificate; not required for CA-signed certificate
    • Server Publish Port = 20005 (do not modify)
    • Tickle Interval = Idle time for Windows Clients before checking for new Model Update (do not modify)
    • Vnc Relay Port = 20030 (do not modify)
    • Vnc Server Port = 20031 (do not modify)
  • Booster Settings
    • Do not configure unless instructed by FileWave SE

macOS Custom Client Import.png

Upload custom FileWave Client PKG to FileWave

  1. Navigate to "FileWave Admin > Preferences > Mobile > macOS".
  2. Click "Upload macOS client package" and authenticate.
  3. Select the extracted "FileWaveClient_XX.X.XX-FQDN-XX-XXX-XXXX.pkg" from previous section.
  4. Wait for the upload confirmation prompt.
  5. Optionally, enable "Use for initial enrollment only".
    • If this box is unchecked, FileWave will deploy any new FileWave Client version uploaded to all MDM enrolled macOS devices.
  6. Click "OK" to save the Preferences.

Enrolling Apple devices via ADE


Now that your devices have been "Assigned" to a ADE Profile, they can either be Factory Reset if already configured or taken fresh out of the box from Apple and they will automatically enroll into FileWave.

If getting authentication required during enrollment, please review this section to learn how to disable ADE enrollment authentication

macOS

macOSRemoteManagement.png

iPadOS

iOSRemoteManagement.png

Finalizing adding of clients

FileWave Clients communicating to the FileWave server will not be able to connect until you add them to the model. We will now allow our new client to join the FileWave server.

image.png

  1. Open FileWave Central.
  2. Click on the “New Client” button in the tool bar
  3. Select either "Desktop Clients" or "Enrolled Mobile Devices" from the dialog box depending on whether it is a macOS or iPad.
  4. Select your new client from the list presented.
  5. Click the “Add Clients” button in the lower right. 

image.png

Once you have selected “Add Clients”, you will be taken to the Clients view in FileWave Admin. By adding a client to the server, we have made changes to the model. In order for those changes to take effect, we need to perform a model update. 

You can also decide to automatically add new clients to skip the step of adding devices. This is discussed here: Conflict Resolution

Making Changes to the Model


Remember that you will need to update the model anytime that you want to apply changes you have made. You can update the model after a single change or multiple changes (adding multiple clients, creating groups, etc.)

Congratulations! Your FileWave environment is now up and running! From here you can continue to add clients, build and deploy Filesets!



winadminClients1002.png