# Cara Koneksi dengan Principal
Seperti yang dijelaskan pada bagian *Principal*, **Connection** merupakan fitur yang digunakan untuk menghubungkan antara Principal dan Distributor. Melalui koneksi ini, Principal dapat mengakses data yang telah diizinkan oleh Distributor.
Untuk dapat menggunakan Smart Portal dan melihat laporan, Principal wajib memiliki setidaknya **satu koneksi aktif dengan Distributor**.
Sementara itu, satu Distributor dapat terhubung dengan beberapa Principal sekaligus. Setiap Principal yang telah diberikan akses dapat melihat data milik Distributor melalui fitur laporan (*report*) di portal.
#### Untuk membuat koneksi (dari Distributor), dapat mengikuti langkah berikut:
**Step 1.** Buka tab **Integrations & Connections.**
**Step 2.** Pilih β**Add Newβ** pada sudut kanan atas, kemudian pilih
β**Connection**β.
Menu/Page Integrations & Connections
**Step 3.** Kemudian pilih nama **Integration** dan **Principal** **Key** pada *popup* seperti pada gambar.
Generate Connection Link (Distributor)
**Pengaturan Akses Data oleh Distributor**
Setelah pop-up muncul, Distributor akan diminta untuk memilih jenis integrasi (aplikasi) yang datanya akan dibagikan atau diberikan akses kepada Principal yang akan terkoneksi.
Selanjutnya, Distributor juga perlu mengisi **PrincipalKey**. Nilai **PrincipalKey** ini akan bergantung pada tipe integrasi yang dipilih:
* **Jika tipe integrasi adalah *****External***:\
Nilai **PrincipalKey** dapat diisi secara bebas, karena tidak akan digunakan oleh sistem. Ke depannya, kemungkinan field ini akan dihapus agar tidak menimbulkan kebingungan bagi pengguna.
* **Jika tipe integrasi adalah *****DMS***:\
Nilai **PrincipalKey** harus diisi dengan **SupplierId** dari sistem DMS. *Supplier* di sini merujuk pada Principal yang akan melakukan koneksi dengan Distributor.
**Contoh:** Jika Principal yang akan menggunakan portal adalah *Principal A*, maka cari data *Supplier* atas nama *Principal A* di DMS (perlu diperhatikan bahwa nama bisa saja berbeda), kemudian ambil **Id Supplier** tersebut dan masukkan ke dalam field **PrincipalKey**.
**Step 4.** Tunggu proses pembuatan persetujuan koneksi seperti berikut.
Connection Link Generated (Distributor)
Setelah semua data diisi dan tombol **Create** diklik, sistem akan secara otomatis menghasilkan sebuah link khusus. Link ini kemudian dapat dibagikan kepada **Principal** yang bersangkutan.
Ketika link tersebut diakses oleh Principal (yang sudah login), akan muncul pop-up di halaman mereka untuk menyetujui permintaan koneksi dari Distributor. Proses ini merupakan lanjutan dari mekanisme yang sudah dijelaskan sebelumnya pada bagian mengenai pihak Principal.
Perlu dicatat: link ini **hanya dapat diakses oleh Principal yang telah melakukan login** ke dalam sistem.
Create Connection by Distributor (link dari Principal)
Selain link yang dibuat oleh Principal, sistem juga memungkinkan **Distributor** untuk membuat link koneksi yang kemudian dapat diakses oleh **Principal**.
Sama seperti sebelumnya, link ini **hanya dapat diakses oleh Principal yang telah login** ke dalam sistem. Setelah Principal berhasil login dan mengakses link tersebut, portal akan menampilkan halaman khusus untuk proses persetujuan atau pengelolaan koneksi dengan Distributor.
Proses yang dilakukan oleh Distributor serupa dengan saat melakukan pembuatan link, yaitu memilih jenis **Integrasi** dan mengisi **PrincipalKey**. Harap mengikuti panduan yang telah dijelaskan sebelumnya terkait pengisian data ini.
Setelah koneksi berhasil dibuat (melalui opsi **Allow access**), jika ingin memutuskan koneksi, hal tersebut dapat dilakukan melalui action menu "**Disconnect Connection**" yang terletak di sebelah kanan tabel, seperti yang terlihat pada gambar.
