To get this branch, use:
bzr branch
http://bzr.recompile.se/loggerhead/mandos/trunk
« back to all changes in this revision
Viewing changes to plugins.d/mandos-client.c
- browse files at revision 738.1.6
- compare with another revision
- download diff
- download tarball
- view history from revision 738.1.6
- Committer: Teddy Hogeborn
- Date: 2015-07-06 20:09:47 UTC
- mto: This revision was merged to the branch mainline in revision 759.
- Revision ID: teddy@recompile.se-20150706200947-w21u4eq74efgl6r5
Fix minor bugs and typos and add some more debug output.
* Makefile (install-client-nokey): Create plugin-helpers directory and
the mandos-client-iprouteadddel
helper program.
* initramfs-tools-hook (PLUGINHELPERDIR): Fix typo.
* plugins.d/mandos-client.c: Change terminology; routes are "deleted",
not "removed". All occurences changed.
(add_remove_local_route): Renamed to "add_delete_local_route". All
callers changed. Also pass "--debug" flag
to helper if in debug mode.
(add_local_route): Add debugging output.
(remove_local_route): Renamed to "delete_local_route". All callers
changed. Also pass "--debug" flag to helper
if in debug mode.
(start_mandos_communication): Add debug output when adding route.
* Makefile (install-client-nokey): Create plugin-helpers directory and
the mandos-client-iprouteadddel
helper program.
* initramfs-tools-hook (PLUGINHELPERDIR): Fix typo.
* plugins.d/mandos-client.c: Change terminology; routes are "deleted",
not "removed". All occurences changed.
(add_remove_local_route): Renamed to "add_delete_local_route". All
callers changed. Also pass "--debug" flag
to helper if in debug mode.
(add_local_route): Add debugging output.
(remove_local_route): Renamed to "delete_local_route". All callers
changed. Also pass "--debug" flag to helper
if in debug mode.
(start_mandos_communication): Add debug output when adding route.
added
removed
plugins.d/mandos-client.c
9
9
* "browse_callback", and parts of "main".
10
10
*
11
11
* Everything else is
12
* Copyright © 2008-2018 Teddy Hogeborn
13
* Copyright © 2008-2018 Björn Påhlsson
14
*
15
* This file is part of Mandos.
16
*
17
* Mandos is free software: you can redistribute it and/or modify it
18
* under the terms of the GNU General Public License as published by
19
* the Free Software Foundation, either version 3 of the License, or
20
* (at your option) any later version.
21
*
22
* Mandos is distributed in the hope that it will be useful, but
12
* Copyright © 2008-2015 Teddy Hogeborn
13
* Copyright © 2008-2015 Björn Påhlsson
14
*
15
* This program is free software: you can redistribute it and/or
16
* modify it under the terms of the GNU General Public License as
17
* published by the Free Software Foundation, either version 3 of the
18
* License, or (at your option) any later version.
19
*
20
* This program is distributed in the hope that it will be useful, but
23
21
* WITHOUT ANY WARRANTY; without even the implied warranty of
24
22
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
25
23
* General Public License for more details.
26
24
*
27
25
* You should have received a copy of the GNU General Public License
28
* along with Mandos. If not, see <http://www.gnu.org/licenses/>.
26
* along with this program. If not, see
27
* <http://www.gnu.org/licenses/>.
29
28
*
30
29
* Contact the authors at <mandos@recompile.se>.
31
30
*/
47
46
#include <stdlib.h> /* free(), EXIT_SUCCESS, srand(),
48
47
strtof(), abort() */
49
48
#include <stdbool.h> /* bool, false, true */
50
#include <string.h> /* strcmp(), strlen(), strerror(),
51
asprintf(), strncpy(), strsignal()
52
*/
49
#include <string.h> /* memset(), strcmp(), strlen(),
50
strerror(), asprintf(), strcpy() */
53
51
#include <sys/ioctl.h> /* ioctl */
54
52
#include <sys/types.h> /* socket(), inet_pton(), sockaddr,
55
53
sockaddr_in6, PF_INET6,
59
57
#include <sys/socket.h> /* socket(), struct sockaddr_in6,
60
58
inet_pton(), connect(),
61
59
getnameinfo() */
62
#include <fcntl.h> /* open(), unlinkat(), AT_REMOVEDIR */
60
#include <fcntl.h> /* open(), unlinkat() */
63
61
#include <dirent.h> /* opendir(), struct dirent, readdir()
64
62
*/
65
63
#include <inttypes.h> /* PRIu16, PRIdMAX, intmax_t,
66
64
strtoimax() */
67
#include <errno.h> /* perror(), errno, EINTR, EINVAL,
68
EAI_SYSTEM, ENETUNREACH,
69
EHOSTUNREACH, ECONNREFUSED, EPROTO,
70
EIO, ENOENT, ENXIO, ENOMEM, EISDIR,
71
ENOTEMPTY,
65
#include <errno.h> /* perror(), errno,
72
66
program_invocation_short_name */
73
67
#include <time.h> /* nanosleep(), time(), sleep() */
74
68
#include <net/if.h> /* ioctl, ifreq, SIOCGIFFLAGS, IFF_UP,
272
266
return true;
273
267
}
274
268
275
/* Set effective uid to 0, return errno */
276
__attribute__((warn_unused_result))
277
int raise_privileges(void){
278
int old_errno = errno;
279
int ret = 0;
280
if(seteuid(0) == -1){
281
ret = errno;
282
}
283
errno = old_errno;
284
return ret;
285
}
286
287
/* Set effective and real user ID to 0. Return errno. */
288
__attribute__((warn_unused_result))
289
int raise_privileges_permanently(void){
290
int old_errno = errno;
291
int ret = raise_privileges();
292
if(ret != 0){
293
errno = old_errno;
294
return ret;
295
}
296
if(setuid(0) == -1){
297
ret = errno;
298
}
299
errno = old_errno;
300
return ret;
301
}
302
303
/* Set effective user ID to unprivileged saved user ID */
304
__attribute__((warn_unused_result))
305
int lower_privileges(void){
306
int old_errno = errno;
307
int ret = 0;
308
if(seteuid(uid) == -1){
309
ret = errno;
310
}
311
errno = old_errno;
312
return ret;
313
}
314
315
/* Lower privileges permanently */
316
__attribute__((warn_unused_result))
317
int lower_privileges_permanently(void){
318
int old_errno = errno;
319
int ret = 0;
320
if(setuid(uid) == -1){
321
ret = errno;
322
}
323
errno = old_errno;
324
return ret;
325
}
326
327
269
/*
328
270
* Initialize GPGME.
329
271
*/
349
291
return false;
350
292
}
351
293
352
/* Workaround for systems without a real-time clock; see also
353
Debian bug #894495: <https://bugs.debian.org/894495> */
354
do {
355
{
356
time_t currtime = time(NULL);
357
if(currtime != (time_t)-1){
358
struct tm tm;
359
if(gmtime_r(&currtime, &tm) == NULL) {
360
perror_plus("gmtime_r");
361
break;
362
}
363
if(tm.tm_year != 70 or tm.tm_mon != 0){
364
break;
365
}
366
if(debug){
367
fprintf_plus(stderr, "System clock is January 1970");
368
}
369
} else {
370
if(debug){
371
fprintf_plus(stderr, "System clock is invalid");
372
}
373
}
374
}
375
struct stat keystat;
376
ret = fstat(fd, &keystat);
377
if(ret != 0){
378
perror_plus("fstat");
379
break;
380
}
381
ret = raise_privileges();
382
if(ret != 0){
383
errno = ret;
384
perror_plus("Failed to raise privileges");
385
break;
386
}
387
if(debug){
388
fprintf_plus(stderr,
389
"Setting system clock to key file mtime");
390
}
391
time_t keytime = keystat.st_mtim.tv_sec;
392
if(stime(&keytime) != 0){
393
perror_plus("stime");
394
}
395
ret = lower_privileges();
396
if(ret != 0){
397
errno = ret;
398
perror_plus("Failed to lower privileges");
399
}
400
} while(false);
401
402
294
rc = gpgme_data_new_from_fd(&pgp_data, fd);
403
295
if(rc != GPG_ERR_NO_ERROR){
404
296
fprintf_plus(stderr, "bad gpgme_data_new_from_fd: %s: %s\n",
412
304
gpgme_strsource(rc), gpgme_strerror(rc));
413
305
return false;
414
306
}
415
{
416
gpgme_import_result_t import_result
417
= gpgme_op_import_result(mc->ctx);
418
if((import_result->imported < 1
419
or import_result->not_imported > 0)
420
and import_result->unchanged == 0){
421
fprintf_plus(stderr, "bad gpgme_op_import_results:\n");
422
fprintf_plus(stderr,
423
"The total number of considered keys: %d\n",
424
import_result->considered);
425
fprintf_plus(stderr,
426
"The number of keys without user ID: %d\n",
427
import_result->no_user_id);
428
fprintf_plus(stderr,
429
"The total number of imported keys: %d\n",
430
import_result->imported);
431
fprintf_plus(stderr, "The number of imported RSA keys: %d\n",
432
import_result->imported_rsa);
433
fprintf_plus(stderr, "The number of unchanged keys: %d\n",
434
import_result->unchanged);
435
fprintf_plus(stderr, "The number of new user IDs: %d\n",
436
import_result->new_user_ids);
437
fprintf_plus(stderr, "The number of new sub keys: %d\n",
438
import_result->new_sub_keys);
439
fprintf_plus(stderr, "The number of new signatures: %d\n",
440
import_result->new_signatures);
441
fprintf_plus(stderr, "The number of new revocations: %d\n",
442
import_result->new_revocations);
443
fprintf_plus(stderr,
444
"The total number of secret keys read: %d\n",
445
import_result->secret_read);
446
fprintf_plus(stderr,
447
"The number of imported secret keys: %d\n",
448
import_result->secret_imported);
449
fprintf_plus(stderr,
450
"The number of unchanged secret keys: %d\n",
451
import_result->secret_unchanged);
452
fprintf_plus(stderr, "The number of keys not imported: %d\n",
453
import_result->not_imported);
454
for(gpgme_import_status_t import_status
455
= import_result->imports;
456
import_status != NULL;
457
import_status = import_status->next){
458
fprintf_plus(stderr, "Import status for key: %s\n",
459
import_status->fpr);
460
if(import_status->result != GPG_ERR_NO_ERROR){
461
fprintf_plus(stderr, "Import result: %s: %s\n",
462
gpgme_strsource(import_status->result),
463
gpgme_strerror(import_status->result));
464
}
465
fprintf_plus(stderr, "Key status:\n");
466
fprintf_plus(stderr,
467
import_status->status & GPGME_IMPORT_NEW
468
? "The key was new.\n"
469
: "The key was not new.\n");
470
fprintf_plus(stderr,
471
import_status->status & GPGME_IMPORT_UID
472
? "The key contained new user IDs.\n"
473
: "The key did not contain new user IDs.\n");
474
fprintf_plus(stderr,
475
import_status->status & GPGME_IMPORT_SIG
476
? "The key contained new signatures.\n"
477
: "The key did not contain new signatures.\n");
478
fprintf_plus(stderr,
479
import_status->status & GPGME_IMPORT_SUBKEY
480
? "The key contained new sub keys.\n"
481
: "The key did not contain new sub keys.\n");
482
fprintf_plus(stderr,
483
import_status->status & GPGME_IMPORT_SECRET
484
? "The key contained a secret key.\n"
485
: "The key did not contain a secret key.\n");
486
}
487
return false;
488
}
489
}
490
307
491
ret = close(fd);
308
ret = (int)TEMP_FAILURE_RETRY(close(fd));
492
309
if(ret == -1){
493
310
perror_plus("close");
494
311
}
533
350
/* Create new GPGME "context" */
534
351
rc = gpgme_new(&(mc->ctx));
535
352
if(rc != GPG_ERR_NO_ERROR){
536
fprintf_plus(stderr, "bad gpgme_new: %s: %s\n",
537
gpgme_strsource(rc), gpgme_strerror(rc));
353
fprintf_plus(stderr, "Mandos plugin mandos-client: "
354
"bad gpgme_new: %s: %s\n", gpgme_strsource(rc),
355
gpgme_strerror(rc));
538
356
return false;
539
357
}
540
358
576
394
/* Create new empty GPGME data buffer for the plaintext */
577
395
rc = gpgme_data_new(&dh_plain);
578
396
if(rc != GPG_ERR_NO_ERROR){
579
fprintf_plus(stderr, "bad gpgme_data_new: %s: %s\n",
397
fprintf_plus(stderr, "Mandos plugin mandos-client: "
398
"bad gpgme_data_new: %s: %s\n",
580
399
gpgme_strsource(rc), gpgme_strerror(rc));
581
400
gpgme_data_release(dh_crypto);
582
401
return -1;
595
414
if(result == NULL){
596
415
fprintf_plus(stderr, "gpgme_op_decrypt_result failed\n");
597
416
} else {
598
if(result->unsupported_algorithm != NULL) {
599
fprintf_plus(stderr, "Unsupported algorithm: %s\n",
600
result->unsupported_algorithm);
601
}
602
fprintf_plus(stderr, "Wrong key usage: %s\n",
603
result->wrong_key_usage ? "Yes" : "No");
417
fprintf_plus(stderr, "Unsupported algorithm: %s\n",
418
result->unsupported_algorithm);
419
fprintf_plus(stderr, "Wrong key usage: %u\n",
420
result->wrong_key_usage);
604
421
if(result->file_name != NULL){
605
422
fprintf_plus(stderr, "File name: %s\n", result->file_name);
606
423
}
607
608
for(gpgme_recipient_t r = result->recipients; r != NULL;
609
r = r->next){
424
gpgme_recipient_t recipient;
425
recipient = result->recipients;
426
while(recipient != NULL){
610
427
fprintf_plus(stderr, "Public key algorithm: %s\n",
611
gpgme_pubkey_algo_name(r->pubkey_algo));
612
fprintf_plus(stderr, "Key ID: %s\n", r->keyid);
428
gpgme_pubkey_algo_name
429
(recipient->pubkey_algo));
430
fprintf_plus(stderr, "Key ID: %s\n", recipient->keyid);
613
431
fprintf_plus(stderr, "Secret key available: %s\n",
614
r->status == GPG_ERR_NO_SECKEY ? "No" : "Yes");
432
recipient->status == GPG_ERR_NO_SECKEY
433
? "No" : "Yes");
434
recipient = recipient->next;
615
435
}
616
436
}
617
437
}
673
493
return plaintext_length;
674
494
}
675
495
676
__attribute__((warn_unused_result, const))
677
static const char *safe_string(const char *str){
678
if(str == NULL)
679
return "(unknown)";
680
return str;
681
}
682
683
496
__attribute__((warn_unused_result))
684
497
static const char *safer_gnutls_strerror(int value){
685
498
const char *ret = gnutls_strerror(value);
686
return safe_string(ret);
499
if(ret == NULL)
500
ret = "(unknown)";
501
return ret;
687
502
}
688
503
689
504
/* GnuTLS log function callback */
693
508
fprintf_plus(stderr, "GnuTLS: %s", string);
694
509
}
695
510
696
__attribute__((nonnull(1, 2, 4), warn_unused_result))
511
__attribute__((nonnull, warn_unused_result))
697
512
static int init_gnutls_global(const char *pubkeyfilename,
698
513
const char *seckeyfilename,
699
const char *dhparamsfilename,
700
514
mandos_context *mc){
701
515
int ret;
702
unsigned int uret;
703
516
704
517
if(debug){
705
518
fprintf_plus(stderr, "Initializing GnuTLS\n");
706
519
}
707
520
521
ret = gnutls_global_init();
522
if(ret != GNUTLS_E_SUCCESS){
523
fprintf_plus(stderr, "GnuTLS global_init: %s\n",
524
safer_gnutls_strerror(ret));
525
return -1;
526
}
527
708
528
if(debug){
709
529
/* "Use a log level over 10 to enable all debugging options."
710
530
* - GnuTLS manual
718
538
if(ret != GNUTLS_E_SUCCESS){
719
539
fprintf_plus(stderr, "GnuTLS memory error: %s\n",
720
540
safer_gnutls_strerror(ret));
541
gnutls_global_deinit();
721
542
return -1;
722
543
}
723
544
748
569
safer_gnutls_strerror(ret));
749
570
goto globalfail;
750
571
}
751
/* If a Diffie-Hellman parameters file was given, try to use it */
752
if(dhparamsfilename != NULL){
753
gnutls_datum_t params = { .data = NULL, .size = 0 };
754
do {
755
int dhpfile = open(dhparamsfilename, O_RDONLY);
756
if(dhpfile == -1){
757
perror_plus("open");
758
dhparamsfilename = NULL;
759
break;
760
}
761
size_t params_capacity = 0;
762
while(true){
763
params_capacity = incbuffer((char **)¶ms.data,
764
(size_t)params.size,
765
(size_t)params_capacity);
766
if(params_capacity == 0){
767
perror_plus("incbuffer");
768
free(params.data);
769
params.data = NULL;
770
dhparamsfilename = NULL;
771
break;
772
}
773
ssize_t bytes_read = read(dhpfile,
774
params.data + params.size,
775
BUFFER_SIZE);
776
/* EOF */
777
if(bytes_read == 0){
778
break;
779
}
780
/* check bytes_read for failure */
781
if(bytes_read < 0){
782
perror_plus("read");
783
free(params.data);
784
params.data = NULL;
785
dhparamsfilename = NULL;
786
break;
787
}
788
params.size += (unsigned int)bytes_read;
789
}
790
ret = close(dhpfile);
791
if(ret == -1){
792
perror_plus("close");
793
}
794
if(params.data == NULL){
795
dhparamsfilename = NULL;
796
}
797
if(dhparamsfilename == NULL){
798
break;
799
}
800
ret = gnutls_dh_params_import_pkcs3(mc->dh_params, ¶ms,
801
GNUTLS_X509_FMT_PEM);
802
if(ret != GNUTLS_E_SUCCESS){
803
fprintf_plus(stderr, "Failed to parse DH parameters in file"
804
" \"%s\": %s\n", dhparamsfilename,
805
safer_gnutls_strerror(ret));
806
dhparamsfilename = NULL;
807
}
808
free(params.data);
809
} while(false);
810
}
811
if(dhparamsfilename == NULL){
812
if(mc->dh_bits == 0){
813
/* Find out the optimal number of DH bits */
814
/* Try to read the private key file */
815
gnutls_datum_t buffer = { .data = NULL, .size = 0 };
816
do {
817
int secfile = open(seckeyfilename, O_RDONLY);
818
if(secfile == -1){
819
perror_plus("open");
820
break;
821
}
822
size_t buffer_capacity = 0;
823
while(true){
824
buffer_capacity = incbuffer((char **)&buffer.data,
825
(size_t)buffer.size,
826
(size_t)buffer_capacity);
827
if(buffer_capacity == 0){
828
perror_plus("incbuffer");
829
free(buffer.data);
830
buffer.data = NULL;
831
break;
832
}
833
ssize_t bytes_read = read(secfile,
834
buffer.data + buffer.size,
835
BUFFER_SIZE);
836
/* EOF */
837
if(bytes_read == 0){
838
break;
839
}
840
/* check bytes_read for failure */
841
if(bytes_read < 0){
842
perror_plus("read");
843
free(buffer.data);
844
buffer.data = NULL;
845
break;
846
}
847
buffer.size += (unsigned int)bytes_read;
848
}
849
close(secfile);
850
} while(false);
851
/* If successful, use buffer to parse private key */
852
gnutls_sec_param_t sec_param = GNUTLS_SEC_PARAM_ULTRA;
853
if(buffer.data != NULL){
854
{
855
gnutls_openpgp_privkey_t privkey = NULL;
856
ret = gnutls_openpgp_privkey_init(&privkey);
857
if(ret != GNUTLS_E_SUCCESS){
858
fprintf_plus(stderr, "Error initializing OpenPGP key"
859
" structure: %s",
860
safer_gnutls_strerror(ret));
861
free(buffer.data);
862
buffer.data = NULL;
863
} else {
864
ret = gnutls_openpgp_privkey_import
865
(privkey, &buffer, GNUTLS_OPENPGP_FMT_BASE64, "", 0);
866
if(ret != GNUTLS_E_SUCCESS){
867
fprintf_plus(stderr, "Error importing OpenPGP key : %s",
868
safer_gnutls_strerror(ret));
869
privkey = NULL;
870
}
871
free(buffer.data);
872
buffer.data = NULL;
873
if(privkey != NULL){
874
/* Use private key to suggest an appropriate
875
sec_param */
876
sec_param = gnutls_openpgp_privkey_sec_param(privkey);
877
gnutls_openpgp_privkey_deinit(privkey);
878
if(debug){
879
fprintf_plus(stderr, "This OpenPGP key implies using"
880
" a GnuTLS security parameter \"%s\".\n",
881
safe_string(gnutls_sec_param_get_name
882
(sec_param)));
883
}
884
}
885
}
886
}
887
if(sec_param == GNUTLS_SEC_PARAM_UNKNOWN){
888
/* Err on the side of caution */
889
sec_param = GNUTLS_SEC_PARAM_ULTRA;
890
if(debug){
891
fprintf_plus(stderr, "Falling back to security parameter"
892
" \"%s\"\n",
893
safe_string(gnutls_sec_param_get_name
894
(sec_param)));
895
}
896
}
897
}
898
uret = gnutls_sec_param_to_pk_bits(GNUTLS_PK_DH, sec_param);
899
if(uret != 0){
900
mc->dh_bits = uret;
901
if(debug){
902
fprintf_plus(stderr, "A \"%s\" GnuTLS security parameter"
903
" implies %u DH bits; using that.\n",
904
safe_string(gnutls_sec_param_get_name
905
(sec_param)),
906
mc->dh_bits);
907
}
908
} else {
909
fprintf_plus(stderr, "Failed to get implied number of DH"
910
" bits for security parameter \"%s\"): %s\n",
911
safe_string(gnutls_sec_param_get_name
912
(sec_param)),
913
safer_gnutls_strerror(ret));
914
goto globalfail;
915
}
916
} else if(debug){
917
fprintf_plus(stderr, "DH bits explicitly set to %u\n",
918
mc->dh_bits);
919
}
920
ret = gnutls_dh_params_generate2(mc->dh_params, mc->dh_bits);
921
if(ret != GNUTLS_E_SUCCESS){
922
fprintf_plus(stderr, "Error in GnuTLS prime generation (%u"
923
" bits): %s\n", mc->dh_bits,
924
safer_gnutls_strerror(ret));
925
goto globalfail;
926
}
927
}
572
ret = gnutls_dh_params_generate2(mc->dh_params, mc->dh_bits);
573
if(ret != GNUTLS_E_SUCCESS){
574
fprintf_plus(stderr, "Error in GnuTLS prime generation: %s\n",
575
safer_gnutls_strerror(ret));
576
goto globalfail;
577
}
578
928
579
gnutls_certificate_set_dh_params(mc->cred, mc->dh_params);
929
580
930
581
return 0;
932
583
globalfail:
933
584
934
585
gnutls_certificate_free_credentials(mc->cred);
586
gnutls_global_deinit();
935
587
gnutls_dh_params_deinit(mc->dh_params);
936
588
return -1;
937
589
}
989
641
/* ignore client certificate if any. */
990
642
gnutls_certificate_server_set_request(*session, GNUTLS_CERT_IGNORE);
991
643
644
gnutls_dh_set_prime_bits(*session, mc->dh_bits);
645
992
646
return 0;
993
647
}
994
648
996
650
static void empty_log(__attribute__((unused)) AvahiLogLevel level,
997
651
__attribute__((unused)) const char *txt){}
998
652
653
/* Set effective uid to 0, return errno */
654
__attribute__((warn_unused_result))
655
error_t raise_privileges(void){
656
error_t old_errno = errno;
657
error_t ret_errno = 0;
658
if(seteuid(0) == -1){
659
ret_errno = errno;
660
}
661
errno = old_errno;
662
return ret_errno;
663
}
664
665
/* Set effective and real user ID to 0. Return errno. */
666
__attribute__((warn_unused_result))
667
error_t raise_privileges_permanently(void){
668
error_t old_errno = errno;
669
error_t ret_errno = raise_privileges();
670
if(ret_errno != 0){
671
errno = old_errno;
672
return ret_errno;
673
}
674
if(setuid(0) == -1){
675
ret_errno = errno;
676
}
677
errno = old_errno;
678
return ret_errno;
679
}
680
681
/* Set effective user ID to unprivileged saved user ID */
682
__attribute__((warn_unused_result))
683
error_t lower_privileges(void){
684
error_t old_errno = errno;
685
error_t ret_errno = 0;
686
if(seteuid(uid) == -1){
687
ret_errno = errno;
688
}
689
errno = old_errno;
690
return ret_errno;
691
}
692
693
/* Lower privileges permanently */
694
__attribute__((warn_unused_result))
695
error_t lower_privileges_permanently(void){
696
error_t old_errno = errno;
697
error_t ret_errno = 0;
698
if(setuid(uid) == -1){
699
ret_errno = errno;
700
}
701
errno = old_errno;
702
return ret_errno;
703
}
704
999
705
/* Helper function to add_local_route() and delete_local_route() */
1000
706
__attribute__((nonnull, warn_unused_result))
1001
707
static bool add_delete_local_route(const bool add,
1055
761
perror_plus("dup2(devnull, STDIN_FILENO)");
1056
762
_exit(EX_OSERR);
1057
763
}
1058
ret = close(devnull);
764
ret = (int)TEMP_FAILURE_RETRY(close(devnull));
1059
765
if(ret == -1){
1060
766
perror_plus("close");
1061
767
_exit(EX_OSERR);
1078
784
helper, O_RDONLY));
1079
785
if(helper_fd == -1){
1080
786
perror_plus("openat");
1081
close(helperdir_fd);
1082
787
_exit(EX_UNAVAILABLE);
1083
788
}
1084
close(helperdir_fd);
789
TEMP_FAILURE_RETRY(close(helperdir_fd));
1085
790
#ifdef __GNUC__
1086
791
#pragma GCC diagnostic push
1087
792
#pragma GCC diagnostic ignored "-Wcast-qual"
1206
911
bool match = false;
1207
912
{
1208
913
char *interface = NULL;
1209
while((interface = argz_next(mc->interfaces,
1210
mc->interfaces_size,
1211
interface))){
914
while((interface=argz_next(mc->interfaces, mc->interfaces_size,
915
interface))){
1212
916
if(if_nametoindex(interface) == (unsigned int)if_index){
1213
917
match = true;
1214
918
break;
1256
960
goto mandos_end;
1257
961
}
1258
962
963
memset(&to, 0, sizeof(to));
1259
964
if(af == AF_INET6){
1260
struct sockaddr_in6 *to6 = (struct sockaddr_in6 *)&to;
1261
*to6 = (struct sockaddr_in6){ .sin6_family = (sa_family_t)af };
1262
ret = inet_pton(af, ip, &to6->sin6_addr);
965
((struct sockaddr_in6 *)&to)->sin6_family = (sa_family_t)af;
966
ret = inet_pton(af, ip, &((struct sockaddr_in6 *)&to)->sin6_addr);
1263
967
} else { /* IPv4 */
1264
struct sockaddr_in *to4 = (struct sockaddr_in *)&to;
1265
*to4 = (struct sockaddr_in){ .sin_family = (sa_family_t)af };
1266
ret = inet_pton(af, ip, &to4->sin_addr);
968
((struct sockaddr_in *)&to)->sin_family = (sa_family_t)af;
969
ret = inet_pton(af, ip, &((struct sockaddr_in *)&to)->sin_addr);
1267
970
}
1268
971
if(ret < 0 ){
1269
972
int e = errno;
1348
1051
sizeof(struct sockaddr_in));
1349
1052
}
1350
1053
if(ret < 0){
1351
if(((errno == ENETUNREACH) or (errno == EHOSTUNREACH))
1054
if(errno == ENETUNREACH
1352
1055
and if_index != AVAHI_IF_UNSPEC
1353
1056
and connect_to == NULL
1354
1057
and not route_added and
1367
1070
with an explicit route added with the server's address.
1368
1071
1369
1072
Avahi bug reference:
1370
https://lists.freedesktop.org/archives/avahi/2010-February/001833.html
1073
http://lists.freedesktop.org/archives/avahi/2010-February/001833.html
1371
1074
https://bugs.debian.org/587961
1372
1075
*/
1373
1076
if(debug){
1553
1256
&decrypted_buffer, mc);
1554
1257
if(decrypted_buffer_size >= 0){
1555
1258
1556
clearerr(stdout);
1557
1259
written = 0;
1558
1260
while(written < (size_t) decrypted_buffer_size){
1559
1261
if(quit_now){
1575
1277
}
1576
1278
written += (size_t)ret;
1577
1279
}
1578
ret = fflush(stdout);
1579
if(ret != 0){
1580
int e = errno;
1581
if(debug){
1582
fprintf_plus(stderr, "Error writing encrypted data: %s\n",
1583
strerror(errno));
1584
}
1585
errno = e;
1586
goto mandos_end;
1587
}
1588
1280
retval = 0;
1589
1281
}
1590
1282
}
1603
1295
free(decrypted_buffer);
1604
1296
free(buffer);
1605
1297
if(tcp_sd >= 0){
1606
ret = close(tcp_sd);
1298
ret = (int)TEMP_FAILURE_RETRY(close(tcp_sd));
1607
1299
}
1608
1300
if(ret == -1){
1609
1301
if(e == 0){
1621
1313
return retval;
1622
1314
}
1623
1315
1316
__attribute__((nonnull))
1624
1317
static void resolve_callback(AvahiSServiceResolver *r,
1625
1318
AvahiIfIndex interface,
1626
1319
AvahiProtocol proto,
1763
1456
__attribute__((nonnull, warn_unused_result))
1764
1457
bool get_flags(const char *ifname, struct ifreq *ifr){
1765
1458
int ret;
1766
int old_errno;
1459
error_t ret_errno;
1767
1460
1768
1461
int s = socket(PF_INET6, SOCK_DGRAM, IPPROTO_IP);
1769
1462
if(s < 0){
1770
old_errno = errno;
1463
ret_errno = errno;
1771
1464
perror_plus("socket");
1772
errno = old_errno;
1465
errno = ret_errno;
1773
1466
return false;
1774
1467
}
1775
strncpy(ifr->ifr_name, ifname, IF_NAMESIZE);
1776
ifr->ifr_name[IF_NAMESIZE-1] = '\0'; /* NUL terminate */
1468
strcpy(ifr->ifr_name, ifname);
1777
1469
ret = ioctl(s, SIOCGIFFLAGS, ifr);
1778
1470
if(ret == -1){
1779
1471
if(debug){
1780
old_errno = errno;
1472
ret_errno = errno;
1781
1473
perror_plus("ioctl SIOCGIFFLAGS");
1782
errno = old_errno;
1783
}
1784
if((close(s) == -1) and debug){
1785
old_errno = errno;
1786
perror_plus("close");
1787
errno = old_errno;
1474
errno = ret_errno;
1788
1475
}
1789
1476
return false;
1790
1477
}
1791
if((close(s) == -1) and debug){
1792
old_errno = errno;
1793
perror_plus("close");
1794
errno = old_errno;
1795
}
1796
1478
return true;
1797
1479
}
1798
1480
2059
1741
return;
2060
1742
}
2061
1743
}
2062
int devnull = (int)TEMP_FAILURE_RETRY(open("/dev/null", O_RDONLY));
2063
if(devnull == -1){
2064
perror_plus("open(\"/dev/null\", O_RDONLY)");
2065
return;
2066
}
1744
#ifdef __GLIBC__
1745
#if __GLIBC_PREREQ(2, 15)
2067
1746
int numhooks = scandirat(hookdir_fd, ".", &direntries,
2068
1747
runnable_hook, alphasort);
1748
#else /* not __GLIBC_PREREQ(2, 15) */
1749
int numhooks = scandir(hookdir, &direntries, runnable_hook,
1750
alphasort);
1751
#endif /* not __GLIBC_PREREQ(2, 15) */
1752
#else /* not __GLIBC__ */
1753
int numhooks = scandir(hookdir, &direntries, runnable_hook,
1754
alphasort);
1755
#endif /* not __GLIBC__ */
2069
1756
if(numhooks == -1){
2070
1757
perror_plus("scandir");
2071
close(devnull);
2072
1758
return;
2073
1759
}
2074
1760
struct dirent *direntry;
2075
1761
int ret;
1762
int devnull = (int)TEMP_FAILURE_RETRY(open("/dev/null", O_RDONLY));
1763
if(devnull == -1){
1764
perror_plus("open(\"/dev/null\", O_RDONLY)");
1765
return;
1766
}
2076
1767
for(int i = 0; i < numhooks; i++){
2077
1768
direntry = direntries[i];
2078
1769
if(debug){
2149
1840
perror_plus("openat");
2150
1841
_exit(EXIT_FAILURE);
2151
1842
}
2152
if(close(hookdir_fd) == -1){
1843
if((int)TEMP_FAILURE_RETRY(close(hookdir_fd)) == -1){
2153
1844
perror_plus("close");
2154
1845
_exit(EXIT_FAILURE);
2155
1846
}
2158
1849
perror_plus("dup2(devnull, STDIN_FILENO)");
2159
1850
_exit(EX_OSERR);
2160
1851
}
2161
ret = close(devnull);
1852
ret = (int)TEMP_FAILURE_RETRY(close(devnull));
2162
1853
if(ret == -1){
2163
1854
perror_plus("close");
2164
1855
_exit(EX_OSERR);
2213
1904
free(direntry);
2214
1905
}
2215
1906
free(direntries);
2216
if(close(hookdir_fd) == -1){
1907
if((int)TEMP_FAILURE_RETRY(close(hookdir_fd)) == -1){
2217
1908
perror_plus("close");
2218
1909
} else {
2219
1910
hookdir_fd = -1;
2222
1913
}
2223
1914
2224
1915
__attribute__((nonnull, warn_unused_result))
2225
int bring_up_interface(const char *const interface,
2226
const float delay){
2227
int old_errno = errno;
1916
error_t bring_up_interface(const char *const interface,
1917
const float delay){
1918
error_t old_errno = errno;
2228
1919
int ret;
2229
1920
struct ifreq network;
2230
1921
unsigned int if_index = if_nametoindex(interface);
2240
1931
}
2241
1932
2242
1933
if(not interface_is_up(interface)){
2243
int ret_errno = 0;
2244
int ioctl_errno = 0;
1934
error_t ret_errno = 0, ioctl_errno = 0;
2245
1935
if(not get_flags(interface, &network)){
2246
1936
ret_errno = errno;
2247
1937
fprintf_plus(stderr, "Failed to get flags for interface "
2260
1950
}
2261
1951
2262
1952
if(quit_now){
2263
ret = close(sd);
1953
ret = (int)TEMP_FAILURE_RETRY(close(sd));
2264
1954
if(ret == -1){
2265
1955
perror_plus("close");
2266
1956
}
2316
2006
}
2317
2007
2318
2008
/* Close the socket */
2319
ret = close(sd);
2009
ret = (int)TEMP_FAILURE_RETRY(close(sd));
2320
2010
if(ret == -1){
2321
2011
perror_plus("close");
2322
2012
}
2334
2024
2335
2025
/* Sleep checking until interface is running.
2336
2026
Check every 0.25s, up to total time of delay */
2337
for(int i = 0; i < delay * 4; i++){
2027
for(int i=0; i < delay * 4; i++){
2338
2028
if(interface_is_running(interface)){
2339
2029
break;
2340
2030
}
2350
2040
}
2351
2041
2352
2042
__attribute__((nonnull, warn_unused_result))
2353
int take_down_interface(const char *const interface){
2354
int old_errno = errno;
2043
error_t take_down_interface(const char *const interface){
2044
error_t old_errno = errno;
2355
2045
struct ifreq network;
2356
2046
unsigned int if_index = if_nametoindex(interface);
2357
2047
if(if_index == 0){
2360
2050
return ENXIO;
2361
2051
}
2362
2052
if(interface_is_up(interface)){
2363
int ret_errno = 0;
2364
int ioctl_errno = 0;
2053
error_t ret_errno = 0, ioctl_errno = 0;
2365
2054
if(not get_flags(interface, &network) and debug){
2366
2055
ret_errno = errno;
2367
2056
fprintf_plus(stderr, "Failed to get flags for interface "
2405
2094
}
2406
2095
2407
2096
/* Close the socket */
2408
int ret = close(sd);
2097
int ret = (int)TEMP_FAILURE_RETRY(close(sd));
2409
2098
if(ret == -1){
2410
2099
perror_plus("close");
2411
2100
}
2426
2115
}
2427
2116
2428
2117
int main(int argc, char *argv[]){
2429
mandos_context mc = { .server = NULL, .dh_bits = 0,
2430
.priority = "SECURE256:!CTYPE-X.509"
2431
":+CTYPE-OPENPGP:!RSA:+SIGN-DSA-SHA256",
2432
.current_server = NULL, .interfaces = NULL,
2433
.interfaces_size = 0 };
2118
mandos_context mc = { .server = NULL, .dh_bits = 1024,
2119
.priority = "SECURE256:!CTYPE-X.509:"
2120
"+CTYPE-OPENPGP", .current_server = NULL,
2121
.interfaces = NULL, .interfaces_size = 0 };
2434
2122
AvahiSServiceBrowser *sb = NULL;
2435
2123
error_t ret_errno;
2436
2124
int ret;
2445
2133
AvahiIfIndex if_index = AVAHI_IF_UNSPEC;
2446
2134
const char *seckey = PATHDIR "/" SECKEY;
2447
2135
const char *pubkey = PATHDIR "/" PUBKEY;
2448
const char *dh_params_file = NULL;
2449
2136
char *interfaces_hooks = NULL;
2450
2137
2451
2138
bool gnutls_initialized = false;
2504
2191
.doc = "Bit length of the prime number used in the"
2505
2192
" Diffie-Hellman key exchange",
2506
2193
.group = 2 },
2507
{ .name = "dh-params", .key = 134,
2508
.arg = "FILE",
2509
.doc = "PEM-encoded PKCS#3 file with pre-generated parameters"
2510
" for the Diffie-Hellman key exchange",
2511
.group = 2 },
2512
2194
{ .name = "priority", .key = 130,
2513
2195
.arg = "STRING",
2514
2196
.doc = "GnuTLS priority string for the TLS handshake",
2569
2251
}
2570
2252
mc.dh_bits = (typeof(mc.dh_bits))tmpmax;
2571
2253
break;
2572
case 134: /* --dh-params */
2573
dh_params_file = arg;
2574
break;
2575
2254
case 130: /* --priority */
2576
2255
mc.priority = arg;
2577
2256
break;
2617
2296
.args_doc = "",
2618
2297
.doc = "Mandos client -- Get and decrypt"
2619
2298
" passwords from a Mandos server" };
2620
ret_errno = argp_parse(&argp, argc, argv,
2621
ARGP_IN_ORDER | ARGP_NO_HELP, 0, NULL);
2622
switch(ret_errno){
2299
ret = argp_parse(&argp, argc, argv,
2300
ARGP_IN_ORDER | ARGP_NO_HELP, 0, NULL);
2301
switch(ret){
2623
2302
case 0:
2624
2303
break;
2625
2304
case ENOMEM:
2626
2305
default:
2627
errno = ret_errno;
2306
errno = ret;
2628
2307
perror_plus("argp_parse");
2629
2308
exitcode = EX_OSERR;
2630
2309
goto end;
2636
2315
2637
2316
{
2638
2317
/* Work around Debian bug #633582:
2639
<https://bugs.debian.org/633582> */
2318
<http://bugs.debian.org/633582> */
2640
2319
2641
2320
/* Re-raise privileges */
2642
ret = raise_privileges();
2643
if(ret != 0){
2644
errno = ret;
2321
ret_errno = raise_privileges();
2322
if(ret_errno != 0){
2323
errno = ret_errno;
2645
2324
perror_plus("Failed to raise privileges");
2646
2325
} else {
2647
2326
struct stat st;
2663
2342
}
2664
2343
}
2665
2344
}
2666
close(seckey_fd);
2345
TEMP_FAILURE_RETRY(close(seckey_fd));
2667
2346
}
2668
2347
}
2669
2348
2684
2363
}
2685
2364
}
2686
2365
}
2687
close(pubkey_fd);
2688
}
2689
}
2690
2691
if(dh_params_file != NULL
2692
and strcmp(dh_params_file, PATHDIR "/dhparams.pem" ) == 0){
2693
int dhparams_fd = open(dh_params_file, O_RDONLY);
2694
if(dhparams_fd == -1){
2695
perror_plus("open");
2696
} else {
2697
ret = (int)TEMP_FAILURE_RETRY(fstat(dhparams_fd, &st));
2698
if(ret == -1){
2699
perror_plus("fstat");
2700
} else {
2701
if(S_ISREG(st.st_mode)
2702
and st.st_uid == 0 and st.st_gid == 0){
2703
ret = fchown(dhparams_fd, uid, gid);
2704
if(ret == -1){
2705
perror_plus("fchown");
2706
}
2707
}
2708
}
2709
close(dhparams_fd);
2366
TEMP_FAILURE_RETRY(close(pubkey_fd));
2710
2367
}
2711
2368
}
2712
2369
2713
2370
/* Lower privileges */
2714
ret = lower_privileges();
2715
if(ret != 0){
2716
errno = ret;
2371
ret_errno = lower_privileges();
2372
if(ret_errno != 0){
2373
errno = ret_errno;
2717
2374
perror_plus("Failed to lower privileges");
2718
2375
}
2719
2376
}
2889
2546
errno = bring_up_interface(interface, delay);
2890
2547
if(not interface_was_up){
2891
2548
if(errno != 0){
2892
fprintf_plus(stderr, "Failed to bring up interface \"%s\":"
2893
" %s\n", interface, strerror(errno));
2549
perror_plus("Failed to bring up interface");
2894
2550
} else {
2895
2551
errno = argz_add(&interfaces_to_take_down,
2896
2552
&interfaces_to_take_down_size,
2919
2575
goto end;
2920
2576
}
2921
2577
2922
ret = init_gnutls_global(pubkey, seckey, dh_params_file, &mc);
2578
ret = init_gnutls_global(pubkey, seckey, &mc);
2923
2579
if(ret == -1){
2924
2580
fprintf_plus(stderr, "init_gnutls_global failed\n");
2925
2581
exitcode = EX_UNAVAILABLE;
3047
2703
3048
2704
/* Allocate a new server */
3049
2705
mc.server = avahi_server_new(avahi_simple_poll_get(simple_poll),
3050
&config, NULL, NULL, &ret);
2706
&config, NULL, NULL, &ret_errno);
3051
2707
3052
2708
/* Free the Avahi configuration data */
3053
2709
avahi_server_config_free(&config);
3056
2712
/* Check if creating the Avahi server object succeeded */
3057
2713
if(mc.server == NULL){
3058
2714
fprintf_plus(stderr, "Failed to create Avahi server: %s\n",
3059
avahi_strerror(ret));
2715
avahi_strerror(ret_errno));
3060
2716
exitcode = EX_UNAVAILABLE;
3061
2717
goto end;
3062
2718
}
3097
2753
end:
3098
2754
3099
2755
if(debug){
3100
if(signal_received){
3101
fprintf_plus(stderr, "%s exiting due to signal %d: %s\n",
3102
argv[0], signal_received,
3103
strsignal(signal_received));
3104
} else {
3105
fprintf_plus(stderr, "%s exiting\n", argv[0]);
3106
}
2756
fprintf_plus(stderr, "%s exiting\n", argv[0]);
3107
2757
}
3108
2758
3109
2759
/* Cleanup things */
3120
2770
3121
2771
if(gnutls_initialized){
3122
2772
gnutls_certificate_free_credentials(mc.cred);
2773
gnutls_global_deinit();
3123
2774
gnutls_dh_params_deinit(mc.dh_params);
3124
2775
}
3125
2776
3148
2799
3149
2800
/* Re-raise privileges */
3150
2801
{
3151
ret = raise_privileges();
3152
if(ret != 0){
3153
errno = ret;
2802
ret_errno = raise_privileges();
2803
if(ret_errno != 0){
2804
errno = ret_errno;
3154
2805
perror_plus("Failed to raise privileges");
3155
2806
} else {
3156
2807
3161
2812
/* Take down the network interfaces which were brought up */
3162
2813
{
3163
2814
char *interface = NULL;
3164
while((interface = argz_next(interfaces_to_take_down,
3165
interfaces_to_take_down_size,
3166
interface))){
3167
ret = take_down_interface(interface);
3168
if(ret != 0){
3169
errno = ret;
2815
while((interface=argz_next(interfaces_to_take_down,
2816
interfaces_to_take_down_size,
2817
interface))){
2818
ret_errno = take_down_interface(interface);
2819
if(ret_errno != 0){
2820
errno = ret_errno;
3170
2821
perror_plus("Failed to take down interface");
3171
2822
}
3172
2823
}
3177
2828
}
3178
2829
}
3179
2830
3180
ret = lower_privileges_permanently();
3181
if(ret != 0){
3182
errno = ret;
2831
ret_errno = lower_privileges_permanently();
2832
if(ret_errno != 0){
2833
errno = ret_errno;
3183
2834
perror_plus("Failed to lower privileges permanently");
3184
2835
}
3185
2836
}
3187
2838
free(interfaces_to_take_down);
3188
2839
free(interfaces_hooks);
3189
2840
3190
void clean_dir_at(int base, const char * const dirname,
3191
uintmax_t level){
3192
struct dirent **direntries = NULL;
3193
int dret;
3194
int dir_fd = (int)TEMP_FAILURE_RETRY(openat(base, dirname,
3195
O_RDONLY
3196
| O_NOFOLLOW
3197
| O_DIRECTORY
3198
| O_PATH));
3199
if(dir_fd == -1){
3200
perror_plus("open");
3201
return;
3202
}
3203
int numentries = scandirat(dir_fd, ".", &direntries,
3204
notdotentries, alphasort);
3205
if(numentries >= 0){
3206
for(int i = 0; i < numentries; i++){
3207
if(debug){
3208
fprintf_plus(stderr, "Unlinking \"%s/%s\"\n",
3209
dirname, direntries[i]->d_name);
3210
}
3211
dret = unlinkat(dir_fd, direntries[i]->d_name, 0);
3212
if(dret == -1){
3213
if(errno == EISDIR){
3214
dret = unlinkat(dir_fd, direntries[i]->d_name,
3215
AT_REMOVEDIR);
3216
}
3217
if((dret == -1) and (errno == ENOTEMPTY)
3218
and (strcmp(direntries[i]->d_name, "private-keys-v1.d")
3219
== 0) and (level == 0)){
3220
/* Recurse only in this special case */
3221
clean_dir_at(dir_fd, direntries[i]->d_name, level+1);
3222
dret = 0;
3223
}
3224
if((dret == -1) and (errno != ENOENT)){
3225
fprintf_plus(stderr, "unlink(\"%s/%s\"): %s\n", dirname,
3226
direntries[i]->d_name, strerror(errno));
3227
}
3228
}
3229
free(direntries[i]);
3230
}
3231
3232
/* need to clean even if 0 because man page doesn't specify */
3233
free(direntries);
3234
dret = unlinkat(base, dirname, AT_REMOVEDIR);
3235
if(dret == -1 and errno != ENOENT){
3236
perror_plus("rmdir");
3237
}
3238
} else {
3239
perror_plus("scandirat");
3240
}
3241
close(dir_fd);
3242
}
3243
3244
2841
/* Removes the GPGME temp directory and all files inside */
3245
2842
if(tempdir != NULL){
3246
clean_dir_at(-1, tempdir, 0);
2843
struct dirent **direntries = NULL;
2844
int tempdir_fd = (int)TEMP_FAILURE_RETRY(open(tempdir, O_RDONLY
2845
| O_NOFOLLOW
2846
| O_DIRECTORY
2847
| O_PATH));
2848
if(tempdir_fd == -1){
2849
perror_plus("open");
2850
} else {
2851
#ifdef __GLIBC__
2852
#if __GLIBC_PREREQ(2, 15)
2853
int numentries = scandirat(tempdir_fd, ".", &direntries,
2854
notdotentries, alphasort);
2855
#else /* not __GLIBC_PREREQ(2, 15) */
2856
int numentries = scandir(tempdir, &direntries, notdotentries,
2857
alphasort);
2858
#endif /* not __GLIBC_PREREQ(2, 15) */
2859
#else /* not __GLIBC__ */
2860
int numentries = scandir(tempdir, &direntries, notdotentries,
2861
alphasort);
2862
#endif /* not __GLIBC__ */
2863
if(numentries >= 0){
2864
for(int i = 0; i < numentries; i++){
2865
ret = unlinkat(tempdir_fd, direntries[i]->d_name, 0);
2866
if(ret == -1){
2867
fprintf_plus(stderr, "unlinkat(open(\"%s\", O_RDONLY),"
2868
" \"%s\", 0): %s\n", tempdir,
2869
direntries[i]->d_name, strerror(errno));
2870
}
2871
free(direntries[i]);
2872
}
2873
2874
/* need to clean even if 0 because man page doesn't specify */
2875
free(direntries);
2876
if(numentries == -1){
2877
perror_plus("scandir");
2878
}
2879
ret = rmdir(tempdir);
2880
if(ret == -1 and errno != ENOENT){
2881
perror_plus("rmdir");
2882
}
2883
}
2884
TEMP_FAILURE_RETRY(close(tempdir_fd));
2885
}
3247
2886
}
3248
2887
3249
2888
if(quit_now){
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0