{ "info": { "author": "Markus Ressel", "author_email": "mail@markusressel.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "# gopass-chrome-importer [![Build Status](https://travis-ci.org/markusressel/gopass-chrome-importer.svg?branch=master)](https://travis-ci.org/markusressel/gopass-chrome-importer) [![PyPI version](https://badge.fury.io/py/gopass-chrome-importer.svg)](https://badge.fury.io/py/gopass-chrome-importer)\nA simple tool to import Chrome passwords into [gopass](https://github.com/gopasspw/gopass).\n\n# How it works\n\n**gopass-chrome-importer** parses the `.csv` file that can be exported from chrome\nand loops over each entry in the list which provides\n\n* a **name** (of the entry)\n* the **url**\n* the **username**\n* the **password**\n\n## Determining the secret file path\n\n1. Since not only passwords for websites are stored in chrome all entries are divided into categories \nwhich are later used as subfolders when creating the actual secrets in gopass. \n2. Next the url is simplified based on the category to provide a human readable name for the secret.\n3. To improve usability with the gopass chrome and firefox plugin the username is used as the file name of the secret.\n\n* `website`\n * the url is stripped down to only contain the domain (and all subdomains) f.ex. `import/website/smile.amazon.com/your@mail.com`\n* `ip`\n * since saved passwords of IPs can be duplicates based on the network you are in\n these passwords are sorted into their own category and the url is stripped to only contain the IP (v4)\n * IPv6 is currently not detected and would be handled as a website\n* `android`\n * the url is stripped down to only contain the package of the app f.ex. `import/android/com.paypal.android.p2pmobile/your@mail.com`\n\n## Secret file content\n\nThe first line of a secret is always supposed to be a password \nwith additional info added below separated by a `---` divider.\nWhen a username is available it will be added to the additional info section\nwhich can then be used by the chrome and firefox plugin:\n\n```text\nmypassword1234\n---\nuser: myuser\n```\n\nIf no user is available just the password is written to the file:\n\n```text\nmypassword1234\n```\n\n## Creating the secret\n\nSince **gopass** does not provide a non-interactive way to create or modify secrets the fact that\nsecrets can not only be edited but also created using the `gopass edit` command is used to work around this\n(security related) limitation. When executing `gopass edit /some/secret` **gopass** creates a temporary decrypted \nfile inside `/dev/shm` for this secret which is then passed to `$EDITOR`. **gopass-chrome-importer** uses this to \nits advantage and writes itself into that env variable to process the temporarily decrypted file. \nFirst of all the existing file is checked to prevent overwriting of existing secret data. \nIf those checks succeed the secret is written to the file in the form described above.\nAfter that **gopass** encrypts the temporary file with the selected recipients and (if a remote is available) \npushes it to the server. \n\n\n# Installing\n\nNow that you hopefully have a good understanding of how this tool works lets actually try it out!\n\nSince this package is not completely without dependencies it is recommended to install it inside a **virtualenv**:\n\n```bash\npython3 -m venv ~/path/to/new/virtual/environment\nsource ~/path/to/new/virtual/environment/bin/activate\npip3 install gopass-chrome-importer\n```\n\n# Usage\n\nFor basic usage the `import` command should be all you ever need.\n**gopass-chrome-importer** has a couple of parameters to customize the import result\nand you should take a look what they offer before actually importing anything.\nFor a quick overview call:\n\n```bash\ngopass-chrome-importer import --help\n```\n\n## Dry Run\n\nTo test things out before actually importing passwords into **gopass** (and possibly \npushing them to origin) you can use the `-d` or `--dry-run` option. This will only output\nsecret paths and contents where passwords are masked as asterisks to give you an idea of what would \nhappen.\n\nAn example output would look similar to this:\n```text\nWould import: /import/ip/127.0.0.1/joe\n******\n---\nuser: joe\n\nWould import: /import/ip/192.168.0.1/admin\n********************\n---\nuser: admin\n```\n\nFor safety **all** examples on this page will include this option. \n\n\n## Set the path to the chrome password export .csv\n\nTo set the path to the `export.csv` file just use the `-p` or `--path` option:\n\n```bash\ngopass-chrome-importer import --path \"~/Downloads/Chrome Passwords.csv\" --dry-run\n```\n\n## Changing the base import path\n\nBy default **gopass-chrome-importer** will import secrets into an `import/` folder. To change this simply\nuse the `-gb` or `--gopass-basepath` option:\n\n```bash\ngopass-chrome-importer import --path \"~/Downloads/Chrome Passwords.csv\" --gopass-basepath /test/ --dry-run\n```\n\n## --yes\n\nBy default **gopass** will ask you some questions when creating a secret like which recipients to use for this secret.\nFor large lists of passwords this can be quite a hassle. **gopass** has a built in `--yes` option to circumvent this \nby always using \"Y\" or the default (if *yes* is not an option). This parameter can also be used (in addition to `-y`)\nin **gopass-chrome-importer** and will just pass it on to **gopass**.\n\n```bash\ngopass-chrome-importer import --path \"~/Downloads/Chrome Passwords.csv\" --gopass-basepath /test/ --yes --dry-run\n```\n\n## Overwrite existing passwords/file contents\n\nWhen **gopass-chrome-importer** tries to save a password in a file that\nalready exists and that file is **not** empty it will (by default) **not change the file contents**\nto prevent accidentally overwriting of existing passwords.\n\nYou can force **gopass-chrome-importer** to ignore this check by using the `-f` or `--force` option.\n\nAlthough your existing passwords are backed up in a git and (hopefully) synced to a \nserver side backend **be careful and think twice before using this option.**\n\n```bash\ngopass-chrome-importer import --path \"~/Downloads/Chrome Passwords.csv\" --gopass-basepath /test/ --yes --force --dry-run\n```\n\n# Contributing\n\nGitHub is for social coding: if you want to write code, I encourage contributions through pull requests from forks\nof this repository. Create GitHub tickets for bugs and new features and comment on the ones that you are interested in.\n\n\n# License\n\n```\nMIT License\n\nCopyright (c) 2018 Markus Ressel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/markusressel/gopass-chrome-importer", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "gopass-chrome-importer", "package_url": "https://pypi.org/project/gopass-chrome-importer/", "platform": "", "project_url": "https://pypi.org/project/gopass-chrome-importer/", "project_urls": { "Homepage": "https://github.com/markusressel/gopass-chrome-importer" }, "release_url": "https://pypi.org/project/gopass-chrome-importer/1.1.0/", "requires_dist": [ "click" ], "requires_python": "", "summary": "A simple tool to import Chrome passwords into gopass.", "version": "1.1.0" }, "last_serial": 4887202, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "e3298bfd4e80d408c85e4599f04a3b96", "sha256": "6ba401554bb09e238c6ffd7b4218c507ea32f072d07fb96b800fc6465d0409bd" }, "downloads": -1, "filename": "gopass_chrome_importer-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e3298bfd4e80d408c85e4599f04a3b96", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9818, "upload_time": "2018-11-20T20:09:28", "url": "https://files.pythonhosted.org/packages/b4/4a/832e2138d4cc66bcc4554570597eb50ef7395ae8fa9a431feb6c8191b305/gopass_chrome_importer-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a9b98a95ec8abd92b5f47a96dabce246", "sha256": "401e9f240fdb5d22c182fa711e8f83caaa1ef703712f04c9812a0091034443f0" }, "downloads": -1, "filename": "gopass-chrome-importer-1.0.0.tar.gz", "has_sig": false, "md5_digest": "a9b98a95ec8abd92b5f47a96dabce246", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8201, "upload_time": "2018-11-20T20:09:31", "url": "https://files.pythonhosted.org/packages/8b/a6/3245d8f77fe225a355459693f5f98b7165061a1af25e4137fb3b2cfd785a/gopass-chrome-importer-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "702e5f42ff43508b22ba9e1ce1da1b30", "sha256": "88c57a9f38adb46be3a75e06cdf125439fd975bdd5d580bfd6cccef31cd60e4a" }, "downloads": -1, "filename": "gopass_chrome_importer-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "702e5f42ff43508b22ba9e1ce1da1b30", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10344, "upload_time": "2018-11-22T00:46:51", "url": "https://files.pythonhosted.org/packages/52/ca/0dfc0d51bf92fb001031b0d3a82dea842ce4469dc48f7f49b78484c93d62/gopass_chrome_importer-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f6c1eff20e9fc1dc47c9d50739e5118b", "sha256": "7ffd35a9424db31b1a24203587418c5c8ef81f6412118b5ccb471180b90d3417" }, "downloads": -1, "filename": "gopass-chrome-importer-1.0.1.tar.gz", "has_sig": false, "md5_digest": "f6c1eff20e9fc1dc47c9d50739e5118b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8683, "upload_time": "2018-11-22T00:46:54", "url": "https://files.pythonhosted.org/packages/de/48/f25932d252471823a9a17929566ffb9bd400b2550187fbc376fd6b053262/gopass-chrome-importer-1.0.1.tar.gz" } ], "1.0.1.dev0": [ { "comment_text": "", "digests": { "md5": "f37227c913865f72485f00d6d9802d4a", "sha256": "50922aed6a5f08fb402faf18fa3911f874ac6dfbe91cb88a9ec3a4fba7a0beb2" }, "downloads": -1, "filename": "gopass_chrome_importer-1.0.1.dev0-py3-none-any.whl", "has_sig": false, "md5_digest": "f37227c913865f72485f00d6d9802d4a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10404, "upload_time": "2018-11-22T00:44:28", "url": "https://files.pythonhosted.org/packages/f3/01/78cab01623cf6a60ab49cddcf109c523b3b443137a862497c2dab4bd92ef/gopass_chrome_importer-1.0.1.dev0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cd21a0897a2705956c6e568f8f9b64c0", "sha256": "1207f792462e1a999f2e942892a4eadf15ffe4d4ed098b94f8d6639a58e6dc5a" }, "downloads": -1, "filename": "gopass-chrome-importer-1.0.1.dev0.tar.gz", "has_sig": false, "md5_digest": "cd21a0897a2705956c6e568f8f9b64c0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8701, "upload_time": "2018-11-22T00:44:30", "url": "https://files.pythonhosted.org/packages/c6/92/b7b94064051c0f01025e999e51e8268e5b4a409cf7a54497cdc0cd931ac4/gopass-chrome-importer-1.0.1.dev0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "9ad2bdce498d1a840dfb8c49e8414cf3", "sha256": "e364a47362f0781b2bfa49c3c6f57674c9b892e1a9fe4c53c7ccec4b56043b3e" }, "downloads": -1, "filename": "gopass_chrome_importer-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "9ad2bdce498d1a840dfb8c49e8414cf3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 12891, "upload_time": "2019-03-02T00:17:54", "url": "https://files.pythonhosted.org/packages/fa/bc/9759f260c4c3c186b67db61eacce5d21759080a395905f3f3efd4de7a851/gopass_chrome_importer-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d31848a97324989b94fd0136226d5ccc", "sha256": "15cef62f691781c3807028719381d5671d47ffb3ae3f7732e8aa7e42d45ba720" }, "downloads": -1, "filename": "gopass-chrome-importer-1.1.0.tar.gz", "has_sig": false, "md5_digest": "d31848a97324989b94fd0136226d5ccc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11416, "upload_time": "2019-03-02T00:17:55", "url": "https://files.pythonhosted.org/packages/cd/8d/35085e7d42dfc65e6ea1704209ce44b6d6e6140fe63063a678fbec8da286/gopass-chrome-importer-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9ad2bdce498d1a840dfb8c49e8414cf3", "sha256": "e364a47362f0781b2bfa49c3c6f57674c9b892e1a9fe4c53c7ccec4b56043b3e" }, "downloads": -1, "filename": "gopass_chrome_importer-1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "9ad2bdce498d1a840dfb8c49e8414cf3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 12891, "upload_time": "2019-03-02T00:17:54", "url": "https://files.pythonhosted.org/packages/fa/bc/9759f260c4c3c186b67db61eacce5d21759080a395905f3f3efd4de7a851/gopass_chrome_importer-1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d31848a97324989b94fd0136226d5ccc", "sha256": "15cef62f691781c3807028719381d5671d47ffb3ae3f7732e8aa7e42d45ba720" }, "downloads": -1, "filename": "gopass-chrome-importer-1.1.0.tar.gz", "has_sig": false, "md5_digest": "d31848a97324989b94fd0136226d5ccc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11416, "upload_time": "2019-03-02T00:17:55", "url": "https://files.pythonhosted.org/packages/cd/8d/35085e7d42dfc65e6ea1704209ce44b6d6e6140fe63063a678fbec8da286/gopass-chrome-importer-1.1.0.tar.gz" } ] }