{"id":42392343,"url":"https://github.com/waggle-sensor/beekeeper","last_synced_at":"2026-01-28T00:19:08.530Z","repository":{"id":40981068,"uuid":"290302262","full_name":"waggle-sensor/beekeeper","owner":"waggle-sensor","description":"Management and administrative cloud services for Waggle.","archived":false,"fork":false,"pushed_at":"2024-01-09T17:09:58.000Z","size":465,"stargazers_count":1,"open_issues_count":6,"forks_count":4,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-01-10T03:09:32.776Z","etag":null,"topics":["beekeeper","cloud"],"latest_commit_sha":null,"homepage":"","language":"Python","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/waggle-sensor.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}},"created_at":"2020-08-25T19:14:52.000Z","updated_at":"2024-01-10T03:09:32.777Z","dependencies_parsed_at":"2024-01-09T03:19:07.111Z","dependency_job_id":null,"html_url":"https://github.com/waggle-sensor/beekeeper","commit_stats":null,"previous_names":[],"tags_count":10,"template":null,"template_full_name":null,"purl":"pkg:github/waggle-sensor/beekeeper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waggle-sensor%2Fbeekeeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waggle-sensor%2Fbeekeeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waggle-sensor%2Fbeekeeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waggle-sensor%2Fbeekeeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waggle-sensor","download_url":"https://codeload.github.com/waggle-sensor/beekeeper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waggle-sensor%2Fbeekeeper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28828607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T23:29:49.665Z","status":"ssl_error","status_checked_at":"2026-01-27T23:25:58.379Z","response_time":168,"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":["beekeeper","cloud"],"created_at":"2026-01-28T00:19:07.868Z","updated_at":"2026-01-28T00:19:08.525Z","avatar_url":"https://github.com/waggle-sensor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Beekeeper Server\n\nThe beekeeper server is the administration server for the cyberinfrastructure.\nAll nodes must register with the beekeeper in order to be added to the ecosystem.\n\nThe beekeeper is responsible for the following:\n1. front end for provisioning and administrative management of all nodes\n2. certificate authority responsible for generating and validating all\ncommunication keys used by the nodes (i.e. services running on them)\n3. administrative portal for collecting the general health of all nodes\n\n\n## start beekeeper\n\n```bash\ndocker run --rm -it \\\n    -v ${PWD}:/workdir:rw \\\n    waggle/beekeeper-key-tools:latest \\\n    create-init-keys.sh -p -o beekeeper-keys\ndocker run --rm -it \\\n    -v ${PWD}:/workdir:rw \\\n    waggle/beekeeper-key-tools:latest \\\n    create-key-cert.sh \\\n    -b my-beehive \\\n    -c beekeeper-keys/bk-ca/beekeeper_ca_key \\\n    -k beekeeper-keys/node-registration-key/registration \\\n    -o beekeeper-keys/registration_certs/untilforever\ndocker-compose up --build\n```\n\n\u003e Note: the above options are for testing only and should not be used in production.\n\n# Register a beehive with beekeeper (example)\n\n1) The first step creates a beehive but credentials will be missing.\n```bash\nkubectl port-forward service/beekeeper-api 5000:5000  # if needed\n\ncurl localhost:5000/beehives -d '{\"id\": \"my-beehive\", \"key-type\": \"rsa-sha2-256\", \"rmq-host\":\"host\", \"rmq-port\": 5, \"upload-host\":\"host\", \"upload-port\": 6}'\n```\nVerify:\n```bash\ncurl localhost:5000/beehives | jq .\n```\n\n2) Create beehive (not beekeeper) CA credentials: [https://github.com/waggle-sensor/waggle-pki-tools](https://github.com/waggle-sensor/waggle-pki-tools)\n\n3) Add credentials for beehive to beekeeper\n```bash\ncd test-data/beehive_ca\ncurl -F \"tls-key=@tls/cakey.pem\" -F \"tls-cert=@tls/cacert.pem\"  -F \"ssh-key=@ssh/ca\" -F \"ssh-pub=@ssh/ca.pub\" -F \"ssh-cert=@ssh/ca-cert.pub\"  localhost:5000/beehives/my-beehive\n```\n\nVerify\n```bash\ncurl localhost:5000/beehives/my-beehive | jq .\n```\n# assign node to a beehive\n\nThe next set of commands will only work once the node has registered.\n\nVSN can be obtained from the node by:\n```bash\ncurl localhost:5000/node/0000000000000001 -d '{\"vsn\": true}'\n```\nGetting the VSN can be done before or after the assignment of beehive or deploying the wes services.\n\n```bash\ncurl localhost:5000/node/0000000000000001 -d '{\"assign_beehive\": \"my-beehive\"}'\ncurl localhost:5000/node/0000000000000001 -d '{\"deploy_wes\": true}'\n```\n\nCheck the logs:\n```bash\ndocker logs beekeeper_bk-api_1\n```\n\nSSH to the node (via reverse ssh tunnel)\n```bash\nssh -i ./beekeeper-keys/node-ssh-key/nodes.pem -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -o IdentitiesOnly=true -o ProxyCommand=\"ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no root@localhost -p 2201 -i ./beekeeper-keys/bk-admin-ssh-key/admin.pem  netcat -U /home_dirs/node-0000000000000001/rtun.sock\" root@foo\n```\n\n\n# Node registration example:\n\n\n```bash\nssh -o UserKnownHostsFile=./known_hosts  sage_registration@localhost -p 20022 -i id_rsa_sage_registration register 0000000000000001\n```\n\n\nOR within bk-config container\n```bash\nssh -o UserKnownHostsFile=./known_hosts  sage_registration@bk-sshd -p 22 -i registration_keys/id_rsa_sage_registration register 0000000000000001\n```\n\n\n`/etc/ssh/ssh_known_hosts` example:\n```text\n@cert-authority beehive.honeyhouse.one ssh-ed25519 AAAAC.....\n```\n\n\n\n# example: copy key files into vagrant\n\n```bash\ncp known_hosts register.pem register.pem-cert.pub ~/git/waggle-edge-stack/ansible/private/\n```\n\nansible will copy these files if detected\n\n# create Certs for node\n\nGot to the directory that contains your `beekeeper-keys` folder. Follow the instructions outlined at https://github.com/waggle-sensor/beekeeper-key-tools for creating a node registration certificate file.\n\n## Unit Testing\n\nUnit-testing is executed via\n- `./unit-tests.sh`\n\nRequires running docker-compose enviornment.\n\n## Development\n\n### Access MySQL Console\n\n```sh\ndocker-compose exec db mysql -u root -ptesttest -D Beekeeper\n```\n\n### Access Shell on Test Node\n\n```sh\ndocker-compose exec node1 bash\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaggle-sensor%2Fbeekeeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaggle-sensor%2Fbeekeeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaggle-sensor%2Fbeekeeper/lists"}