AMF (Agile Messaing Framework)
  • Agile Messaging Framework
    • Get Started
      • Install
        • Pre-requisites
        • CockroachDB
        • NATS for Queuing
        • Hashicorp Vault
          • Configure Vault
        • Python 3.9
        • AMF Bundle
        • Installation of AMF
          • Configure and install
          • Post Install Steps
        • IBM SFG Integration
          • Configure and Install
            • Install jars in SFG
            • Add amf.properties
            • Add CRDB pool details
            • Import Sterling Artifacts
          • Post Install Steps
            • Create user with API permissions
            • Changes in BPs
    • Concepts
      • Providers
      • Users
      • Message Type
      • Message Mapping
      • Workflow
      • Communication profiles
        • SFTP Profiles
          • Customer Initiated
          • MFT Initiated
            • MFT Initiated Send
            • MFT Initiated Receive
        • Connect Direct
          • Customer Initiated
          • MFT Initiated
        • SharePoint
          • MFT Initiated
            • MFT Initiated Send
            • MFT Initiated Receive
        • S3
          • MFT Initiated
            • MFT Initiated Send
            • MFT Initiated Receive
        • Azure ADLS
          • MFT Initiated
            • MFT Initiated Send
        • HTTP with Token
          • MFT Initiated
            • MFT Initiated Send
        • UFA
          • Customer Initiated
            • Customer Initiated Send
            • Customer Initiated Receive
      • Communication Rules
        • Immediate
        • Scheduled
    • Management
      • AMF UI Operations
      • AMF Services Operations
    • User Manual
      • Signup and Login
      • Dashboard
      • Track N Trace
        • Message Activity
        • Failed Message Activity
        • Onboarding Activity
        • Session Activity
        • Service Availability
        • Scheduler Activity
        • Delivery Queue
        • Audit Log
      • Onboarding
        • Customers
        • Users
          • Communication Profiles
        • Message Types
        • Message Mapping
        • Workflow
          • Definitions
          • Actions
          • Rules
        • Communication Rules
    • Troubleshooting
    • Tutorials
      • UFA Installations
        • Linux Installation
        • Windows Installation
      • Schedules
        • Run based on timer
        • Run daily
        • Run based on day(s) of the week
        • Run based on day(s) of the month
      • UseCases
        • UC01
        • UC02
        • UC03
        • UC04
        • UC05
        • UC06
        • UC07
        • UC08
        • UC09
        • UC10
        • UC11
        • UC12
        • UC13
        • UC14
        • UC15
        • UC16
        • UC17
        • UC18
        • UC19
        • UC20
        • UC21
        • UC22
        • UC23
        • UC24
        • UC25
        • UC26
Powered by GitBook
On this page
  1. Agile Messaging Framework
  2. Tutorials
  3. UseCases

UC11

PreviousUC10NextUC12

Last updated 3 months ago

UFA --> AMF --> SFG --> SFTP

Use Case: Partner21 (Sender) sends files to AMF we encrypt the file and then deliver those files to Partner22 (Receiver) using SFTP protocol from SFG via AMF. (Agile Messaging Framework).

Sequence Diagram:

Steps:

A. Onboard Partner21 in AMF and Partner22 in SFG via AMF.

B. Install UFA agent (Partner21).

C. Create Message Type or use the existing one in AMF.

D. Onboard Partner21 Customer Initiated Upload profile.

E. Onboard Partner22 SFTP MFT Initiated Send profile.

F. Create Open PGP Encrypt as Action Type.

G. Create Delivery Action or use the predefined one (Deliver as is).

H. Create Workflow definition and add Actions (Created in step f and step g) as step1 and step2.

I. Create Workflow rule with Sender, Receiver, Message Type and Workflow definition name (Created in step h).

J. Verify the Message activity in AMF once Partner21 uploads the file to AMF via UFA. If everything is configured correctly, the file will be delivered to Partner22 via SFTP protocol.

Process:

A. Onboard Partner21 in AMF and Partner22 in SFG via AMF.

Login to AMF

Go to Onboarding -> Users

Click on + icon at the top right corner

Select Customer and give details of Partner21, select User Type, Authentication

Type and click next.

  1. User Type: Which Zone does the Partner belongs to send or receive files? (DMZ or Trusted)

  2. Authentication Type: Where do we store the Partner credentials? (LDAP or local (SFG/AMF) or Both)

