Standards for Technology in Automotive Retail

 
 Home -  News Feed 
Web Services
   Next

Web Services

Web Services v4.0.5

Ramesh Rangaiah, Navistar

Pejavar Rao, Navistar

Andrew Selletta, ADP

Hector Rivas, PACCAR

William Fitzpatrick, NADA

Copyright © 2011 Standards for Technology in Automotive Retail

Revision History
Revision 3.0s001December 2008

  • Enhanced PullMessage with Filter Criteria

Revision 4.0g002May 2009

  • Updated to latest WS Specifications

  • Changed STAR Transport Namespace

  • Added STAR Level 1 interoperability rules.

  • Converted document to standardized look and feel.

March 2010

  • Added STAR Level 2 Security Chapter

  • Added STAR Level 2 Security Requirements

March 2011

  • Modified STAR1005 rule

Table of Contents

I. Preface
I.I. Purpose
I.II. Scope
I.III. Audience
I.IV. Background
I.V. Service Provider Requirements
I.VI. Communication Patterns Overview
Part I. STAR Level One
1. STAR Web Services Overview
1.1. Background
1.2. STAR Web Services Types
1.3. Web Service Interoperability Requirements
2. Common Components
2.1. Overview
2.2. Message Packaging
2.2.1. Notes Regarding Payloads and Attachments
2.3. Namespaces
2.4. Web Methods
2.4.1. ProcessMessage
2.4.2. PutMessage
2.4.3. PullMessage
2.5. The payload Manifest SOAP Header
3. Communication Patterns
3.1. One-Way Communication
3.1.1. One-Way Synchronous Communication
3.1.2. One-Way Asynchronous Communication
3.2. Two-Way Communication
3.2.1. Two-Way Synchronous Communication
3.2.2. Two-Way Asynchronous Communication
4. Generic Web Services Specifications
4.1. Overview
4.2. Generic WSDL
4.3. Benefits and Considerations
4.4. Pull Web Service Filter Criteria
4.4.1. Filter Elements
4.5. Generic WSDL Example
5. BOD Specific Web Service Specifications
5.1. Overview
5.2. BOD Specific WSDLS
5.3. Benefits and Considerations
5.4. BOD Specific WSDL Example
6. Error Handling
6.1. HTTP Errors, SOAP Faults, and BOD Level Errors
6.1.1. General Principles
6.1.2. Spectrum of Error Types
6.1.3. HTTP Errors
6.2. SOAP Faults
6.2.1. Sample Error Cases
6.3. Application Level Errors
7. Security
7.1. Overview
7.2. WS-I Basic Security Profile
7.3. WS-Security SOAP Header
7.4. Authentication
7.4.1. Username and Password
7.4.2. The Username element
7.4.3. Plain Text Password
7.4.4. Password Digest  
7.5. Security Error Handling
Part II. STAR Level Two
8. Enhanced Security
8.1. Overview
8.2. WS-I Conformance Claim
8.2.1. WS-I Basic Security Profile
8.3. Digital Certificates
8.3.1. Certificate Sources
8.4. Attachment Security
9. Reliable Messaging
9.1. Overview
9.1.1. Terms and Definitions
9.1.2. Reliable Messaging Namespaces
9.2. Reliable Messaging Construct
9.2.1. Message Sequencing
9.2.2. WS-MakeConnection and Non-Addressable End Points
9.2.3. WS-ReliableMessaging Standardized Error Handling and Monitoring
9.3. Meeting STAR Guidelines Requirements
9.3.1. Message Assurance Profiles
9.3.2. WS-ReliableMessaging Delivery Assurance Features
9.3.3. WS-ReliableMessaging Message Integrity
9.4. STAR Web Service Requirements
10. Attachments
10.1. MTOM/WS-Attachments
10.2. Attachment Element
10.2.1. MTOM Attachments
STAR Interoperability Rules
A. STAR Level One Check List
A.1. Check List
Normative References
Non-Normative References

List of Figures

2.1. Message Structure
2.2. Manifest
2.3. Process Message
2.4. ProcessMessage with Errors
2.5. ProcessMessage with Application System Errors
2.6. Successful PutMessage Sequence
2.7. PullMessage Structure
2.8. Successful PullMessage Operation
2.9. Payload Manifest
3.1. One-way Asynchronous Communication
3.2. Two-way Asynchronous Communication
4.1. PullMessage Filter Type
4.2. Generic Transport
4.3. Generic Payload Element Definition
4.4. Generic Element
5.1. WSDL Directory Structure
5.2. BOD Specific Service and Operations
5.3. BOD Specific Process Message Definition
5.4. BOD specific strongly typed payload
6.1. Spectrum of Error Types by Communication Mechanism
8.1. Example of Certificate Signed by Third Party CA
8.2. Example of Certificate Signed by Private CA
8.3. Example of Self-Signed Certificate
8.4. Example of Self-Signed Certificate Imported
9.1. Reliable Messaging Conversation Sequence
   Next
   Preface