Dokumentasi Solusi & Panduan Demo

OmniMFT Ops Copilot

AI Agent untuk Operasional Managed File Transfer — Axway SecureTransport × Boomi

Versi 1.0 · November 2026 · Tim MFT Operations, Security Auditor, dan Integration Engineer

Ringkasan eksekutif

OmniMFT Ops Copilot adalah AI agent yang membantu tim operasional MFT melacak transfer file, mendiagnosis kegagalan, menjaga masa berlaku sertifikat, memproses ulang file, dan meng-onboard partner SFTP baru — cukup lewat percakapan.

Agent tersedia di dua tempat: di Boomi Agentstudio (cloud, untuk pengguna bisnis) dan sebagai agent lokal di Claude Code (untuk engineer). Keduanya memakai logika OmniMFT yang sama dan sudah diuji terhadap SecureTransport 5.5 di lab.

File yang diunggah partner ke SecureTransport otomatis diteruskan ke Boomi, divalidasi, diaudit, dan dibalas dengan tanda terima. Seluruh integrasi berjalan tanpa membuka port masuk ke jaringan on-premise.

10tool agent di Agentstudio
3/3skenario end-to-end lulus
±8 dtkeksekusi aksi di bridge
0port masuk dibuka

Empat kapabilitas inti

Pelacakan & diagnosis

Menjawab pertanyaan status transfer dalam bahasa natural: pengirim → penerima, protokol, status, ukuran, waktu. Transfer gagal disertai pesan error ST dan diagnosis penyebab.

Penjaga sertifikat & key

Mengaudit sertifikat SSL/TLS, SSH key, dan PGP key di ST. Yang sudah kedaluwarsa ditandai CRITICAL, yang habis dalam 30 hari WARNING, lengkap dengan saran perintah perbaikan.

Orkestrasi & reprocess

Mengorelasikan transfer ST dengan eksekusi Boomi, menampilkan alasan penolakan Boomi, dan me-resubmit transfer agar ST mengirim ulang file ke Boomi.

Onboarding partner

Membuat partner SFTP baru yang langsung ter-rute ke Boomi: akun, transfer site Generic-HTTP(S), dan subscription — dengan dry-run, persetujuan, dan rollback otomatis.

Arsitektur solusi

Alur file: Partner → SecureTransport → Boomi

Partner SFTP → SecureTransport (on-prem, VPN) → Boomi Cloud 1. Partner upload SFTP port 8022 ke folder/inbound 2. SecureTransport 5.5 Subscription BasicApplication auto-push 3. Generic-HTTP(S) site HTTPS PUT ke listenerBoomi 4. Boomi listener OmniMFT API – ST InboundFile 5. Subprocess Unwrap multipart →validasi → audit → receiptJSONOn-premise (lab, via FortiClient VPN)Boomi Cloud (Test atom)
Gambar 1 — Alur file dari partner SFTP hingga diproses Boomi

Agentstudio ↔ on-premise: outbound-only bridge

ON-PREMISE (lab + laptop) BOOMI CLOUD Axway SecureTransport 5.5 192.168.0.21 · Admin API 8444 · SFTP 8022Tetap privat OmniMFT bridge worker bridge_worker.py (laptop/host)Snapshot tiap ±60 dtk · polling antrean ±5 dtkAksi ter-allow-list · kredensial di .envAdmin REST API via VPN Disk V2 store work/omnimft snapshots/ · requests/ · results/tanpa DELETE Bridge listeners (WSS) upsertOmnimftDoc · getOmnimftDoccreateOmnimftRequestqueryOmnimftRequests Agentstudio: OmniMFT Ops Copilot baca snapshot · antrekan aksi · ambil hasilterbitkan snapshot & hasil (HTTPS keluar)ambil antrean aksi (HTTPS keluar)Internet · ZscalerPort masuk ke on-prem: TIDAK ADA
Gambar 2 — Agentstudio terhubung ke SecureTransport melalui bridge outbound-only

Mengapa outbound-only? Laptop korporat memakai Zscaler (inspeksi TLS, memblokir aplikasi tunnel) dan ST hanya terjangkau via FortiClient VPN. Pola outbound-only patuh kebijakan keamanan tanpa pengecualian khusus.

