sharing.rst (4259B)
1 .. _gns-sharing: 2 3 Publishing and sharing your zone 4 ================================ 5 6 A zone becomes useful to others once they can find it. This page explains 7 how to publish records, how to hand out your zone key, and how to get a name 8 for your zone that other GNUnet users can resolve without any setup. 9 10 Publishing records 11 ------------------ 12 13 Only records marked as **public** are published. Add ``-p`` when you create 14 a record: 15 16 .. code-block:: console 17 18 $ gnunet-namestore -z myzone -a -p -n www -t A -V 192.0.2.1 -e 1d 19 20 Your peer signs and encrypts public records and stores them in the GNUnet 21 DHT, and republishes them regularly while it is running. Keep your peer 22 running (see :doc:`/users/start`): if it stays offline, your records 23 eventually expire from the network. 24 25 Sharing your zone key 26 --------------------- 27 28 Print the public key of your zone and give it to the people who should be 29 able to resolve your names: 30 31 .. code-block:: console 32 33 $ gnunet-identity -d -q -e myzone 34 000G0507HZ8M09QWA93N2YX9Y9357777C0HTPK7PA0HTKJS5GCXXPGKBWC 35 36 A friend then adds it to one of their zones under a petname of their 37 choice, for example ``you``: 38 39 .. code-block:: console 40 41 $ gnunet-namestore -z theirzone -a -n you -t EDKEY -V 000G0507HZ8M...WC -e 1d 42 43 and can resolve your public records as ``www.you.theirzone``. Without 44 adding anything, they can also use the key itself as the top-level domain: 45 ``www.000G0507HZ8M...WC``. 46 47 How you exchange keys matters: the key *is* the identity of your zone. Use 48 a channel that you trust to deliver it unmodified, for example in person or 49 in a signed message. 50 51 Registering a name under .pin.gns.alt 52 ------------------------------------- 53 54 Every GNUnet installation is configured with the start zone 55 ``.pin.gns.alt``, a registry operated by GNUnet e.V. on a first-come, 56 first-served basis. If you register ``myname`` there, every GNUnet user can 57 resolve your records as ``www.myname.pin.gns.alt`` without exchanging keys 58 first. 59 60 To register, visit https://fcfs.gnunet.org and register your zone key under 61 a name of your choice. The registrar is connected to the demo deployment of 62 `GNU Taler <https://taler.net/>`__ and asks for a payment in KUDOS, a demo 63 currency you get for free when you register at the Taler demo; the service 64 is therefore effectively free. 65 66 Keep in mind that names in ``.pin.gns.alt`` are only as trustworthy as the 67 registry: whoever operates it could, in principle, change the delegation. 68 For names that matter, exchange keys directly as well. 69 70 Business cards and QR codes 71 --------------------------- 72 73 GNUnet includes ``gnunet-bcd``, which creates printable business cards with 74 a QR code of your zone key, and ``gnunet-qr``, which reads such a code with 75 a camera and imports the zone. 76 77 .. warning:: 78 79 In GNUnet 0.29, importing a zone from a QR code does not work: the 80 import step (``gnunet-namestore -u``) fails for current zone keys. 81 Exchange keys as text, as shown above, until this is fixed. 82 83 ``gnunet-bcd`` is a small web application. It needs a LaTeX installation 84 with the ``units``, ``labels``, ``pst-barcode``, ``luatex85``, ``preview``, 85 ``pdfcrop`` and ``koma-script`` packages (on Debian, ``texlive-full`` 86 contains all of them). Start it, then open http://localhost:8888/ in a 87 browser and fill in the form, including your zone key: 88 89 .. code-block:: console 90 91 $ gnunet-arm -i bcd 92 93 The result is a PDF with ten business cards. 94 95 The default start zones 96 ----------------------- 97 98 The start zones configured by default, such as ``.pin.gns.alt``, are 99 registered in `GANA <https://gana.gnunet.org>`__ and follow a `restrictive 100 registration policy 101 <https://git.gnunet.org/gana.git/tree/gnu-name-system-default-tlds/POLICY>`__. 102 Every user can remove them or add others; see :ref:`gns-concepts`. 103 104 Running your own registrar 105 -------------------------- 106 107 The software behind https://fcfs.gnunet.org is available as a separate 108 package, the GNUnet GNS registrar, from the `GNU FTP mirror 109 <https://ftpmirror.gnu.org/gnunet>`__. Build and run it with: 110 111 .. code-block:: console 112 113 $ ./configure && make 114 $ ./gnunet-gns-registrar 115 116 It requires a `GNU Taler merchant backend <https://taler.net/>`__ for 117 payments; see the example configuration in the package for the available 118 options.