Select the provider the Partner belongs to and click next

  1. AMF: AMF provider is used to onboard Partners which use UFA

  2. IBM: This will come from the provider's config. We can choose several types based on the provider’s config.

  3. Open Ldap: We need to select this if we selected the Authentication Type as LDAP in step 4-ii.

Select AMF Provider for Partner21 which uses UFA protocol.

Select IBM Provider for Partner22 which uses SFTP protocol.

Verify the Partner details and click Onboard User.

B. Install UFA agent (Partner21).

Please refer to the UFA installation document for this step.

C. Create Message Type or use the existing one in AMF:

Go to Message Types under Onboarding

Click on + icon in the right corner to add a new message type

Note: In this scenario we will use the existing message type (GENERIC)

D. Onboard Partner21 Customer Initiated Upload profile.

Double click on Partner21

Click on + icon at the top right corner

Select the protocol as UFA, operation as Upload, give the remaining details

and click save.

  1. Upload Folder: Folder where the files will be placed to deliver to AMF.

  2. File Pattern: File pattern to filter the files.

  3. Sender: Sender name who is sending files (Partner21 in this case)

  4. Receiver: Receiver name to whom we are delivering files via AMF (Partner22 in this case).

  5. Message Type: Message type we used in this case (GENERIC)

  6. Polling Interval: The polling interval between the sync i.e., UFA agent and the server.

  7. Archive Flag: Option to enable or disable the archives.

  8. Archive Folder: Folder to archive the files if we enabled step vii

  9. Run Script Before Upload: Script name with path if we want to run any scripts before the file upload.

  10. Chunk Size: Size of the files that will be transferred in bits when there is a large file transfer

  11. Pgp Encrypt: Option to encrypt the uploaded file.

  12. Validate MD5 Check Sum: Option to validate the MD5 Checksum on uploaded files.

Once the onboarding is done, we can see the status as completed.

E. Onboard Partner22 SFTP MFT Initiated Send profile.

Double click on Partner22.

Click on + icon at the top right corner.

Select MFT initiated upload profile and give the remaining details

(SFTP Protocol) and click save.

  1. Remote Host: Remote Host/IP of Partner22 SFTP server

  2. Remote Port: Port of Partner22 SFTP server

  3. Remote User ID: Remote User ID in Partner22 SFTP server

  4. Auth Type: Auth type supported by Remote SFTP server (password or key)

  5. Use Source File Name: Option to use source filename

  6. Remote File Name: Remote file name if you disabled the Use Source File Name in the 3-v

  7. Remote Path: Path for the file to be placed

  8. Use Temp File Name in Copy: Option to use temp file name in copy

  9. Remote KHK (Known Host Key): Known host key of Remote SFTP server

  10. Send Email Notifications: Option to send email notifications for successful delivery

  11. Receivers Mail Ids: Recipients mail addresses if we enable Send Email Notifications.

  12. Clean up on delivery: Option to clean the file in file system after the file is delivered (Once the file was cleaned, we cannot redeliver the file again).

F. Create Open Pgp Encrypt as Action Type

Go to Actions under Onboarding->Workflow

Click on + icon to create new action

Give Name, select Open PGP Encrypt as action type and Select Public Key

and click save.

G. Create Delivery Action or use the predefined one (Deliver as is)

Go to Actions under Onboarding->Workflow

Click on + icon to create new action

Note: In this scenario we will use the existing Action (Deliver as is)

H. Create Workflow definition and add Actions (Created in step f and step g) as

step1 and step2.

Go to Definitions under Onboarding->Workflow.

Click on + icon at the top right corner.

Give Workflow name, description and click save.

Double click on the Workflow definition name.

Click on the + icon at the top right corner

Select the action that we Created in steps f and g as steps 1 &2

and click save.

I. Create Workflow rule with Sender, Receiver, Message Type and Workflow

definition name (Created in step h).

Go to Rules under Onboarding -> Workflow.

Click on + icon at the top right

Give Sender, Receiver, Message Type, Workflow (Created in step h) and

click on save

J. Verify the Message activity in AMF once Partner21 uploads file to

AMF via UFA. If everything is configured correctly, the file will be

delivered to Partner22 via SFTP protocol.

Go to Message activity under Track N Trace

To see more details of the delivery double click on the record

Here we can see the details for the file delivered to Partner22.