Commit Graph

193 Commits

Author SHA1 Message Date
Itamar Turner-Trauring
442d61da7d Get rid of separate renewal of leases in HTTP API. 2021-08-19 16:44:05 -04:00
Jean-Paul Calderone
602d4c5a91 improve the "create lease" endpoint
* Simplify some language using terms from our new glossary
* explicitly state the two success-case behaviors
* make the error-case behavior different from the success-case behavior
* link to some tickets about future work in this area
2021-08-19 10:26:45 -04:00
Jean-Paul Calderone
ff6fa4a922
Merge pull request #1106 from LeastAuthority/3765.gbs-glossary
Start a GBS glossary

Fixes: ticket:3765
2021-08-18 16:45:26 -04:00
Jean-Paul Calderone
c5a03f4116 elaborate on `already-have and allocated` somewhat 2021-08-18 10:17:48 -04:00
Jean-Paul Calderone
0f78d8df25 a glossary 2021-08-17 14:58:34 -04:00
Jean-Paul Calderone
47dfe5d4f0 fix typo 2021-08-17 14:11:08 -04:00
Jean-Paul Calderone
65f71135e1 Spell the endpoint correctly 2021-08-17 14:10:50 -04:00
Jean-Paul Calderone
23212fc816 add some example client/server interactions 2021-08-17 14:01:44 -04:00
Jean-Paul Calderone
89e1865f78 Forget about runtime performance 2021-04-02 09:27:58 -04:00
Jean-Paul Calderone
c15fe70378 Replace plain "Tahoe" with "Tahoe-LAFS" as the name of the project/software/system/etc 2021-04-01 12:53:25 -04:00
Jean-Paul Calderone
94b92202c3 Try to clarify requirement for some security properties 2021-03-30 12:45:22 -04:00
Jean-Paul Calderone
0f0398aeaf minor typography 2021-03-30 12:39:50 -04:00
Jean-Paul Calderone
e843206524 expand on justification for performance complaints 2021-03-30 12:39:27 -04:00
Jean-Paul Calderone
835c050e6c fix word-o 2021-03-30 12:39:22 -04:00
Jean-Paul Calderone
2de90c4bfe Merge remote-tracking branch 'origin/master' into 3645.gbs-expanded-motivation 2021-03-30 10:43:38 -04:00
Jean-Paul Calderone
0485eeb126 Attempt to explain inclusion of lease secrets in the body 2021-03-30 10:03:03 -04:00
Jean-Paul Calderone
31c838d584 the expanded motivation 2021-03-22 20:28:24 -04:00
Jean-Paul Calderone
6520d3a505 add the APIs 2021-03-22 13:44:48 -04:00
Jean-Paul Calderone
4a117e5d9b Also get rid of the footnote target 2021-03-22 09:25:22 -04:00
Jean-Paul Calderone
bc86820273 Change v=2 to v=1 2021-03-22 09:10:35 -04:00
Jean-Paul Calderone
0d2e9e8e6a match local prevailing convention for naming 2021-03-19 15:43:40 -04:00
Jean-Paul Calderone
6aad53a598 explain why this conclusion is fine 2021-03-19 15:03:36 -04:00
Jean-Paul Calderone
e3a6d75962
Remove the obvious documentation references 2020-02-13 10:23:27 -05:00
meejah
d964be6340 remove code details 2019-06-23 11:12:55 -06:00
heartsucker
33090ef6e2 remove last remaining references to pycryptopp 2019-06-13 22:19:28 -06:00
Jean-Paul Calderone
687c4c8f4f Talk about lack of creation 2018-06-29 11:30:45 -04:00
Jean-Paul Calderone
635c0c5db0 Slots are not separately, explicitly created 2018-06-29 11:30:28 -04:00
Jean-Paul Calderone
250465f810 Discard base32 and SHA1. 2018-06-29 11:11:30 -04:00
Jean-Paul Calderone
ff12263ed5 remove an extra extra word 2018-06-27 16:53:37 -04:00
Jean-Paul Calderone
209c8694f9 Simplify language 2018-06-27 16:53:17 -04:00
Jean-Paul Calderone
4cd018fc11 Consistently name the gbs information
And replace the flag with the full information otherwise the client
cannot find the gbs server without talking to the introducer again.
2018-06-27 16:51:47 -04:00
Jean-Paul Calderone
4e5ec27d50 Use that : notation consistently here 2018-06-27 16:49:45 -04:00
Jean-Paul Calderone
145ee3b6ab mention the introducer 2018-06-27 16:39:02 -04:00
Jean-Paul Calderone
c43eacc3a9 clarify which party is vulnerable 2018-06-13 08:27:45 -04:00
Jean-Paul Calderone
c3011a434b Specify preferred encoding and encoding negotiation 2018-06-06 13:46:45 -04:00
Jean-Paul Calderone
b8cfee79e3 frame it a little more 2018-06-06 13:31:34 -04:00
Jean-Paul Calderone
4e10f7971a discuss decision to use query args 2018-05-29 10:52:37 -04:00
Jean-Paul Calderone
3d3c3d2eb4 elaborate on the transition stages
talk about cases of each stage and desired behavior
2018-05-22 09:57:39 -04:00
Jean-Paul Calderone
a592053b18 refer to GBS more than HTTP 2018-05-22 09:57:29 -04:00
Jean-Paul Calderone
534b8db318 markup and spelling 2018-05-22 09:57:18 -04:00
Jean-Paul Calderone
acf541a0be try to make the example more useful 2018-05-22 09:08:59 -04:00
Jean-Paul Calderone
504452f1fd clean up description of certificate validity period 2018-05-22 09:00:30 -04:00
Jean-Paul Calderone
ab37b5eabb clean up the description of the tls usage 2018-05-22 09:00:10 -04:00
Jean-Paul Calderone
65103445ea secrecy is the kind of security we're talking about here 2018-05-22 08:43:19 -04:00
Jean-Paul Calderone
97176e88d4 but it is part of this proposed solution 2018-05-22 08:43:12 -04:00
Jean-Paul Calderone
bf305b91e4 HTTP *per se* is not a requirement 2018-05-22 08:42:55 -04:00
Jean-Paul Calderone
5ede9662bb fix typo 2018-05-22 08:42:39 -04:00
Jean-Paul Calderone
44afc1de03 talk about a non-security requirement! 2018-05-22 08:42:28 -04:00
Jean-Paul Calderone
ff48e67418 flop some heading levels around 2018-05-22 08:42:16 -04:00
Jean-Paul Calderone
c321c937f6 copy edits and another option for tubID length 2018-05-22 08:27:31 -04:00
Jean-Paul Calderone
b73e95ec30 discuss protocol identification 2018-05-22 08:27:24 -04:00
Jean-Paul Calderone
17ae8a191b I like it 2018-05-22 08:27:15 -04:00
Jean-Paul Calderone
4592bf3de2 wip - more edits of the security material & transition plan 2018-05-21 16:23:53 -04:00
Jean-Paul Calderone
176732dcaf gotta announce the new fURL sometime 2018-05-21 14:59:46 -04:00
Jean-Paul Calderone
16076f9bd7 be explicit about the security goals being achieved 2018-05-21 14:59:28 -04:00
Jean-Paul Calderone
11184939e8 It's SPKI not public key 2018-05-21 14:59:10 -04:00
Jean-Paul Calderone
fa4384e36e add a security summary (noting foolscap features)
also, expanded discussion.
2018-05-21 14:14:53 -04:00
Jean-Paul Calderone
cea0ae8004 tahoe-lafs is already good at redundant storage 2018-05-21 14:14:39 -04:00
Jean-Paul Calderone
4626a09224 elaborate on reputation-based assumptions 2018-05-21 13:31:16 -04:00
Jean-Paul Calderone
931ffec005 semantic newlines 2018-05-21 13:31:10 -04:00
Jean-Paul Calderone
d09b613d59 make mutable and immutable read the same 2018-05-18 15:45:22 -04:00
Jean-Paul Calderone
f4b59b166d no more int-key mappings 2018-05-18 13:08:13 -04:00
Jean-Paul Calderone
3898911fcc consistent title levels 2018-05-18 13:07:18 -04:00
Jean-Paul Calderone
f09ed91ab6 collapse these two APIs, they are the same
also add mutable .../shares listing
2018-05-18 13:01:57 -04:00
Jean-Paul Calderone
9388903515 need a way to advise of corrupt mutable shares 2018-05-18 13:01:45 -04:00
Jean-Paul Calderone
c6a8e4535c mount this beneath the storage index resource 2018-05-18 13:01:19 -04:00
Jean-Paul Calderone
69195e0a5a maybe we don't even want Range 2018-05-18 13:01:10 -04:00
Jean-Paul Calderone
6c664d69a8 consistent non-abbreviation 2018-05-18 13:01:03 -04:00
Jean-Paul Calderone
9402698918 Harmonize hyphens 2018-05-18 11:11:04 -04:00
Jean-Paul Calderone
943b389d77 Banish slots and deemphasize buckets 2018-05-18 11:09:17 -04:00
Jean-Paul Calderone
3ef1ceeead markup 2018-05-18 09:13:57 -04:00
Jean-Paul Calderone
dd78fe81d0 note the failure case 2018-05-18 09:05:46 -04:00
Jean-Paul Calderone
fb51c1df40 correct the sample code 2018-05-18 09:05:37 -04:00
Jean-Paul Calderone
00ae3b5663 discuss encoded hash length 2018-05-18 09:05:25 -04:00
Jean-Paul Calderone
d3f9ee2406 link to a different upload resume strategy 2018-05-17 15:09:50 -04:00
Jean-Paul Calderone
113af95984 when you are sending a range, you use Content-Range
when you are _asking_ for a range, you use Range
2018-05-17 15:08:03 -04:00
Jean-Paul Calderone
2bbe51a01d Discuss Range requests for uploads 2018-05-17 14:11:37 -04:00
Jean-Paul Calderone
d011c2f936 rst twiddles 2018-05-17 14:11:32 -04:00
Jean-Paul Calderone
eb9b44885e simple naming mistake
this must be a different endpoint or it is ambiguous with bucket
interactions.  plus it makes more sense that "place where storage
indexes are" is different from "place where buckets are" although I
am still uncomfortable with the idea that "storage indexes" are things
and not ... indexes ...
2018-05-17 14:01:46 -04:00
Jean-Paul Calderone
4e99f22c2b make containers plural I suppose 2018-05-17 14:01:36 -04:00
Jean-Paul Calderone
1d3f9715f8 trivial json markup fix 2018-05-17 14:01:18 -04:00
Jean-Paul Calderone
5fa71484e3 call out the base32/base64 mismatch 2018-05-16 10:16:58 -04:00
Jean-Paul Calderone
67ff44039f add values to the example 2018-05-16 09:49:58 -04:00
Jean-Paul Calderone
4bed6363a3 be specific about public key comparison 2018-05-16 09:49:48 -04:00
Jean-Paul Calderone
4ad5b5ab46 address slots 2018-05-15 16:00:40 -04:00
Jean-Paul Calderone
c824bcd8b2 make the share a logical child of the bucket? 2018-05-15 15:28:03 -04:00
Jean-Paul Calderone
6d84cd8179 these are gone 2018-05-15 15:27:53 -04:00
Jean-Paul Calderone
178cb58a57 dunno how much the risk is elevated 2018-05-15 15:27:33 -04:00
Jean-Paul Calderone
6b72750397 reduce verticality 2018-05-15 15:27:26 -04:00
Jean-Paul Calderone
5f88cd0687 rework the security section 2018-05-15 15:16:01 -04:00
Jean-Paul Calderone
357820357c front matter 2018-05-15 15:04:20 -04:00
Jean-Paul Calderone
465489fd0b re-organize 2018-05-15 14:48:42 -04:00
Jean-Paul Calderone
23242266dc consistent style 2018-05-15 14:16:02 -04:00
Jean-Paul Calderone
a3d4edca7d retrieve server version and info 2018-05-15 10:10:21 -04:00
Jean-Paul Calderone
73d903ad96 client-selected resource identifier -> PUT 2018-05-15 09:42:20 -04:00
Jean-Paul Calderone
5b35f591f1 write share data 2018-05-15 09:42:10 -04:00
Jean-Paul Calderone
b6572e2856 clear now they are not necessarily consecutive 2018-05-15 09:41:45 -04:00
Jean-Paul Calderone
599bf074e3 more spurious indentation 2018-05-15 09:07:58 -04:00
Jean-Paul Calderone
8e9ba52118 spurious indentation 2018-05-15 09:07:07 -04:00
Jean-Paul Calderone
53dce7eafc first pass over read and write api 2018-05-14 15:58:21 -04:00