SFTP – Mga Tagubilin sa Pag-set up

TALAAN NG NILALAMAN

• SFTP – Mga Tagubilin sa Pag-set up
  • Pagho-host at pagpapatunay ng pagkakakilanlan
  • Pag-configure
  • Dalas at iskedyul
  • Pag-uulat at paghawak ng error
    • Kaugnay na mga Madalas Itanong (FAQs)
  • Paano gumawa ng pampublikong SSH key para sa SFTP server
    • Format
    • Pattern
    • Paglikha ng SSH Keys 
    • Halimbawa ng Key
  • Mga tagubilin para sa partikular na uri ng talaan

Pagho-host at pagpapatunay ng pagkakakilanlan

Ang inyong SFTP folder ay aming iho-host sa isang hiwalay na SFTP server (gamit ang AWS). Bawat kliyente ay magkakaroon ng natatanging user account na may direktang access sa kani-kanilang SFTP folder. Sinusuportahan namin ang key-based authentication. Dahil dito, kinakailangan ninyong gumawa ng magkaparehang pampubliko at pribadong key at ilagay ang pampublikong key sa Public Key field kapag nagse-set up ng inyong folder. Ang key ay dapat nasa openSSH RSA na format. Para sa mga hakbang kung paano gumawa ng key, tingnan ang Paano gumawa ng pampublikong SSH key para sa SFTP server sa ibaba.

Pag-configure

1. Ilagay ang pampublikong key na inyong ginawa sa Public Key field. Maaari rin ninyong palitan ang Username field kung kinakailangan. Ang halaga sa Username field ay dapat magsimula sa letra, numero, o underscore at may habang 3 hanggang 100 na karakter. Pinapayagan ang mga letra, numero, underscore, @, tuldok (.), at gitling (-).

2. Kopyahin ang Username, Spotnana domain URL, at Port number at itabi ang mga ito sa isang ligtas na lugar dahil kakailanganin ito ng inyong team kapag ise-set up na ang pagpapadala ng mga file sa bagong folder. 
   Tandaan: Kapag tapos na ang pag-set up ng SFTP folder, maaari ninyong muling makita ang mga halagang ito sa ilalim ng Manage.

3. Ilagay ang email address(es) kung saan nais ninyong matanggap ang mga ulat tungkol sa inyong mga file upload sa SFTP email notification field. Para sa karagdagang detalye, tingnan ang Pag-uulat at paghawak ng error sa ibaba.

4. I-click ang Connect.

Kapag nailagay na ang pampublikong key, ang paunang status ay magiging Unverified. Ito ang makikita sa OBT hangga’t wala pang natatanggap na file sa folder. Maaari kayong magpadala ng test file o aktwal na HR feed o custom field file (tanging mga suportadong format lamang ang mapoproseso). Kapag napalitan ang pampublikong key, babalik muli sa Unverified ang status hanggang sa may matanggap na bagong file.

Upang alisin ang inyong SFTP folder, i-click ang Disconnect. Mawawala ang inyong SFTP folder. Kung kailangan ninyong mag-set up ulit, kailangang ilagay muli mula sa simula ang lahat ng impormasyong nabanggit sa itaas.

Dalas at iskedyul

Kayo ang magpapasya kung gaano kadalas at kailan mag-a-upload ng mga file. Ginagamit namin ang paglikha ng file object bilang hudyat upang simulan ang pagproseso. Ibig sabihin, sa sandaling mailagay ninyo ang file sa inyong folder sa aming SFTP server, awtomatikong sisimulan ng aming aplikasyon ang pagproseso ng upload. 

Para sa mga mungkahi ukol sa dalas at iskedyul na angkop sa bawat uri ng talaan (halimbawa: users, custom fields, legal entities), tingnan ang Dalas at iskedyul na bahagi sa SFTP na tagubilin para sa bawat uri ng talaan.

Pag-uulat at paghawak ng error

Kinokolekta namin ang datos ng inyong mga file upload at ginagamit ito upang makagawa ng ulat pagkatapos ng bawat upload. Ipinapadala ang ulat na ito sa email address(es) na inilagay ninyo sa SFTP email notification field habang nagse-set up. Para sa bawat file na na-upload, makikita sa ulat ang: 

• anumang dahilan kung bakit nabigo ang pag-upload ng file (maling format, kulang na pangalan ng column, atbp.).

• anumang dahilan kung bakit may hilera sa file na hindi na-upload. Hindi kami nagsasagawa ng bahagi-bahaging pag-update; kung may error sa isang column o may kulang na kinakailangang field, mabibigo ang buong hilera. 

• ang status ng upload (pending, matagumpay, nabigo).

Maaari ninyong gamitin ang nilalaman ng ulat upang matukoy at maresolba ang anumang error. Kung hindi ninyo ito malutas, makipag-ugnayan sa technical support. 

Kaugnay na mga Madalas Itanong (FAQs)

1. Tumatanggap ba kami ng incremental file na naglalaman lamang ng mga talaang kailangang i-update o idagdag?

   • Oo

2. Kailangan bang isama sa inyong ina-upload na file (gamit man ang SFTP o mano-manong upload) ang mga opsyonal na column kahit hindi ninyo ginagamit ang mga ito?

   • Hindi

Paano gumawa ng pampublikong SSH key para sa SFTP server

Gamitin ang mga tagubilin sa ibaba upang makagawa ng pampublikong SSH key na ipapasa ninyo sa amin.

Format

• Uri: String

• Limitasyon sa Haba: Pinakamahabang haba ay 2048.

Pattern

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

Paglikha ng SSH Keys 

Upang makagawa ng SSH keys, patakbuhin ang utos na ito sa command line ng Windows o terminal ng macOS, Linux, o UNIX:

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

Kahulugan ng mga parameter 

• -t ay uri ng encryption

• -b ay haba ng key (sa bits)

• -f ay pangalan ng key

Halimbawa ng Key

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

Mga tagubilin para sa partikular na uri ng talaan

Para sa mas detalyadong mga tagubilin tungkol sa pag-upload ng partikular na uri ng talaan gamit ang SFTP, tingnan ang mga sumusunod na paksa ayon sa uri ng talaan:

• HR feeds (users)
• Mga Tungkulin
• Mga Pasadyang Patlang
• Mga Opisina
• Mga Legal na Entity