Mengonfigurasi GitHub Enterprise Server untuk Single sign-on dengan Microsoft Entra ID

Dalam artikel ini, Anda mempelajari cara mengintegrasikan GitHub Enterprise Server dengan MICROSOFT Entra ID. Saat mengintegrasikan GitHub Enterprise Server dengan MICROSOFT Entra ID, Anda dapat:

  • Mengontrol di MICROSOFT Entra ID siapa yang memiliki akses ke GitHub Enterprise Server.
  • Memungkinkan pengguna Anda untuk masuk secara otomatis ke GitHub Enterprise Server dengan akun Microsoft Entra mereka.
  • Kelola akun Anda di satu lokasi pusat.

Prasyarat

Untuk memulai, Anda memerlukan item berikut:

  • Langganan Microsoft Entra. Jika Anda tidak memiliki langganan, Anda bisa mendapatkan akun gratis .
  • GitHub Enterprise Server, siap untuk inisialisasi.
  • Bersama dengan Administrator Aplikasi Cloud, Administrator Aplikasi juga dapat menambahkan atau mengelola aplikasi di ID Microsoft Entra. Untuk informasi selengkapnya, lihat Peran bawaan Azure.

Deskripsi skenario

Dalam artikel ini, Anda mengonfigurasi dan menguji Microsoft Entra SSO di lingkungan pengujian.

  • GitHub Enterprise Server mendukung SSO yang diinisiasi SP dan IDP .
  • GitHub Enterprise Server mendukung provisi pengguna Just In Time .
  • GitHub Enterprise Server mendukung Provisi pengguna otomatis.

Nota

Aplikasi GitHub Enterprise Server saat ini tidak mendukung provisi SCIM di platform cloud pemerintah. Batasan ini disebabkan oleh GitHub Enterprise Server yang memerlukan User-Agent header, yang tidak termasuk dalam permintaan provisi yang dikirim dari lingkungan cloud pemerintah.

Untuk mengonfigurasi integrasi GitHub Enterprise Server ke MICROSOFT Entra ID, Anda perlu menambahkan GitHub Enterprise Server dari galeri ke daftar aplikasi SaaS terkelola Anda.

  1. Masuk ke pusat admin Microsoft Entra dengan peran minimal sebagai administrator aplikasi cloud.
  2. Jelajahi Entra ID>Aplikasi Perusahaan>Aplikasi Baru.
  3. Di bagian Tambahkan dari galeri , ketik GitHub Enterprise Server di kotak pencarian.
  4. Pilih GitHub Enterprise Server dari panel hasil lalu tambahkan aplikasi. Tunggu beberapa detik saat aplikasi ditambahkan ke penyewa Anda.

Atau, Anda juga dapat menggunakan Wizard Konfigurasi Aplikasi Perusahaan. Dalam wizard ini, Anda dapat menambahkan aplikasi ke penyewa Anda, menambahkan pengguna/grup ke aplikasi, menetapkan peran, dan menelusuri konfigurasi SSO juga. Pelajari selengkapnya tentang wizard Microsoft 365.

Mengonfigurasi dan menguji Microsoft Entra SSO untuk GitHub Enterprise Server

Konfigurasikan dan uji SSO Microsoft Entra dengan GitHub Enterprise Server menggunakan pengguna uji bernama B.Simon. Agar SSO berfungsi, Anda perlu membuat hubungan tautan antara pengguna Microsoft Entra dan pengguna terkait di GitHub Enterprise Server.

Untuk mengonfigurasi dan menguji SSO Microsoft Entra dengan GitHub Enterprise Server, lakukan langkah-langkah berikut:

  1. Mengonfigurasi microsoft Entra SSO - untuk memungkinkan pengguna Anda menggunakan fitur ini.
    1. Buat pengguna pengujian Microsoft Entra - untuk menguji single sign-on Microsoft Entra dengan B.Simon.
    2. Tetapkan pengguna uji Microsoft Entra - agar B.Simon dapat menggunakan single sign-on Microsoft Entra.
  2. Konfigurasikan SSO GitHub Enterprise Server - untuk mengonfigurasi pengaturan akses menyeluruh di sisi aplikasi.
    1. Buat pengguna uji GitHub Enterprise Server - untuk memiliki padanan B.Simon di GitHub Enterprise Server yang terhubung ke representasi pengguna di Microsoft Entra.
  3. Uji SSO - untuk memverifikasi apakah konfigurasi berfungsi.

Mengonfigurasi Microsoft Entra SSO

