SFTP

Konektor SFTP memungkinkan Anda terhubung ke server SFTP dan melakukan operasi transfer file.

Sebelum memulai

Di project Google Cloud Anda, lakukan tugas berikut:

• Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi, lihat Konektivitas jaringan.
• Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
• Memberikan peran IAM roles/secretmanager.viewer dan roles/secretmanager.secretAccessor ke akun layanan yang ingin Anda gunakan untuk konektor
• Aktifkan secretmanager.googleapis.com (Secret Manager API) dan connectors.googleapis.com (Connectors API). Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan layanan.

Membuat koneksi SFTP

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

1. Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.

   Buka halaman Koneksi

2. Klik + Buat baru untuk membuka halaman Buat Koneksi.
3. Di bagian Lokasi, pilih lokasi dari daftar Wilayah, lalu klik Berikutnya.

   Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

4. Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
   1. Di kolom Connector, pilih SFTP.
   2. Di kolom Versi konektor, pilih versi yang diinginkan.
   3. Di kolom Connection Name, masukkan nama untuk instance koneksi. Nama koneksi dapat berisi huruf kecil, angka, atau tanda hubung. Nama harus diawali dengan huruf dan diakhiri dengan huruf atau angka, serta tidak boleh lebih dari 49 karakter.
   4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
   5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
   6. Di kolom Service Account, pilih akun yang memiliki peran yang diperlukan.
   7. (Opsional) Konfigurasi setelan node Koneksi.
   • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
   • Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.

   Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

   8. (Opsional) Di kolom Remote Path, masukkan jalur folder di server SFTP untuk melakukan operasi entitas, seperti List, Create, Update, atau Delete.

   Jika Anda mengakses entitas (file atau folder) di folder root, atau folder turunan langsung dari folder root, Anda tidak perlu menetapkan nilai apa pun ke kolom ini. Namun, jika Anda ingin mengakses entitas bertingkat yang berada di kedalaman 2 tingkat atau lebih dari folder root, Anda harus menetapkan nilai kolom ini ke jalur dasar folder yang memiliki entitas yang ingin Anda akses. Misalnya, jika Anda ingin mengakses file /folder_A/folder_B/folder_C/test.png, Anda harus menyetel Jalur Jarak Jauh ke /folder_A/folder_B/folder_C.

   9. Atau, klik + Tambahkan label untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
   10. Klik Berikutnya.
5. Di bagian Tujuan, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan dan klik Berikutnya.

Di kolom Jenis Tujuan, pilih jenis yang diinginkan:

• Untuk menentukan nama host atau alamat IP tujuan, pilih Alamat host dan masukkan alamat di kolom Host 1.
• Untuk membuat koneksi pribadi, pilih Endpoint attachment dan pilih lampiran yang diperlukan dari daftar Endpoint Attachment.

Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan mengonfigurasi alamat IP keluar statis untuk koneksi Anda, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.

6. Di bagian Autentikasi, pilih Jenis autentikasi dan masukkan detail yang relevan, lalu klik Berikutnya.

   Jenis autentikasi berikut didukung oleh koneksi SFTP:

   • Nama pengguna dan sandi
   • SSH_PUBLIC_KEY

   Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

7. Tinjau detail koneksi dan autentikasi Anda, lalu klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

• Nama pengguna dan sandi
  • Nama pengguna: Nama pengguna SFTP yang akan digunakan untuk koneksi.
  • Sandi: Secret Manager Secret yang berisi sandi yang terkait dengan nama pengguna SFTP.

• SSH_PUBLIC_KEY
  • Nama pengguna: Akun pengguna SFTP yang digunakan untuk mengautentikasi.
  • Kunci Pribadi SSH: Kunci Pribadi untuk autentikasi SSH.
  • Sandi Kunci Pribadi SSH: Frasa sandi/sandi yang melindungi kunci pribadi, jika ada.
  • Jenis Kunci Pribadi SSH: Format Kunci Pribadi.

Menggunakan koneksi SFTP dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Connectors.

• Untuk memahami cara membuat dan menggunakan tugas Konektor di Apigee Integration, lihat Tugas konektor.
• Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Aplikasi, lihat Tugas konektor.

[{
"Success":"true"
}]

[{
"Success":"true"
}]

Batasan sistem

Konektor SFTP dapat memproses 1 transaksi per detik, per node, dan membatasi kecepatan transaksi apa pun yang melampaui batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Membuat koneksi menggunakan Terraform

Anda dapat menggunakan resource Terraform untuk membuat koneksi baru.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Untuk melihat contoh template terraform untuk pembuatan koneksi, lihat contoh template.

Saat membuat koneksi ini menggunakan Terraform, Anda harus menetapkan variabel berikut dalam file konfigurasi Terraform:

    {
      "type": "object",
      "properties": {
        "FilePath": {
          "type": "string",
          "readOnly": false
        },
        "Filename": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false,
          "description": "The name of the file or directory."
        },
        "FileSize": {
          "type": [
            "number",
            "null"
          ],
          "readOnly": false,
          "description": "The size of the file."
        },
        "LastModified": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "IsDirectory": {
          "type": [
            "boolean",
            "null"
          ],
          "readOnly": false
        },
        "Permissions": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "Owner": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "OwnerId": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "Group": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        },
        "GroupId": {
          "type": [
            "string",
            "null"
          ],
          "readOnly": false
        }
      }
    }
  

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Forum Cloud.

Langkah berikutnya

• Pahami cara menangguhkan dan melanjutkan koneksi.
• Pahami cara memantau penggunaan konektor.
• Pahami cara melihat log konektor.