Comments on WSS-SOAPMessageSecurity-122903-merged.pdf

[NISHIMURA Toshihiro <nishimura.toshi@jp.fujitsu.com>]

Hi,

One question before editorial comments.
Have we discussed about the URI for STR Dereference Transform?
Currently, schemas.xmlsoap.org namespace is used:
  http://schemas.xmlsoap.org/2003/06/STR-Transform

Here are editorial comments on
WSS-SOAPMessageSecurity-122903-merged.pdf.

- Line 107
  "WSS-SOAP Message Security" -> "WSS: SOAP Message Security"

- Line 161
  "this specification uses the notational convention of WSS: SOAP
   Message Security."
  "this specification" is "WSS: SOAP Message Security". It refers itself.

- Line 166
  Missing period (".").

- Lines 167-171 states almost same thing with Line 182-185, but
  mentions different SOAP version for detailed example.

- Line 192 (table)
  SHA-1 -> SHA
    or
  Secure Hash Algorithm -> Secure Hash Algorithm 1


- Line 194
  "The following (non-normative) table defines acronyms and
  abbreviations for this document."
  Unnecessary line. (2.4 is Terminology section, not Acronyms
  section.)

- Line 218
  wth -> with

- Line 337
  Missing Period (".") at the end of this line.

- Line 340
  "Lines (008) to (035)" -> "Lines (008) to (023)"

- Line 354
  Why "body" is in italic font?

- Line 369
  Unnecessary bullet.

- Line 422
  Why 'in the form of a' is quoted?

- Lines 458-468
  S:role is explained here but S:mustUnderstand is not.

- Line 476
  "<wsse: Security>" (whitespace)

- Lines 477, 481
  "must" should be "MUST" ?

- Line 573
  "URIe" -> "URI"

- Line 614
  "SecurityTokenReference" -> "<wsse:SecurityTokenReference>"

- Line 619
  "SecurityTokenReference" -> "<wsse:SecurityTokenReference> element"
  "<Security>" -> "<wsse:Security>"

- Line 634 
  "<Reference>" -> "<wsse:Reference>"
  "<SecurityTokenReference>" -> "<wsse:SecurityTokenReference>"

- Line 637
  "<SecurityToken>" -> "security token" (?)

- Line 708
  "ds:KeyName" -> "<ds:KeyName>" (?)

- Line 812 uses "Message provider" and Line 813 uses "producer of the
  message"

- Line 868-869
  "The fundamental difference .... is which namespace declarations
  which are placed in the output."
  The first "which" should be "the" ?

- Lines 940, 945, 946, 949, 951, 953
  "<SecurityTokenReference>" -> "<wsse:SecurityTokenReference>"

- Lines 962, 963, 965, 966, 976, 978, 979, 980, 981, 982
  Add "ds:" prefix to the elements

- Line 990
  "Transform Output:"
  This line should not be bulleted.

- Line 998 mentions about wsse:CanonicalizationParameters element.
  I think <wsse:TransformationParameters> element is correct.

---
NISHIMURA Toshihiro (FAMILY Given)
nishimura.toshi@jp.fujitsu.com
XML/Web Services Technology Dept.,
STRATEGY AND TECHNOLOGY DIV., FUJITSU LIMITED