APNs Certificate Creation & Renewal on macOS Computers (XCA)

Description 
 Apple Mobile Device Management (MDM) requires an Apple Push Notification service (APNs) certificate; renewable yearly. 
 APNs Expiry If APNs certificates are allowed to expire, all MDM communication will be lost, until renewed.  Update Model will also fail until renewed. 
 
 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. 
 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. 
 Step-By-Step Guide 
 Prerequisites 
 
 Access to the  Apple Push Certificates Portal ( 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 
 
 Step 1: Generate CSR (Certificate Signing Request) 
 
 Open the  CSR generator  at  ssl.com . ( https://www.ssl.com/online-csr-and-key-generator/ ) 
 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) 
 
 
 Generate the CSR and download the files:
 
 CSR file (.csr) 
 Private Key (.key) 
 
 
 
 ⚠️ Keep the  .key file  safe – you will need it later in XCA. 
 Step 2: Sign the CSR with FileWave 
 Before the CSR can be uploaded to Apple, it must be signed by FileWave. 
 
 Navigate to  https://csr.filewave.com/  and log in with your FileWave account. 
 Upload the previously created  .csr file . 
 Under  Download signed CSR , your uploaded CSR should now appear as signed. 
 Download this newly signed CSR – this is the file you will upload to Apple in the next step. 
 Store the file in a secure location. 
 
 
 Step 3: Upload the signed FileWave CSR to Apple 
 If you are renewing a certificate then jump to  Renewing a Certificate 
 Creating a new certificate 
 
 Go to the  Apple Push Certificates Portal : https://identity.apple.com/pushcert/ . 
 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). 
 Click  Create . 
 Accept Apple’s  Terms of Use . 
 Click  Choose File  and upload the  signed FileWave CSR . 
 Click  Upload  – Apple will confirm the request. 
 Download the issued  APNS certificate (.pem or .cer) . 
 
 
 Renewing an existing certificate 
 
 Go to https://identity.apple.com/pushcert/ and log in with the same Apple ID that owns the certificate. 
 Locate the certificate to renew, confirm the  Subject DN (Topic)  matches the certificate in FileWave Admin. 
 Click  Renew . 
 Upload the  signed FileWave CSR . 
 Download the renewed  APNS certificate (.pem or .cer) . 
 
 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". 
 To confirm the certificate, compare the Subject DN (Topic) and current certificate. 
 Clicking the 'i' button will show the certificate details, including the Topic: 
 
 Ensure this matches with the 'Current Certificate' in FileWave Admin > Preferences > Mobile > Apple Push Notification Certificate: 
 
 Step 4: Import and process the certificate in XCA 
 
 First, download  XCA for macOS : https://github.com/chris2511/xca/releases 
 Install and start  XCA . 
 Go to  Private Keys  →  Import  and select the previously saved  .key file  from Step 1. 
 Go to  Certificates  →  Import  and load the APNS certificate you downloaded from Apple (.cer/.pem). 
 Link the certificate with the corresponding private key in XCA. 
 Export the certificate as a PKCS #12 (.pfx) file – important: without a password. 
 After export,  rename the .pfx file to .p12  (FileWave requires the .p12 extension). 
 
 Step 5: Import the certificate into FileWave 
 
 Open the  FileWave Admin . 
 Go to  Preferences  →  Mobile . 
 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. 
 
 
 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. 
 
 APNs certificates require yearly renewals.  Through FileWave Admin > Dashboard > Alert Settings, automated emails may configured.  Consider adding 'APN for MDM'.  Note this requires the Email preferences in Admin to be configured. 
 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 
 Related articles 
 
 APNs Certificate Creation & Renewal on macOS Computers (Keychain) 
 APNs Certificate Creation & Renewal on Windows