Agent lokal (Claude Code)

Untuk engineer, logika yang sama tersedia sebagai MCP server lokal di Claude Code yang mengakses SecureTransport langsung lewat VPN.

Komponen

Komponen Boomi

Folder platform: Training-Sandbox-WSL/OmniMFT-STInboundListener

KomponenTipeFungsi
OmniMFT API - ST Inbound FileProcess (WSS listener)Menerima file dari ST: POST/PUT /ws/simple/executeStInboundFile
[SUB] OmniMFT - Receive ST FileProcess (subprocess)Unwrap multipart, tolak file kosong, audit, receipt JSON
OmniMFT Bridge API - Upsert DocProcess (WSS listener)Bridge worker menulis snapshot/hasil
OmniMFT Bridge API - Get DocProcess (WSS listener)Agentstudio membaca snapshot/hasil (NOT_FOUND bila belum ada)
OmniMFT Bridge API - Create RequestProcess (WSS listener)Agentstudio mengantrekan aksi, mengembalikan requestId
OmniMFT Bridge API - Query RequestsProcess (WSS listener)Bridge worker melihat daftar antrean
OmniMFT Disk StoreConnection (Disk V2)Penyimpanan dokumen di work/omnimft pada cloud atom
OmniMFT Disk Upsert/Get/ListOperations (Disk V2)Tulis, baca, dan daftar dokumen (tanpa DELETE)
OmniMFT Ops CopilotAgentstudio agent4 task, 10 tool, guardrail; deployed ke Agent Garden Production

Tool agent di Agentstudio

ToolJenisFungsi
get_bridge_healthBacaKesehatan bridge, konektivitas ST, umur snapshot
get_transfer_snapshotBacaTransfer 24 jam terakhir + transfer gagal 7 hari
get_certificate_snapshotBacaSertifikat/key expired & akan expired (30 hari)
get_boomi_inbound_snapshotBacaEksekusi listener Boomi 24 jam terakhir
request_live_transfer_searchAksi (antrean)Pencarian transfer live dengan filter
request_snapshot_refreshAksi (antrean)Minta snapshot diperbarui sekarang
request_resubmit_transferAksi (persetujuan)Resubmit transfer di ST
request_partner_onboarding_planAksi (antrean)Rencana onboarding partner (dry-run)
request_partner_onboarding_executeAksi (persetujuan)Eksekusi onboarding sesuai rencana
get_request_resultBacaAmbil hasil aksi berdasarkan requestId

Kode on-premise

FileFungsi
server.pyMCP server OmniMFT (7 tool) untuk agent lokal di Claude Code
omnimft/st_client.pyKlien Admin REST API SecureTransport v2.0 (stateless, tanpa cookie sesi)
omnimft/boomi_client.pyKlien Boomi Platform API (eksekusi & riwayat eksekusi)
bridge_worker.pyBridge outbound-only untuk Agentstudio (snapshot + antrean aksi)
start-bridge.shStart / stop / status bridge worker
agent/agentgarden_build.pyMembuat/memperbarui tool dan agent di Agentstudio, serta deploy
CLAUDE.mdPersona agent lokal + catatan teknis yang sudah terverifikasi

Keamanan & kepatuhan

Tanpa port masuk

Tidak ada tunnel atau port yang dibuka; semua koneksi keluar via HTTPS ke *.boomi.com, patuh Zscaler.

Kredensial tetap on-prem

Kredensial ST dan Boomi disimpan di .env (mode 600). Password partner baru disimpan di secrets/ dan tidak pernah ditampilkan.

Persetujuan manusia

Resubmit dan eksekusi onboarding wajib persetujuan di Agentstudio; onboarding selalu didahului dry-run.

Aksi ter-allow-list

Bridge hanya menjalankan aksi yang diizinkan; endpoint tujuan Boomi dikunci di sisi on-prem, tidak bisa diubah dari chat.

Guardrail agent

Menolak permintaan kredensial, operasi destruktif, dan konten private key; isi tool result diperlakukan sebagai data.

Jejak audit

Setiap permintaan dan file masuk tercatat di log eksekusi Boomi (OMNIMFT_REQUEST, ST_INBOUND).

