Integrasi Eksternal = koneksi portal ke layanan luar (Microsoft 365: Email & OneDrive, dll). Setup di sini bersifat global per tenant — sekali setup, semua project bisa pakai.
Microsoft 365 Email
Kirim email atas nama mailbox tenant Esteh via Graph API
Tenant ID
Client ID
Client Secret
Domain Sender yang Diizinkan
Belum Aktif — Langkah Setup
- Buka entra.microsoft.com → App Registrations → New Registration.
- Nama:
Esteh Portal — Mail Send. Account type: Single tenant. Klik Register. - Setelah ter-register, masuk ke menu API Permissions → Add a permission → Microsoft Graph → Application permissions → cari & centang
Mail.Send→ Add. - Klik Grant admin consent for PT Esteh Indonesia Makmur (butuh Global Admin role). Tunggu sampai status hijau "Granted".
- Masuk ke menu Certificates & secrets → New client secret. Beri label
Portal Mail Production. Expiry: 24 months. Klik Add — SEGERA COPY VALUE-NYA (tidak bisa dilihat ulang setelah halaman di-close). - Di tab Overview, copy Application (client) ID dan Directory (tenant) ID.
- SSH ke droplet portal, edit
/home/claudeadmin/portal/.env, tambahkan:M365_TENANT_ID=<Directory (tenant) ID> M365_MAIL_CLIENT_ID=<Application (client) ID> M365_MAIL_CLIENT_SECRET=<Client secret VALUE (bukan ID)> - Restart portal:
cd /home/claudeadmin/portal && docker compose restart portal-app - Refresh halaman ini (Ctrl+Shift+R) — status harusnya berubah jadi Aktif.
- Simpan Client Secret di Bitwarden dengan label "Esteh Portal — M365 Mail Client Secret". Backup penting!
Test Kirim Email
Harus domain yang di-whitelist
OneDrive — Penyimpanan File Project
Baca data Excel/CSV project dari folder OneDrive it@ via Graph API
✓ Terhubung. folder department terbaca di "Portal Esteh Group".
Memakai aplikasi Entra yang sama dengan Email (izin tambahan Files.ReadWrite.All).
Log Email Terbaru (50 terakhir)
Memuat...
Belum ada email yang dikirim portal.
| Waktu | Sender | To | Subject | Trigger | Status |
|---|---|---|---|---|---|