Petunjuk Instalasi – OtomaX API

1. Install Hosting Bundle

OtomaX API berjalan di atas Microsoft .NET 6. Untuk itu kita harus menginstal .NET 6 Hosting Bundle, yang didalamnya termasuk .Net Runtime dan IIS Support (API bisa dipasang di IIS).
Download: https://dotnet.microsoft.com/en-us/download/dotnet/6.0

Informasi terkait: https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/hosting-bundle?view=aspnetcore-6.0

 

2. Ekstrak file otomax_api.zip

Pastikan file zip didapat dari sumber terpercaya untuk menghindari resiko TROJAN/VIRUS.
Extract zip tersebut ke dalam sebuah folder, misalnya D:/otomax_api.

Jika sebelumnya didalam folder sudah terdapat file yang sama, overwrite semua file KECUALI appsettings.json. Karena file appsettings.json berisi seting yang disesuaikan dengan kondisi masing-masing komputer.

 

3. Edit appsettings.json

Buka file appsettings.json dengan Notepad atau editor sejenis. Sesuaikan ConnectionString dengan alamat database OtomaX yang dituju.

{
  "Logging": {
    "LogLevel": {
    "Default": "Information",
    "Microsoft": "Warning",
    "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "Urls": "http://*:5000",
  "ConnectionString": "Server=.\\SQLEXPRESS;Database=otomax;Trusted_Connection=True;Max Pool Size=3;Application Name=API",
  "SenderCallbacks": {
    "OtomaX.Addon": "http://45.77.173.173:9888/api/senderoto/"
  },
  "AppEndpoints": {
    "OtomaX.Addon": "*"
  },
  "LogInvalidSignature": false
}

Jika kita mau menggunakan SSL maka cukup ubah isi “Urls” dari http menjadi https, contoh: https://*:5000. Jika port 5000 sudah digunakan, bisa gunakan port lain, contoh: https://*.5001.

 

4. Jalankan program otomax_api.exe

 

5. Mengenkripsi Connection String

Jika ConnectionString tidak mengandung Trusted_Connection, OtomaX API akan meminta kita untuk mengubah isi ConnectionString ke bentuk yang terenkrip. Tujuannya agar informasi pada ConnectionString menjadi tersembunyi dan rahasia.

 

Cukup ikuti perintah yang muncul pada layer untuk melakukan enkripsi pada ConnectionString.
Setelah ConnectionString berhasil diubah maka program akan berjalan normal seperti pada poin nomor 4.

Selesai.