checkip.cloud

checkip.cloud is a simple web interface and API implementation of for cloud_ip_checker.py. It is implemented in Docker. This is the system behind the publicly available service checkip.cloud. This repository is associated with the following repository:

• cloud_ip_checker.py is the logic behind this web implementation.

Data Sources

checkip.cloud queries against the following providers:

• Amazon Web Services (AWS)
• Google Services
• Google Cloud Platform (GCP)
• Microsoft Azure
• Microsoft 365 (M365)
• Oracle Cloud Infrastructure (OCI)
• Digital Ocean
• Linode
• Cloudflare
• Fastly

See cloud_ip_checker.py for more information on where this data comes from and how the data sources can be updated.

Web UI

The web UI is simple. It takes an IP as input and prints output in a simple HTML table.

API

The API endpoint is available at /api/ip/<ip here>. A JSON object is returned to the query. Errors are returned if the IP is not found or if the input is not an IP address.

Below is an example of the JSON output of a query using curl.

curl -s http://<host>/api/ip/2620:1ec:4::152 | jq
{
  "ip": "2620:1ec:4::152",
  "matches": [
    {
      "provider": "Azure",
      "cidr": "2620:1ec:4::/46",
      "service": "AzureFrontDoor.FirstParty",
      "changeNumber": 20,
      "region": "",
      "regionId": 0,
      "platform": "Azure",
      "systemService": "AzureFrontDoor",
      "networkFeatures": [
        "API",
        "NSG",
        "UDR",
        "FW"
      ]
    },
    {
      "provider": "M365",
      "cidr": "2620:1ec:4::152/128",
      "serviceArea": "Exchange",
      "serviceAreaDisplayName": "Exchange Online",
      "id": 1,
      "urls": [
        "outlook.cloud.microsoft",
        "outlook.office.com",
        "outlook.office365.com"
      ],
      "tcpPorts": "80,443",
      "udpPorts": "443",
      "expressRoute": true,
      "category": "Optimize"
    },
    {
      "provider": "M365",
      "cidr": "2620:1ec:4::152/128",
      "serviceArea": "Exchange",
      "serviceAreaDisplayName": "Exchange Online",
      "id": 2,
      "urls": [
        "outlook.office365.com",
        "smtp.office365.com"
      ],
      "tcpPorts": "143, 587, 993, 995",
      "expressRoute": true,
      "category": "Allow",
      "notes": "POP3, IMAP4, SMTP Client traffic"
    }
  ]
}