Add credentials_delivery to isds_add_box()
[libisds.git] / NEWS
bloba391ecfda7fab76806d0983a569654695dba141c
1 Version 0.3.1
2 =============
4 • Add `server' directory to distribution tar balls because example messages
5 are needed for some tests.
7 Version 0.3
8 ===========
10 • This library breaks API because of new features and changes in ISDS.
12 • This library version covers complete ISDS specification as released on
13 2010-05-23.
15 • Support for XML documents added. Use isds_document.is_xml to distinguish
16 between binary and XML document types. Because XML node list
17 (isds_document.xml_node_list) is used to describe XML document, your
18 application must link to libxml2 library too since now. Please note this
19 feature has not been heavily tested and that the interface is a little tricky
20 (regarding memory allocation). See client/sendxmldoc.c and
21 client/loadsentmessagewithxmldocuments.c examples for hints how to use it.
23 • Box creation (isds_add_box()) supports requesting for token. This
24 functionality is not covered by specification as it's not implemented on
25 server side yet.
27 • Message authenticity verification through new web service
28 AuthenticateMessage (isds_authenticate_message()) is supported. This function
29 sends a signed message encapsulated in CMS to ISDS where the system resolves
30 originality of the message.
32 • isds_envelope->dmType is input/output now. The one letter value is
33 transferred while sending new message. However ISDS ignores this option as
34 semantic is not defined yet.
36 • isds_envelope->timestamp is optional now. Some ISDS services can return
37 message without time stamp as can do not exist yet.
39 • Cookie-tracked session authentication changed to stateless. That means
40 password is transmitted to server on each request. Password is cached by
41 libcurl library until connection gets closed. Also different server locators
42 for non-certificate and certificate client authentication emerged. Old log-in
43 method will be canceled on 2010-07-01. Old libisds versions become useless.
44 Upgrade is strongly recommended.
46 • Static and out-of-source directory compilation is supported now.
48 • New function isds_normalize_mime_type(): translates file name extension to
49 MIME type (because official ISDS client is broken). This can be globally
50 enabled by isds_set_opt().
52 • Context parameters can be set by isds_set_opt(): TLS options (isds_set_tls()
53 is deprecated now), MIME type normalization (new: mangle document MIME type
54 in incoming messages into more reasonable values).
56 • Deprecated functions removed: isds_load_received_message(),
57 isds_log_signed_message().
59 • isds_DbUserInfo.caState added (country of contact address).
61 • isds_get_delivery_info() fixed to produce standard raw representation of
62 delivery details that can be loaded by isds_load_delivery() back.
64 • New function guess_raw_type(): detects type of supported message and
65 delivery details formats. Detected format can be supplied to
66 isds_load_message(). This way, application can automagically load and parse
67 any supported format.
69 • libcurl debug messages are caught by libisds and redirected to library
70 logger (ILF_HTTP facility).
72 Version 0.2.1
73 =============
75 • Libs value in libisds.pc pkg-config module fixed.
77 Version 0.2
78 ===========
80 • X.509 client certificate authentication is supported (but not tested yet).
81 Underlying HTTPS cURL library supports OpenSSL, GnuTLS and NSS cryptographic
82 back ends currently.
84 Current legislation requires to use cryptographic module with unexportable
85 private key. I've tested ASEKey produced by Athena Smartcard Solution
86 with OpenSSL back end successfully (a patch for curl-7.20.0 is required).
88 Example code client/certauth.c and server/tls/peer server and CA, server and
89 client cryptographic material are bundled. 
91 • Application can pass CRL PEM file to cryptographic library.
93 • Library offers pkg-config integration. Application build scripts can check
94 `libisds' pkg-config module and use PKG_CHECK_MODULES() m4 macro.
96 • Application can get dynamic string describing library version and its
97 dependencies at run-time (isds_version()).
99 • API changed and is not backward compatible. Please adjust and recompile your
100 applications.
102 • Library tests have been splitted to off-line (--enable-test) and on-line
103 (--enable-online-test) tests. On-line tests can not be compiled without
104 off-line tests. All tests are switched off by default.
106 • Server base URL for isds_login() does not contain path anymore. Application
107 must supply schema and hostname only (e.g. https://localhost/). Undefined base
108 URL will be interpreted as official ISDS locator.
110 • Base URLs of official ISDS server (isds_locator) and testing ISDS server
111 (isds_testing_locator) are provided by library. Application can offer them as
112 default choices to the user.
114 • Documents can be submitted for authorize conversion into Czech POINT system
115 (czp_convert_document(), requires specific isds_ctx).
117 • Application can catch all global log messages and redirect them wherever it
118 needs.
120 Version 0.1
121 ===========
123 • This is first public release. Whole ISDS 2010-01-22 specification is covered
124 except: XML documents, X.509 authentication