Document History
Version | Changes | Effective Date |
1.0 | First approved version 3Keys MDLP Add-On Note 2023_03_2 | 27-Jul-2023 |
1. Overview
This document describes changes in the 3Keys MDLP connector ABAP part.
2. Description
Adjustment MDLP Connector code to Support MDLP manual signature approach via SAP GUI and Crypto Pro SSF integration.
In case of manual signature scenario token is stored at MDLP Connector Java part and updated from transaction /K3T/RU_MONITOR by user. MDLP system interaction works automatically if connector has active token and stopped if token is expired until token renewal by user.
Prerequisite of manual signature are the following:
installed Crypto Pro SSF software
installed certificate to Crypto Pro container
correct signature customising on ATTP system (Crypto Pro library)
correct signature customising on MDLP Connector settings (SSF id for configuration, manual approval, manual signature)
in case Java part use HTTPs the binding shall be created for new Web services
New transaction /K3T/RU_SSF_C Russia MDLP Certificate assignment created to maintain certificate assignment.
New field “Signature required” added to transaction /K3T/RU_CONF node Configuration ID.
The following corrections implemented into transaction /K3T/RU_MONITOR:
New menu “Manual Signature” with option “Update Token” added to the program toolbar. If token is still active update token option will be provided via confirmation Popup. To update token
Approval button logic corrected to send selected report using manual signature. Additional popup window appears to execute manual signature before sending report via SAP GUI and Crypto Pro SSF integration. After signature report is send to MDLP Connector Java part
MDLP Message menu button processing corrected to check token before sending request to MDLP system
The following corrections implemented into transaction /K3T/RU_MDLP_SN_INFO Russia MLDP serial number info:
check for active token at MDLP Connector
The following corrections implemented into program /K3T/RU_MDLP_DISPATCHER:
report manual signature filter - reports with manual signature configurations will not be send to MDLP system by program (only using approval button via transaction /K3T/RU_MONITOR)
The following corrections implemented into program /K3T/RU_MDLP_IN (Inbound message processing):
report manual signature filter - reports with manual signature configurations will be processed only in case active token exists for configuration
API methods will be used to receive information for reports with manual signature from MDLP independently of system customizing (This correction works at inbound processing modules, for example, Function module /K3T/RU_AIF_IN_SCN will receive hierarchy information using API method not by using 220 XML message)
The following corrections implemented into transaction /K3T/RU_OMS_TOKEN Russia OMS token:
report manual signature filter - OMS token for manual signature configurations will not be updated by program if program is executed on background mode (only dialog mode)
manual signature - If OMS token for manual signature configuration need to be updated additional popup window appears to execute manual signature to sign authorisation data via SAP GUI and Crypto Pro SSF integration. After signature data is send to MDLP Connector Java part and token is updated at ATTP system
New separate interfaces created to execute report sending including manual signature function module /K3T/RU_MDLP_REQ_SIGNED / proxy class /K3T/CO_RU_MDLP_REQ_SIGNED
New Web service interfaces created at Java (called from ABAP part using proxy classes):
/K3T/CO_RU_GET_OMS_AUTH
/K3T/CO_RU_MDLP_CHECK_TOKEN
/K3T/CO_RU_MDLP_REQ_SIGNED
/K3T/CO_RU_MDLP_UPDATE_TOKEN
/K3T/CO_RU_UPDATE_OMS_TOKEN
New RFC interfaces created at Java (called from ABAP part using RFC function modules):
/K3T/RU_GET_OMS_AUTH - Get Auth string for signature for OMS token (manual signature)
/K3T/RU_MDLP_CHECK_TOKEN - Russia MDLP Get token for Config ID
/K3T/RU_MDLP_REQ_SIGNED - Russia MDLP send message (manual signature)
/K3T/RU_MDLP_UPDATE_TOKEN - Russia MDLP Update token for Config ID
/K3T/RU_UPDATE_OMS_TOKEN - Get new token from OMS (manual signature)
3. Solution
Import related to the transport request.
3.1 Correction instruction ATTP 3.0
Transport request | Description / Dependencies |
A1DK900550 | 3Keys MDLP Add-On 3.0 Note 2023_03_02 Required transport A1DK900498 |
3.2 Correction instruction ATTP 3.1
Transport request | Description / Dependencies |
A2DK900608 | 3Keys MDLP Add-On 3.1 Note 2023_03_02 Required transport A2DK900519 |
3.3 Correction instruction ATTP 3.2
Transport request | Description / Dependencies |
A3DK900186 | 3Keys MDLP Add-On 3.2 Note 2023_03_02 Required transport A3DK900132 |
4. Recommendation
TO BE ADDED
5. Source code objects
Short description | Program | Object type | Object name |
Translation for: Domain Definition | LANG | DOMD | /K3T/RU_NOTE2023_03_03V1 |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3T/CL_MR_CONSTANTS |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3T/CL_MR_UTILS |
Public Header (ABAP Objects) | LIMU | CPUB | /K3T/CL_MR_CONSTANTS |
Public Header (ABAP Objects) | LIMU | CPUB | /K3T/CL_MR_UTILS |
Domain Definition | LIMU | DOMD | /K3T/D_MR_REP_TYPE |
Method (ABAP Objects) | LIMU | METH | /K3T/CL_MDLP_API_REQ GET_INSTANCE |
Method (ABAP Objects) | LIMU | METH | /K3T/CL_MR_CONSTANTS CLASS_CONSTRUCTOR |
Method (ABAP Objects) | LIMU | METH | /K3T/CL_MR_UTILS GET_MONTH_NUMBER |
Method (ABAP Objects) | LIMU | METH | /K3T/CL_MR_UTILS GET_WEEK_NUMBER |
Report Source Code | LIMU | REPS | /K3T/RU_MAR_MONITOR_C01 |
Report Source Code | LIMU | REPS | /K3T/RU_MAR_TASK_PROC_C01 |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_DEL_RSLT |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_GEN_R_DP |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_GEN_R_MV |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_GEN_R_PR |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_GEN_R_RM |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_RESULTS |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_RSLT |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_SEARCH |
Class (ABAP Objects) | R3TR | CLAS | /K3T/CL_MDLP_API_JOB_STATUS |
Domain | R3TR | DOMA | /K3T/RU_NOTE2023_03_03V1 |
Program | R3TR | PROG | /K3T/RU_MAR_REP_PROC |
Program | R3TR | PROG | /K3T/RU_MAR_REP_PROC_C01 |
Program | R3TR | PROG | /K3T/RU_MAR_REP_PROC_SSC |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_MD |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_MD_C01 |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_MD_SSC |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_ON_MV |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_ON_MV_C01 |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_ON_MV_SSC |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_PR |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_PR_C01 |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_PR_SSC |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_RM |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_RM_C01 |
Program | R3TR | PROG | /K3T/RU_MAR_SCD_GEN_RM_SSC |