Miglioramenti alla funzionalità di Tracciatura su File
------------------------------------------------------

Tra le informazioni che possono essere riversate nei file di log associati ai topic di file trace, sono adesso disponibili anche le seguenti informazioni:

- Token negoziati con gli Authorization Server:

	- retrievedAccessToken: access token ottenuto dall’authorization server configurato nella Token Policy associata al connettore;

	- retrievedTokenClaim(nomeClaim): valore del claim indicato come parametro e presente nella risposta ritornata dall’authorization server;

	- retrievedTokenRequestTransactionId: identificativo della transazione che ha originato la richiesta verso l’authorization server;

	- retrievedTokenRequestGrantType: tipo di grant type utilizzato nella negoziazione del token (clientCredentials, usernamePassword, rfc7523_x509, rfc7523_clientSecret);

	- retrievedTokenRequestJwtClientAssertion: asserzione jwt generata durante una negoziazione con grant type "rfc7523_x509";

	- retrievedTokenRequestClientId: clientId utilizzato durante la negoziazione del token;

	- retrievedTokenRequestClientToken: bearer token utilizzato durante la negoziazione del token;

	- retrievedTokenRequestUsername: username utilizzato durante una negoziazione del token con grant type "usernamePassword";

	- retrievedTokenRequestUrl: endpoint dell’authorization server.

- Certificato TLS Client:

	- clientCertificateSubjectDN: distinguished name del subject relativo al certificato tls client; 

	- clientCertificateSubjectCN: common name del subject relativo al certificato tls client;

	- clientCertificateSubjectDNInfo(String oid): ritorna l'informazione indicata come parametro relativa al subject del certificato tls client;
	
	- clientCertificateIssuerDN: distinguished name dell'issuer relativo al certificato tls client; 

	- clientCertificateIssuerCN: common name dell'issuer relativo al certificato tls client; 

	- clientCertificateIssuerDNInfo(String oid): ritorna l'informazione indicata come parametro relativa all'issuer del certificato tls client.

- Token OAuth2 validato come JWT:

	- tokenClaim(nomeClaim): consente di accedere ad un singolo claim di un token OAuth2 validato su GovWay;

	- tokenRaw: JWT token presente nella richiesta; 

	- tokenHeaderRaw: porzione dell'header relativa al token JWT presente nella richiesta, in formato base64; 

	- tokenPayloadRaw: porzione del payload relativa al token JWT presente nella richiesta, in formato base64; 

	- tokenDecodedHeader: contenuto decodificato dell'header presente nel token JWT; 

	- tokenDecodedPayload: contenuto decodificato del payload presente nel token JWT; 

	- tokenHeaderClaim(nomeClaim): valore del claim indicato come parametro e presente nell'header del token JWT;

	- tokenPayloadClaim(nomeClaim): valore del claim indicato come parametro e presente nel payload del token JWT;
		
	- tokenHeaderClaims(): claims (nome=valore) presenti nell'header del token JWT;
		
	- tokenHeaderClaims(claimSeparator, nameValueSeparator): simile alla precedente opzione, consente di indicare i separatori utilizzati;

	- tokenPayloadClaims(): claims (nome=valore) presenti nel payload del token JWT;
		
	- tokenPayloadClaims(claimSeparator, nameValueSeparator): simile alla precedente opzione, consente di indicare i separatori utilizzati;

	- tokenCertificateSubjectDN: distinguished name del subject relativo al certificato con cui è stato firmato il token JWT; 

	- tokenCertificateSubjectCN: common name del subject relativo al certificato con cui è stato firmato il token JWT; 

	- tokenCertificateSubjectDNInfo(String oid): ritorna l'informazione indicata come parametro relativa al subject del certificato con cui è stato firmato il token JWT;
		
	- tokenCertificateIssuerDN: distinguished name dell'issuer relativo al certificato con cui è stato firmato il token JWT; 

	- tokenCertificateIssuerCN: common name dell'issuer relativo al certificato con cui è stato firmato il token JWT; 

	- tokenCertificateIssuerDNInfo(String oid): ritorna l'informazione indicata come parametro relativa all'issuer del certificato con cui è stato firmato il token JWT.

