Cara Install OpenSID API

OpenSID API adalah sebuah sistem tambahan yang menghubungkan OpenSID agar bisa menggunakan layanan mobile dan aplikasi PBB. Sebelum bisa menggunakan app Android Layanan Mandiri OpenSID, OpenSID API perlu dipasang terlebih dahulu.

OpenSID API di install secara terpisah dari OpenSID, tetapi tetap harus bisa melakukan koneksi ke database OpenSID sebagai sumber informasi yang akan digunakan.

Cara Install Di Server Local

1. git clone https://github.com/OpenSID/opensid-laravel.git atau unduh dari file yang dibagikan
2. cd opensid-laravel && composer install
3. copyfile .env.example dan rename file .env
4. silahkan sesuaikan konfigurasi database pada file .env
5. php artisan migrate
6. php artisan jwt:secret
7. php artisan serve

Cara Install Pada Share Hosting

untuk melakukan instalasi ke sharehosting, silahkan ikuti langkah2 berikut ini :

1. Buka halaman File Manager pada Cpanel Anda.
2. Upload source code opensid-laravel yang telah anda download dari github
3. Extract file opensid-laravel.zip
4. Buka folder yang baru diextract yaitu opensid-laravel (nama folder dapat disesuaikan dengan yang Anda inginkan)
5. Rename folder public menjadi opensid-laravel kemudian pindahkan ke folder public_html dengan cara klik kanan move /public_html/
6. Buka file index.php kemudian pada file tersebut cari dan ubah script seperti berikut :

require __DIR__.'/../vendor/autoload.php'; 
$app = require_once __DIR__.'/../bootstrap/app.php'; 

diubah menjadi

require __DIR__.'/../../opensid-laravel/vendor/autoload.php';
$app = require_once __DIR__.'/../../opensid-laravel/bootstrap/app.php';

7. rename file .env.example menjadi .env dan sesuaikan konfigurasi database
8. ubah url localhost pada file .env kemudian cari APP_URL disesuaikan dengan alamat domain Anda.

APP_URL=http://localhost

9. buat sebuah file dengan nama .htaccess dan pastekan script berikut

DirectoryIndex index.php
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /api/
    RewriteRule ^$ public/index.php [L]
    RewriteRule ^((?!public/).*)$ public/$1 [L,NC]
</IfModule>

10. berikan permission 755 ke folder storage

Cara Install Pada VPS

untuk cara install pada VPS pada dasarnya sama saja seperti cara instalasi di server local (langkah 1 – 6 ), hanya saja untuk point ke 7 silahkan sesuaikan root project ke folder opensid-api/public.

berikut ini adalah contoh setup pada Nginx :

server {
        listen 80 api.namadesa.id;
        root /var/www/opensid-api/public;
        index index.php index.html index.htm;
        server_name _;
        location / {
                try_files $uri $uri/ /index.php$is_args$args;
        }
        location ~ \.php$ {
                try_files $uri /index.php = 404;
                fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;
        }
}

jangan lupa memberikan permission agar sistem bisa melalukan write ke storage dan log sistem laravel dengan cara :

chown -R www-data:www-data /var/www/opensid-api/storage

Contoh setup virtualhost pada Apache 👍

<VirtualHost *:80>
    DocumentRoot "/var/www/opensid-api/public"
    ServerName api.namadesa.id
    <Directory "/var/www/opensid-api/public">
            AllowOverride All
            Options FollowSymLinks +Indexes
            Order allow,deny
            Allow from all
    </Directory>
</VirtualHost>

Wajib Protokol Https

Supaya lolos uji keamanan ketika melakukan permintaan data dari client ke API OpenSID, maka domain/ subdomain API OpenSID wajib menggunakan SSL agar bisa diakses menggunakan protokol https.

Alternatif SSL yang gratis yang bisa digunakan adalah Let’s Encryp.

Referensi : How To Secure Apache with Let’s Encrypt on Ubuntu 18.04