# Panduan Menghubungkan Login Microsoft ke CRM

Panduan ini dibuat sesederhana mungkin agar Pemilik Bisnis (*Owner*) dapat menghubungkan sistem CRM dengan ekosistem Microsoft perusahaan (Office 365 / Azure / Entra ID). 

Proses ini sangat aman karena dilakukan langsung di dalam akun resmi Microsoft perusahaan Anda. Waktu pengerjaan kurang lebih 5-10 menit.

---

## Tahap 1: Mendaftarkan Aplikasi di Microsoft Azure

Langkah ini ibarat "meminta izin" kepada Microsoft agar CRM Anda diperbolehkan berkomunikasi dengan akun Microsoft karyawan.

1. Buka browser dan masuk ke [Portal Microsoft Azure](https://portal.azure.com/) menggunakan akun admin Microsoft perusahaan Anda.
2. Di bar pencarian paling atas, ketik **App registrations** (Pendaftaran aplikasi), lalu klik menu tersebut yang muncul berlogo kotak biru.
3. Klik tombol **+ New registration** (Pendaftaran baru) di kiri atas.
4. Isi formulir pendaftaran dengan panduan berikut:
   - **Name**: Ketikkan nama aplikasi yang mudah diingat (Contoh: "CRM Perusahaan").
   - **Supported account types**: Pilih opsi paling atas yaitu **Accounts in this organizational directory only** (Hanya akun dalam direktori ini). *Pilihan ini sangat penting untuk memastikan HANYA karyawan internal Anda yang bisa login, orang luar tidak akan bisa.*
   - **Redirect URI**: 
     - Di kotak sebelah kiri (pilih platform), pilih **Web**.
     - Di kotak sebelah kanan, masukkan tautan ini: 
       `https://[DOMAIN-CRM-ANDA]/signin/microsoft_callback` 
       *(Penting: Ganti `[DOMAIN-CRM-ANDA]` dengan alamat asli CRM Anda, contohnya: `https://charly.mayagrahakencana.com/signin/microsoft_callback`)*
5. Klik tombol biru **Register** (Daftar) di bagian paling bawah.

---

## Tahap 2: Mendapatkan `Client ID`

Setelah Anda menekan tombol Register, Anda akan dibawa ke halaman profil aplikasi yang baru saja dibuat. Di sinilah kita mengambil identitas aplikasi tersebut.

1. Di halaman utama (*Overview*), perhatikan tulisan **Application (client) ID**.
2. Di sebelahnya akan ada kode panjang (kombinasi angka dan huruf). Salin (*Copy*) kode tersebut.
3. Buka **Notepad** (atau catatan kosong lainnya) dan *Paste* kode tadi. Beri nama: **Client ID**.

---

## Tahap 3: Membuat Kunci Rahasia (`Client Secret`)

Sistem CRM Anda butuh kata sandi khusus (kunci) untuk bisa mengetuk pintu Microsoft. Kita akan membuatnya sekarang.

1. Di menu sebelah kiri (masih di halaman Azure yang sama), cari bagian *Manage* dan klik **Certificates & secrets** (Sertifikat & rahasia).
2. Pastikan Anda berada di tab *Client secrets*, lalu klik tombol **+ New client secret** (Rahasia klien baru).
3. Akan muncul jendela kecil di sebelah kanan:
   - **Description**: Isi bebas, misal "Kunci Login CRM".
   - **Expires**: Pilih **730 days (24 months)** agar Anda tidak repot memperbaruinya setiap beberapa bulan.
4. Klik tombol **Add** (Tambahkan) di bawah.
5. **⚠️ LANGKAH PALING KRUSIAL:** Setelah ditambahkan, tabel di bawah akan memunculkan sebuah kode di kolom **Value**. 
   Anda **WAJIB LANGSUNG MENYALIN (COPY)** kode di kolom **Value** ini sekarang juga. 
   *(Catatan: Kode ini dirahasiakan oleh Microsoft dan hanya ditampilkan SATU KALI. Jika Anda me-refresh halaman, kode ini akan disensor permanen dan Anda terpaksa harus membuat kunci yang baru).*
6. *Paste* kode rahasia ini ke Notepad Anda yang tadi. Beri nama: **Client Secret**.

---

## Tahap 4: Memasukkan Data ke CRM

Selesai! Sekarang lihat Notepad Anda, Anda sudah memiliki dua kunci emas:
1. **Client ID**
2. **Client Secret**

**Langkah Terakhir:**
Berikan kedua teks rahasia ini kepada Programmer Anda, ATAU masukkan langsung kode tersebut ke dalam kolom Integrasi Login Microsoft yang telah disiapkan di menu Pengaturan (*Settings*) CRM Anda.

Selamat! Seluruh karyawan Anda kini bisa masuk ke CRM dengan mudah dan aman menggunakan akun Microsoft perusahaan.
