AWS Integration - Documentation

What AWS Integration Does

Pinger Man can integrate with AWS to streamline domain and DNS management. With this integration:

  • Your domains and DNS records are automatically imported.
  • WHOIS monitors are automatically created for imported domains.
  • You can view all your DNS records and create DNS monitors with a single click.
  • With the right permissions, you can also add, edit, or delete DNS records directly from Pinger Man, making it your central hub for DNS management.

How to Integrate with AWS

  1. Go to the Integrations Area
    1. In the Pinger Man dashboard, select Integrations from the left sidebar.
    2. Click Add Integration to open the Add Integration form.
    3. Enter a Name for the integration.
    4. Select AWS as the Type.
    5. Select one of the Auth Type  and follow the steps below
  2. OPTION 1 - Access Key Authentication
    1. Create a new AWS IAM user for Pinger Man with the permissions specified below. Follow the official guide of AWS to enable API access.
    2. Specify the minimum permission (see  permissions section  below).
  3. OPTION 2 - IAM Role Authentication (Recommended)

      4. Create a new AWS IAM Role for Pinger Man using the steps shown below.

      • Goto Identity and Access Management (IAM)
      • Select Roles
      • Click Create role
      • Select AWS account
      • Select Another AWS account
      • Specify Pinger Man's AWS account ID:  131707192396
      • Check  Require external ID
      • Go back to Pinger Man and copy the AWS External ID from the Add Integration form
      • Paste this external ID in AWS Console
      • Click Next
      • Skip specifying permission here and specify the minimum permission needed after the role is created (see permissions section below).
      • Click Next
      • Give the role a name such as PingerMan
      • Provide a suitable description (optional)
      • Click on Create Role
  4. Fill Out the Integration Form
    1. Back in Pinger Man, complete the form with the following details depending on which Auth Type you selected:-
      1. Access Key Authentication
        1. AWS Access Key: The API access key for the IAM User.
        2. AWS Secret Key: This API secret key for the IAM User.
      2. IAM Role Authentication
        1. AWS Role ARN: The ARN of the newly created role
    2. Click Finish to complete the integration.

Permissions

You can specify the permissions depending upon your use case. Also, you can choose between read-only and write permissions.
  • Read-Only Permissions (Recommended)
    • For importing Domains
      • route53domains:ListDomains
    • For importing DNS Records
      • route53:ListHostedZones
      • route53:ListHostedZonesByName
      • route53:GetHostedZone
      • route53:ListResourceRecordSets
  • Write-Permissions (for DNS Management)
    • route53:ChangeResourceRecordSets
    • route53:GetChange
Always review the permissions granted with your security or IT team to ensure compliance with your organization’s policies.