AI Gateway menggunakan konsumen untuk mengautentikasi entri rute dan API. Topik ini menjelaskan cara membuat dan mengelola konsumen di Konsol AI Gateway.
Prosedur
Masuk ke Konsol AI Gateway.
Pada panel navigasi di sebelah kiri, pilih Consumers. Di bilah navigasi bagian atas, pilih Wilayah.
Di pojok kiri atas halaman Consumers, klik Create Consumer.
Pada halaman Create Consumer, masukkan nama konsumen, pilih metode autentikasi, lalu klik Create.
Autentikasi JWT
Tabel berikut menjelaskan parameter-parameter tersebut:
Item Konfigurasi
Deskripsi
Consumer Name
Nama kustom dari konsumen.
Status
Status konsumen. Status dapat berupa Enabled atau Disabled. Setelah membuat konsumen, Anda dapat secara manual enable atau disable konsumen tersebut.
Description
Deskripsi konsumen.
Authentication Method
Metode autentikasi yang didukung oleh konsumen. Saat ini, JWT dan API Key didukung.
Key Type
Symmetric Key: Konfigurasi JSON Web Key Set (JWKS) default dihasilkan. Konfigurasi ini unik untuk setiap konsumen dan berisi kunci yang digunakan untuk mengenkripsi atau mendekripsi token.
Asymmetric Key: Anda harus memasukkan konfigurasi JWKS lengkap. Gunakan kunci privat untuk mengenkripsi token. Gerbang menggunakan kunci publik yang dikonfigurasi dalam JWKS untuk dekripsi.
JWKS
Untuk informasi lebih lanjut tentang spesifikasi JWKS, lihat JSON Web Key (JWK).
JWKS Token Configuration
Type: Jenis parameter token. Nilai default adalah Header.
Key: Nama parameter token.
Prefix: Awalan nama parameter token. Konfigurasikan informasi parameter token yang memerlukan verifikasi. Secara default, token ditempatkan di Authorization Header dengan awalan Bearer. Contohnya: Authorization: Bearer token.
Pass-through: Pilih opsi ini untuk meneruskan parameter token ke layanan backend.
Consumer ID In JWKS Payload
Tentukan kunci dan nilai yang sesuai dari muatan JWKS untuk mengidentifikasi konsumen saat ini. Secara default, disediakan pasangan kunci-nilai dengan kunci uid dan nilainya berupa string acak. Anda dapat memodifikasinya sesuai kebutuhan.
Kode berikut menunjukkan contoh konfigurasi muatan:
{ "uid": "11215ac069234abcb8944232b79ae711" }Autentikasi API Key
Tabel berikut menjelaskan parameter-parameter tersebut:
Item Konfigurasi
Deskripsi
Consumer Name
Nama kustom dari konsumen.
Status
Status konsumen. Status dapat berupa Enabled atau Disabled. Setelah membuat konsumen, Anda dapat secara manual enable atau disable konsumen tersebut.
Description
Deskripsi konsumen.
Authentication Method
Metode autentikasi yang didukung oleh konsumen. Saat ini, JWT dan API Key didukung.
Generation Method
System-generated: Sistem secara otomatis menghasilkan kredensial Kunci API.
Custom: Tentukan kredensial Kunci API kustom dan sumbernya.
Credential
Kredensial Kunci API kustom.
Credential Source
Lokasi dalam permintaan tempat gerbang mengambil kredensial. Lokasi berikut didukung:
Authorization: Bearer <token>
Custom HTTP Header
Custom Query Parameter