Selesaikan tugas pasca-instalasi yang diperlukan untuk mempersiapkan IBM Bob bagi pengguna akhir, termasuk sertifikat TLS, federasi LDAP, akses pengguna, dan distribusi endpoint.

Setelah menginstal Bob self-hosted, lakukan tugas administratif berikut sebelum melakukan orientasi pengguna.

Konfigurasi federasi IDP dan LDAP

Dengan federasi LDAP, kamu dapat masuk ke Bob menggunakan kredensial LDAP atau Active Directory yang sudah ada. Konfigurasikan federasi LDAP hanya jika organisasimu menggunakan layanan direktori untuk manajemen identitas. Jika federasi LDAP tidak diperlukan, buat pengguna langsung di Keycloak.

Dapatkan nilai konfigurasi LDAP atau Active Directory yang diperlukan, termasuk:

URL server LDAP
Base pencarian pengguna dan grup
Informasi akun bind (jika berlaku)
Sertifikat CA untuk koneksi LDAPS yang menggunakan certificate authority privat

Buat file konfigurasi IDP dari template yang tersedia:

cp config-idp-template.yaml my-idp.yaml

Perbarui file dengan domain email, email admin, dan detail lingkungan LDAP atau Active Directory-mu.

Terapkan konfigurasi IDP:

./bobctl configure-idp --config my-idp.yaml

Parameter	Deskripsi
`--config`	Menentukan file konfigurasi IDP.
`--dry-run`	Memvalidasi konfigurasi tanpa menerapkan perubahan.

Verifikasi konfigurasi IDP.

Lihat status IDP:

oc get bobidp -n <instance-namespace>

Lihat informasi rekonsiliasi terperinci:

oc get bobidp bob-idp -n <instance-namespace> -o yaml

Verifikasi bahwa kondisi berikut melaporkan status yang berhasil:

Kondisi	Deskripsi
`Ready`	Semua domain yang dikonfigurasi, penugasan administrator, dan penyedia LDAP telah direkonsiliasi dengan sukses.
`LDAPRegistered`	Penyedia LDAP telah didaftarkan di Keycloak.
`LDAPReachable`	Server LDAP dapat dijangkau dari cluster.
`LDAPAuthenticated`	Autentikasi LDAP berhasil diselesaikan.
`LDAPUserSyncSucceeded`	Sinkronisasi pengguna awal berhasil diselesaikan. Hanya muncul jika `userSync.enabled: true`.

Secara default, bobctl menunggu hingga 600 detik untuk rekonsiliasi selesai. Untuk mengubah timeout:

BOB_IDP_WAIT_TIMEOUT=900 ./bobctl configure-idp --config my-idp.yaml

Kamu dapat mengonfigurasi beberapa penyedia LDAP dalam satu file konfigurasi dengan mendefinisikan beberapa entri dalam daftar ldaps. Invokasi bobctl configure-idp yang terpisah tidak diperlukan untuk setiap penyedia.

Untuk detail konfigurasi LDAP lengkap, lihat Integrasi LDAP.

Kelola sertifikat

Bob mengekspos layanan melalui TLS. Workstation klien harus mempercayai certificate authority (CA) yang menerbitkan sertifikat cluster.

Kamu dapat menggunakan salah satu pendekatan sertifikat berikut:

Konfigurasikan sertifikat enterprise atau publik (direkomendasikan)

Hasilkan sertifikat dengan OpenSSL

Gunakan sertifikat self-signed default

Catatan:

Kesalahan koneksi TLS di Bob IDE atau bob-shell biasanya disebabkan oleh sertifikat CA yang tidak dipercaya di workstation klien.

Untuk instruksi lengkap, lihat Sertifikat TLS.

Konfigurasi akses pengguna

Instalasi on-premises Bob menyertakan penyedia identitas Keycloak. Sebelum pengguna dapat mengakses platform, konfigurasikan salah satu metode autentikasi berikut:

Federasi LDAP atau Active Directory: jika kamu mengonfigurasi federasi LDAP menggunakan bobctl configure-idp, pengguna dapat mengautentikasi dengan kredensial enterprise yang sudah ada. Lihat Integrasi LDAP.

Pengguna Keycloak langsung: buat dan kelola pengguna langsung di Keycloak. Pendekatan ini cocok untuk lingkungan evaluasi yang tidak menggunakan integrasi LDAP.

Ambil dan bagikan URL endpoint

Berikan pengguna informasi endpoint yang diperlukan untuk terhubung ke Bob.

Ambil hostname route gateway Bob:

oc get route \
  -n <instance-namespace> \
  -l app.kubernetes.io/component=gateway \
  -o jsonpath='{.items[0].spec.host}'

Contoh output:

api.bob.example.com

Buat URL endpoint:

https://api.bob.example.com

Jika tidak ada route yang tersedia, verifikasi bahwa instance Bob siap:

oc get bob -n <instance-namespace>

Konfirmasikan bahwa statusnya adalah Ready, lalu berikan pengguna informasi berikut:

Item	Diperlukan
URL endpoint Bob	Ya
Sertifikat CA (`bob-ca.crt`)	Hanya jika menggunakan CA self-signed atau privat
Detail autentikasi	Ya

Tugas pasca-instalasi

Konfigurasi federasi IDP dan LDAP

Kelola sertifikat

Konfigurasi akses pengguna

Ambil dan bagikan URL endpoint

Di halaman ini