⭐ Add provider ipinfo #6176

Bajusz15 · 2025-11-13T17:16:21Z

Adds ipinfo provider. Initially I added functionality to route the request through an interface, but after alignment we decided to keep it simple, ipinfo can be used to query ipinfo.io for any ip.

If the envrionment variable IPINFO_TOKEN is set we can use the paid sdk version, otherwise we fall back to the free deprecated API (simply calling ipinfo.io/).

To get public IP of the machine we are running ipinfo from, we need to call ipinfo with an empty address.

Usage:

go run ./apps/cnquery/cnquery.go run -c "ipinfo(ip('1.1.1.1'))"
ipinfo: ipinfo returned_ip=1.1.1.1 hostname="one.one.one.one" bogon=false
 
go run ./apps/cnquery/cnquery.go run -c "ipinfo"   
ipinfo: ipinfo returned_ip=95.XX.XXX.19 hostname="REDACTED.kabel-deutschland.de" bogon=false

go run ./apps/cnquery/cnquery.go run -c "ipinfo(ip('192.168.178.86'))"
ipinfo: ipinfo returned_ip=192.168.178.86 hostname="" bogon=true

go run ./apps/cnquery/cnquery.go run -c "network.routes.defaults.map(iface.ips.map(_.ip)).flat.map(ipinfo(_){*})"
.....

github-actions · 2025-11-13T17:19:16Z

Test Results

4 574 tests ±0 4 570 ✅ ±0 2m 15s ⏱️ -15s
409 suites ±0 4 💤 ±0
30 files ±0 0 ❌ ±0

Results for commit 75fe0d1. ± Comparison against base commit 8a0946d.

♻️ This comment has been updated with latest results.

chris-rock

Great first version @Bajusz15 I added some feedback

chris-rock · 2025-11-13T21:13:56Z

providers/ipinfo/config/config.go

+var Config = plugin.Provider{
+	Name:    "ipinfo",
+	ID:      "go.mondoo.com/cnquery/v12/providers/ipinfo",
+	Version: "10.0.0",


should be version 12

chris-rock · 2025-11-13T21:14:13Z

providers/ipinfo/config/config.go

+	Connectors: []plugin.Connector{
+		{
+			Name:      "ipinfo",
+			Use:       "ipinfo",


proper description required

chris-rock · 2025-11-13T21:15:07Z

providers/ipinfo/go.mod

+
+go 1.25.1
+
+require go.mondoo.com/cnquery/v12 v12.9.0


should be a relative import similar to the other providers

providers/ipinfo/resources/ipinfo.go

providers/ipinfo/main.go

chris-rock · 2025-11-13T21:19:00Z

providers/ipinfo/resources/ipinfo.go

+		url = "https://ipinfo.io"
+	} else {
+		// Query for specific IP
+		url = fmt.Sprintf("https://ipinfo.io/%s", queryIP.String())


any reason why we are not using https://github.com/ipinfo/go? This would also help us to implement the token support.

It was not working without a real token when I was testing it locally. I removed it in this commit, but this is still an early draft and needs lot of rework. If I can find a way to use the sdk without a real token I will change it back.

Empty token works without any problem:

const token = "" // params: httpClient, cache, token. `http.DefaultClient` and no cache will be used in case of `nil`. client := ipinfo.NewClient(nil, nil, token) const ip_address = "8.8.8.8" info, err := client.GetIPInfo(net.ParseIP(ip_address)) if err != nil { panic(err) } fmt.Println(info)

go.mod

chris-rock · 2025-11-20T17:46:45Z

providers/ipinfo/resources/ipinfo.go

+)
+
+// getIPInfoToken returns the IPINFO_TOKEN from environment variable, cached after first read
+func getIPInfoToken() string {


This should be done when we start the connection, then we also do not need to use locks https://github.com/mondoohq/cnquery/pull/6176/files#diff-59130fb879bd3dcc44bb675d913b5a3f8019f8cc4f814d53bcc0f4ea39b0ab5aR18-R28

chris-rock · 2025-11-20T17:48:10Z

providers/ipinfo/README.md

+
+This provider makes public IP address information accessible from ipinfo.io.
+
+It provides a connector for querying IP information via the ipinfo.io API.


We should add examples here how to use it and also include sample MQL. https://github.com/mondoohq/cnquery/tree/main/providers/shodan is a good example

I specifically would also love to see some examples that use the cross provider connection eg. with local interface.

Updated readme now

chris-rock · 2025-11-20T17:54:47Z

.github/actions/spelling/excludes.txt

 ^\.github/workflows/.*\.yaml
 _release_template_file.md
 ignore$
+ipinfo


This PR should merge into main, not another branch

chris-rock · 2025-11-20T17:58:27Z

providers/ipinfo/resources/ipinfo.go

+		url = "https://ipinfo.io"
+	} else {
+		// Query for specific IP
+		url = fmt.Sprintf("https://ipinfo.io/%s", queryIP.String())


Empty token works without any problem:

const token = "" // params: httpClient, cache, token. `http.DefaultClient` and no cache will be used in case of `nil`. client := ipinfo.NewClient(nil, nil, token) const ip_address = "8.8.8.8" info, err := client.GetIPInfo(net.ParseIP(ip_address)) if err != nil { panic(err) } fmt.Println(info)

Bajusz15 changed the title ~~Add resource ipinfo~~ New provider ipinfo Nov 13, 2025

This comment has been minimized.

Sign in to view

chris-rock reviewed Nov 13, 2025

View reviewed changes

chris-rock reviewed Nov 20, 2025

View reviewed changes

go.mod Outdated Show resolved Hide resolved

Bajusz15 changed the title ~~New provider ipinfo~~ Add new provider ipinfo Nov 20, 2025

Bajusz15 marked this pull request as ready for review November 20, 2025 12:35

Bajusz15 changed the title ~~Add new provider ipinfo~~ ⭐ Add provider ipinfo Nov 20, 2025

chris-rock reviewed Nov 20, 2025

View reviewed changes

Bajusz15 added 18 commits November 20, 2025 20:11

init ipinfo

ee9d614

wip

44d9957

wip

49956ce

wip

2c5b75a

refactor

b1744ed

wip

e491f09

wip

c618957

wip

c044f60

state before discarding interface based routing

50f5c98

ipinfo simple

fb98791

refactor

f924b58

add readme

6c753ed

add license

f505db2

fixes

2f795a3

fixes

bebe163

refactor

f42ca75

add examples + default provider

e65ca36

readme

4fe5b09

Bajusz15 changed the base branch from mate/849/ipv4v6 to main November 20, 2025 19:12

Bajusz15 force-pushed the mate/849/externalIP branch from 338d9e3 to 4fe5b09 Compare November 20, 2025 19:13

PR comments

75fe0d1


		This provider makes public IP address information accessible from ipinfo.io.

		It provides a connector for querying IP information via the ipinfo.io API.

⭐ Add provider ipinfo #6176

Are you sure you want to change the base?

⭐ Add provider ipinfo #6176

Uh oh!

Conversation

Bajusz15 commented Nov 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment has been minimized.

github-actions bot commented Nov 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Results

Uh oh!

This comment has been minimized.

chris-rock left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Bajusz15 commented Nov 13, 2025 •

edited

Loading

github-actions bot commented Nov 13, 2025 •

edited

Loading