{"id":28190102,"url":"https://github.com/ethern-myth/secure-session-vault","last_synced_at":"2026-04-14T23:31:48.478Z","repository":{"id":293445731,"uuid":"984056522","full_name":"Ethern-Myth/secure-session-vault","owner":"Ethern-Myth","description":"A secure client-side vault for storing session data outside of localStorage or sessionStorage using self-hosting with docker","archived":false,"fork":false,"pushed_at":"2025-05-15T10:38:03.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T11:46:12.068Z","etag":null,"topics":["api","backend","docker","environment","golang","memory","nodejs","storage"],"latest_commit_sha":null,"homepage":"","language":null,"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/Ethern-Myth.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":"2025-05-15T10:27:17.000Z","updated_at":"2025-05-15T10:39:15.000Z","dependencies_parsed_at":"2025-05-15T11:56:17.729Z","dependency_job_id":null,"html_url":"https://github.com/Ethern-Myth/secure-session-vault","commit_stats":null,"previous_names":["ethern-myth/secure-session-vault"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethern-Myth%2Fsecure-session-vault","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethern-Myth%2Fsecure-session-vault/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethern-Myth%2Fsecure-session-vault/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethern-Myth%2Fsecure-session-vault/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ethern-Myth","download_url":"https://codeload.github.com/Ethern-Myth/secure-session-vault/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254509449,"owners_count":22082896,"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":["api","backend","docker","environment","golang","memory","nodejs","storage"],"created_at":"2025-05-16T10:12:03.615Z","updated_at":"2026-04-14T23:31:48.450Z","avatar_url":"https://github.com/Ethern-Myth.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Secure-session-vault\n\nA secure client-side vault for storing session data outside of localStorage or sessionStorage using self-hosting with docker.\nDesigned to work with a self-hosted Dockerized backend that protects sensitive data from XSS and other client-side attacks.\n\n\u003cbr/\u003e\n\n**Just a quick note: If previously you pulled the docker image that was ~943MB in size, a new update has been published with a compression size to ~8MB. We did just because we want a good minimal system that is easy to carry around.**\n\n\u003cbr/\u003e\n\n\n[![npm downloads](https://img.shields.io/npm/dm/secure-session-vault-client)](https://www.npmjs.com/package/secure-session-vault-client)\n\n\u003cbr/\u003e\n\n[![NPM](https://nodei.co/npm/secure-session-vault-client.png)](https://nodei.co/npm/secure-session-vault-client/)\n\n## 🔐 Features\n\n- Stores session tokens securely via a local vault microservice.\n- Avoids `localStorage`/`sessionStorage` vulnerabilities.\n- ESM compatible, reusable NPM package.\n- Auto-discovers Docker-hosted vault via default hostnames or manual URL injection.\n- Self-hosting with docker.\n\n## 🚀 Installation\n\n```bash\nnpm install secure-session-vault-client\n OR\n yarn add secure-session-vault-client\n OR\n pnpm install secure-session-vault-client\n```\n\n## ⚙️ Vault Backend\nRun the backend using Docker, the backend is available on docker hub at[Docker Hub](https://hub.docker.com/r/ethernmyth/secure-session-vault):\n\n```bash\ndocker run -p 17000:17000 ethernmyth/secure-session-vault:latest\n```\n\nOr include it in your Docker Compose setup with:\n\n```yaml\nservices:\n  vault:\n    image: ethernmyth/secure-session-vault:latest\n    ports:\n      - \"17000:17000\"\n```\n\n## 🛠️ Usage\n\nThis was built with access for node supported project and the backend can be accessed independently as well:\n\n```typescript\nimport { SecureSessionVault } from \"secure-session-vault-client\";\n\nconst vault = new SecureSessionVault(); // Or pass a custom vault URL\n\nawait vault.setItem(\"accessToken\", \"abc123\");\nconst token = await vault.getItem(\"accessToken\");\nawait vault.removeItem(\"accessToken\");\n```\n\n2. **Access the Vault API**\n\nStore a value:\n\n```bash\ncurl -X POST \"http://localhost:17000/vault?key=session\u0026value=abc123\"\n```\n\nRetrieve it:\n\n```bash\ncurl \"http://localhost:17000/vault?key=session\"\n```\n\nDelete it:\n\n```bash\ncurl -X DELETE \"http://localhost:17000/vault?key=session\"\n```\n\n## 🌐 Default Fallback URLs\nThe client will try the following in order:\n\nhttp://localhost:17000\n\nhttp://127.0.0.1:17000\n\nhttp://host.docker.internal:17000\n\n---\n\nYou can override with:\n\n```typescript\nnew SecureSessionVault(\"http://custom-ip-or-host:17000\");\n```\n\n\n## 👤 Author\n\nCreated and Maintained by: [Ethern-Myth](https://github.com/ethern-myth)\n\n---\n\n**Give a like to this project and let's share it and spread it more. Thanks.**\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethern-myth%2Fsecure-session-vault","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethern-myth%2Fsecure-session-vault","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethern-myth%2Fsecure-session-vault/lists"}