# APNs

MDM/DDM communication relies upon Apple's APNs cloud service.

# Apple Push Notification Service

## What

- Like to know a new message has been sent?
- Want to see how many messages are unread from the Home Screen, per App?

<p class="callout success">The following is really just for information, describing APNs.</p>

Push Notifications are mostly designed to allow 3rd party Apps the ability to inform users through their App, e.g. messages, sounds, etc. some relevant detail.<span class="Apple-converted-space"> </span>Users control which messages are silenced or visible and how they are visible through Settings.

Developers of Apps requiring this service register their App with Apple.<span class="Apple-converted-space"> </span>This process requires an APNs token, integrated into the App’s Server.

<p class="callout info">Generation of an APNs token itself is a required action by FileWave Admins as per the other KB articles in this chapter.</p>

For APNs to succeed, the App and 3rd party server must be able to trust Apple’s APNs Cloud Service.<span class="Apple-converted-space"> </span>Hence, Trust Stores must include Apple’s APNs Root Certificate.

### APNs Certificate Update:

At times the Root Certificate used by APNs will require replacing, prior to expiry.

<table cellpadding="0" cellspacing="0" id="bkmrk-apns-cert-service-up" style="width: 100%;"><tbody><tr><td style="width: 33.015495%;" valign="top">**APNs Cert**

</td><td style="width: 14.779499%;" valign="top">**Service**

</td><td style="width: 13.118508%;" valign="top">**Up to Date**

</td><td style="width: 16.917248%;" valign="top">**From Date**

</td><td style="width: 22.169249%;" valign="top">**Expiry Date**