Ikuti langkah-langkah ini untuk mengaktifkan SSO Microsoft Entra.

  1. Masuk ke pusat admin Microsoft Entra dengan peran minimal sebagai administrator aplikasi cloud.

  2. Telusuri Entra ID>Aplikasi Perusahaan>GitHub Enterprise Server>Single Sign-On.

  3. Pada halaman Pilih metode single sign-on, pilih SAML.

  4. Pada halaman Atur login tunggal dengan SAML, pilih ikon pensil pada Konfigurasi Dasar SAML untuk mengedit pengaturan.

    Cuplikan layar memperlihatkan cara mengedit Konfigurasi S A M L Dasar.

  5. Pada bagian Konfigurasi SAML Dasar , jika Anda ingin mengonfigurasi aplikasi dalam mode yang dimulai IDP , lakukan langkah-langkah berikut:

    a. Dalam kotak teks Pengidentifikasi (ID Entitas) , ketik URL menggunakan pola berikut: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

    b. Dalam kotak teks URL Balasan , ketik URL menggunakan pola berikut: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

  6. Pilih Atur URL tambahan dan lakukan langkah berikut jika Anda ingin mengonfigurasi aplikasi dalam mode yang dimulai SP :

    Dalam kotak teks URL Masuk , ketik URL menggunakan pola berikut: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

    Nota

    Nilai-nilai ini tidak nyata. Perbarui nilai-nilai ini dengan Pengidentifikasi, URL Balasan, dan URL Login yang sebenarnya. Hubungi tim dukungan Klien GitHub Enterprise Server untuk mendapatkan nilai-nilai ini. Anda juga dapat merujuk ke pola yang ditampilkan di bagian Konfigurasi SAML Dasar .

  7. Aplikasi GitHub Enterprise Server mengharapkan pernyataan SAML dalam format tertentu, yang mengharuskan Anda untuk menambahkan pemetaan atribut kustom ke konfigurasi atribut token SAML Anda. Cuplikan layar berikut menunjukkan daftar atribut default.

    Cuplikan layar memperlihatkan gambar aplikasi Enterprise Server.

  8. Edit Atribut & Klaim Pengguna.

  9. Pilih Tambah klaim baru dan masukkan nama seperti administrator di kotak teks (nilai yang administrator peka terhadap huruf besar/kecil).

  10. Perluas Kondisi klaim dan pilih Anggota dari Jenis pengguna.

  11. Pilih Pilih grup dan cari Grup yang ingin Anda sertakan klaim ini, di mana anggotanya harus menjadi administrator untuk GHES.

  12. Pilih Atribut untuk Sumber dan masukkan true (tanpa tanda kutip) untuk Nilai.

  13. Pilih Simpan.

    Cuplikan layar menunjukkan cara mengelola klaim atribut.

  14. Pada halaman Siapkan akses menyeluruh dengan SAML , di bagian Sertifikat Penandatanganan SAML , temukan Sertifikat (Base64) dan pilih Unduh untuk mengunduh sertifikat dan menyimpannya di komputer Anda.

    Cuplikan layar memperlihatkan tautan Unduhan sertifikat.

  15. Pada bagian Siapkan GitHub Enterprise Server , salin URL yang sesuai berdasarkan kebutuhan Anda.

    Cuplikan menunjukkan cara menyalin URL konfigurasi yang sesuai.

Membuat dan menetapkan pengguna uji Microsoft Entra

Ikuti prosedur dalam panduan cepat membuat dan menetapkan akun pengguna untuk membuat akun pengguna uji bernama B.Simon.

Konfigurasi SSO untuk GitHub Enterprise Server

Untuk mengonfigurasi SSO di sisi GitHub Enterprise Server, Anda perlu mengikuti instruksi yang disebutkan di sini.

Membuat pengguna uji GitHub Enterprise Server

Di bagian ini, pengguna bernama B.Simon dibuat di GitHub Enterprise Server. GitHub Enterprise Server mendukung penyediaan pengguna just-in-time, yang diaktifkan secara bawaan. Tidak ada item tindakan untuk Anda di bagian ini. Jika pengguna belum ada di GitHub Enterprise Server, pengguna baru dibuat setelah autentikasi.

GitHub Enterprise Server juga mendukung provisi pengguna otomatis. Anda dapat menemukan detail selengkapnya di sini tentang cara mengonfigurasi provisi pengguna otomatis.

Uji SSO

Di bagian ini, Anda menguji konfigurasi akses menyeluruh Microsoft Entra dengan opsi berikut.

SP dimulai:

  • Pilih Uji aplikasi ini, opsi ini mengalihkan ke URL Masuk GitHub Enterprise Server tempat Anda dapat memulai alur masuk.

  • Buka URL Masuk GitHub Enterprise Server secara langsung dan mulai alur masuk dari sana.

IDP dimulai:

  • Pilih Uji aplikasi ini, dan Anda akan secara otomatis masuk ke GitHub Enterprise Server tempat Anda menyiapkan SSO.

Anda juga dapat menggunakan Microsoft My Apps untuk menguji aplikasi dalam mode apa pun. Saat Anda memilih petak peta GitHub Enterprise Server di Aplikasi Saya, jika dikonfigurasi dalam mode SP, Anda akan diarahkan ke halaman masuk aplikasi untuk memulai alur masuk dan jika dikonfigurasi dalam mode IDP, Anda akan secara otomatis masuk ke GitHub Enterprise Server tempat Anda menyiapkan SSO. Untuk informasi selengkapnya, lihat Microsoft Entra My Apps.

Konten terkait

  • Last updated on