Skip to content

Commit

Permalink
Explicitly forbid mutating agg jobs, collections
Browse files Browse the repository at this point in the history
Resolves #406
  • Loading branch information
tgeoghegan committed Jun 15, 2023
1 parent c5868ea commit 8ff46ab
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions draft-ietf-ppm-dap.md
Original file line number Diff line number Diff line change
Expand Up @@ -1461,6 +1461,12 @@ The Helper responds to the Leader with HTTP status code 201 Created and a body
consisting of the `AggregationJobResp`, with media type
"application/dap-aggregation-job-resp".

Aggregation job initialization MUST be idempotent. That is, further requests to
initialize some aggregation job whose body is identical to the first request
MUST succeed. However, changing an aggregation job's parameters is illegal, so
further requests with a different body MUST fail with an HTTP client error
status code.

Finally, if `state == Continued(prep_state)`, then the Helper stores `state` to
prepare for the next continuation step ({{aggregation-helper-continuation}}).
Otherwise, if `state == Finished(out_share)`, then the Helper stores `out_share`
Expand Down Expand Up @@ -1871,6 +1877,11 @@ The Leader then begins working with the Helper to aggregate the reports
satisfying the query (or continues this process, depending on the VDAF) as
described in {{aggregate-flow}}.

Collection job creation MUST be idempotent. That is, further requests to
create some collection job whose body is identical to the first request MUST
succeed. However, changing a collection job's parameters is illegal, so further
requests with a different body MUST fail with an HTTP client error status code.

After receiving the response to its `CollectionReq`, the Collector makes an HTTP
`POST` request to the collection job URI to check on the status of the collect
job and eventually obtain the result. If the collection job is not finished
Expand Down

0 comments on commit 8ff46ab

Please sign in to comment.