</td></tr><tr><td rowspan="2" style="width: 33.015495%;" valign="top">[AAA Certificate Services root certificate](https://comodoca.my.salesforce.com/sfc/dist/version/download/?oid=00D1N000002Ljih&ids=0683l00000G9fLm&d=%2Fa%2F3l000000VbG0%2Fh70Hv.GWfGuD79pR_if0MtGjJFcUj.NRZS_RLqEyC_4&asPdf=false)

</td><td style="width: 14.779499%;" valign="top">Sandbox

</td><td style="width: 13.118508%;" valign="top">Jan 2025

</td><td style="width: 16.917248%;" valign="top">-

</td><td rowspan="2" style="width: 22.169249%;" valign="top">Dec 31 23:59:59 2028 GMT

</td></tr><tr><td style="width: 14.779499%;" valign="top">Production

</td><td style="width: 13.118508%;" valign="top">Feb 2025

</td><td style="width: 16.917248%;" valign="top">-

</td></tr><tr><td rowspan="2" style="width: 33.015495%;" valign="top">[SHA-2 Root : USERTrust RSA Certification Authority certificate](https://www.sectigo.com/knowledge-base/detail/Sectigo-Intermediate-Certificates/kA01N000000rfBO)

</td><td style="width: 14.779499%;" valign="top">Sandbox

</td><td style="width: 13.118508%;" valign="top">-

</td><td style="width: 16.917248%;" valign="top">Jan 2025

</td><td rowspan="2" style="width: 22.169249%;" valign="top">Jan 18 23:59:59 2038 GMT

</td></tr><tr><td style="width: 14.779499%;" valign="top">Production

</td><td style="width: 13.118508%;" valign="top">-

</td><td style="width: 16.917248%;" valign="top">Feb 2025

</td></tr></tbody></table>

Apple will supply information when this occurs, ensuring developers of Apps and providers of 3rd party servers update their products.

<p class="callout success">FileWave Server already includes both of the above listed certificates within its Trust Store.</p>

### 3rd Party Apps

The act of installing an App requiring APNs, registers that App with APNs and the device receives a Unique Device Token.

Messages pushed can include:

- Display Alert Message to User
- Apply Badge Icon to App’s Icon
- Play a Sound
- Deliver Notification Silently

Both Message and Unique Device Token are sent by the App’s Server when attempting to initiate a notification.

Notifications are relayed through Apple’s APNs service.<span class="Apple-converted-space"> </span>On receipt of the notification, the device will act accordingly, e.g. display a message to user.

In essence, the message payload therefore consists of:

- APS Dictionary: Message content
- Alert Keys: Assist notification processing,<span class="Apple-converted-space"> e</span>.g. an identifier to a particular conversation of a messaging app.
- Device ID: Unique Device Token

<p class="callout info">The App should contain the current APNs Root Certificate within its Trust Store</p>

### MDM/DDM

MDM communication also relies upon the APNs service and therefore is an example of this process, but key aspects are:

- The act of enrolment is equivalent to installing the App, initiating the receipt of the Unique Device Token.
- The App in question is a binary, included in the Operating System by Apple: '/usr/libexec/mdmclient'.
- APS dictionary should not be included in the payload from an MDM server.

MDM APNs messages are nothing more than a request for the device to contact the MDM server.<span class="Apple-converted-space"> </span>Any commands are subsequently sent directly to the device, once the device responds back to the MDM server from this APNs request.

Since Apple are the developers of the 'mdmclient', Apple manage its Trust Store.<span class="Apple-converted-space"> </span>Apple’s list of supported Root Certificates per OS version are available from their KB:

[https://support.apple.com/en-gb/103272](https://support.apple.com/en-gb/103272)

# APNs Certificate Creation & Renewal on macOS Computers (Keychain)

## Description

Apple Mobile Device Management (MDM) requires an Apple Push Notification service (APNs) certificate; renewable yearly.

<p class="callout danger">**APNs Expiry**  
If APNs certificates are allowed to expire, all MDM communication will be lost, until renewed. Update Model will also fail until renewed.</p>

[![image.png](https://kb.filewave.com/uploads/images/gallery/2026-02/scaled-1680-/fhcPHbbdCiRSEEnr-image.png)](https://kb.filewave.com/uploads/images/gallery/2026-02/fhcPHbbdCiRSEEnr-image.png)

The following guide provides the steps to create and renew an APNs certificate using macOS with Keychain app.

<p class="callout danger">**APNs Topic**  
An APNs certificate has a unique topic, in the form of a hexadecimal string, and belongs to the Apple ID used to create the certificate. When renewing, the topic must match to ensure devices continue to communicate with the server. As such, not only must the same Apple ID be used when renewing an APNs certificate, but the current certificate must also be selected for renewal.</p>

## Step-By-Step Guide

#### Creating the Certificate Signing Request (CSR)

1. Open Keychain Access, located in: Applications &gt; Utilities &gt; Keychain Access.app.
2. Create a CSR. Keychain Access &gt; Certificate Assistant &gt; Request a Certificate from a Certificate Authority...
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/alhme0ulSOWeQObZ-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/alhme0ulSOWeQObZ-image.png)
3. Enter the AppleID and Server name that you are going to be associating with this certificate in the "Common Name" field.
    
    <p class="callout success">  
    **Common Name**  
    Certificate Private Key names are visible in Keychain and the Common Name is used to set the Private Key name. Supplying the Apple ID and Server as the Common Name, ensures the Apple ID used to generate the certificate will be stored for future reference.  
    </p>
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/WI3uC33RSK2VtDKp-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/WI3uC33RSK2VtDKp-image.png)
4. Select the radio button "Saved to disk" and click Continue.
5. Save the CSR request, ready to upload to FileWave in the next section.
    
    <p class="callout success">Certificate Storage  
    Consider creating a secure location to store the created certificates and sub divide them using the date or year, e.g folder named: 'MDM APNs certificates 2020'.  
    </p>

#### Sign the CSR

CSR requests must be signed before uploading to Apple. FileWave has a portal for this process, which requires an active FileWave account.

1. Navigate to [https://csr.filewave.com/](https://csr.filewave.com/) and login.
2. Upload the previously created CSR.
3. 'Download signed CSR' should list this uploaded and now signed CSR.
4. Download this newly signed CSR, ready for upload to Apple in the next section. Again consider where this certificate is stored.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/aUMBuc33HyIemxTq-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/aUMBuc33HyIemxTq-image.png)

#### Upload the signed FileWave CSR to Apple

##### Creating a new Certificate

If you are renewing a certificate then jump to [Renewing a Certificate](#bkmrk-renewing-a-certifica)

1. Navigate to: [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/) and log in with an Apple ID.
    
    This Apple ID will own the certificate and is required for every renewal. Do not use a personal Apple ID, to avoid complications if that person where to leave the business or institution.
2. Click 'Create'.
3. 'Accept' Apple's 'Terms of Use'.
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/q3SFfJ5UMpW5OH2c-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/q3SFfJ5UMpW5OH2c-image.png)

##### Renewing a Certificate

1. Navigate to: [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/) and **log in with the Apple ID used to initially create the certificate.**
2. Confirm the Certificate to renew.
3. Select 'Renew'.

To confirm the certificate, compare the Subject DN (Topic) and current certificate.

Clicking the 'i' button will show the certificate details, including the Topic:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/EY8Q5DZth1VIaIlJ-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/EY8Q5DZth1VIaIlJ-image.png)

Ensure this matches with the 'Current Certificate' in FileWave Admin &gt; Preferences &gt; Mobile &gt; Apple Push Notification Certificate:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/5UNFgg1tC7c2u7NY-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/5UNFgg1tC7c2u7NY-image.png)

<p class="callout danger">If the 'Topics' do not match do not continue. If the correct certificate is not in the list on Apple's website, this is the wrong Apple ID. If this guide was followed in creating the original certificate, the previously used Apple ID will be viewable from the certificate "Private Key".</p>

Click 'Choose File' and browse to the signed FileWave CSR from the previous section.

Click 'Upload' and Apple will return a 'Confirmation'.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/WFKdWCVHQSMrPtXm-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/WFKdWCVHQSMrPtXm-image.png)

