Re: [wss] Comments on oasis-0005-wss-username-token-profile-1[1].0.pdf

[Anthony Nadalin <drsecure@us.ibm.com>]

(1) Done, chose WSS: SOAP Message Security
(2) Done, chose Username Token
(3) Done
(4) PDF Problem
(5) Done
(6) Done
(7) Done
(8) Done
(9) Done

Subject: Re: [wss] Comments on oasis-0005-wss-username-token-profile-1[1].0.pdf

• From: NISHIMURA Toshihiro <nishimura.toshi@jp.fujitsu.com>
• To: wss@lists.oasis-open.org
• Date: Fri, 12 Dec 2003 10:56:19 +0900

---

Hello,

At Thu, 11 Dec 2003 11:25:12 -0800,
Blake Dournaee wrote:
> 2.		 Line 117: The term 'providers' is used to describe a web service
> provider, yet in line 119, they are called 'producers.' Should we use
> consistent terminology here?

In section "1 Introduction", the words "web service consumer" and
"web service" are used. It is better to use same terminology.


Here are another editorial comments:

1. ":" should be used in the spec name (?)
Line 45  Web Services Security (WSS) SOAP Message Security
Line 61  WSS: SOAP Message Security
Line 85  WSS-SOAP Message Security
Line 243 WSS: SOAP Message Security
Line 272 WSS SOAP Message Security
Line 2-3 Web Services Security UsernameToken Profile 1.0

2. Terminology "Username Token"
  When we imply the element, "<wsse:UsernameToken>" should be used.
  But when we use it as a common noun, which should we use?
  - UsernameToken
  - username Token
  - Username Token

Line  15 UsernameToken
Line  45 UsernameToken
Line 102 Username token
Line 120 UsernameToken
Line 124 UsernameTokens
Line 146 username
Line 233 Username Token
Line 236 Username Token
Line 237 UsernameToken
Line 238 username Token
Line 239 UsernameToken
Line 249 <UsernameToken>
Line 266 UsernameToken
Line 271 Username token
(Line 267 SecurityTokens)

3. Attribute values are enclosed in "<" and ">".
Line 96  "<wsse:PasswordDigest>"
Line 129 "<wsse:PasswordText> or <wsse:PasswordDigest>"
Line 234 "<wsse:UsernameToken>"

4. Line 135-136 Unnecessary newline (new paragraph)

5. Line 146, 148, 150
   Should these paragraphs be indented?

6. Line 177
   "Nonce element" should be "<wsse:Nonce> element" or just "nonce"

7. Line 193-206
  Though the namespace declaration uses "S11", <Envelope> and <Header>
  elements have "S:" prefix.

8. Line 242 "may" --> "MAY" ?

9. Line 251 "in the Web Services Security: Username Token Profile
   Document."
   Is it better to use "this document" or "this specification"?

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

Anthony Nadalin | work 512.436.9568 | cell 512.289.4122