Langsung ke konten
Localtonet Localtonet Dasbor

Single Sign-On dengan Microsoft

Perlu Saldo Tunnel HTTP

Bantuan untuk halaman ini
Di halaman ini 6 bagian
  1. Sebelum memulai
  2. Langkah-langkah
  3. Mendaftarkan aplikasi di Microsoft Entra
  4. Menambahkan penyedia di Localtonet
  5. Mengaktifkannya untuk tunnel
  6. Mengujinya
  7. Jenis akun dan endpoint
  8. Yang dibaca Localtonet dari Microsoft
  9. Pemecahan masalah
  10. Halaman terkait

Biarkan pengunjung masuk dengan akun kerja atau sekolah Microsoft Entra ID, atau akun Microsoft pribadi, sebelum mereka dapat membuka tunnel HTTP. Anda mendaftarkan aplikasi di Microsoft Entra, menambahkannya ke Localtonet sebagai penyedia, lalu mengaktifkannya untuk tunnel.

Sebelum memulai #

  • Tunnel HTTP dan Saldo di akun Anda. Lihat ikhtisar Single Sign-On.
  • Akses ke Microsoft Entra admin center dengan peran yang boleh mendaftarkan aplikasi. Microsoft menyebut Application Developer sebagai peran minimum.
  • Keputusan tentang siapa yang boleh masuk: hanya organisasi Anda, organisasi mana pun, atau akun pribadi juga. Keputusan ini menentukan dua dari alamat yang Anda masukkan di Localtonet. Lihat Jenis akun dan endpoint.

Langkah-langkah #

  1. Mendaftarkan aplikasi di Microsoft Entra #

    Panduan resmi Microsoft adalah Register an app in Microsoft Entra ID, Add a redirect URI, dan Add app credentials. Singkatnya:

    1. Di Microsoft Entra admin center, buka Entra ID › App registrations dan pilih New registration.
    2. Masukkan Name. Pengunjung melihatnya saat masuk.
    3. Di bawah Supported account types, pilih siapa yang dapat menggunakan aplikasi, lalu pilih Register.
    4. Di halaman Overview, salin Application (client) ID. Untuk aplikasi single-tenant, salin juga Directory (tenant) ID.
    5. Di bawah Manage, buka Authentication, pilih Add Redirect URI, pilih platform Web, masukkan redirect URI di bawah, lalu pilih Configure.
    6. Buka Certificates & secrets › Client secrets dan pilih New client secret. Tambahkan deskripsi, pilih masa berlaku, lalu pilih Add. Segera salin Value secret tersebut: Microsoft tidak pernah menampilkannya lagi setelah Anda meninggalkan halaman.
    Redirect URI (platform: Web)
    http://auth.localtonet.com/auth/callback

    Client secret kedaluwarsa. Microsoft membatasi masa berlakunya hingga 24 bulan. Saat kedaluwarsa, proses masuk berhenti berfungsi sampai Anda membuat secret baru dan menyimpannya di penyedia Localtonet.

  2. Menambahkan penyedia di Localtonet #

    Buka Tunnel Saya › HTTP dan pilih SSO di bagian atas halaman. Di dialog Penyedia SSO, pilih Tambah penyedia.

    KolomNilai
    Nama penyediaNama apa pun, misalnya Company Microsoft. Anda melihatnya di pengaturan tunnel.
    Jenis penyediaMicrosoft. Mengubah jenis penyedia yang tersimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret.
    AktifAktif
    Client IDApplication (client) ID dari Microsoft Entra.
    Client secretValue secret, bukan Secret ID. Tidak pernah ditampilkan setelah disimpan.

    Buka Endpoint & callback. Nilai-nilai ini terisi otomatis:

    KolomNilai yang terisiPerlu diubah?
    Endpoint otorisasihttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeGanti common sesuai tabel di bagian berikutnya.
    Endpoint tokenhttps://login.microsoftonline.com/common/oauth2/v2.0/tokenGanti common dengan nilai yang sama seperti di atas.
    Endpoint info penggunahttps://graph.microsoft.com/oidc/userinfoTidak. Tidak mengandung tenant.
    Path callback/auth/callback/microsoftTidak.

    Jika perlu, isi Aturan akses email, lalu pilih Simpan penyedia.

  3. Mengaktifkannya untuk tunnel #

    Di bawah Tunnel Anda, pilih Pengaturan pada tunnel, lalu Kelola di samping Penyedia SSO. Di dialog Single sign-on, aktifkan Wajibkan login dan sakelar penyedia Microsoft Anda. Pilih Simpan.

    Daftar di bawah Siapa yang dapat login dan Path login bersifat opsional. Keduanya dijelaskan di ikhtisar.

  4. Mengujinya #

    Buka URL tunnel di jendela browser pribadi. Localtonet menampilkan Sign in to continue dengan tombol untuk penyedia Anda. Setelah Anda masuk di Microsoft, Anda dikembalikan ke tunnel dan layanan Anda dimuat.

