NNCP - Revision history

Klinger: Category:CLI added

2025-04-30T19:02:10Z

← Older revision		Revision as of 19:02, 30 April 2025
Line 258:		Line 258:
	[[Category:Networking]]		[[Category:Networking]]
	[[Category:Server]]		[[Category:Server]]
			[[Category:CLI]]

Klinger: syntax

2025-04-30T19:01:15Z

syntax

← Older revision		Revision as of 19:01, 30 April 2025
Line 256:		Line 256:
	</syntaxhighlight>		</syntaxhighlight>

	[Category:Networking]		[[Category:Networking]]
	[Category:Server]		[[Category:Server]]

Klinger: [Category:Networking] [Category:Server]

2025-04-30T19:00:34Z

[Category:Networking] [Category:Server]

← Older revision		Revision as of 19:00, 30 April 2025
Line 255:		Line 255:
	}		}
	</syntaxhighlight>		</syntaxhighlight>

			[Category:Networking]
			[Category:Server]

Ehmry: /* Sending mail */ sendmail typo

2025-04-29T10:33:30Z

Sending mail: sendmail typo

← Older revision		Revision as of 10:33, 29 April 2025
Line 168:		Line 168:
	=== Sending mail ===		=== Sending mail ===

	To send mail alice configures her client ~~send~~ mail to her mailserver by using nncp-exec as if it were <code>sendmail</code>.		To send mail alice configures her client to relay mail to her mailserver by using nncp-exec as if it were <code>sendmail</code>.

	<code>		<code>

Ehmry: /* Relaying email */ strip tags from the user part of email addresses

2025-04-29T10:32:48Z

Relaying email: strip tags from the user part of email addresses

← Older revision		Revision as of 10:32, 29 April 2025
Line 243:		Line 243:

	# Configure a NNCP Mail Delivery Agent (MDA) for local users.		# Configure a NNCP Mail Delivery Agent (MDA) for local users.
	action "nncp" mda "/run/wrappers/bin/nncp-exec -quiet %{~~rcpt~~.user} sendmail"		action "nncp" mda "/run/wrappers/bin/nncp-exec -quiet %{dest.user:strip} sendmail"

	# Configure SMTP relaying to external domains.		# Configure SMTP relaying to external domains.

Ehmry: Add configurations examples for relaying email.

2025-04-29T09:52:08Z

Add configurations examples for relaying email.

Show changes

Ehmry: Add configuration example for receiving email.

2025-04-29T08:57:05Z

Add configuration example for receiving email.

@@ Line 118: / Line 118: @@
 <syntaxhighlight lang="console">
 $ nix-store --export ./result | nncp-exec "$NODE" nix-store-import
 </syntaxhighlight>

Ehmry: Fix typo, update status of caller and daemon services.

2025-04-29T08:48:12Z

Fix typo, update status of caller and daemon services.

← Older revision		Revision as of 08:48, 29 April 2025
Line 16:		Line 16:
	$ nncp-cfgnew -nocomments > /etc/secrets/nncp.hjson		$ nncp-cfgnew -nocomments > /etc/secrets/nncp.hjson
	</syntaxhighlight>		</syntaxhighlight>
	This ~~file~~ generated file be stripped down to include only the <code>self</code> and <code>neigh</code> sections:		This generated file should be stripped down to include only the <code>self</code> and <code>neigh</code> sections:

	<pre>		<pre>
Line 88:		Line 88:
	== Callers and Daemons ==		== Callers and Daemons ==

	~~Automatically starting~~ the <code>nncp-caller</code> and <code>nncp-daemon</code> ~~programs is not yet available from a NixOS module~~.		The NNCP caller and daemon can be enabled for NixOS using the options <code>services.nncp.caller</code> and <code>services.nncp.daemon</code>.

			<syntaxhighlight lang="nix">
			{
			services.nncp = let
			attrs = {
			enable = true;
			extraArgs = [ "-autotoss" ];
			};
			in {
			caller = attrs;
			daemon = attrs;
			};
			}
			</syntaxhighlight>

	== Remote command execution ==		== Remote command execution ==

imported>Ehmry: Add store path importing example

2023-08-14T08:25:10Z

Add store path importing example

