gnunet-handbook

The GNUnet Handbook
Log | Files | Refs

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.