Click 'Download' and save the ".pem" file. Again consider where this certificate is stored.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/HycVQrfrgEDWv8DU-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/HycVQrfrgEDWv8DU-image.png)

#### Create a ".p12" from the Signed CSR

1. Open Keychain Access app, select login from the Keychains list and then choose 'My Certificates' tab.
    
    <p class="callout danger">**Keychain**  
    If imported into the System Keychain, the Private Key will not be accessible. **If 'All Items' tab is selected, private keys will not be available!**</p>
2. Drag the downloaded PEM file into the Keychain main window.
3. Locate the imported certificate. It will begin with "APSP:".
4. Click the disclosure triangle and select the expanded private key.
    
    <p class="callout success">Common Name and Topic  
    The name of the Private Key will show the value defined as the "Common Name" from the creation of the CSR. Where recommendation was followed, this should list the Apple ID and Server name. Additionally the name of the Certificate is the same as the Topic.</p>
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/uuFHabp3h5NmLvXI-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/uuFHabp3h5NmLvXI-image.png)
5. From the 'File' menu, choose 'Export Items...'.
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/5u8xeq96035BvYly-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/5u8xeq96035BvYly-image.png)
6. Export as a .p12 file. Again consider where this certificate is stored.
7. Click Save.
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/OH8JkN1mLliLtY9o-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/OH8JkN1mLliLtY9o-image.png)
8. Leave the password blank.
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/QwHLlAdx7FwEmFei-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/QwHLlAdx7FwEmFei-image.png)
9. Enter your local admin account, when prompted, allowing Keychain to export.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/wYvhPBxbO3qgRPHq-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/wYvhPBxbO3qgRPHq-image.png)

#### Uploading the Certificate into FileWave

