summaryrefslogtreecommitdiff
path: root/README
blob: a753c3b8588b27c9ad34946cd543f688297c057b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
=============
GNU ANASTASIS
=============

This package includes the Anastasis core logic.  The code is released
under the GNU Affero General Public License (v3 or later).  See
COPYING for details.

Description
===========

GNU Anastasis is a key backup and recovery tool from the GNU project.
This package includes the backend run by the Anastasis providers as
well as libraries for clients and a command-line interface.

Installation instructions can be found in INSTALL and
also in the handbook at https://docs.anastasis.lu/ which
is also in the doc/ folder. Please note that you must run
'make install' before you can run the testsuite using
'make check'.


Dependencies
============

libjansson  : MIT License
libgcrypt   : LGPL
libsodium   : ISC License
postgresql  : PostgreSQL License
libgnunet*  : GPLv3+,
libtaler*   : GPLv3+
GNU recutils: GPLv3+ (when building from Git)


Directory structure
===================

src/include/ includes installed (public) headers
src/util/ implements helper and crypto routines
src/backend/ contains the REST service
src/stasis/ implements the database logic for the backend
src/authorization/ contains various authorization plugins
src/restclient/ implements a REST client for the backend
src/lib/ implements the main client-side backup and recovery logic
src/testing/ contains test cases for 'src/restclient/' and 'src/lib/'
src/reducer/ implements a reducer API on top of 'src/lib/'
src/cli/ includes a reducer-based command-line interface
contrib/ contains resource files, like what identity attributes to ask for
doc/ contains documentation files, like TeXinfo
po/ internationalization via GNU gettext


Development note
================

To test against a local development service, add

	{
	    "code" : "xx",
	    "name" : "Testland",
	    "continent" : "Demoworld",
	    "call_code" : "+00"
	}

to contrib/redux.countries.json, and also append something like

	{
            "url" : "http://localhost:8086/",
            "restricted" : "xx"
	},
	{
            "url" : "http://localhost:8087/",
            "restricted" : "xx"
	},
	{
            "url" : "http://localhost:8088/",
            "restricted" : "xx"
	},
	{
            "url" : "http://localhost:8089/",
            "restricted" : "xx"
	}

to contrib/provider-list.json. Then the reducer will use these
providers on loopback for the "testland" country.


Experimental providers
======================

We hope to have another provider running soon. Once it is operational,
we should add

        {
            "url" : "https://v1.anastasis.openw3b.org/",
            "name" : "Openw3b Foundation, India"
        },

to the contrib/provider-list.json.