{"id":24867157,"url":"https://github.com/hmaier-dev/topo-tool","last_synced_at":"2025-09-09T21:56:09.396Z","repository":{"id":183972463,"uuid":"663374139","full_name":"hmaier-dev/topo-tool","owner":"hmaier-dev","description":"combining info from network-access-control plus mac-address-tables, to inventory the topology","archived":false,"fork":false,"pushed_at":"2024-04-25T08:30:19.000Z","size":143,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T20:14:23.238Z","etag":null,"topics":["clearpass-api","comware","mac-address","network","ssh"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hmaier-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-07-07T06:42:48.000Z","updated_at":"2024-12-08T21:01:31.000Z","dependencies_parsed_at":"2023-10-20T17:45:39.482Z","dependency_job_id":null,"html_url":"https://github.com/hmaier-dev/topo-tool","commit_stats":null,"previous_names":["hmaier-dev/topo-tool"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hmaier-dev/topo-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmaier-dev%2Ftopo-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmaier-dev%2Ftopo-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmaier-dev%2Ftopo-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmaier-dev%2Ftopo-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hmaier-dev","download_url":"https://codeload.github.com/hmaier-dev/topo-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmaier-dev%2Ftopo-tool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261073337,"owners_count":23105639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["clearpass-api","comware","mac-address","network","ssh"],"created_at":"2025-02-01T01:56:57.353Z","updated_at":"2025-06-21T06:05:54.322Z","avatar_url":"https://github.com/hmaier-dev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# topo-tool\nThis tool pulls mac-addresses from a list of **HPE7-Comware-Switches** \nand compares them with those saved on a **Aruba-Clearpass** (**N**etwork**A**ccess**C**ontrol).\n\nFrom this comparison, the program can allocate which **switch-port** belongs to which **hostname**.\n\nI wrote this tool, because I was instructed to inventory the location all computers at work. Even though I could not figure out the exact room, with this tool I could get the house in which the device is standing. \nThis was a huge time save for me. \n\n## Running without docker\nBefore running this tool you need several setup/in-mind:\n\n- You **need** a network-connection to **comware-switches** and to a **clearpass-api**. \n\n- username + password for the switches and the clearpass (create an api-reader)\n\n- `data/cred.txt` containing the credentials, which looks like the following.\n\n```` txt\n## Clearpass API-User\napi_user=\u003cuser\u003e\napi_password=\u003cpassword\u003e\n\n## User for Comware-Switches\nsw_user=\u003cuser\u003e\nsw_password=\u003cpassword\u003e\n````\n\n- A mysql/mariadb-database called `topology-tool` setup from `db/setup.sql`. \n- latest htmx-library in `web/js/htmx.min.js`\n\n  - Linux: `wget https://unpkg.com/htmx.org@1.9.4/dist/htmx.min.js \u003e web/js/htmx.min.js  `\n  - Windows: `(wget https://unpkg.com/htmx.org@1.9.4/dist/htmx.min.js).Content | Out-File -Path web/js/htmx.min.js  `\n\n\n### Web-Interface\nYou can run/build the `web/server.go` to get a web-interface for searching through the database. \nThe address is `localhost:8181/topotool`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmaier-dev%2Ftopo-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmaier-dev%2Ftopo-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmaier-dev%2Ftopo-tool/lists"}