{"id":13572863,"url":"https://github.com/jreisinger/checkip","last_synced_at":"2026-01-31T03:12:07.844Z","repository":{"id":44816354,"uuid":"257377038","full_name":"jreisinger/checkip","owner":"jreisinger","description":"Get (security) info about IP addresses","archived":false,"fork":false,"pushed_at":"2025-10-28T17:43:22.000Z","size":6621,"stargazers_count":238,"open_issues_count":3,"forks_count":25,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-10-28T19:24:16.546Z","etag":null,"topics":["cli","go","ipaddress","security","tool"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jreisinger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-04-20T19:00:20.000Z","updated_at":"2025-10-28T17:42:46.000Z","dependencies_parsed_at":"2024-02-14T13:45:53.177Z","dependency_job_id":"ae09bd6a-cda7-4f46-ada3-ba540f743a53","html_url":"https://github.com/jreisinger/checkip","commit_stats":null,"previous_names":["jreisinger/geoip"],"tags_count":152,"template":false,"template_full_name":null,"purl":"pkg:github/jreisinger/checkip","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreisinger%2Fcheckip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreisinger%2Fcheckip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreisinger%2Fcheckip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreisinger%2Fcheckip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jreisinger","download_url":"https://codeload.github.com/jreisinger/checkip/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jreisinger%2Fcheckip/sbom","scorecard":{"id":536614,"data":{"date":"2025-08-11","repo":{"name":"github.com/jreisinger/checkip","commit":"e0bd66b27ec64fbae25c23481cccb1fdf0d28456"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.4,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 1/24 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/test-release.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/test-release.yml:7: update your workflow using https://app.stepsecurity.io/secureworkflow/jreisinger/checkip/test-release.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test-release.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/jreisinger/checkip/test-release.yml/master?enable=pin","Info:   0 out of   2 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.48.5 not signed: https://api.github.com/repos/jreisinger/checkip/releases/213112523","Warn: release artifact v0.48.4 not signed: https://api.github.com/repos/jreisinger/checkip/releases/211879717","Warn: release artifact v0.48.3 not signed: https://api.github.com/repos/jreisinger/checkip/releases/211878438","Warn: release artifact v0.48.0 not signed: https://api.github.com/repos/jreisinger/checkip/releases/211864210","Warn: release artifact v0.47.7 not signed: https://api.github.com/repos/jreisinger/checkip/releases/191974697","Warn: release artifact v0.48.5 does not have provenance: https://api.github.com/repos/jreisinger/checkip/releases/213112523","Warn: release artifact v0.48.4 does not have provenance: https://api.github.com/repos/jreisinger/checkip/releases/211879717","Warn: release artifact v0.48.3 does not have provenance: https://api.github.com/repos/jreisinger/checkip/releases/211878438","Warn: release artifact v0.48.0 does not have provenance: https://api.github.com/repos/jreisinger/checkip/releases/211864210","Warn: release artifact v0.47.7 does not have provenance: https://api.github.com/repos/jreisinger/checkip/releases/191974697"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 8 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T07:09:44.820Z","repository_id":44816354,"created_at":"2025-08-20T07:09:44.820Z","updated_at":"2025-08-20T07:09:44.820Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28928060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T02:59:34.861Z","status":"ssl_error","status_checked_at":"2026-01-31T02:59:05.369Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","go","ipaddress","security","tool"],"created_at":"2024-08-01T15:00:22.551Z","updated_at":"2026-01-31T03:12:07.837Z","avatar_url":"https://github.com/jreisinger.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"[![Go Reference](https://pkg.go.dev/badge/github.com/jreisinger/checkip.svg)](https://pkg.go.dev/github.com/jreisinger/checkip)\n[![Go Report Card](https://goreportcard.com/badge/github.com/jreisinger/checkip)](https://goreportcard.com/report/github.com/jreisinger/checkip)\n[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)\n\n# checkip\n\nSometimes I come across an IP address, reviewing logs for example, and I want to know more about this numerical label. Checkip is CLI tool and Go [library](https://pkg.go.dev/github.com/jreisinger/checkip/check) that provides (security) information on IP addresses. It runs various checks to get the information. Most checks are passive, i.e. not interacting directly with the IP address. Active checks, like ping and tls, are not aggressive.\n\n## Quick start\n\n```\n$ go install github.com/jreisinger/checkip@latest\n$ checkip 1.1.1.1 91.228.166.47\n--- 1.1.1.1 ---\ndb-ip.com       Sydney, Australia\ndns name        one.one.one.one\niptoasn.com     CLOUDFLARENET\nis on AWS       false\nisc.sans.edu    attacks: 0, abuse contact: abuse@cloudflare.com\nping            0% packet loss (5/5), avg round-trip 4 ms\ntls             TLS 1.3, exp. 2026/01/21, cloudflare-dns.com, *.cloudflare-dns.com, one.one.one.one\nvirustotal.com  network: 1.1.1.0/24, SAN: cloudflare-dns.com, *.cloudflare-dns.com, one.one.one.one, 1.0.0.1, 1.1.1.1, 162.159.36.1, 162.159.46.1, 2606:4700:4700::1001, 2606:4700:4700::1111, 2606:4700:4700::64, 2606:4700:4700::6400\nmalicious prob. 0% (0/12) ✅\n--- 91.228.166.47 ---\ndb-ip.com       Petržalka, Slovakia\ndns name        skh1-webredir01-v.eset.com\niptoasn.com     ESET-AS\nis on AWS       false\nisc.sans.edu    attacks: 0, abuse contact: domains@eset.sk\nping            0% packet loss (5/5), avg round-trip 5 ms\ntls             TLS 1.3, exp. 2024/01/02!!, www.eset.com, eset.com\nvirustotal.com  network: 91.228.164.0/22, SAN: www.eset.com, eset.com\nmalicious prob. 17% (2/12) 🤏\n```\n\n## More usage examples\n\nUse detailed JSON output to filter out those checks that consider the IP address to be malicious:\n\n```\ncheckip -j 91.228.166.47 | jq '.checks[] | select(.ipAddrIsMalicious == true)'\n```\n\nCheck multiple IP addresses coming from STDIN:\n\n```\ndig +short eset.sk | checkip\n```\n\nContinuously generate [random IP addresses](https://github.com/jreisinger/checkip/blob/master/randip) and check them (hit Ctrl-C to stop):\n\n```\nwhile true; do ./randip; sleep 2; done | checkip 2\u003e /dev/null\n```\n\nGenerate 100 random IP addresses and select Russian or Chinese:\n\n```\n./randip 100 | checkip -p 20 -j 2\u003e /dev/null | \\\njq -r '.ipAddr as $ip | .checks[] | select (.description == \"db-ip.com\" and (.ipAddrInfo.iso_code == \"RU\" or .ipAddrInfo.iso_code == \"CN\")) | $ip'\n```\n\nFind out who is trying to SSH into your Linux system:\n\n```\nsudo journalctl --unit ssh --since \"1 hour ago\" | \\\ngrep 'Bye Bye' | perl -wlne '/from ([\\d\\.]+)/ \u0026\u0026 print $1' | sort | uniq | \\\ncheckip 2\u003e /dev/null\n```\n\n## Installation\n\nTo install the CLI tool\n\n```\n# optional; to install inside a container\ndocker run --rm -it golang /bin/bash\n\ngo install github.com/jreisinger/checkip@latest\n```\n\nor download a [release](https://github.com/jreisinger/checkip/releases) binary (from under \"Assets\") for your system and architecture.\n\n## Configuration and cache\n\nFor some checks to start working you need to sign up on a web site (like https://www.abuseipdb.com) and get an API (or LICENSE) key. Checkip doesn't report an absent API key as an error; the check is simply not executed and `missingCredentials` JSON field is set to the name of the API key (like `ABUSEIPDB_API_KEY`).\n\nStore the keys in `$HOME/.checkip.yaml` file:\n\n```\nABUSEIPDB_API_KEY: aaaaaaaabbbbbbbbccccccccddddddddeeeeeeeeffffffff11111111222222223333333344444444\nMAXMIND_LICENSE_KEY: abcdef1234567890\nSHODAN_API_KEY: aaaabbbbccccddddeeeeffff11112222\nURLSCAN_API_KEY: abcd1234-a123-4567-678z-a2b3c4b5d6e7\nVIRUSTOTAL_API_KEY: aaaaaaaabbbbbbbbccccccccddddddddeeeeeeeeffffffff1111111122222222\n```\n\nYou can also use environment variables with the same names.\n\nData used by some checks is downloaded (cached) to `$HOME/.checkip/` folder. Is gets periodically re-downloaded so it is fresh.\n\n## Development\n\nCheckip is easy to extend. If you want to add a new way of checking IP addresses:\n\n1. Write a function of type [check.Func](https://pkg.go.dev/github.com/jreisinger/checkip/check#Func).\n2. Add it to [check.Funcs](https://pkg.go.dev/github.com/jreisinger/checkip/check#Funcs) variable.\n\nTypical workflow:\n\n```\nmake run # test and run\n\ngit commit\n\ngit tag | sort -V | tail -1\ngit tag -a v0.2.0 -m \"new check func\"\n\ngit push --follow-tags # will build a new release on GitHub\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjreisinger%2Fcheckip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjreisinger%2Fcheckip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjreisinger%2Fcheckip/lists"}