PGP Unpackage Service

Implement the PGP Unpackage Service

Configure the PGP Unpackage Service

To configure the PGP Unpackage service, specify the settings for the fields in the GPM. These fields are described in the subsequent table.

The following table contains the parameters that are passed from the PGP Unpackage service to the business process:

Business Process Example - Decrypt Operation (Public Key Decryption)

The following business process uses the PGP Unpackage service to decrypt the primary document in the document area. The profile is based on PGP107. In this case, the default Command Line 2 adapter configuration, PGPCmdlineService, is used to execute the decrypt command. It uses the working directory, remote name and port stated in the business process. Therefore, these values will override any pre-configured values in PGPCmdlineService.

<process name="PGP_Decrypt "> 
  <sequence name="optional"> 
   <operation name="One"> 
      <participant name=" PGPUnpackageService "/> 
      <output message="Xout"> 
               <assign to="." from="*"></assign> 
               <assign to="profile_name">PGP107</assign>  
               <assign to=" secret_keymap_name"> my_secret </assign>
               <assign to="workingDir">/server1/tmp</assign> 
               <assign to="remoteName">00.000.00.000</assign> 
               <assign to="remotePort">12345</assign> 
    </output> 
     <input message="Xin"> 
               <assign to="." from="*"></assign> 
     </input> 
   </operation> 
  </sequence> 
</process> 

Business Process Example - Verify Operation

The following business process uses the PGP Unpackage service to verify the primary document in the document area. The profile is based on PGP107. In this case, the Command Line 2 adapter configuration called MyCLA2 is used to execute the commands. The remote name, port and working directory have been pre-configured in the service configuration. Therefore, they are not required in the business process.

<process name="PGP_Verify"> 
 <sequence name="optional"> 
    <operation name="One"> 
      <participant name="PGPUnpackageService "/> 
      <output message="Xout"> 
               <assign to="." from="*"></assign> 
               <assign to="profile_name">PGP107</assign>  
               <assign to="cmdline2svcname">MyCLA2</assign>
    </output> 
     <input message="Xin"> 
               <assign to="." from="*"></assign> 
     </input> 
   </operation> 
  </sequence> 
</process> 

Business Process Example - OnFault Handling

The following business process shows onFault handling with the PGP Unpackage service.

 <process name="PGP_Decrypt"> 
 <sequence name="optional"> 
    <operation name="One"> 
      <participant name="PGPUnpackageService "/> 
      <output message="Xout"> 
               <assign to="." from="*"></assign> 
               <assign to="profile_name">PGP107</assign>  
               <assign to=" secret_keymap_name"> si_secret </assign>
               <assign to="workingDir">/server1/tmp</assign> 
               <assign to="remoteName">00.000.00.000</assign>
               <assign to="remotePort">12345</assign>  
    </output> 
     <input message="Xin"> 
               <assign to="." from="*"></assign> 
     </input> 
   </operation> 
               <assign to="Status">The file is decrypted successfully</assign> 
   <onFault>
               <assign to="Status">General Error Occurred</assign>
            </onFault>
            <onFault code="[PGPErrorCode] Decryption error">
               <assign to="Status">Decryption error</assign>
            </onFault> 
 </sequence> 
</process> 

Business Process Example - PGP Partner and PGP Sponsor

The following business process uses the PGP Partner and PGP Sponsor services to decrypt and verify documents.

<process name="use_partner_sponsor">
  <operation name="PGP Unpackage Service">
    <participant name="PGPUnpackageService"/>
       <output message="PGPUnPackageServiceTypeInputMessage">
     <assign to="pgp_partner_name">partner</assign>
     <assign to="pgp_sponsor_name">sponsor</assign>
     <assign to="profile_name">pgp</assign>
     <assign to="." from="*"></assign>
   </output>
    <input message="inmsg">
     <assign to="." from="*"></assign>
   </input>
  </operation> 
</process>

Advanced Status Messages

Exit Codes from E-Business Server

The following table contains exit codes from E-Business Server. The content of the description field will be displayed in the Advanced Status column, preceded by [PGPErrorCode]:

Exit Codes from PGP Command Line

The following table contains exit codes from PGP Command Line. The content of the description field will be displayed in the Advanced Status column, preceded by [PGPErrorCode]:

Errors During Validation

The following table contains errors that result from the PGP Unpackage service when it validates information before executing PGP commands on the remote server. The content of the status field will be displayed in the Advanced Status column: