SFTP - Petunjuk Pengaturan

DAFTAR ISI

• SFTP - Petunjuk Pengaturan
  • Hosting dan autentikasi
  • Konfigurasi
  • Frekuensi dan Penjadwalan
  • Laporan dan Penanganan Kesalahan
    • Pertanyaan yang Sering Diajukan (FAQ) Terkait
  • Cara Membuat Kunci SSH Publik untuk Server SFTP
    • Format
    • Polanya
    • Membuat Kunci SSH 
    • Contoh Kunci
  • Petunjuk untuk Jenis Data Tertentu

Hosting dan autentikasi

Folder SFTP Anda akan kami tempatkan di server SFTP tersendiri (melalui AWS). Setiap klien akan mendapatkan akun pengguna khusus yang hanya dapat mengakses folder SFTP miliknya sendiri. Kami mendukung autentikasi berbasis kunci. Oleh karena itu, Anda perlu membuat sepasang kunci publik-pribadi dan memasukkan kunci publik tersebut pada kolom Public Key saat mengatur folder Anda. Kunci yang digunakan harus berformat openSSH RSA . Untuk langkah-langkah membuat kunci, silakan lihat bagian Cara Membuat Kunci SSH Publik untuk Server SFTP di bawah ini.

Konfigurasi

1. Masukkan kunci publik yang telah Anda buat ke dalam kolom Public Key . Anda juga dapat memperbarui kolom Username jika diperlukan. Nilai pada kolom Username harus diawali dengan huruf, angka, atau garis bawah (_), serta terdiri dari 3 hingga 100 karakter. Username dapat berisi huruf, angka, garis bawah (_), simbol @, titik (.), dan tanda hubung (-).

2. Salin nilai Username, URL domain Spotnana, dan Nomor port ke tempat yang aman, karena informasi ini akan dibutuhkan oleh tim di organisasi Anda yang akan mengatur pengiriman file ke folder yang baru dibuat. 
   Catatan: Setelah pengaturan folder SFTP selesai, informasi ini dapat diakses kembali melalui menu Manage.

3. Masukkan alamat email yang ingin Anda gunakan untuk menerima laporan terkait unggahan file pada kolom SFTP email notification . Untuk informasi lebih lanjut, silakan lihat bagian Laporan dan Penanganan Kesalahan di bawah ini.

4. Klik Connect.

Setelah kunci publik dimasukkan, status awal akan menjadi Unverified. Status ini akan terlihat di OBT sampai file pertama benar-benar diterima di folder Anda. File yang dikirim bisa berupa file uji coba sesuai kebutuhan Anda, atau file HR feed atau custom field yang sebenarnya (hanya file dengan format yang didukung yang akan diproses). Selain itu, jika kunci publik diperbarui, status akan kembali menjadi Unverified sampai file berikutnya diterima.

Untuk menghapus folder SFTP Anda, klik Disconnect. Tindakan ini akan menghapus folder SFTP Anda. Jika di kemudian hari Anda ingin mengaturnya kembali, seluruh informasi di atas perlu diisi ulang dari awal.

Frekuensi dan Penjadwalan

Anda dapat menentukan sendiri jadwal dan frekuensi pengunggahan file. Kami menggunakan pemicu pembuatan objek file untuk memulai proses file. Artinya, begitu Anda mengunggah file ke folder SFTP kami, aplikasi kami akan langsung memproses file tersebut. 

Untuk rekomendasi frekuensi dan penjadwalan berdasarkan jenis data (misalnya, pengguna, custom field, entitas hukum), silakan lihat bagian Frekuensi dan Penjadwalan pada petunjuk SFTP untuk masing-masing jenis data.

Laporan dan Penanganan Kesalahan

Kami mengumpulkan data dari setiap file yang Anda unggah, lalu membuat laporan internal setelah setiap unggahan selesai. Laporan ini akan dikirim ke alamat email yang Anda masukkan pada kolom SFTP email notification saat pengaturan. Untuk setiap file yang diunggah, laporan akan berisi: 

• alasan jika terjadi kegagalan unggah file (misal: format salah, nama kolom tidak sesuai, dan sebagainya).

• alasan jika ada baris dalam file yang gagal diunggah. Kami tidak melakukan pembaruan sebagian; jika ada kesalahan pada kolom tertentu atau data wajib tidak diisi pada baris tersebut, maka baris itu akan gagal diproses. 

• status unggahan (menunggu, berhasil, gagal).

Anda dapat menggunakan isi laporan ini untuk menelusuri dan memperbaiki kesalahan. Jika Anda masih mengalami kendala, silakan hubungi tim dukungan teknis. 

Pertanyaan yang Sering Diajukan (FAQ) Terkait

1. Apakah kami menerima file tambahan yang hanya berisi data yang perlu diperbarui atau ditambahkan saja?

   • Ya

2. Apakah file yang Anda unggah (baik melalui SFTP maupun unggah manual) harus tetap mencantumkan kolom opsional meskipun tidak digunakan?

   • Tidak

Cara Membuat Kunci SSH Publik untuk Server SFTP

Ikuti petunjuk berikut untuk membuat kunci SSH publik yang akan Anda berikan kepada kami.

Format

• Tipe: String

• Batas Panjang: Maksimal 2048 karakter.

Polanya

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

Membuat Kunci SSH 

Untuk membuat kunci SSH, jalankan perintah berikut di Command Line Windows atau Terminal di macOS, Linux, atau UNIX:

ssh-keygen -t rsa -b 4096 -f key_name

Penjelasan: 

• -t adalah jenis enkripsi

• -b adalah panjang kunci (dalam bit)

• -f adalah nama file kunci

Contoh Kunci

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Petunjuk untuk Jenis Data Tertentu

Untuk petunjuk lebih rinci tentang pengunggahan data tertentu melalui SFTP, silakan lihat topik berikut sesuai jenis data masing-masing:

• HR feeds (pengguna)
• Peran (Roles)
• Custom field
• Kantor
• Entitas hukum