MMyPlanDokumentasi
Administrasi

SSO, domain terverifikasi, dan SCIM

Masuk lewat penyedia identitas perusahaan (OpenID Connect), wajibkan SSO, verifikasi domain email, izinkan bergabung otomatis, dan kelola anggota lewat SCIM 2.0.

Halaman Pengaturan workspace → Keamanan & SSO mengumpulkan pengaturan untuk organisasi:

  • Single sign-on (OpenID Connect): anggota masuk lewat Okta, Microsoft Entra ID (Azure AD), Google Workspace, atau penyedia OIDC lain.
  • Domain terverifikasi: bukti bahwa domain email perusahaan milik Anda. SSO hanya menerima alamat di domain ini.
  • Gabung otomatis: orang dengan alamat di domain terverifikasi bisa bergabung sendiri, langsung atau lewat persetujuan admin.
  • Provisioning SCIM: penyedia identitas menambah, memperbarui, dan mengeluarkan anggota secara otomatis.

SSO dan SCIM tersedia di paket Enterprise. Domain terverifikasi dan gabung otomatis tersedia mulai paket Business.

Memverifikasi domain

Tambahkan domain

Di bagian Domain terverifikasi, ketik domain email kerja Anda (misalnya perusahaan.co.id) lalu klik Tambah domain. Domain email publik seperti gmail.com tidak bisa ditambahkan.

Buat record TXT

MyPlan menampilkan Nama (_myplan-verification.perusahaan.co.id) dan Nilai (myplan-verification=…). Tambahkan record TXT dengan isi tersebut di penyedia DNS Anda.

Klik Verifikasi

Setelah record terpasang, klik Verifikasi. Perubahan DNS kadang butuh beberapa menit; jika belum terlihat, MyPlan menampilkan bahwa record belum ditemukan. Satu domain hanya bisa diverifikasi oleh satu workspace.

Menyiapkan SSO

Daftarkan aplikasi di penyedia identitas

Buat aplikasi web OIDC di penyedia identitas Anda. Gunakan URI pengalihan yang ditampilkan MyPlan (https://myplan.my.id/v1/auth/sso/callback) dan izinkan scope openid email profile.

Isi pengaturan di MyPlan

Isi URL issuer (misalnya https://perusahaan.okta.com), Client ID, dan Client secret. MyPlan membaca dokumen discovery penyedia untuk menemukan endpoint dan kunci tanda tangannya. Client secret disimpan terenkripsi dan tidak pernah ditampilkan lagi.

Aktifkan dan uji

Nyalakan Aktifkan single sign-on, klik Simpan, lalu klik Uji masuk. Anda dibawa ke penyedia identitas dan kembali ke halaman ini dengan hasilnya, misalnya Uji masuk berhasil.

Pilihan lain:

  • Buat akun saat pertama masuk: orang baru dari penyedia identitas otomatis menjadi anggota workspace dengan Peran untuk orang baru (Anggota atau Tamu). Jika dimatikan, hanya anggota yang sudah ada yang bisa masuk lewat SSO.
  • Kursi paket tetap berlaku: jika semua kursi terpakai, orang baru tidak bisa masuk sampai admin menambah kursi.

Cara masuk dengan SSO

Di halaman masuk, klik Lanjutkan dengan SSO, ketik email kerja, lalu lanjutkan di penyedia identitas. Setelah itu MyPlan membuka sesi biasa. Jika akun memakai autentikasi dua langkah MyPlan, kode 2FA tetap diminta.

Keamanan yang diperiksa MyPlan pada setiap login: PKCE, state, dan nonce; tanda tangan ID token terhadap kunci JWKS penyedia (RS256/RS384/RS512 atau ES256); issuer; audience; masa berlaku; serta alamat email harus berada di domain terverifikasi workspace.

Mewajibkan SSO

Setelah uji masuk berhasil dan minimal satu domain terverifikasi, nyalakan Wajibkan SSO. Sejak itu, semua anggota kecuali pemilik harus masuk lewat SSO untuk membuka workspace; sesi yang dibuka dengan kata sandi atau Google melihat layar Single sign-on diwajibkan dengan tombol Lanjutkan dengan SSO.

Pemilik workspace tetap bisa masuk dengan cara biasa sebagai jalan darurat (misalnya saat penyedia identitas bermasalah). Token API dan token akun tidak terpengaruh.

Mengganti issuer, client ID, atau client secret mengharuskan uji masuk ulang sebelum SSO bisa diwajibkan lagi.

Gabung otomatis lewat domain

Untuk setiap domain terverifikasi, pilih:

PilihanPerilaku
MatiOrang hanya bisa bergabung lewat undangan.
Gabung sebagai anggotaOrang yang masuk dengan alamat di domain ini melihat workspace di bagian Workspace organisasi Anda dan bisa langsung bergabung.
Minta bergabungOrang mengirim permintaan; admin menyetujui atau menolaknya di Permintaan bergabung.

Provisioning SCIM

Buat token SCIM

Di bagian Provisioning SCIM, beri nama token (misalnya Okta) lalu klik Buat token. Salin token (diawali mps_) sekarang; token tidak ditampilkan lagi.

Atur penyedia identitas

Di Okta, Entra ID, atau Google, isi URL dasar SCIM yang ditampilkan MyPlan (https://myplan.my.id/v1/scim/v2) dan token tadi sebagai bearer token.

Yang didukung:

  • Users: buat, baca, cari dengan filter userName eq "…" (juga externalId dan emails.value), ganti (PUT), ubah sebagian (PATCH, termasuk gaya Azure "False"), dan hapus.
  • Groups: dipetakan ke grup anggota; buat, cari dengan displayName eq "…", ganti nama, tambah dan hapus anggota.
  • Menonaktifkan atau menghapus pengguna mengeluarkannya dari workspace tanpa menghapus pekerjaannya. Tugas, komentar, dan halaman yang ia buat tetap ada; mengaktifkan kembali mengembalikan keanggotaannya.
  • Pemilik workspace tidak bisa dinonaktifkan lewat SCIM.

Token bisa dicabut kapan saja dengan Cabut.

SAML 2.0 belum didukung. MyPlan hanya menawarkan SSO lewat OpenID Connect, yang didukung semua penyedia identitas utama.

Izin

TindakanPeran
Mengatur SSO, domain, dan token SCIMAdmin atau Pemilik (sso.manage)
Menyetujui permintaan bergabungAdmin atau Pemilik (member.manage)

Terkait

Di halaman ini