Skip to content

Reuse existing definitions for Unix time and Structured fields. #1313

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
richanna merged 2 commits into from
Dec 1, 2020
Merged

Reuse existing definitions for Unix time and Structured fields. #1313

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
22a1be3
Reuse existing definitions for Unix time and Structured fields.
ioggstream Oct 25, 2020
2aac52c
Merge branch 'master' into ioggstream-1311-bis
richanna Dec 1, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 5 additions & 7 deletions draft-ietf-httpbis-message-signatures.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,10 +55,6 @@ normative:
target: https://pubs.opengroup.org/onlinepubs/9699919799/
title: The Open Group Base Specifications Issue 7, 2018 edition
date: 2018
StructuredFields:
target: https://datatracker.ietf.org/doc/draft-ietf-httpbis-header-structure
title: Structured Field Vaues for HTTP
date: 2020

informative:
RFC3339:
Expand Down Expand Up @@ -164,6 +160,8 @@ Verifier
:
: An entity that is verifying or has verified an HTTP Message Signature against an HTTP Message. Note that an HTTP Message Signature may be verified multiple times, potentially by different entities.

The term "Unix time" is defined by {{POSIX.1}} [section 4.16](http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_16).

This document contains non-normative examples of partial and complete HTTP messages. To improve readability, header fields may be split into multiple lines, using the `obs-fold` syntax. This syntax is deprecated in [MESSAGING], and senders MUST NOT generate messages that include it.


Expand Down Expand Up @@ -215,7 +213,7 @@ The following table shows example canonicalized values for header fields, given

## Dictionary Structured Field Members

An individual member in the value of a Dictionary Structured Field is identified by the lowercased field name, followed by a semicolon `":"`, followed by the member name. An individual member in the value of a Dictionary Structured Field is canonicalized by applying the serialization algorithm described in Section 4.1.2 of {{StructuredFields}} on a Dictionary containing only that member.
An individual member in the value of a Dictionary Structured Field is identified by the lowercased field name, followed by a semicolon `":"`, followed by the member name. An individual member in the value of a Dictionary Structured Field is canonicalized by applying the serialization algorithm described in Section 4.1.2 of {{!StructuredFields=I-D.ietf-httpbis-header-structure}} on a Dictionary containing only that member.

### Canonicalization Examples

Expand Down Expand Up @@ -264,15 +262,15 @@ The following table shows example canonicalized values for different content ide

The signature's Creation Time ({{signature-metadata}}) is identified by the `*created` identifier.

Its canonicalized value is an Integer String containing the signature's Creation Time expressed as the number of seconds since the Epoch, as defined in [Section 4.16](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_16) of {{POSIX.1}}.
Its canonicalized value is an Integer String containing the signature's Creation Time expressed in "Unix time".

> The use of seconds since the Epoch to canonicalize a timestamp simplifies processing and avoids timezone management required by specifications such as [RFC3339].

## Signature Expiration Time

The signature's Expiration Time ({{signature-metadata}}) is identified by the `*expires` identifier.

Its canonicalized value is a Decimal String containing the signature's Expiration Time expressed as the number of seconds since the Epoch, as defined in [Section 4.16](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_16) of {{POSIX.1}}.
Its canonicalized value is a Decimal String containing the signature's Expiration Time expressed in "Unix time".

## Target Endpoint

Expand Down