Create an IP Whitelist

Protect your projects against unauthorized use by restricting access to a set of trusted IP addresses using an IP Whitelist.

Define one easy-to-maintain whitelist per company account. Each whitelist can contain an unlimited number of network ranges and/or IP addresses that can access your company’s project dashboards and API communication endpoints.

 Note

Only the company account owner can manage the IP whitelist.

Before creating your IP Whitelist, plan your approach and gather user data. Doing this preliminary work will significantly reduce support calls related to project access after you build your whitelist.

These rules and guidelines make it easier to create and maintain your company’s IP Whitelist.

  1. Inventory all individuals that must have access to your company’s projects, then identify and list their IP addresses. Your list may include company employees, outside contractors, and agency employees.
  2. Any user who has access to your company's projects should be whitelisted.
    • Messaging projects: Go to Settings » Team Access and note the usernames in the Team Member list. Repeat for each of your projects.
    • Mobile wallet projects: Click in the right side of the Airship dashboard header, then click Team Management and note the usernames in the Accepted Invitations list.
  3. Add your own IP address to the whitelist first. To make that easy, your IP address is listed at the top of the IP Whitelist screen.
  4. If anyone, including you, needs to have access to a project when working remotely (from home, hotel, convention center, coffee shop, etc.), his or her remote IP address must be included on the whitelist in addition to the work IP address. Bear in mind that some internet service providers periodically rotate their customers’ IP addresses. If this is a common occurrence, consider recommending that individuals working remotely tunnel in to your company’s network via a corporate virtual private network (VPN) that routes all their traffic through the corporate network.

Create a Whitelist

 Warning

When you save the first IP address or range on the whitelist, you will block all individuals not originating from that saved IP address or range; they will not be able to access any of your company’s projects. Consider creating the initial whitelist off-hours to avoid inadvertently blocking a colleague's access to a project.

 Important

  • If you need to access your company’s Airship account from more than one location / IP address, add each of those IP addresses in this initial session.
  • If your current IP address is not in the IP range you’re attempting to add or isn’t in the saved IP ranges, you will get a validation error; the system will prevent you from locking yourself out in the same session you’re setting up.
  • Duplicate address entries and overlapping address blocks will not cause error messages.

  1. Click in the right side of the dashboard header and select IP Whitelist.
  2. Click Add IP Address and enter your current IP address, which is displayed at the top of the screen.
  3. Click Add IP Address and enter an individual IP address or a block of IP addresses using CIDR notation.
  4. Click Save Whitelist.