draft-ietf-trade-voucher-vtsapi-04.txt   draft-ietf-trade-voucher-vtsapi-05.txt 
Trade Working Group February 2003 Trade Working Group February 2003
INTERNET-DRAFT Masayuki Terada INTERNET-DRAFT Masayuki Terada
Ko Fujimura Ko Fujimura
Expires: August 2003 NTT Expires: August 2003 NTT
Voucher Trading System Application Programming Interface (VTS-API) Voucher Trading System Application Programming Interface (VTS-API)
<draft-ietf-trade-voucher-vtsapi-04.txt> <draft-ietf-trade-voucher-vtsapi-05.txt>
Status of This Document Status of This Document
This document is an Internet-Draft and is in full conformance with This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC2026. all provisions of Section 10 of RFC2026.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet- other groups may also distribute working documents as Internet-
Drafts. Drafts.
skipping to change at page 2, line 5 skipping to change at page 1, line 50
Abstract Abstract
This document specifies the Voucher Trading System Application This document specifies the Voucher Trading System Application
Programming Interface (VTS-API). The VTS-API allows a wallet or other Programming Interface (VTS-API). The VTS-API allows a wallet or other
application to issue, transfer, and redeem vouchers in a uniform application to issue, transfer, and redeem vouchers in a uniform
manner independent of the VTS implementation. The VTS is a system to manner independent of the VTS implementation. The VTS is a system to
securely transfer vouchers, e.g., coupons, tickets, loyalty points, securely transfer vouchers, e.g., coupons, tickets, loyalty points,
and gift certificates; this process is often necessary in the course and gift certificates; this process is often necessary in the course
of payment and/or delivery transactions. of payment and/or delivery transactions.
Copyright (C) The Internet Society (2003). All Rights Reserved.
Acknowledgements Acknowledgements
The following persons, in alphabetic order, contributed substantially The following persons, in alphabetic order, contributed substantially
to the material herein: to the material herein:
Donald Eastlake 3rd Donald Eastlake 3rd
Iguchi Makoto Iguchi Makoto
Yoshitaka Nakamura Yoshitaka Nakamura
Ryuji Shoda Ryuji Shoda
skipping to change at page 3, line 22 skipping to change at page 3, line 21
5.7 VoucherComponentRepository . . . . . . . . . . . . . . . . 20 5.7 VoucherComponentRepository . . . . . . . . . . . . . . . . 20
5.7.1 register . . . . . . . . . . . . . . . . . . . . . . . . . 20 5.7.1 register . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.8 VoucherComponent . . . . . . . . . . . . . . . . . . . . . 21 5.8 VoucherComponent . . . . . . . . . . . . . . . . . . . . . 21
5.8.1 getIdentifier . . . . . . . . . . . . . . . . . . . . . . 21 5.8.1 getIdentifier . . . . . . . . . . . . . . . . . . . . . . 21
5.8.2 getDocument . . . . . . . . . . . . . . . . . . . . . . . 21 5.8.2 getDocument . . . . . . . . . . . . . . . . . . . . . . . 21
5.9 ReceptionListener . . . . . . . . . . . . . . . . . . . . 22 5.9 ReceptionListener . . . . . . . . . . . . . . . . . . . . 22
5.9.1 arrive . . . . . . . . . . . . . . . . . . . . . . . . . . 22 5.9.1 arrive . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.10 Exceptions . . . . . . . . . . . . . . . . . . . . . . . . 22 5.10 Exceptions . . . . . . . . . . . . . . . . . . . . . . . . 22
6. Example Code . . . . . . . . . . . . . . . . . . . . . . . 23 6. Example Code . . . . . . . . . . . . . . . . . . . . . . . 23
7. Security Considerations . . . . . . . . . . . . . . . . . 25 7. Security Considerations . . . . . . . . . . . . . . . . . 25
8. References . . . . . . . . . . . . . . . . . . . . . . . . 25 8. Normative References . . . . . . . . . . . . . . . . . . . 25
9. Author's Address . . . . . . . . . . . . . . . . . . . . . 26 9. Informative References . . . . . . . . . . . . . . . . . . 25
10. Author's Address . . . . . . . . . . . . . . . . . . . . . 26
Full Copyright Statement . . . . . . . . . . . . . . . . . . . . . 26 Full Copyright Statement . . . . . . . . . . . . . . . . . . . . . 26
1. Introduction 1. Introduction
This document specifies the Voucher Trading System Application This document specifies the Voucher Trading System Application
Programming Interface (VTS-API). The motivation and background of the Programming Interface (VTS-API). The motivation and background of the
Voucher Trading System (VTS) are described in Requirements for Voucher Trading System (VTS) are described in Requirements for
Generic Voucher Trading [VTS]. Generic Voucher Trading [VTS].
A voucher is a logical entity that represents a certain right and is A voucher is a logical entity that represents a certain right and is
skipping to change at page 25, line 27 skipping to change at page 25, line 27
Component. This document, however, does not specify any application Component. This document, however, does not specify any application
authentication scheme and it is assumed to be specified by other authentication scheme and it is assumed to be specified by other
related standards. Until various VTS systems are deployed, it is related standards. Until various VTS systems are deployed, it is
enough to manually check and install VTS plug-ins like other download enough to manually check and install VTS plug-ins like other download
applications. applications.
To protect vouchers from being stolen, the VTSAgent must be To protect vouchers from being stolen, the VTSAgent must be
authenticated securely. This document introduced a login/logout authenticated securely. This document introduced a login/logout
facility for this purpose (see Section 5.4). facility for this purpose (see Section 5.4).
8. References 8. Normative References
[DOM] V. Apparao, S. Byrne, M. Champion, S. Isaacs, I. Jacobs, A. Le [DOM] V. Apparao, S. Byrne, M. Champion, S. Isaacs, I. Jacobs, A. Le
Hors, G. Nicol, J. Robie, R. Sutor, C. Wilson, and L. Wood. Hors, G. Nicol, J. Robie, R. Sutor, C. Wilson, and L. Wood.
"Document Object Model (DOM) Level 1 Specification", W3C "Document Object Model (DOM) Level 1 Specification", W3C
Recommendation, October 1998, Recommendation, October 1998,
<http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/> <http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/>
[GVL] K. Fujimura and M. Terada, "XML Voucher: Generic Voucher
Language", draft-ietf-trade-voucher-lang-05.txt, 2003.
[RFC2119] S. Bradner, "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, 1997.
9. Informative References
[ECML] J. W. Parsons and D. Eastlake "Electronic Commerce Modeling [ECML] J. W. Parsons and D. Eastlake "Electronic Commerce Modeling
Language (ECML) Version 2 Specification", Language (ECML) Version 2 Specification",
draft-ietf-trade-ecml2-spec-08.txt, 2003. draft-ietf-trade-ecml2-spec-08.txt, 2003.
[EXC-C14N] J. Boyer, D. Eastlake, and J. Reagle, "Exclusive XML [EXC-C14N] J. Boyer, D. Eastlake, and J. Reagle, "Exclusive XML
Canonicalization Version 1.0", W3C Recommendation, July 2002, Canonicalization Version 1.0", W3C Recommendation, July 2002,
<http://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/> <http://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/>
[GPSF] G. Lacoste, B. Pfitzmann, M. Steiner, and M. Waidner (Eds.), [GPSF] G. Lacoste, B. Pfitzmann, M. Steiner, and M. Waidner (Eds.),
"SEMPER - Secure Electronic Marketplace for Europe," LNCS 1854, "SEMPER - Secure Electronic Marketplace for Europe," LNCS 1854,
Springer-Verlag, 2000. Springer-Verlag, 2000.
[GVL] K. Fujimura and M. Terada, "XML Voucher: Generic Voucher
Language", draft-ietf-trade-voucher-lang-04.txt, 2002.
[IOTP] D. Burdett, "Internet Open Trading Protocol - IOTP Version [IOTP] D. Burdett, "Internet Open Trading Protocol - IOTP Version
1.0", RFC 2801, 2000. 1.0", RFC 2801, 2000.
[JCC] Sun Microsystems Inc., "Java Commerce Client", [JCC] Sun Microsystems Inc., "Java Commerce Client",
<http://java.sun.com/products/commerce/>. <http://java.sun.com/products/commerce/>.
[RFC2119] S. Bradner, "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, 1997.
[SHA-1] Department of Commerce/National Institute of Standards and [SHA-1] Department of Commerce/National Institute of Standards and
Technology, "FIPS PUB 180-1. Secure Hash Standard. U.S.", Technology, "FIPS PUB 180-1. Secure Hash Standard. U.S.",
<http://csrc.nist.gov/publications/fips/fips180-1/fip180-1.txt> <http://csrc.nist.gov/publications/fips/fips180-1/fip180-1.txt>
[VTS] K. Fujimura, "Requirements and Design for Voucher Trading [VTS] K. Fujimura, "Requirements and Design for Voucher Trading
System (VTS)", draft-ietf-trade-drt-requirements-04.txt, 2002. System (VTS)", draft-ietf-trade-drt-requirements-04.txt, 2002.
In RFC Editor queue. In RFC Editor queue.
9. Author's Address 10. Author's Address
Masayuki Terada and Ko Fujimura Masayuki Terada and Ko Fujimura
NTT Corporation NTT Corporation
1-1 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-0847 JAPAN 1-1 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-0847 JAPAN
Phone: +81-(0)46-859-3814 Phone: +81-(0)46-859-3814
Fax: +81-(0)46-859-8329 Fax: +81-(0)46-859-8329
Email: terada@isl.ntt.co.jp, fujimura@isl.ntt.co.jp Email: terada@isl.ntt.co.jp, fujimura@isl.ntt.co.jp
Full Copyright Statement Full Copyright Statement
 End of changes. 

This html diff was produced by rfcdiff 1.25, available from http://www.levkowetz.com/ietf/tools/rfcdiff/