Safari Web Push does not implement the Web Push standard for which all other browsers do. Because of this, in order to set up your website to prompt for notification permissions and deliver notifications to your Safari visitors your must perform additional integration steps.
Before you start ensure you have the following:
Have access to a Mac computer
Have an Apple Developer Account
The below steps walk you through generating the required Web Push security certificates and uploading them to the Pushly platform.
You must create a separate web push certificate for each site/domain that opts in subscribers. Re-using certificates across multiple domains will result in fewer notifications delivered and higher unsubscribe rates.
On a Mac computer Open the Keychain Access
application and click on Certificates
under the Category
left navigation section.
Within the Keychain Access
drop down menu, select Keychain Access
> Certificate Assistant
> Request a Certificate from a Certificate Authority
.
In the Certificate Information window, enter the following information:
In the User Email Address
field, enter your email address.
In the Common Name
field, create a name for your private key (e.g. Company Name Web Push).
The CA Email Address
field should be left empty.
In the Request
group, select the Saved to disk
option.
Click Continue
within Keychain Access and save the CSR to disk to complete this step.
​Login to your company's Apple Developer Console account.
Click on Certificates, IDs, and Profiles
in the left navigation bar.
Choose Identifiers
in the left navigation bar.
In the top-right dropdown choose Website Push ID
and then click the +
button next to the Identifiers
header.
Choose Website Push IDs
from the list of options and press the Continue
button.
Enter a description. Eg: Pushy Web Push
Enter an identifier. Eg: web.com.YOUR_COMPANY_NAME.webpush
Click the Continue
and then Register
button.
Click on Certificates
in the left nav and press the +
sign next to the Certificates
header..
Choose Website Push ID Certificate
from the list of Production certificate options and then click Continue
.
Select the Website Push ID that was created in the previous step and then click Continue
.
Click the Choose File
button, browse for the CSR file that we created in the first step, and click Continue
.
The next screen informs you that your certificate is ready. Click Download
to store the certificate on your computer.
Navigate to the certificate you saved on your computer and double click it to install it to the Keychain Access
application.
Open the Keychain Access
application and click on Certificates
under the Category
left navigation section.
Right click on the installed Website Push ID certificate and choose Export
.
In the save dialog, choose a filename (or leave the default), choose the .p12
file format, and click the Save
button.
You will be prompted to enter a password - leave both boxes empty and click OK
.
Click Allow
to save the p12 certificate to your computer.
Log in to the Pushly platform.
In the left navigation choose Settings
and then Domain
.
Ensure all subdomains that users will be prompted on are in the Whitelisted SDK Domains
list.
Scroll down to the Safari Integration
section and enter the Website Push ID
you created in Step 2. (Eg: "web.com.example")
Upload the p12
file from your computer and leave the Private Key Password
box empty.
Click the Submit
button at the bottom of the page to finish setting up Safari Support.
Note: These changes may take up to 1 hour to take effect.