5141 kkk2 interaction log clients application must

5.1.4.1 KKK2 interaction log
Client’s application must log every event on the client’s PC in the following manner;
and must keep record of at least the last 12 hours’ messages of KKK2 interaction
log.
The log must be a text file, and each event must be put in a new line.
The interaction log must contain every event:
 Date of event
Form:_YYYY.MM.DD. HH:mm:SS (local time)
AIS/DOC/KKK2/ISP/v1.17/2008.06.3014
28/46

KKK2 interface specifiation Electronic Import Customs Procedures(AIS) Project
 Request ID or Thread ID
If SOAP calling comes from more strings, start of XX calling / end of XX
calling / Exception events can be connected with this identifier. This column
is not needed if callings are made in one string (synchronous manner).
The following events must be logged:
 Start of client application. Parameters:
o client’s software name, version, issue date, manufacturer
 Stop of client application
 Giving the parameters of SOAP connection. Parameters:
o URL address of webservice
o User identifier
o Type of authentication (Basic or X509)
o IP address of client PC
o IP address of gateway/proxy (if there is one, and configurated in the
application)
 Exception generated during SOAP calling. Parameters:
o Content of exception (not only the error text, but possibly all the data
members of the exception object)
o HTTP status code (if there is one)
 Start of SOAP ConnectionTest calling. Parameters:
o None
 End of SOAP ConnectionTest calling. Parameters:
o status.ID,
o status.Message
 Start of SOAP Delete calling. Parameters:
o string[] messageIDs block: values per elements
 End of SOAP Delete calling. Parameters:
o Status[] block: value of ID and Message features per elements
 Start of SOAP Download calling. Parameters:
o string channelName
o int maxMessageCount
 End of SOAP Download calling. Parameters:
o status.ID,
o status.Message
o Message[] block: value of ID feature per elements
 Start of SOAP Upload calling. Parameters:
o message.ID
 End of SOAP Upload calling. Parameters:
o status.ID,
o status.Message
AIS/DOC/KKK2/ISP/v1.17/2008.06.3014
29/46

KKK2 interface specifiation Electronic Import Customs Procedures(AIS) Project
5.1.5 Basic authentication under .NET platform
Using basic authentication KKK-Webservice connection is not effective with the
default configuration of .NET, so for .NET-based clients tuning is needed.
Traditional ASP.NET webservice client proxy is generated from.NET
SoapHttpClientProtocol class by .NET, whose predecessor is WebClientProtocol.
WebClientProtocol has a PreAuthenticate property, which is to be used at basic
authentication.
If PreAuthenticate = false (default), then there is a coordination between the server
and the client concerning identification before each webservice calling. The client
sends a request without authentication, and the server - if authentication is
obligatory – indicates with an error page ‘HTTP Error 401.2 - Unauthorized: Access
is denied due to server configuration.’ that it wants to identify the client by all
means.