{ "id": "08309df36af9cb7c64b953ee0d2786c926d7bae74bd08ef23b267942a304d432", "pubkey": "a008def15796fba9a0d6fab04e8fd57089285d9fd505da5a83fe8aad57a3564d", "created_at": 1734355080, "kind": 1617, "tags": [ [ "a", "30617:a008def15796fba9a0d6fab04e8fd57089285d9fd505da5a83fe8aad57a3564d:ngit" ], [ "r", "26689f97810fc656c7134c76e2a37d33b2e40ce7" ], [ "r", "ec99da472f7fd9678b10f95e2f55cc17f96f8e62" ], [ "alt", "git patch: docs: add FAQ with server protocol question" ], [ "t", "root" ], [ "branch-name", "faq-server-protocol" ], [ "p", "a008def15796fba9a0d6fab04e8fd57089285d9fd505da5a83fe8aad57a3564d" ], [ "commit", "ec99da472f7fd9678b10f95e2f55cc17f96f8e62" ], [ "parent-commit", "4ee83e2fe5335a8afd78439c35f029c4a472e797" ], [ "commit-pgp-sig", "-----BEGIN PGP SIGNATURE-----\n\niQIzBAABCAAdFiEEsRaN4Kb3mvfPwNXpaOFUhtc/deEFAmdgKHgACgkQaOFUhtc/\ndeH7UQ//eIpoxEaVwkfQvVB0F5tLGzMslN7NNW1CmPm5YL3cCyC8D80OpAyRSk4F\nxevQFxcK1BZ5CuMBn/YwFJZCf3wTQpUU4e5Qg7r4tYWXuH00M8OywVmRdWrkY0HR\nXKzmFmWO/I3CtfebbmPZrFzpd94mLoHDaIteQvRr0A0cSsa2A/hvYc576BtRq5xo\n2oV5mBlUKckmgAGRaWTi3Q+s9be/y/KerqJyQ8Hy97kTnqyhbXNh+j37hnc9CSmc\nFu8WFkesKhdMzT0ftgt8Jg0SeYve6+qJCBHJNqogtHr+vEGAYE+wLQJuVcz7q44w\nqGmDqAcz515xcpuGiWI+8+YGmhgBAhCyBRroXck8P9BBQ2Y21Jd9NW2PMyTEIgnj\nzt2HbG8/rR/YL3oSb8upbmxkKNkg8obZlt4bfX3T3xcB7hgeN/z1h2xYhyUFiTBI\npsV1gy8NBYCVAdt9LVpwfbx0yCXHKfaziTsRjXj5Nha+ukwUt4zqCtaHClO/C6nO\n/UrjshuioUi9iLkhSgsiW8sWtDhIzCw8BzJVu34/ywBous8i1ANcuBtHAapEgrq2\nIfcO5VuCoksJ7AjWExoO1SlzT4YxBtFyd+6jsA+YQE+qME2F9C1byyUGBmOIt8Al\nsHbnKvTbhA83QJincNWM5Xhdjf6kPTwbGHAHLKnsYqJ7x/0ka94=\n=nYOI\n-----END PGP SIGNATURE-----" ], [ "description", "docs: add FAQ with server protocol question\n\nA question came up about the reason to specify git server protocol\nand ssh user in the nostr git url format. this is an attempt to\nanswer it in a more holistic manner.\n" ], [ "author", "DanConwayDev", "DanConwayDev@protonmail.com", "1734355063", "0" ], [ "committer", "DanConwayDev", "DanConwayDev@protonmail.com", "1734355063", "0" ] ], "content": "From ec99da472f7fd9678b10f95e2f55cc17f96f8e62 Mon Sep 17 00:00:00 2001\nFrom: DanConwayDev \u003cDanConwayDev@protonmail.com\u003e\nDate: Mon, 16 Dec 2024 13:17:43 +0000\nSubject: [PATCH] docs: add FAQ with server protocol question\n\nA question came up about the reason to specify git server protocol\nand ssh user in the nostr git url format. this is an attempt to\nanswer it in a more holistic manner.\n---\n FAQs.md | 27 +++++++++++++++++++++++++++\n 1 file changed, 27 insertions(+)\n create mode 100644 FAQs.md\n\ndiff --git a/FAQs.md b/FAQs.md\nnew file mode 100644\nindex 0000000..4a24bf4\n--- /dev/null\n+++ b/FAQs.md\n@@ -0,0 +1,27 @@\n+# FAQs\n+\n+## what protocol is used to interact with the git server(s) listed in the announcement event `30617`?\n+\n+Most Git servers support a variety of protocols, and it is the user's responsibility to specify which one to use in the Git remote URL.\n+\n+For a Nostr repository, the Git remote URL(s) are specified by the maintainer in the announcement event. These URLs may include a protocol that is not suitable for the user. For instance, if SSH is specified, the user may not have SSH keys configured for the Git server.\n+\n+Privacy-conscious users often prefer to use unauthenticated HTTP for read operations and SSH for write operations.\n+\n+The git-remote-nostr plugin is designed to increase the likelihood of success by disregarding the protocol specified by the maintainer and using the following approach. It attempts to use the following protocols for read operations:\n+\n+- Unauthenticated HTTP\n+- SSH\n+- Authenticated HTTP\n+\n+For write operations, it tries:\n+\n+- SSH\n+- Unauthenticated HTTP\n+- Authenticated HTTP\n+\n+If the first protocol attempted fails but a subsequent one succeeds, all future attempts will default to the successful protocol.\n+\n+Some users may prefer a different configuration, such as using SSH for both read and write operations. They can achieve this by specifying ssh in the Nostr Git URL: `nostr://ssh/dan@gitworkshop.dev/ngit`.\n+\n+Additionally, users may want to use non-default SSH keys. The user for non-default SSH keys can be specified in the Nostr Git URL: `nostr://nym1@ssh/npub123/identifier`. In this case, NIP05 addresses cannot be used.\n--\nlibgit2 1.8.1\n\n", "sig": "f0657f8ae6211dc5c8d5dabd901eb84a254055d7e9c8749b18e4b23846e972b9ed628c21e546fdad8d9129671a200bdae8e8576836c0edb9209c354ed15d193f" }