proxy.golang.org : github.com/jaredreisinger/sensorpush-proxy
sensorpush-proxy is a rate-limiting, authentication-hiding proxy for [SensorPush] data. ## Usage More than likely, you’ll want to use the already-built [Docker image] for this, so that you can just throw your credentials and sensor config at it and let it run behind something like Traefik or nginx. Regardless of whether you use Docker or the raw binary, `sensorpush-proxy` includes both the proxy itself and also a `query` sub-command to help you discover the sensor IDs available to you. ### Get SensorPush credentials If you have any SensorPush devices, you ought to already have an account with SensorPush. In order to activate API access, you need to sign into their [Gateway Cloud Dashboard] at least once and agree to the terms of service. Once you've done that, the username and password you use for that dashboard are the same ones you need for this proxy. Unfortunately, SensorPush does not allow you to create limited-use (and revocable) tokens to use in place of your password for API access. This proxy _**only**_ uses the password you provide in order to retrieve the sensor data you request. Use secure best practices to ensure that the configuration you pass to this proxy is kept secret/encrypted until the last possible moment. ### Get sensorpush-proxy Either `docker pull sensorpush-proxy` for the Docker image, or grab a binary distribution for your platform from [the releases page]. You can also build from source, in which case you may want to take a look at the [./CONTRIBUTING.md] documentation for more about the tooling and expected process. Note that in the below `sensorpush-proxy` command lines, you will need to use something like `docker run --rm -ti jaredreisinger/sensorpush-proxy` followed by the command-line flags, and/or with a configuration file mounted and available to the container. ### Discover sensor IDs Use the `query` subcommand with your SensorPush credentials to discover the sensor IDs available to you: You should see as output several log lines that show the name, ID, and type of the sensors on your account _(IDs shown below are not real!)_: ### Figure out your desired configuration and run the proxy `sensorpush-proxy` supports configuration by command-line flags, by environment variables, or by configuration file; use whichever form or combination of forms is the most convenient. _**However**_, please be aware of the risk of putting your SensorPush password in plaintext in any form. The generally-accepted best practice for things like passwords is to keep them as secrets in your CI/CD pipeline or container orchestration tool, and to provide them to `sensorpush-proxy` from there. That said, the examples here won’t show any use of secrets. Given the above example, let’s assume that we want to proxy the “Kitchen” (`123456.67834768348756683478`) and “Garage” (`135678.0934908340980985858`) sensors, using the names “inside” and “outside” respectively. #### As command-line flags _(Shown here across multiple lines for readability...)_ #### As environment variables #### As a config file _(in ./config.yaml, say)_ and then: ### Call the API There is only one API endpoint exposed at present, `/sensors`, which returns a JSON object keyed by the sensor names from the configuration. This example pipes through `jq` purely for prettier formatting: which results in: ## Background For further details, peruse the [./docs/background.md] and/or other documentation in the [./docs] folder. [SensorPush]:[https://www.sensorpush.com] [Docker image]:[https://hub.docker.com/r/jaredreisinger/sensorpush-proxy] [Gateway Cloud Dashboard]:[https://dashboard.sensorpush.com/] [the releases page]:[https://github.com/JaredReisinger/sensorpush-proxy/releases]
Registry
-
Source
- Documentation
- JSON
purl: pkg:golang/github.com/jaredreisinger/sensorpush-proxy
License: ISC
Latest release: 5 months ago
First release: over 2 years ago
Namespace: github.com/jaredreisinger
Stars: 0 on GitHub
Forks: 0 on GitHub
Docker dependents: 1
Docker downloads: 120
See more repository details: repos.ecosyste.ms
Last synced: 9 days ago