- Profilo Interoperabilità 'ModI':

	- tokenModI<tokenType>Raw: security token presente nella richiesta; 

	- tokenModI<tokenType>CertificateSubjectDN: distinguished name del subject relativo al certificato con cui è stato firmato il security token; 

	- tokenModI<tokenType>CertificateSubjectCN: common name del subject relativo al certificato con cui è stato firmato il security token; 

	- tokenModI<tokenType>CertificateSubjectDNInfo(String oid): ritorna l'informazione indicata come parametro relativa al subject del certificato con cui è stato firmato il security token;
		
	- tokenModI<tokenType>CertificateIssuerDN: distinguished name dell'issuer relativo al certificato con cui è stato firmato il security token; 

	- tokenModI<tokenType>CertificateIssuerCN: common name dell'issuer relativo al certificato con cui è stato firmato il security token; 

	- tokenModI<tokenType>CertificateIssuerDNInfo(String oid): ritorna l'informazione indicata come parametro relativa all'issuer del certificato con cui è stato firmato il security token.

	I tipi di token disponibili sono:

	- Authorization: security token ricevuto nell'header HTTP 'Authorization';

	- Integrity: security token ricevuto nell'header HTTP 'Agid-JWT-Signature';

	- Soap: security token ricevuto nell'header SOAP;

	Per i tipi di token 'Authorization' e 'Integrity', relativi ad API di tipo REST, sono disponibili anche le seguenti informazioni:

	- tokenModI<tokenType>HeaderRaw: porzione dell'header relativa al security token presente nella richiesta, in formato base64; 

	- tokenModI<tokenType>PayloadRaw: porzione del payload relativa al security token presente nella richiesta, in formato base64; 

	- tokenModI<tokenType>DecodedHeader: contenuto decodificato dell'header presente nel security token; 

	- tokenModI<tokenType>DecodedPayload: contenuto decodificato del payload presente nel security token; 

	- tokenModI<tokenType>HeaderClaim(nomeClaim): valore del claim indicato come parametro e presente nell'header del security token;

	- tokenModI<tokenType>PayloadClaim(nomeClaim): valore del claim indicato come parametro e presente nel payload del security token;
		
	- tokenModI<tokenType>HeaderClaims(): claims (nome=valore) presenti nell'header del security token;
		
	- tokenModI<tokenType>HeaderClaims(claimSeparator, nameValueSeparator): simile alla precedente opzione, consente di indicare i separatori utilizzati;

	- tokenModI<tokenType>PayloadClaims(): claims (nome=valore) presenti nel payload del security token;
		
	- tokenModI<tokenType>PayloadClaims(claimSeparator, nameValueSeparator): simile alla precedente opzione, consente di indicare i separatori utilizzati;

- Altro:
	
	- requesterIP: rappresenta l’indirizzo IP del richiedente e assumerà la prima informazione valorizzata, trovata nella richiesta, nel seguente ordine: forwardedIP, clientIP;

	- resultCode: consente di ottenere il codice numerico di GovWay che rappresenta l'esito della transazione.

Sono infine stati risolti i seguenti problemi: 

- corretto valore ritornato dalla keyword 'inUrl', dove è stato eliminato il prefisso '[in]' o '[out]' che rimane recuperabile tramite la keyword 'inFunction';

- la tracciatura dell'informazione '${logBase64:errorDetail}' provocava un errore inatteso poichè venivano erroneamente serializzate in base64 le informazioni prima di interpretare il dettaglio dell'errore;

- le richieste errate (es. API not found) non venivano tracciate se la funzionalità veniva attivata tramite una configurazione globale.