NEWS

   1 Version 0.5
   2 ===========
   3
   4 • ABI changed due to changes in specification. API is preserved. Please
   5 recompile your applications.
   6
   7 • This release has not been tested on real system because devoloper has not
   8 obtained new testing account yet. But he believes library works. Testers are
   9 welcome.
  10
  11 • Delivery events 5, 10, 11, 12, and 13 are recognized now.
  12
  13 • GetMessageAuthor service implemented as get_message_sender() function.
  14
  15 • New isds_envelope member `dmPublishOwnID' added. It allows sender to reveal
  16 his natural name to recipient on sending a message.
  17
  18 • isds_GetDataBoxUsers() can return empty list of users now.
  19
  20 • New document types recognised. MIME types of Software602 forms have been
  21 changed to reflect IANA registry.
  22
  23 • Credential for testing account removed from documentation and code. Owner of
  24 ISDS removed all testing accounts, testers must request for new account and
  25 must agree with new rules including keeping credentials in secret and
  26 non-disclosuring found bugs in ISDS. Example clients and on-line tests read
  27 credentials from environment and central file in build root direcotory. See
  28 README for more details.
  29
  30 • Errors from libxml2 parser are captured by libisds log system as ILF_XML
  31 facility and at ILL_ERROR level. Application can get them by standard library
  32 interface.
  33
  34 • Library can be compiled without support for network operation by passing
  35 `--without-libcurl' option to configure script. All functions dependent on
  36 network remain available and will return IE_NOTSUP return code.
  37
  38 • Dead variables removed to pass compilation by GCC 4.6 in strict mode.
  39
  40 • Prepare test environment to pass without ~/.gnupg directory. Packagers can
  41 remove the hack from their packages now.
  42
  43 Version 0.4
  44 ===========
  45
  46 • This version breaks ABI because of ISDS specification change. Please adapt
  47 your application where affected functions are called.
  48
  49 • ABI change: isds_get_password_expiration() will return NULL if password never
  50 expires. Adjust your application to cope with NULL pointer on IE_SUCCESS.
  51
  52 • ABI change: isds_add_box() has new credentials_delivery parameter to request
  53 for on-line credentials delivery and to receive token for that.
  54
  55 • ABI change: isds_add_user() has new credentials_delivery parameter to
  56 request for on-line credentials delivery and to receive token for that.
  57
  58 • ABI change: isds_reset_password() has different arguments to request for
  59 on-line credentials delivery and to receive token for that.
  60
  61 • ABI change: deprecated functions isds_set_tls() and
  62 isds_set_mime_type_normalization() removed. Use isds_set_opt() instead.
  63
  64 • SOAP Fault error message is passed to application via isds_long_message().
  65
  66 • New function isds_get_list_of_sent_message_state_changes() implements
  67 GetMessageStateChanges service. It returns list of message status changes in
  68 requested time interval.
  69
  70 • New function isds_get_box_list_archive() implements GetDataBoxList service.
  71 It returns ZIP archive with comma separate list of boxes. Different types of
  72 lists can be requested. Only type `UPG' is available to public.
  73
  74 • New function isds_activate() implements Activate service.
  75
  76 • New delivery state EV0 is recognized as EVENT_ENTERED_SYSTEM isds_event_type.
  77
  78 • `tsr' document name suffix is recognized as time stamp file type.
  79
  80 • New function isds_pki_credentials_free() to deallocate isds_pki_credentials
  81 structure.
  82
  83 • ISO time string parser fixed (negative or no time zone offset).
  84
  85 • All tests can run in parallel now.
  86
  87 • Lot of internal tests added. Funny color output now.
  88
  89 Version 0.3.1
  90 =============
  91
  92 • Add `server' directory to distribution tar balls because example messages
  93 are needed for some tests.
  94
  95 Version 0.3
  96 ===========
  97
  98 • This library breaks API because of new features and changes in ISDS.
  99
 100 • This library version covers complete ISDS specification as released on
 101 2010-05-23.
 102
 103 • Support for XML documents added. Use isds_document.is_xml to distinguish
 104 between binary and XML document types. Because XML node list
 105 (isds_document.xml_node_list) is used to describe XML document, your
 106 application must link to libxml2 library too since now. Please note this
 107 feature has not been heavily tested and that the interface is a little tricky
 108 (regarding memory allocation). See client/sendxmldoc.c and
 109 client/loadsentmessagewithxmldocuments.c examples for hints how to use it.
 110
 111 • Box creation (isds_add_box()) supports requesting for token. This
 112 functionality is not covered by specification as it's not implemented on
 113 server side yet.
 114
 115 • Message authenticity verification through new web service
 116 AuthenticateMessage (isds_authenticate_message()) is supported. This function
 117 sends a signed message encapsulated in CMS to ISDS where the system resolves
 118 originality of the message.
 119
 120 • isds_envelope->dmType is input/output now. The one letter value is
 121 transferred while sending new message. However ISDS ignores this option as
 122 semantic is not defined yet.
 123
 124 • isds_envelope->timestamp is optional now. Some ISDS services can return
 125 message without time stamp as can do not exist yet.
 126
 127 • Cookie-tracked session authentication changed to stateless. That means
 128 password is transmitted to server on each request. Password is cached by
 129 libcurl library until connection gets closed. Also different server locators
 130 for non-certificate and certificate client authentication emerged. Old log-in
 131 method will be canceled on 2010-07-01. Old libisds versions become useless.
 132 Upgrade is strongly recommended.
 133
 134 • Static and out-of-source directory compilation is supported now.
 135
 136 • New function isds_normalize_mime_type(): translates file name extension to
 137 MIME type (because official ISDS client is broken). This can be globally
 138 enabled by isds_set_opt().
 139
 140 • Context parameters can be set by isds_set_opt(): TLS options (isds_set_tls()
 141 is deprecated now), MIME type normalization (new: mangle document MIME type
 142 in incoming messages into more reasonable values).
 143
 144 • Deprecated functions removed: isds_load_received_message(),
 145 isds_log_signed_message().
 146
 147 • isds_DbUserInfo.caState added (country of contact address).
 148
 149 • isds_get_delivery_info() fixed to produce standard raw representation of
 150 delivery details that can be loaded by isds_load_delivery() back.
 151
 152 • New function guess_raw_type(): detects type of supported message and
 153 delivery details formats. Detected format can be supplied to
 154 isds_load_message(). This way, application can automagically load and parse
 155 any supported format.
 156
 157 • libcurl debug messages are caught by libisds and redirected to library
 158 logger (ILF_HTTP facility).
 159
 160 Version 0.2.1
 161 =============
 162
 163 • Libs value in libisds.pc pkg-config module fixed.
 164
 165 Version 0.2
 166 ===========
 167
 168 • X.509 client certificate authentication is supported (but not tested yet).
 169 Underlying HTTPS cURL library supports OpenSSL, GnuTLS and NSS cryptographic
 170 back ends currently.
 171
 172 Current legislation requires to use cryptographic module with unexportable
 173 private key. I've tested ASEKey produced by Athena Smartcard Solution
 174 with OpenSSL back end successfully (a patch for curl-7.20.0 is required).
 175
 176 Example code client/certauth.c and server/tls/peer server and CA, server and
 177 client cryptographic material are bundled.
 178
 179 • Application can pass CRL PEM file to cryptographic library.
 180
 181 • Library offers pkg-config integration. Application build scripts can check
 182 `libisds' pkg-config module and use PKG_CHECK_MODULES() m4 macro.
 183
 184 • Application can get dynamic string describing library version and its
 185 dependencies at run-time (isds_version()).
 186
 187 • API changed and is not backward compatible. Please adjust and recompile your
 188 applications.
 189
 190 • Library tests have been splitted to off-line (--enable-test) and on-line
 191 (--enable-online-test) tests. On-line tests can not be compiled without
 192 off-line tests. All tests are switched off by default.
 193
 194 • Server base URL for isds_login() does not contain path anymore. Application
 195 must supply schema and hostname only (e.g. https://localhost/). Undefined base
 196 URL will be interpreted as official ISDS locator.
 197
 198 • Base URLs of official ISDS server (isds_locator) and testing ISDS server
 199 (isds_testing_locator) are provided by library. Application can offer them as
 200 default choices to the user.
 201
 202 • Documents can be submitted for authorize conversion into Czech POINT system
 203 (czp_convert_document(), requires specific isds_ctx).
 204
 205 • Application can catch all global log messages and redirect them wherever it
 206 needs.
 207
 208 Version 0.1
 209 ===========
 210
 211 • This is first public release. Whole ISDS 2010-01-22 specification is covered
 212 except: XML documents, X.509 authentication