NEWS

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