{"id":25423922,"url":"https://github.com/dref360/kharon","last_synced_at":"2025-08-09T09:13:26.284Z","repository":{"id":224228042,"uuid":"762765110","full_name":"Dref360/kharon","owner":"Dref360","description":"Simplify Secure App Sharing","archived":false,"fork":false,"pushed_at":"2024-08-21T14:44:39.000Z","size":1714,"stargazers_count":4,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-14T01:59:03.701Z","etag":null,"topics":["app","app-sharing-website","fastapi","react","secure"],"latest_commit_sha":null,"homepage":"https://kharon.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dref360.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-24T16:22:05.000Z","updated_at":"2024-11-03T22:43:14.000Z","dependencies_parsed_at":"2024-07-06T00:04:37.676Z","dependency_job_id":"23a9f46c-e5e3-4962-8dfb-736fa08a2721","html_url":"https://github.com/Dref360/kharon","commit_stats":null,"previous_names":["dref360/shared-science","dref360/kharon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Dref360/kharon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dref360%2Fkharon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dref360%2Fkharon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dref360%2Fkharon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dref360%2Fkharon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dref360","download_url":"https://codeload.github.com/Dref360/kharon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dref360%2Fkharon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266578623,"owners_count":23951147,"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","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":["app","app-sharing-website","fastapi","react","secure"],"created_at":"2025-02-16T22:47:13.592Z","updated_at":"2025-07-22T21:33:59.660Z","avatar_url":"https://github.com/Dref360.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n   \u003cimg src=\"docs/assets/logo.svg\", width=\"35%\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n   🚀 \u003ca href=\"https://kharon.app\"\u003ehttps://kharon.app\u003c/a\u003e 🚀\n\u003c/p\u003e\n\n\n\n**Reverse Proxy Server with Authentication and Authorization**\n\n---\n\n## Overview\n\nThis project solves the problem of sharing applications with other people around the world. This way, you can safely create dashboards with private data and share it with specific people without setting up the AuthN/Z yourself.\n\nKharon is a FastAPI-based reverse proxy server with Google Authentication. It allows you to secure your applications by requiring users to authenticate via their Google accounts before accessing web servers using an SSH tunnel.\n\n\u003cp align=\"center\"\u003e\n   \u003cimg src=\"docs/assets/diagram.png\" width=\"50%\"\u003e\n\u003c/p\u003e\n\n## Features\n\n- [x] **Google Authentication:** Users must log in with their Google accounts to access protected resources.\n- [x] **Authorization:** Authorize people to access jobs (using [Casbin](https://dev.to/teresafds/authorization-on-fastapi-with-casbin-41og) would be a great future implementation for fine-grained AuthZ).\n- [x] **FastAPI:** Utilizes the FastAPI framework for efficient and fast development.\n- [x] **API Key Management:** Users can create/delete keys.\n- [x] **KharonDaemon (KHD):** Small daemon that we can [tunnel](https://pypi.org/project/sshtunnel/) into with SSH.\n  - [x] **SSH Server (port 2222)**\n  - [x] **Automatic registration to host**\n  - [x] **Reverse Proxy:** Directs incoming requests to the appropriate backend services.\n\n### Key idea\n\nThe idea is that the proxy is done through an SSH tunnel, making the whole connection secure.\nA user goes on the website, authenticates themselves and can see jobs linked to their account. They can then access the webpage over the tunnel.\n\n### Recipes\n\n- [ ] **Gradio App:** Launch your own gradio app protected behind a Google Login.\n- [ ] **Azimuth:** Collaborate securely on improving your dataset or model using [Azimuth](github.com/ServiceNow/azimuth).\n\n## Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/Dref360/shared-science.git\n   ```\n\n2. Install the required dependencies:\n\n   ```bash\n   poetry install\n   ```\n\n## Configuration\n\n1. Create a Google Cloud Platform (GCP) project and set up the OAuth 2.0 credentials.\n\n2. Create a copy of `.env.default` named `.env` with your GCP credentials and other configuration settings.\n   1. Do the same in `webapp/.env`\n\n## Usage\n\n1. Start the FastAPI server:\n\n   ```bash\n   poetry run fastapi dev kharon/app.py\n   ```\n\n2. Start the frontend\n\n   ```bash\n   cd webapp \u0026\u0026 npm install\n   npm start\n   ```\n\n3. Access the reverse proxy at `http://localhost:8000` and follow the Google Authentication flow.\n\n## Contributing\n\nFeel free to contribute to the project by opening issues or submitting pull requests. Please make sure to follow the project's code of conduct.\n\n## License\n\nThis project is licensed under the Apache V2 License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- FastAPI: https://fastapi.tiangolo.com/\n- SQLModel: https://sqlmodel.tiangolo.com/\n\nThank you for using Kharon!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdref360%2Fkharon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdref360%2Fkharon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdref360%2Fkharon/lists"}