Safelist IPs
Best Practice
PagerDuty supports safelisting IP addresses, however, we’d like to highlight that this method of ensuring webhook delivery security is no longer best practice. We have added TLS 1.2 and custom headers to our webhooks which will ensure webhooks are delivered from PagerDuty. If you are migrating away from using IP safelisting and have questions about PagerDuty’s webhook deliverability, please contact our Support team.
The EU Service Region
Please make sure to safelist IPs resolving to the URLs corresponding to [your service region] (doc:service-regions) (currently available regions are US and EU).
Events APIs
PagerDuty’s Events API, which is used for triggering, acknowledging and resolving incidents, requires that your system be able to make outbound connections to events.pagerduty.com
on TCP port 443 (for HTTPS).
events.pagerduty.com
and events.eu.pagerduty.com
resolve to multiple IPs, which you can find by querying the A records using dig
or nslookup
.
Example Query 1 (US)
$ dig a +short events.pagerduty.com
35.167.69.145
44.231.93.240
44.233.86.211
In this example, you see that the Events API is accessible in the US region at the IPs 35.167.69.145
, 44.231.93.240
and 44.233.86.211
.
Example Query 1 (EU)
$ dig a +short events.eu.pagerduty.com
18.159.153.65
18.198.156.244
35.159.34.57
In this example, you see that the Events API is accessible in the EU region at the IPs 18.159.153.65
, 18.198.156.244
and 35.159.34.57
.
REST API
To access our REST API, your system must be able to make outbound connections to api.pagerduty.com
and/or api.eu.pagerduty.com
on TCP port 443. Our REST API only allows HTTPS connections; for security’s sake, HTTP connections are not allowed.
api.pagerduty.com
and api.eu.pagerduty.com
resolve to multiple IPs as well, however these IPs will be different than the ones used for our Events API or webhooks.
Example Query 2 (US)
$ dig a +short api.pagerduty.com
35.162.7.45
44.227.224.80
44.232.118.253
Taking the example of the US service region, you see that the REST API is accessible at the IPs 35.162.7.45
, 44.227.224.80
and 44.232.118.253
.
Example Query 2 (EU)
$ dig a +short api.eu.pagerduty.com
18.156.39.226
18.157.174.159
18.158.168.35
Taking the example of the EU service region, you see that the REST API is accessible at the IPs 18.156.39.226
, 18.157.174.159
and 18.158.168.35
.
The EU Service Region
Customers using REST API-based integrations may need to safelist IPs resolving to both
api.pagerduty.com
andapi.eu.pagerduty.com
.
Webhooks
Webhooks are HTTP or HTTPS calls sent from PagerDuty to your web server on the IP and port of your choosing. Please see the current list of IPs that PagerDuty uses to send webhooks in our developer documentation, Webhook IPs.
Firewalls and Access Control Lists (ACLs)
You should not expect the IP addresses in the developer documentation Webhook IPs to change, as they are a fixed list of IPs. This means you can safely hardcode them into your firewall or ACL.
Webhook IPs
Prior to May 5th, 2022 the list of Webhooks IPs was subject to change without notice. With that in mind, we provided a couple scripts to notify you and automatically update EC2 security groups when that happened. Since you should not expect Webhook IPs to change, we’ve removed reference to these scripts and they’ve been retired.
Jira Server Integration
If you are using the Jira Server integration, depending on the service region for your account, you will also need to add the address records of app.pagerduty.com
or app.eu.pagerduty.com
to any sort of safelist that controls network egress traffic; this integration will make API calls to PagerDuty that go directly to the hostname of your account's service region.
Updated about 1 year ago