1. Launch the FileWave Admin and login to the FileWave server.
2. Open the FileWave Admin Preferences.
    
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/PZDUQSCEcAP5ab0F-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/PZDUQSCEcAP5ab0F-image.png)
3. Select the 'Mobile' tab.
4. Click 'Browse' and navigate to the saved ".p12" APNs certificate.
5. Select the exported ".p12" certificate.
6. Click 'Upload APN Certificate/Key Pair'.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/I23j4sVN66E3Nhh0-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/I23j4sVN66E3Nhh0-image.png)

The topic should match the previous topic. FileWave Central should warn if the topics do not match before accepting the upload:

[![APNs Mismatch Warning.png](https://kb.filewave.com/uploads/images/gallery/2026-02/scaled-1680-/DZkb0W7U8C9M5XxQ-apns-mismatch-warning.png)](https://kb.filewave.com/uploads/images/gallery/2026-02/DZkb0W7U8C9M5XxQ-apns-mismatch-warning.png)

Click 'OK' to save and close the Preferences dialog.

That is it! FileWave may now manage Apple devices using Apple’s Push Notification Service.

<p class="callout success">APNs certificates require yearly renewals. Through FileWave Admin &gt; Dashboard &gt; Alert Settings, automated emails may configured. Consider adding 'APN for MDM'. Note this requires the Email preferences in Admin to be configured.</p>

## Contact Apple for help

If you forgot the email tied to your Apple Push Notiifcation you may reach out to Apple for assistant

[Contact Apple for help with APN](https://support.apple.com/en-us/118629)

## Related articles

- [APNs Certificate Creation &amp; Renewal on macOS Computers (XCA)](https://kb.filewave.com/books/certificates/page/apns-certificate-creation-renewal-on-macos-computers-xca "APNs Certificate Creation & Renewal on macOS Computers (XCA)")
- [APNs Certificate Creation &amp; Renewal on Windows](https://kb.filewave.com/books/certificates/page/apns-certificate-creation-renewal-on-windows-computers "APNs Certificate Creation & Renewal on Windows Computers")

# APNs Certificate Creation & Renewal on macOS Computers (XCA)

## Description

Apple Mobile Device Management (MDM) requires an Apple Push Notification service (APNs) certificate; renewable yearly.

<p class="callout danger">**APNs Expiry**  
If APNs certificates are allowed to expire, all MDM communication will be lost, until renewed. Update Model will also fail until renewed.</p>

[![image.png](https://kb.filewave.com/uploads/images/gallery/2026-02/scaled-1680-/owIFDXr7VebYFYur-image.png)](https://kb.filewave.com/uploads/images/gallery/2026-02/owIFDXr7VebYFYur-image.png)

This guide explains how to create the Apple Push Notification Service (APNS) certificate for FileWave **using an online CSR generator and the XCA certificate management tool, instead of the Apple Keychain**. The Apple Keychain often causes issues with private key handling on newer macOS versions, so this method provides a more reliable alternative. You may use any online CSR generator (for example ssl.com), it does not have to be ssl.com specifically.

<p class="callout danger">**APNs Topic**  
An APNs certificate has a unique topic, in the form of a hexadecimal string, and belongs to the Apple ID used to create the certificate. When renewing, the topic must match to ensure devices continue to communicate with the server. As such, not only must the same Apple ID be used when renewing an APNs certificate, but the current certificate must also be selected for renewal.</p>

## Step-By-Step Guide

#### **Prerequisites**

- Access to the **Apple Push Certificates Portal** ( [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/) ).
- A valid **Apple Business/School Manager account** or Apple ID.
- Access to the **FileWave Central** console.
- Installed **XCA** tool: [https://github.com/chris2511/xca/releases](https://github.com/chris2511/xca/releases)

#### **Step 1: Generate CSR (Certificate Signing Request)**

1. Open the **CSR generator** at [ssl.com](https://www.ssl.com/online-csr-and-key-generator/). ( [https://www.ssl.com/online-csr-and-key-generator/](https://www.ssl.com/online-csr-and-key-generator/) )
2. Enter the required details: 
    - **Common Name (CN):** e.g. FileWave APNS
    - **Organization (O):** your company or school name
    - **Organizational Unit (OU):** optional, e.g. IT Department
    - **Country (C):** two-letter ISO code (e.g. DE)
3. Generate the CSR and download the files: 
    - **CSR file (.csr)**
    - **Private Key (.key)**

<p class="callout danger">⚠️ Keep the **.key file** safe – you will need it later in XCA.</p>

#### **Step 2: Sign the CSR with FileWave**

Before the CSR can be uploaded to Apple, it must be signed by FileWave.

1. Navigate to [https://csr.filewave.com/](https://csr.filewave.com/) and log in with your FileWave account.
2. Upload the previously created **.csr file**.
3. Under *Download signed CSR*, your uploaded CSR should now appear as signed.
4. Download this newly signed CSR – this is the file you will upload to Apple in the next step.
5. Store the file in a secure location.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/aUMBuc33HyIemxTq-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/aUMBuc33HyIemxTq-image.png)

#### **Step 3: Upload the signed FileWave CSR to Apple**

If you are renewing a certificate then jump to [Renewing a Certificate](#bkmrk-renewing-an-existing)

##### **Creating a new certificate**

1. Go to the **Apple Push Certificates Portal**: [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/).
2. Sign in with an Apple ID (⚠️ do not use a personal Apple ID – use a generic business or institution Apple ID for long-term use).
3. Click **Create**.
4. Accept Apple’s *Terms of Use*.
5. Click **Choose File** and upload the **signed FileWave CSR**.
6. Click **Upload** – Apple will confirm the request.
7. Download the issued **APNS certificate (.pem or .cer)**.

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/q3SFfJ5UMpW5OH2c-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/q3SFfJ5UMpW5OH2c-image.png)

##### **Renewing an existing certificate**

1. Go to [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/) and log in with the same Apple ID that owns the certificate.
2. Locate the certificate to renew, confirm the *Subject DN (Topic)* matches the certificate in FileWave Admin.
3. Click **Renew**.
4. Upload the **signed FileWave CSR**.
5. Download the renewed **APNS certificate (.pem or .cer)**.

<p class="callout danger">If the 'Topics' do not match do not continue. If the correct certificate is not in the list on Apple's website, this is the wrong Apple ID. If this guide was followed in creating the original certificate, the previously used Apple ID will be viewable from the certificate "Private Key".</p>

##### <span style="color: rgb(68, 68, 68);">To confirm the certificate, compare the Subject DN (Topic) and current certificate.</span>

Clicking the 'i' button will show the certificate details, including the Topic:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/EY8Q5DZth1VIaIlJ-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/EY8Q5DZth1VIaIlJ-image.png)

Ensure this matches with the 'Current Certificate' in FileWave Admin &gt; Preferences &gt; Mobile &gt; Apple Push Notification Certificate:

[![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/5UNFgg1tC7c2u7NY-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/5UNFgg1tC7c2u7NY-image.png)

#### **Step 4: Import and process the certificate in XCA**

1. First, download **XCA for macOS**: [https://github.com/chris2511/xca/releases](https://github.com/chris2511/xca/releases)
2. Install and start **XCA**.
3. Go to **Private Keys** → *Import* and select the previously saved **.key file** from Step 1.
4. Go to **Certificates** → *Import* and load the APNS certificate you downloaded from Apple (.cer/.pem).
5. Link the certificate with the corresponding private key in XCA.
6. **Export the certificate as a PKCS #12 (.pfx) file – important: without a password.**
7. After export, **rename the .pfx file to .p12** (FileWave requires the .p12 extension).

#### **Step 5: Import the certificate into FileWave**

1. Open the **FileWave Admin**.
2. Go to **Preferences** → **Mobile**.  
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/PZDUQSCEcAP5ab0F-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/PZDUQSCEcAP5ab0F-image.png)
3. Import the **.p12 file** you exported from XCA by browsing to the file and then picking to Upload. The topic should match the previous topic. FileWave Central should warn if the topics do match before accepting the upload.  
    [![image.png](https://kb.filewave.com/uploads/images/gallery/2026-02/scaled-1680-/M8qpq5EUMPbud9Aq-image.png)](https://kb.filewave.com/uploads/images/gallery/2026-02/M8qpq5EUMPbud9Aq-image.png)
    
    ![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/I23j4sVN66E3Nhh0-image.png)
4. Save the settings by clicking OK to close the preferences dialog and verify that devices are communicating.

#### **Step 6: Verification**

- Test whether new or existing MDM clients correctly connect to the APNS service.
- Check the logs in FileWave Admin to ensure there are no certificate errors.

<p class="callout success">APNs certificates require yearly renewals. Through FileWave Admin &gt; Dashboard &gt; Alert Settings, automated emails may configured. Consider adding 'APN for MDM'. Note this requires the Email preferences in Admin to be configured.</p>

## Contact Apple for help

If you forgot the email tied to your Apple Push Notiifcation you may reach out to Apple for assistant

[Contact Apple for help with APN](https://support.apple.com/en-us/118629)

## Related articles

- [APNs Certificate Creation &amp; Renewal on macOS Computers (Keychain)](https://kb.filewave.com/books/certificates/page/apns-certificate-creation-renewal-on-macos-computers-keychain "APNs Certificate Creation & Renewal on macOS Computers (Keychain)")
- [APNs Certificate Creation &amp; Renewal on Windows](https://kb.filewave.com/books/certificates/page/apns-certificate-creation-renewal-on-windows-computers "APNs Certificate Creation & Renewal on Windows Computers")

# APNs Certificate Creation & Renewal on Windows Computers

## Description

Apple Mobile Device Management (MDM) requires an Apple Push Notification service (APNs) certificate; renewable yearly.

<p class="callout danger">**APNs Expiry**  
If APNs certificates are allowed to expire, all MDM communication will be lost, until renewed. Update Model will also fail until renewed.</p>

[![image.png](https://kb.filewave.com/uploads/images/gallery/2026-02/scaled-1680-/zeiTOyrwFm3LNsoH-image.png)](https://kb.filewave.com/uploads/images/gallery/2026-02/zeiTOyrwFm3LNsoH-image.png)

This guide explains how to create the Apple Push Notification Service (APNS) certificate for FileWave on Windows computers using OpenSSL. You will generate a Certificate Signing Request (CSR), have it signed by FileWave, upload it to Apple, and then convert it to a format FileWave can import.

<p class="callout danger">**APNs Topic**  
An APNs certificate has a unique topic, in the form of a hexadecimal string, and belongs to the Apple ID used to create the certificate. When renewing, the topic must match to ensure devices continue to communicate with the server. As such, not only must the same Apple ID be used when renewing an APNs certificate, but the current certificate must also be selected for renewal.</p>

## Step-By-Step Guide

#### **Prerequisites**

- Access to the **Apple Push Certificates Portal** ([https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/))
- A valid **Apple Business/School Manager account** or Apple ID
- Access to the **FileWave Central** console
- **OpenSSL for Windows** installed: [https://slproweb.com/products/Win32OpenSSL.html](https://slproweb.com/products/Win32OpenSSL.html)
    - Download the full version (not the light version, as it needs configuration files)

<p class="callout info">**Administrator Access**  
All cmd.exe commands in this guide must be run with 'Run as Administrator'.</p>

#### **Step 1: Generate CSR (Certificate Signing Request)**

1. Open **cmd.exe** as an Administrator
2. Create a CSR by entering the following command. This will create two files on the Desktop: `request.csr` and `privateKey.key`:

```
"C:\Program Files\OpenSSL-Win64\bin\openssl.exe" req -out "%USERPROFILE%\Desktop\request.csr" -new -newkey rsa:2048 -nodes -keyout "%USERPROFILE%\Desktop\privateKey.key" -config "C:\Program Files\OpenSSL-Win64\bin\cnf\openssl.cnf"

```

3. When prompted, enter values for the certificate fields. For **Common Name**, use a descriptive name like your Apple ID and server name (e.g., `company@example.com - FileWave Server`). This helps you identify the certificate later.

<p class="callout info">**Common Name and Private Key**  
The Common Name you enter will be stored in the Private Key name. Using your Apple ID and server name ensures you can identify which Apple ID created this certificate in the future—important when renewing.</p>

[![1 windows_cmd_csr_creation.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/oOuKYCQKixxAANkB-1-windows-cmd-csr-creation.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/oOuKYCQKixxAANkB-1-windows-cmd-csr-creation.png)

#### **Step 2: Sign the CSR with FileWave**

Before the CSR can be uploaded to Apple, it must be signed by FileWave.

1. Navigate to [https://csr.filewave.com/](https://csr.filewave.com/) and log in with your FileWave account
2. Upload the `request.csr` file you created in Step 1
3. Under **Download signed CSR**, your uploaded CSR should now appear as signed
4. Download this newly signed CSR – this is the file you will upload to Apple in the next step
5. Store the file in a secure location

[![csr_portal.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/vDujlITxq2cGB7mV-csr-portal.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/vDujlITxq2cGB7mV-csr-portal.png)

#### **Step 3: Upload the signed FileWave CSR to Apple**

If you are renewing a certificate, skip to **Renewing an existing certificate** below.

##### **Creating a new certificate**

1. Go to the **Apple Push Certificates Portal**: [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/)
2. Sign in with an Apple ID (⚠️ do not use a personal Apple ID – use a generic business or institution Apple ID for long-term use)
3. Click **Create**
4. Accept Apple's **Terms of Use**
5. Click **Choose File** and upload the **signed FileWave CSR** from Step 2
6. Click **Upload** – Apple will confirm the request
7. Download the issued **APNS certificate (.pem or .cer)** and store it securely

[![create_push.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/nH1NkLoy7Lx62m6w-create-push.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/nH1NkLoy7Lx62m6w-create-push.png)

##### **Renewing an existing certificate**

1. Go to [https://identity.apple.com/pushcert/](https://identity.apple.com/pushcert/) and log in with the **same Apple ID** that owns the certificate
2. Locate the certificate to renew and click the **info (i)** button to view certificate details, including the **Topic** [![APNS renewal.003.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/ah9EE6tNfUf5rEl8-apns-renewal-003.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/ah9EE6tNfUf5rEl8-apns-renewal-003.png)
3. Compare this Topic with the 'Current Certificate' in **FileWave Admin &gt; Preferences &gt; Mobile &gt; Apple Push Notification Certificate** [![APNS renewal.001.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/KLlcGQKeZcgUB00C-apns-renewal-001.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/KLlcGQKeZcgUB00C-apns-renewal-001.png)

<p class="callout danger">**Topic Mismatch**  
If the Topics do not match, do not continue. If the correct certificate is not in the list on Apple's website, you are using the wrong Apple ID. You can identify the correct Apple ID by reviewing the Private Key name from the original CSR (which should contain your Apple ID).</p>

4. Click **Renew**
5. Upload the **signed FileWave CSR** from Step 2
6. Click **Upload** – Apple will confirm the request [![apns_confirmation.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/7PKkG4SXXfh7z5TH-apns-confirmation.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/7PKkG4SXXfh7z5TH-apns-confirmation.png)
7. Download the renewed **APNS certificate (.pem or .cer)** and store it securely [![signed_csr_download.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/I1DsMZM5J61zQk2R-signed-csr-download.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/I1DsMZM5J61zQk2R-signed-csr-download.png)

#### **Step 4: Create a .p12 file from the Signed Certificate**

1. Open **cmd.exe** as an Administrator
2. Create a `.p12` file by entering the following command. Replace the file paths if necessary, and note that `MDM_FileWave.pem` is an example – use your actual downloaded certificate filename:

```
"C:\Program Files\OpenSSL-Win64\bin\openssl.exe" pkcs12 -export -in "%USERPROFILE%\Downloads\MDM_FileWave.pem" -inkey "%USERPROFILE%\Desktop\privateKey.key" -out "%USERPROFILE%\Desktop\push_cert.p12" -name fw-apns

```

3. When prompted for the **Export Password**, leave it blank and press Enter [![cerate_p12.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/odCqISOpVBqlf5WV-cerate-p12.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/odCqISOpVBqlf5WV-cerate-p12.png)

<p class="callout info">**Path Issues**  
If the command errors when creating the .p12 file, replace the %USERPROFILE% variable with the full file path (e.g., C:\\Users\\YourUsername\\).</p>

4. Verify the certificate was created correctly by running:

```
"C:\Program Files\OpenSSL-Win64\bin\openssl.exe" pkcs12 -info -in "%USERPROFILE%\Desktop\push_cert.p12"

```

This will display certificate details. Confirm that the **Common Name** matches the value you entered in Step 1, and that the **Topic** matches the value from Apple.

[![openssl_private_key.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/IPw6DYAGQJLo77Rd-openssl-private-key.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/IPw6DYAGQJLo77Rd-openssl-private-key.png)

<p class="callout success">**Common Name and Topic**  
The Private Key name will display the Common Name you entered when creating the CSR. The certificate name is the same as the Topic. Both should match the certificate you created or renewed at Apple.</p>

#### **Step 5: Upload the certificate into FileWave**

1. Launch **FileWave Admin** and log in to your FileWave server
2. Open **Preferences** [![filewave_admin_prefs.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/LxUUQK6q2z5nAL7v-filewave-admin-prefs.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/LxUUQK6q2z5nAL7v-filewave-admin-prefs.png)
3. Select the **Mobile** tab
4. Click **Browse** and navigate to the `push_cert.p12` file you created in Step 4
5. Select the file and click **Upload APN Certificate/Key Pair**

[![APNS renewal.001.png](https://kb.filewave.com/uploads/images/gallery/2026-01/scaled-1680-/WNkas6lTSFZCruWH-apns-renewal-001.png)](https://kb.filewave.com/uploads/images/gallery/2026-01/WNkas6lTSFZCruWH-apns-renewal-001.png)

The topic should match the previous topic. FileWave Central should warn if the topics do match before accepting the upload:

[![APNs Mismatch Warning.png](https://kb.filewave.com/uploads/images/gallery/2026-02/scaled-1680-/1Gee8BgJGxherpat-apns-mismatch-warning.png)](https://kb.filewave.com/uploads/images/gallery/2026-02/1Gee8BgJGxherpat-apns-mismatch-warning.png)

Click **OK** to save and close the Preferences dialog.

FileWave may now manage Apple devices using Apple's Push Notification Service.

#### **Step 6: Verification**

- Test whether new or existing MDM clients correctly connect to the APNS service
- Check the logs in FileWave Admin to ensure there are no certificate errors

<p class="callout success">APNs certificates require yearly renewals. Through **FileWave Admin &gt; Dashboard &gt; Alert Settings**, you can configure automated email reminders. Consider enabling the 'APN for MDM' alert. Note: this requires Email preferences in Admin to be configured.</p>

## Contact Apple for help

If you forgot the email tied to your Apple Push Notification certificate, you may reach out to Apple for assistance:

[Contact Apple for help with APN](https://support.apple.com/en-us/118629)

## Related articles

- [APNs Certificate Creation &amp; Renewal on macOS Computers (XCA)](https://kb.filewave.com/books/certificates/page/apns-certificate-creation-renewal-on-macos-computers-xca)
- [APNs Certificate Creation &amp; Renewal on macOS Computers (Keychain)](https://kb.filewave.com/books/certificates/page/apns-certificate-creation-renewal-on-macos-computers-keychain)