HttpAuth.pm

filter: Statementstmt 90.4% 19 / 21 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 7 / 7 Podpod n/a totaltotal 92.8% 26 / 28 CC 1 SCAR 0.4
CC
1
Cov
90%
BEGIN
1.3
BEGIN
1.0
BEGIN
1.0
CRAP 1.0
« Zap.pm ↑ Summary Event.pm »
1 package Net::Nostr::HttpAuth;
2  
3 2 ▶use strictures 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 2 ▶use Net::Nostr::_ConstructorArgs ();
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 2 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 2 ▶use JSON ();
Subroutine BEGIN: called CC=1 SCAR=0.0
9 2 ▶use MIME::Base64 qw(encode_base64 decode_base64);
Subroutine BEGIN: called CC=1 SCAR=0.0
10 2 ▶use Digest::SHA qw(sha256_hex);
Subroutine BEGIN: called CC=1 SCAR=0.0
11 0 ▶use Net::Nostr::Event;
Subroutine BEGIN: called CC=1 SCAR=2.6
12 use Exporter 'import';
13  
14 our @EXPORT_OK = qw(
15 create_auth_event
16 create_auth_header
17 parse_auth_header
18 validate_auth_event
19 );
20  
21 my $HEX64 = qr/\A[0-9a-f]{64}\z/;
22  
23 sub create_auth_event {
24 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
25 my $pubkey = $args{pubkey} // croak "pubkey is required";
26 my $url = $args{url} // croak "url is required";
27 my $method = $args{method} // croak "method is required";
28  
29 croak "pubkey must be 64-char lowercase hex" unless $pubkey =~ $HEX64;
30  
31 my @tags = (
32 ['u', $url],
33 ['method', $method],
34 );
35  
36 # SHOULD include payload hash for body-bearing methods
37 if (defined $args{payload}) {
38 push @tags, ['payload', sha256_hex($args{payload})];
39 }
40  
41 return Net::Nostr::Event->new(
42 pubkey => $pubkey,
43 kind => 27235,
44 content => '',
45 tags => \@tags,
46 created_at => $args{created_at} // time(),
47 );
48 }
49  
50 sub create_auth_header {
51 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
52 my $key = $args{key} // croak "key is required";
53 my $url = $args{url} // croak "url is required";
54 my $method = $args{method} // croak "method is required";
55  
56 my $event = create_auth_event(
57 pubkey => $key->pubkey_hex,
58 url => $url,
59 method => $method,
60 (defined $args{payload} ? (payload => $args{payload}) : ()),
61 (defined $args{created_at} ? (created_at => $args{created_at}) : ()),
62 );
63  
64 $key->sign_event($event);
65  
66 my $json = JSON->new->utf8->encode($event->to_hash);
67 my $b64 = encode_base64($json, '');
68 return "Nostr $b64";
69 }
70  
71 sub parse_auth_header {
72 my ($header) = @_;
73 croak "authorization header is required" unless defined $header && length $header;
74  
75 my ($scheme, $b64) = split / /, $header, 2;
76 croak "expected Nostr authorization scheme, got $scheme"
77 unless defined $scheme && $scheme eq 'Nostr';
78 croak "missing base64 data" unless defined $b64 && length $b64;
79  
80 my $json = decode_base64($b64);
81 croak "invalid base64 data" unless defined $json && length $json;
82  
83 my $data = eval { JSON->new->utf8->decode($json) };
84 croak "invalid JSON in authorization header: $@" if $@;
85  
86 return Net::Nostr::Event->from_wire($data);
87 }
88  
89 sub validate_auth_event {
90 my ($event, %opts) = @_;
91 croak "event is required" unless defined $event;
92 my $url = $opts{url} // croak "url is required";
93 my $method = $opts{method} // croak "method is required";
94 my $time_window = $opts{time_window} // 60;
95  
96 # 0. Verify event ID and signature (NIP-01 requirement)
97 $event->validate;
98  
99 # 1. Kind MUST be 27235
100 croak "kind must be 27235" unless $event->kind == 27235;
101  
102 # 2. created_at MUST be within time window
103 my $age = abs(time() - $event->created_at);
104 croak "created_at outside time window ($age > $time_window seconds)"
105 if $age > $time_window;
106  
107 # 3. u tag MUST match exactly
108 my $u_value;
109 my $method_value;
110 my $payload_value;
111 for my $tag (@{$event->tags}) {
112 if ($tag->[0] eq 'u' && !defined $u_value) {
113 $u_value = $tag->[1];
114 } elsif ($tag->[0] eq 'method' && !defined $method_value) {
115 $method_value = $tag->[1];
116 } elsif ($tag->[0] eq 'payload' && !defined $payload_value) {
117 $payload_value = $tag->[1];
118 }
119 }
120  
121 croak "missing u tag" unless defined $u_value;
122 croak "u tag does not match request URL"
123 unless $u_value eq $url;
124  
125 # 4. method tag MUST match
126 croak "missing method tag" unless defined $method_value;
127 croak "method tag does not match request method"
128 unless $method_value eq $method;
129  
130 # MAY: check payload hash if server provides the body
131 if (defined $payload_value && defined $opts{payload}) {
132 my $expected = sha256_hex($opts{payload});
133 croak "payload tag does not match request body hash"
134 unless $payload_value eq $expected;
135 }
136  
137 return 1;
138 }
139  
140 1;
141  
142 __END__
« Zap.pm ↑ Summary Event.pm »