Jenis akun dan endpoint #

Bagian alamat Microsoft setelah login.microsoftonline.com/ mengatur siapa yang dapat masuk. Bagian ini harus sesuai dengan Supported account types aplikasi Anda. Endpoint otorisasi dan Endpoint token selalu mendapat nilai yang sama. Endpoint info pengguna tidak pernah berubah.

Supported account types di Microsoft EntraGunakan sebagai pengganti commonSiapa yang dapat masuk
Single tenant onlyDirectory (tenant) ID AndaPengguna dan tamu dari tenant Anda sendiri.
Multiple Entra ID tenantsorganizationsAkun kerja atau sekolah dari organisasi mana pun.
Any Entra ID Tenant + Personal Microsoft accountsBiarkan commonAkun kerja atau sekolah dan akun Microsoft pribadi.
Personal accounts onlyconsumersAkun Microsoft pribadi.

Contoh untuk aplikasi single-tenant. Ganti <TENANT_ID> dengan Directory (tenant) ID Anda:

Single tenant
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint:         https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint:     https://graph.microsoft.com/oidc/userinfo

Aplikasi single-tenant tidak berfungsi dengan common. Microsoft menjawab dengan error AADSTS50194. Masukkan tenant ID Anda ke kedua endpoint, atau ubah aplikasi ke jenis akun multitenant.

Dengan jenis akun multitenant atau pribadi, orang di luar organisasi Anda dapat masuk di Microsoft. Gunakan Domain email yang diizinkan pada penyedia, atau Siapa yang dapat login pada tunnel, untuk hanya menerima orang yang Anda inginkan.

Yang dibaca Localtonet dari Microsoft #

Endpoint info pengguna Microsoft hanya mengembalikan alamat email jika ada yang terkait dengan akun, sehingga akun tanpa alamat email mungkin tidak lolos aturan yang bekerja berdasarkan email.

Pemecahan masalah #

AADSTS50011: reply URL tidak cocok

Redirect URI dalam permintaan tidak terdaftar untuk aplikasi. Pesan menampilkan alamat yang dikirim. Alamat itu harus identik dengan salah satu redirect URI di halaman Authentication pada app registration, pada platform Web, termasuk huruf besar dan kecil. Daftarkan persis http://auth.localtonet.com/auth/callback.

AADSTS50194: aplikasi tidak dikonfigurasi sebagai aplikasi multitenant

Aplikasi bersifat single tenant, tetapi endpoint-nya masih mengandung common. Ganti common dengan Directory (tenant) ID Anda di Endpoint otorisasi dan Endpoint token, lalu pilih Simpan penyedia.

AADSTS700016: aplikasi tidak ditemukan di direktori

Client ID salah, atau endpoint mengarah ke tenant tempat aplikasi tidak ada. Periksa Application (client) ID dan tenant ID di endpoint.

AADSTS7000215 atau AADSTS7000222: client secret tidak valid atau kedaluwarsa

Buat client secret baru di bawah Certificates & secrets, tempel Value-nya ke Client secret di Localtonet, lalu pilih Simpan penyedia.

Microsoft meminta persetujuan admin

Tenant Anda tidak mengizinkan pengguna menyetujui aplikasi sendiri. Administrator tenant harus memberikan persetujuan untuk aplikasi di Microsoft Entra admin center.

“403 - Access Denied” setelah berhasil masuk di Microsoft

Aturan Localtonet menolak akun tersebut. Periksa Aturan akses email pada penyedia dan Siapa yang dapat login pada tunnel, serta apakah akun memiliki alamat email sama sekali. Setelah memperbaiki aturan, tunggu semenit lalu muat ulang.

Dukungan