{"id":16641951,"url":"https://github.com/crabtree/mtls-transmitter","last_synced_at":"2025-10-30T11:31:20.968Z","repository":{"id":53018440,"uuid":"182446440","full_name":"crabtree/mtls-transmitter","owner":"crabtree","description":"Reverse proxy injecting client certificate for mTLS communication","archived":false,"fork":false,"pushed_at":"2021-04-09T12:28:53.000Z","size":7,"stargazers_count":21,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-02T08:11:24.305Z","etag":null,"topics":["certificate","golang","hacktoberfest","mtls","mutual-tls","proxy","reverse-proxy","ssl","tls","tls-proxy"],"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/crabtree.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}},"created_at":"2019-04-20T19:27:31.000Z","updated_at":"2024-01-30T15:24:07.000Z","dependencies_parsed_at":"2022-09-12T22:00:48.510Z","dependency_job_id":null,"html_url":"https://github.com/crabtree/mtls-transmitter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crabtree%2Fmtls-transmitter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crabtree%2Fmtls-transmitter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crabtree%2Fmtls-transmitter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crabtree%2Fmtls-transmitter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crabtree","download_url":"https://codeload.github.com/crabtree/mtls-transmitter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238960292,"owners_count":19559239,"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":["certificate","golang","hacktoberfest","mtls","mutual-tls","proxy","reverse-proxy","ssl","tls","tls-proxy"],"created_at":"2024-10-12T07:48:21.474Z","updated_at":"2025-10-30T11:31:20.356Z","avatar_url":"https://github.com/crabtree.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mtls-transmitter\n\nmtls-transmitter is a simple reverse proxy that injects client certificate for mTLS communication. It creates a reverse proxy that injects client certificate to incomming http requests and routes them to the https endpoint.\n\n## Building the binary\n\n```bash\n$ go build -o mtls-transmitter ./cmd/transmitter\n```\n\n## Running the binary\n\n```bash\n$ ./mtls-transmitter -cert=/path/to/cert.pem -key=/path/to/key.pem -url=desired.host.com [-port=8080] [-skip-ssl]\n```\n\n### Parameters\nParameters can also be set as flags or as environment variables, with flags\nattempting to take precedence.\n\n| Flag | Env Var | Description |\n| --- | --- | --- |\n| `-cert` | `CERT` | The path to the client certificate; **required** |\n| `-key` | `KEY` | The path to the client certificate key; **required** |\n| `-url` | `URL` | The `hostname:port` to which the proxy fowards requests; **required** |\n| `-port` | `PORT` | The port on which the proxy listens on; default: `8080` |\n| `-skip-ssl` | `SKIP_SSL` | If set to `true`, the proxy sill skip server certificate verification; default: `false` |\n| `-silent` | `SILENT` | If set to `true`, the proxy will not log proxied events; default: `false` |\n\n## Running inside the docker container\n\n### Building\n\n```bash\n$ docker build -t crabtree/mtls-transmitter .\n```\n\n### Running\n\n\u003e**NOTE:** To run mtls-transmitter inside the docker container you need to provide your client certificate to your container.\n\n```bash\n$ docker run --rm -v /path/to/cert-dir:/cert -p 8080:8080 crabtree/mtls-transmitter -cert /cert/cert.pem -key /cert/key.pem -url desired.host.com\n```\n\n## Development\n\nUse the following:\n```bash\nmake          # to format and validate changes\nmake build    # to build the binary\n```\n\nSee the [Makefile](Makefile) for additional options.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrabtree%2Fmtls-transmitter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrabtree%2Fmtls-transmitter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrabtree%2Fmtls-transmitter/lists"}