Ansicht
Dokumentation

IDMX_DI_SIGN - signs a character chain by using of standard SSF functions

General Data in Customer Master   Vendor Master (General Section)  
This documentation is copyright by SAP AG.

Functionality

The function module creates a digital signature based on a character string. The process of signing is done by the kernel (independant from the frontend) controlled by the calling application. Standard secure storage and forward function modules will be used.

The basic values for this process are:

- a imported character string, e.g. data of an invoice in a specific order

- the code page the interpretition of byte code will be based on

- the hash algorithm to be used for the imported character string

- the output format of the digital signature

Der Funktionsbaustein erstellt für eine Zeichenkette eine digitale Signatur. Die Signierung erfolgt über den Kernel/Server (unabhänging vom Frontend), gesteuert über die aufrufende Applikation. Es werden Secure Storage and Forward Standardfunktionsbausteine verwendet.

Basis hierfür sind

- eine übergebene Zeichenkette, z. B. Rechnungsdaten in einer definierten Anordnung

- die Zeichensatztabelle, auf der die Interpretation des Bytecodes beruhen soll

- der zu verwendene Hash-Algorythmus für die übergebene Zeichenkette

- das Ausgabeformat der Digitalen Signatur

Example

Invoice data concatenated in the character string 'INVOICE' will be transcoded in the unicode format UTF-8 and will be hashed by the algorithm MD5. The application name 'ZMEX1' is assigned to the relevant pse-file in the ssf customizing. Export parameters are the digital signature coded in byte and character mode using the output format PKCS1 padding algorithm V1.5 and the serial number of the digital certificate. An export of the hash is possible too.

Für eine Rechnung wird basierend auf der Zeichensatztabelle UTF-8 der Hashalgorithmus MD5 angewendet. Über den Applikationsnamen ZMEX1 ist im Customizing das PSE-File hinterlegt. Die digitale Signatur wird im Format PKCS1 mit Paddingalgorithmus V1.5 im Character- und Bytemode ausgegeben. Die Seriennummer des verwendeten Zertifikates wird zurückgegeben. Eine Ausgabe des Hashwertes ist ebenfalls möglich.

CALL FUNCTION 'IDMX_DI_UTILITY_SIGN'
EXPORTING
inv_str ,,= invoice
codepage ,,= '4110'
hash_alg ,,= 'MD5'
ssf_format ,,= 'PKCS1-V1.5'
applic ,,= 'ZMEX1'
IMPORTING
PRN_SIGN ,,= signature
SIGN_BM ,,= sig_hex
LEN_SIGN_BM ,,= sig_hex_len
PRN_CERT_SNO ,,= serial
* PRN_HASH ,,= hash
* HASH_BM ,,= hash_hex
* LEN_hash_BM ,,= hash_hex_len
EXCEPTIONS
SSF_CUSTOM_ERROR ,,= 1
SSF_KRN_ERROR ,,= 2
SSF_NO_MEMORY ,,= 3
SSF_NO_SSFLIB ,,= 4
SSF_NO_CERT ,,= 5
SSF_PARAMETER_NOT_FOUND ,,= 6
SSF_PARAMETER_WRONG ,,= 7
CONV_ERROR ,,= 8
OTHERS ,,= 9

Notes

Further information

Parameters

CERT_BASE64
CERT_VALID_FROM
CERT_VALID_TO
CRC_SSFPARMS
INV_STR
IV_DOC_AWKEY
IV_DOC_AWTYP
IV_GET_CERTIFICATE
IV_PRINT
IV_RELEASE
LEN_SIGN_BM
ORI_MD5
PATH
PRN_CERT_SNO
PRN_SIGN
SIGN_BM
SSF_PARAMETERS
SSF_PARAMETERS_ID
SSF_PW

Exceptions

CONV_ERROR
CUSTOM_ERROR
INVALID_FILENAME_PASSWORD
NO_OPERATION
SSF_CUSTOM_ERROR
SSF_KRN_ERROR
SSF_NO_CERT
SSF_NO_MEMORY
SSF_NO_SSFLIB
SSF_PARAMETER_NOT_FOUND
SSF_PARAMETER_WRONG

Function Group

IDMX_DI_UTILITY

Fill RESBD Structure from EBP Component Structure   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 4267 Date: 20240523 Time: 074112     sap01-206 ( 68 ms )