{"id":27610535,"url":"https://github.com/johnpcarter/c8yconnector","last_synced_at":"2026-02-12T14:33:26.673Z","repository":{"id":136321854,"uuid":"332420299","full_name":"johnpcarter/c8yConnector","owner":"johnpcarter","description":"webMethods package for accessing your Cumulocity tenant","archived":false,"fork":false,"pushed_at":"2022-09-29T15:46:28.000Z","size":362,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-21T02:47:45.652Z","etag":null,"topics":["cumulocity","cumulocity-agent","webmethods"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/johnpcarter.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-01-24T10:28:00.000Z","updated_at":"2022-09-29T15:46:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"5a1af2dc-5ff3-49e9-a789-259a123dc21b","html_url":"https://github.com/johnpcarter/c8yConnector","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/johnpcarter/c8yConnector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnpcarter%2Fc8yConnector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnpcarter%2Fc8yConnector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnpcarter%2Fc8yConnector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnpcarter%2Fc8yConnector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnpcarter","download_url":"https://codeload.github.com/johnpcarter/c8yConnector/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnpcarter%2Fc8yConnector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29368692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: 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":["cumulocity","cumulocity-agent","webmethods"],"created_at":"2025-04-22T23:29:21.502Z","updated_at":"2026-02-12T14:33:26.643Z","avatar_url":"https://github.com/johnpcarter.png","language":"HTML","readme":"##c8yConnector\n\nProvides a set of services to allow access to your c8y tenant. Use in conjunction with your webMethods based agents to integrate any device type with Cumulocity. \nThe services are documented in Designer under the comments section of each service and from the packages [home](http://localhost:5555/c8yConnector) directory /c8yConnector. You can also view [online](https://raw.githack.com/johnpcarter/c8yConnector/main/pub/index.html).\n\n**Installation**\n\nThis source code is a webMethods Micro Service Runtime package and you will need to first install the Software AG Micro Service Runtime or download a docker image.\n\n**local installation**\n\nIf you have an Integration Server or Micro Service Runtime running locally for development purposes, first navigate to your packages directory;\n\n*$cd /${SAG_HOME}/IntegrationServer/packages*  \nor\n*$cd /${SAG_HOME}/IntegrationServer/instances/${INSTANCE}/packages*  \n\nIf your packages directory is already under version control\n\n*$git submodule add https://github.com/johnpcarter/c8yConnector.git c8yConnector.git*  \n\nor if you are not, then simply clone the repository\n\n*$git clone https://github.com/johnpcarter/c8yConnector.git*  \n\nThen download dependent packages\n\n*$git clone https://github.com/johnpcarter/JcPublicTools.git*  \n\nThen restart your runtime server and refresh your package browser in Designer.\n\n**Docker Installation**\n\nA predefined Dockerfile template has been provided in the resources directory. It is recommended that you copy the directory\nand then update Dockerfile and aclmap_sm.cnf file appropriately.\n\ncd into your directory and download the latest source code\n\n*$ cd ${WORKING_DIR}*  \n\n*$ git clone https://github.com/johnpcarter/c8yConnector.git*  \n*$ git clone https://github.com/johnpcarter/JcPublicTools.git*  \n\nYou will also need to add your own packages and configuration as part of the build by copying the following line into the section 'add YOUR packages here'\ne.g.\n\n*ADD --chown=sagadmin ./c8yPhilipsHueAgent /opt/softwareag/IntegrationServer/packages/c8yPhilipsHueAgent*  \n\nand also update the ./resources/aclmap_sm.cnf file to include permissions for any the services that you are exposing through an API.\n\nYou could also choose to include your MSR license file by adding the following line\n\n*ADD --chown=sagadmin .licenseKey.xml /opt/softwareag/IntegrationServer/config/licenseKey.xml*  \n\nYou can now build your image\n\n*$ docker build -t ${YOUR DOCKER IMAGE} .*  \n\n**Preparing the Micro Service zip file for your tenant**\n\nYou will need to export the newly build image as a tar file and then zip it with the provided cumulocity.json file before uploading to your tenant\n\n*$ docker save -o image.tar ${YOUR DOCKER IMAGE}*  \n*$ zip ${c8y_app_name} cumulocity.json image.tar*\n\n**Uploading the Micro Service agent to your Cumulocity tenant**\n\nLogin in to your Cumulocity tenant and select the \"Administration\" app, then from the left hand side menu \"Applications\", \"Own Applications\" and then click \"Add application\". Choose \"Upload microservice\"and select the zip that you created before.\n\nAlternatively you can upload the image from the command line using the 'cumulocity-microservice.sh' script with\n\n*$ ./cumulocity-microservice.sh deploy -n philips-hue-agent -u \u003cYOUR_LOGIN\u003e -p \u003cYOUR_PASSWORD\u003e -d https://www.cumulocity.com -te \u003cTENANT_ID\u003e*  \n\nOnce uploaded, make sure that you subscribe to the app in order to start it up and activate it.\n\nFor more information refer to the Cumulocity documentation on [Micro Service Runtime](https://cumulocity.com/guides/microservice-sdk/concept/#microservice-runtime)\n\n**Starting up the agent remotely**\n\nYou can also use the agent from your own development environment or run the docker image outside of your tenant if you wish.\nYou will need to set the bootstrap credentials or set the c8y user in your local environment.\n\nYou can obtain your bootstrap credentials via the following api call\n\n*$ curl \"https://\u003cTENTANT_NAME\u003e.cumulocity.com/application/applications/\u003cAPP_ID\u003e/bootstrapUser\" \\\n -u '\u003cYOUR_USER\u003e:\u003cYOUR_PASSWORD\u003e'*\n\nFrom your local environment, run the service\n\n*jc.cumulocity.tools.app:setCredentials*  \n\nand either provide your own credentials via the C8Y_TENANT, C8Y_USER and C8Y_PASSWORD inputs, or you want to use the app's credentials provide \nthe 'C8Y_BOOSTRAP_TENANT', 'C8Y_BOOTSTRAP_USER' and 'C8Y_BOOTSTRAP_PASSWORD' inputs. Reload your own agent package to ensure scheduled jobs or listeners work properly.\n\nIf you want to run the docker image independently then set the following environment variables when starting up the container\n\n*-e C8Y_BOOTSTRAP_TENANT=''*\n*-e C8Y_BOOTSTRAP_USER=''*\n*-e C8Y_BOOTSTRAP_PASSWORD=''*\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnpcarter%2Fc8yconnector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnpcarter%2Fc8yconnector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnpcarter%2Fc8yconnector/lists"}