Hasil pengujian

SkenarioHasilStatus
CSV dengan spasi di nama fileProcessed di ST; diterima Boomi, nama file utuh, 47 byteLulus
File biner 4 KBProcessed di ST; Boomi menerima tepat 4096 byteLulus
File kosong (0 byte)Ditolak Boomi; ST mencatat Failed + diagnosisLulus
POST langsung non-STReceipt JSON HTTP 200 (regresi)Lulus
Bridge: simpan / baca / NOT_FOUND / kunci ilegalSemua respons sesuaiLulus
Bridge: antrean → eksekusi → hasilDiproses bridge ±8 detikLulus
Onboarding partner (live)Akun + site + subscription dibuat; login SFTP berhasil; rollback terujiLulus
Deploy agent AgentstudioAgent Garden Production, status ACTIVELulus

Tantangan teknis yang diselesaikan

TemuanPenyebabSolusi
Site HTTP bawaan ST ditolak Boomi (403)Site HTTP bawaan memakai protokol ST-ke-ST (POST / dulu).Pakai plugin Generic-HTTP(S) dengan metode PUT.
Nama file tidak terkirimEkspresi ST (${stenv[...]}) kosong di plugin Generic-HTTP; file dikirim sebagai multipart.Subprocess Boomi membuka multipart dan mengambil nama file dari Content-Disposition.
Error CSRF di Admin API STCookie sesi ST terikat token CSRF.Klien API stateless: Basic Auth tanpa menyimpan cookie.
Disk GET file yang belum adaMenghasilkan nol dokumen, bukan error.Branch + penanda DPP_FOUND untuk mengembalikan NOT_FOUND.
Tunnel diblokirZscaler memblokir aplikasi tunnel.Arsitektur outbound-only bridge melalui Boomi.

Panduan demo

Runbook

  1. Sambungkan FortiClient VPN (ST 192.168.0.21 harus terjangkau).
  2. Jalankan bridge: ./start-bridge.sh lalu cek ./start-bridge.sh --status (harus RUNNING).
  3. Buka Boomi Agentstudio → OmniMFT Ops Copilot → mulai percakapan.
  4. Jalankan skenario demo (lihat bagian berikut).
  5. Setelah selesai: ./start-bridge.sh --stop.

Skenario yang disarankan

“Transfer apa yang gagal 7 hari terakhir dan kenapa?”
Agent membaca snapshot, menjelaskan tiap kegagalan beserta penyebab dan perbaikannya.

“Cek sertifikat yang expired atau akan expired 30 hari ke depan.”
Daftar CRITICAL lalu WARNING, dengan saran perintah perbaikan.

“Kenapa empty_file.csv dari omnimft_e2e ditolak Boomi?”
Korelasi ST (Failed) dengan Boomi (ST_INBOUND_REJECTED, 0 byte) + retry otomatis ST.

“Onboard partner SFTP baru PT_Maju_Logistik dan route ke Boomi.”
Dry-run → persetujuan → eksekusi → detail koneksi SFTP (±30–60 detik).

Keterbatasan & langkah berikutnya

Keterbatasan

  • Snapshot tertinggal ±1–2 menit; untuk data detik ini gunakan refresh atau pencarian live.
  • Aksi lewat antrean butuh ±10–30 detik termasuk polling hasil oleh agent.
  • Host bridge dan VPN harus aktif saat demo; jika mati, agent melaporkan bridge offline.
  • Tracking ID ST tidak ikut terkirim ke Boomi (keterbatasan plugin); korelasi memakai nama file, akun, dan waktu.
  • File antrean/hasil di Boomi tidak dihapus otomatis (desain tanpa DELETE); pembersihan bisa dijadwalkan.

Langkah berikutnya

  1. Pindahkan bridge worker dari laptop ke server/VM di lab agar berjalan 24/7.
  2. Ganti akun admin ST bawaan dengan akun API khusus berhak terbatas.
  3. Tambahkan routing lanjutan di Boomi setelah audit (database, API tujuan, atau SFTP lain).
  4. Perpanjang/ganti sertifikat yang expired dan yang akan habis dalam 14 hari.
  5. Jadwalkan pembersihan berkala dokumen antrean di Boomi Cloud.