← Older revision		Revision as of 08:25, 14 August 2023
Line 89:		Line 89:

	Automatically starting the <code>nncp-caller</code> and <code>nncp-daemon</code> programs is not yet available from a NixOS module.		Automatically starting the <code>nncp-caller</code> and <code>nncp-daemon</code> programs is not yet available from a NixOS module.

			== Remote command execution ==

			=== Store path importing ===

			NNCP config:
			<syntaxhighlight lang="nix">
			{
			programs.nncp.settings.neigh.${NODE}.exec.nix-store-import = "nix-store --import";
			}
			</syntaxhighlight>

			Export command:
			<syntaxhighlight lang="console">
			$ nix-store --export ./result \| nncp-exec "$NODE" nix-store-import
			</syntaxhighlight>

imported>Ehmry: Quick first version

2023-05-22T09:02:53Z

Quick first version

New page

<blockquote>
NNCP (Node to Node copy) is a collection of utilities simplifying secure store-and-forward files, mail and command exchanging.

These utilities are intended to help build up small size (dozens of nodes) ad-hoc friend-to-friend (F2F) statically routed darknet delay-tolerant networks for fire-and-forget secure reliable files, file requests, Internet mail and commands transmission. All packets are integrity checked, end-to-end encrypted, explicitly authenticated by known participants public keys. Onion encryption is applied to relayed packets. Each node acts both as a client and server, can use push and poll behaviour model. Also there is multicasting areas support.

Out-of-box offline sneakernet/floppynet, dead drops, sequential and append-only CD-ROM/tape storages, air-gapped computers support. But online TCP daemon with full-duplex resumable data transmission exists.
</blockquote>
<cite>http://www.nncpgo.org/</cite>

== Configuration ==

NNCP can be installed and configured manually or via [https://nixos.org/manual/nixos/unstable/options.html#opt-programs.nncp.enable NixOS configuration].

In any case the first step is to generate a configuration file.
<syntaxhighlight lang="console">
$ nncp-cfgnew -nocomments > /etc/secrets/nncp.hjson
</syntaxhighlight>
This file generated file be stripped down to include only the <code>self</code> and <code>neigh</code> sections:

<pre>
{
self: {
# DO NOT show anyone your private keys!!!
id: HFTEI…SITTA
exchpub: RG2SF…7JEYA
exchprv: 4YAON…LWCMA
signpub: ASKTA…EFVSQ
signprv: Z6Q4R…SC2ZI
noiseprv: ACJVW…7G7NA
noisepub: J2W5C…SZM6Q
}
neigh: {
self: {
id: HFTEI…SITTA
exchpub: RG2SF…7JEYA
signpub: ASKTA…EFVSQ
noisepub: J2W5C…SZM6Q
}
}
}
</pre>

The location of this file should be defined in your NixOS configuration at [https://nixos.org/manual/nixos/unstable/options.html#opt-programs.nncp.secrets programs.nncp.secrets]:
<syntaxhighlight lang="nix">
{
programs.nncp = {
enable = true;
secrets = [ "/etc/secrets/nncp.hjson" ];
};
}
</syntaxhighlight>

In this example the secret keys are stored outside the Nix store an we will add public keys for neighboring nodes in the NixOS configuration.

<syntaxhighlight lang="nix">
{
programs.nncp = {
enable = true;
secrets = [ "/etc/secrets/nncp.hjson" ];
neigh = {
alice = {
# information that Alice has given us about her "self".
id = "D6BOO…YTYWQ";
exchpub = "V4WJ6…4VA3Q";
signpub = "NZLTN…HCGOA";
noisepub = "UNL2J…7FRDA";
# We can connect directly to Alice over network.
addr = {
lan = "[fe80::1234%igb0]:5400";
internet = "alice.com:3389";
proxied = "|ssh remote.host nncp-daemon -ucspi";
};
};
bob = {
# information that Bob has given us about his "self".
id = "3I3HC…F4P4Q";
exchpub = "7VJN7…BWUTQ";
signpub = "E6XSC…5VYRA";
noisepub = "TAKXG…Z6MZQ";
# We cannoct connect to Bob but be can relay packets to him thru Alice.
via = [ "alice" ];
};
};
};
}
</syntaxhighlight>

== Callers and Daemons ==

Automatically starting the <code>nncp-caller</code> and <code>nncp-daemon</code> programs is not yet available from a NixOS module.