NEWS

   1 Version 0.7
   2 ===========
   3
   4 • New ISDS service Re-signISDSDocument has been implemented as
   5 isds_resign_message() function. This can be used for adding time stamp to
   6 already signed message or delivery details that had been produced without the
   7 time stamp.
   8
   9 • TLS errors from cURL library are reported as IE_SECURITY to libisds
  10 applications now. This is new isds_error value and it denotes any security
  11 problem leading to abort of requested operation.
  12
  13 • This release is ABI-compatible with previous version 0.6. However
  14 applications built against 0.7 are not guaranteed to work with 0.6.
  15
  16 • Internal test suite checks TLS authentication. GnuTLS is needed for
  17 building tests now.
  18
  19 • Parsing dmRecipientOrgUnitNum value from message envelope has been fixed.
  20
  21 • A memory leak when using XPath has been fixed.
  22
  23 Version 0.6.2
  24 =============
  25
  26 • Building tests out of source tree has been fixed.
  27
  28 Version 0.6.1
  29 =============
  30
  31 • Missing test/simline/server_types.h files has been added into distribution
  32 to fix test suite compilation.
  33
  34 Version 0.6
  35 ===========
  36
  37 • ABI changed due to changes in specification. Some functions got additional
  38 parameters or return codes.
  39
  40 • One-time password (OTP) authentication implemented. There is a new argument
  41 at isds_login() and isds_change_password() functions of type struct isds_otp*.
  42 Pass NULL if do not request OTP authentication.  The structure is used to
  43 select OTP method (HMAC- or time-based code), to pass the OTP code (use NULL
  44 to ask server for new time-based code), and to retrieve fine state of OTP
  45 authentication. The functions can return IE_PARTIAL_SUCCESS if time-based
  46 method is selected and server sent the new OTP code successfully.
  47 OTP-authenticated context resides on URL different from others (use NULL or
  48 isds_otp_locator for official instance or isds_otp_testing_locator for testing
  49 instance). You can try client/login tool to check OTP-authenticated log-in.
  50 You can use client/hotp_generator tool to generate series of HMAC-based OTP
  51 codes (requires Perl Authen::OATH module).  There is a bug in cURL < 7.28.0
  52 preventing from correct re-authentication. If you have unpatched cURL,
  53 configure libisds with `--enable-curlreauthorizationbug' option. (See INSTALL
  54 for more details.)
  55
  56 • isds_change_password() has additional argument to retrieve reference number
  57 of the request assigned by the server. Pass NULL if you do not care.
  58
  59 • Internal tests check log-in procedure against simulated ISDS server. You can
  60 run the simulated server as standalone executable in test/simline/server_cli
  61 to check another clients. The server implements besides authentication
  62 DummyRequest, services for changing passwords and EraseMessage.
  63
  64 • New DeleteDataBoxPromptly service implemented as isds_delete_box_promptly().
  65 (This service is not documented in the specification).
  66
  67 • New PDZInfo service implemented as isds_get_commercial_permissions(). This
  68 service enables application to know whether it can send commercial messages,
  69 which subtypes of commercial messages can send (there are differences on
  70 payment type), and to retrieve tokens for sending such messages.
  71
  72 • New service EraseMessage implemented as isds_delete_message_from_storage().
  73 This function can be used to delete messages stored in long term storage (also
  74 known as safe previously). Only messages in the long term storage can be
  75 explicitly deleted.
  76
  77 • New user types USERTYPE_LIQUIDATOR (company liquidator) and
  78 USERTYPE_OFFICIAL_CERT (undocumented in specification) added.
  79
  80 • Return value of isds_normalize_mime_type() is pointer to constant string now
  81 to discourage application from fiddling with the value.
  82
  83 • Autoconf m4 macros have been updated (curl-7.26.0, gettext-0.18.1.1,
  84 gpgme-1.3.1, libgcrypt-1.5.0, libtool-2.4.2, libxml2-2.8.0).
  85
  86 Version 0.5
  87 ===========
  88
  89 • ABI changed due to changes in specification. API is preserved. Please
  90 recompile your applications.
  91
  92 • This release has not been tested on real system because devoloper has not
  93 obtained new testing account yet. But he believes library works. Testers are
  94 welcome.
  95
  96 • Delivery events 5, 10, 11, 12, and 13 are recognized now.
  97
  98 • GetMessageAuthor service implemented as get_message_sender() function.
  99
 100 • New isds_envelope member `dmPublishOwnID' added. It allows sender to reveal
 101 his natural name to recipient on sending a message.
 102
 103 • isds_GetDataBoxUsers() can return empty list of users now.
 104
 105 • New document types recognised. MIME types of Software602 forms have been
 106 changed to reflect IANA registry.
 107
 108 • Credential for testing account removed from documentation and code. Owner of
 109 ISDS removed all testing accounts, testers must request for new account and
 110 must agree with new rules including keeping credentials in secret and
 111 non-disclosuring found bugs in ISDS. Example clients and on-line tests read
 112 credentials from environment and central file in build root direcotory. See
 113 README for more details.
 114
 115 • Errors from libxml2 parser are captured by libisds log system as ILF_XML
 116 facility and at ILL_ERROR level. Application can get them by standard library
 117 interface.
 118
 119 • Library can be compiled without support for network operation by passing
 120 `--without-libcurl' option to configure script. All functions dependent on
 121 network remain available and will return IE_NOTSUP return code.
 122
 123 • Dead variables removed to pass compilation by GCC 4.6 in strict mode.
 124
 125 • Prepare test environment to pass without ~/.gnupg directory. Packagers can
 126 remove the hack from their packages now.
 127
 128 Version 0.4
 129 ===========
 130
 131 • This version breaks ABI because of ISDS specification change. Please adapt
 132 your application where affected functions are called.
 133
 134 • ABI change: isds_get_password_expiration() will return NULL if password never
 135 expires. Adjust your application to cope with NULL pointer on IE_SUCCESS.
 136
 137 • ABI change: isds_add_box() has new credentials_delivery parameter to request
 138 for on-line credentials delivery and to receive token for that.
 139
 140 • ABI change: isds_add_user() has new credentials_delivery parameter to
 141 request for on-line credentials delivery and to receive token for that.
 142
 143 • ABI change: isds_reset_password() has different arguments to request for
 144 on-line credentials delivery and to receive token for that.
 145
 146 • ABI change: deprecated functions isds_set_tls() and
 147 isds_set_mime_type_normalization() removed. Use isds_set_opt() instead.
 148
 149 • SOAP Fault error message is passed to application via isds_long_message().
 150
 151 • New function isds_get_list_of_sent_message_state_changes() implements
 152 GetMessageStateChanges service. It returns list of message status changes in
 153 requested time interval.
 154
 155 • New function isds_get_box_list_archive() implements GetDataBoxList service.
 156 It returns ZIP archive with comma separate list of boxes. Different types of
 157 lists can be requested. Only type `UPG' is available to public.
 158
 159 • New function isds_activate() implements Activate service.
 160
 161 • New delivery state EV0 is recognized as EVENT_ENTERED_SYSTEM isds_event_type.
 162
 163 • `tsr' document name suffix is recognized as time stamp file type.
 164
 165 • New function isds_pki_credentials_free() to deallocate isds_pki_credentials
 166 structure.
 167
 168 • ISO time string parser fixed (negative or no time zone offset).
 169
 170 • All tests can run in parallel now.
 171
 172 • Lot of internal tests added. Funny color output now.
 173
 174 Version 0.3.1
 175 =============
 176
 177 • Add `server' directory to distribution tar balls because example messages
 178 are needed for some tests.
 179
 180 Version 0.3
 181 ===========
 182
 183 • This library breaks API because of new features and changes in ISDS.
 184
 185 • This library version covers complete ISDS specification as released on
 186 2010-05-23.
 187
 188 • Support for XML documents added. Use isds_document.is_xml to distinguish
 189 between binary and XML document types. Because XML node list
 190 (isds_document.xml_node_list) is used to describe XML document, your
 191 application must link to libxml2 library too since now. Please note this
 192 feature has not been heavily tested and that the interface is a little tricky
 193 (regarding memory allocation). See client/sendxmldoc.c and
 194 client/loadsentmessagewithxmldocuments.c examples for hints how to use it.
 195
 196 • Box creation (isds_add_box()) supports requesting for token. This
 197 functionality is not covered by specification as it's not implemented on
 198 server side yet.
 199
 200 • Message authenticity verification through new web service
 201 AuthenticateMessage (isds_authenticate_message()) is supported. This function
 202 sends a signed message encapsulated in CMS to ISDS where the system resolves
 203 originality of the message.
 204
 205 • isds_envelope->dmType is input/output now. The one letter value is
 206 transferred while sending new message. However ISDS ignores this option as
 207 semantic is not defined yet.
 208
 209 • isds_envelope->timestamp is optional now. Some ISDS services can return
 210 message without time stamp as can do not exist yet.
 211
 212 • Cookie-tracked session authentication changed to stateless. That means
 213 password is transmitted to server on each request. Password is cached by
 214 libcurl library until connection gets closed. Also different server locators
 215 for non-certificate and certificate client authentication emerged. Old log-in
 216 method will be canceled on 2010-07-01. Old libisds versions become useless.
 217 Upgrade is strongly recommended.
 218
 219 • Static and out-of-source directory compilation is supported now.
 220
 221 • New function isds_normalize_mime_type(): translates file name extension to
 222 MIME type (because official ISDS client is broken). This can be globally
 223 enabled by isds_set_opt().
 224
 225 • Context parameters can be set by isds_set_opt(): TLS options (isds_set_tls()
 226 is deprecated now), MIME type normalization (new: mangle document MIME type
 227 in incoming messages into more reasonable values).
 228
 229 • Deprecated functions removed: isds_load_received_message(),
 230 isds_log_signed_message().
 231
 232 • isds_DbUserInfo.caState added (country of contact address).
 233
 234 • isds_get_delivery_info() fixed to produce standard raw representation of
 235 delivery details that can be loaded by isds_load_delivery() back.
 236
 237 • New function guess_raw_type(): detects type of supported message and
 238 delivery details formats. Detected format can be supplied to
 239 isds_load_message(). This way, application can automagically load and parse
 240 any supported format.
 241
 242 • libcurl debug messages are caught by libisds and redirected to library
 243 logger (ILF_HTTP facility).
 244
 245 Version 0.2.1
 246 =============
 247
 248 • Libs value in libisds.pc pkg-config module fixed.
 249
 250 Version 0.2
 251 ===========
 252
 253 • X.509 client certificate authentication is supported (but not tested yet).
 254 Underlying HTTPS cURL library supports OpenSSL, GnuTLS and NSS cryptographic
 255 back ends currently.
 256
 257 Current legislation requires to use cryptographic module with unexportable
 258 private key. I've tested ASEKey produced by Athena Smartcard Solution
 259 with OpenSSL back end successfully (a patch for curl-7.20.0 is required).
 260
 261 Example code client/certauth.c and server/tls/peer server and CA, server and
 262 client cryptographic material are bundled.
 263
 264 • Application can pass CRL PEM file to cryptographic library.
 265
 266 • Library offers pkg-config integration. Application build scripts can check
 267 `libisds' pkg-config module and use PKG_CHECK_MODULES() m4 macro.
 268
 269 • Application can get dynamic string describing library version and its
 270 dependencies at run-time (isds_version()).
 271
 272 • API changed and is not backward compatible. Please adjust and recompile your
 273 applications.
 274
 275 • Library tests have been splitted to off-line (--enable-test) and on-line
 276 (--enable-online-test) tests. On-line tests can not be compiled without
 277 off-line tests. All tests are switched off by default.
 278
 279 • Server base URL for isds_login() does not contain path anymore. Application
 280 must supply schema and hostname only (e.g. https://localhost/). Undefined base
 281 URL will be interpreted as official ISDS locator.
 282
 283 • Base URLs of official ISDS server (isds_locator) and testing ISDS server
 284 (isds_testing_locator) are provided by library. Application can offer them as
 285 default choices to the user.
 286
 287 • Documents can be submitted for authorize conversion into Czech POINT system
 288 (czp_convert_document(), requires specific isds_ctx).
 289
 290 • Application can catch all global log messages and redirect them wherever it
 291 needs.
 292
 293 Version 0.1
 294 ===========
 295
 296 • This is first public release. Whole ISDS 2010-01-22 specification is covered
 297 except: XML documents, X.509 authentication