Apa Itu Skema Keamanan?#
Skema keamanan adalah cara untuk mendefinisikan bagaimana endpoint Anda diautentikasi, mengikuti OpenAPI Specification (OAS). Alih-alih menyiapkan autentikasi untuk setiap endpoint secara individual, Anda dapat membuat templat yang dapat digunakan kembali (skema keamanan) yang memisahkan metode autentikasi dari kredensial yang sebenarnya. Hal ini memudahkan tim untuk mengelola, memperbarui, dan menggunakan kembali pengaturan autentikasi secara lebih fleksibel.Mengapa Menggunakan Skema Keamanan?#
Definisikan Sekali, Gunakan di Mana Saja: Buat skema keamanan satu kali dan gunakan kembali di beberapa endpoint atau folder.
Kombinasi yang Fleksibel: Sebuah endpoint dapat menggunakan lebih dari satu jenis skema keamanan.
Pemisahan Templat dan Nilai: Pisahkan aturan autentikasi (templat) dari nilai sebenarnya (kredensial), yang membuatnya lebih mudah untuk dipelihara.
Mencegah Kebocoran Kredensial: Saat menguji endpoint dengan skema keamanan pada dokumentasi online, kredensial harus dimasukkan secara manual.
Mewarisi Secara Otomatis: Endpoint dapat mewarisi skema keamanan dari folder induknya, sehingga mengurangi penyiapan yang berulang.
Mendukung Semua Metode Auth Utama: Termasuk API Key, Bearer Token, Basic Auth, OAuth 2.0, dan lainnya.
Sesuai dengan OpenAPI: Sepenuhnya kompatibel dengan spesifikasi Skema Keamanan OpenAPI 3.0.
Kapan Anda Harus Menggunakannya?#
Ketika beberapa endpoint menggunakan metode autentikasi yang sama.
Ketika satu endpoint memerlukan beberapa jenis autentikasi.
Ketika Anda memerlukan kredensial yang berbeda untuk lingkungan yang berbeda.
Ketika tim bekerja bersama dan memerlukan cara terpadu untuk mengelola autentikasi.
Ketika Anda ingin menyertakan definisi keamanan yang jelas dan terstandardisasi dalam dokumentasi OpenAPI Anda.
Modified at 2026-06-11 10:17:04