Rilis bulan Juli ini berfokus pada tiga area: keamanan perusahaan dan manajemen akses, migrasi API serta sinkronisasi spesifikasi, dan alur kerja pengujian yang lebih mudah dipelihara.
Tim API membutuhkan lebih dari fitur individual. Mereka perlu menemukan kredensial sebelum menjadi insiden, melacak akses dan aktivitas organisasi, mempertahankan konteks data saat impor, serta menjalankan pengujian otomatis yang mudah digunakan kembali dan dipantau.
Bulan ini, Apidog memperbarui tiga alur kerja utama:
- Keamanan dan akses perusahaan (Paket Enterprise): deteksi risiko kredensial, audit aktivitas organisasi, serta peningkatan SCIM, SAML, dan SSO.
- Migrasi API dan sinkronisasi spesifikasi: pertahankan lebih banyak konteks Postman dan buat impor OpenAPI/Swagger lebih aman untuk diulang.
- Pengujian dan keandalan alur kerja: gunakan kembali aset pengujian, lihat eksekusi skenario terakhir, dan simpan konfigurasi lingkungan besar dengan lebih andal.
1. 🔐 Keamanan dan Akses Perusahaan
Tata kelola API perusahaan membutuhkan tiga kemampuan: menemukan data sensitif, melacak aktivitas penting, dan memberikan akses yang tepat kepada pengguna yang tepat.
Ketersediaan: Paket Enterprise
Enterprise Secret Scanner untuk Menemukan Risiko Kredensial
Proyek API sering menyimpan parameter permintaan, header, environment, variabel, skrip, contoh, dan konfigurasi autentikasi. Jika API key, access token, private key, atau kredensial lain tersimpan sebagai teks biasa, risikonya dapat sulit ditemukan—terutama di organisasi besar.
Gunakan Secret Scanner untuk menjalankan alur remediasi yang lebih terstruktur:
- Mulai dari tampilan organisasi. Administrator dapat melihat tim dengan temuan rahasia yang belum diselesaikan dan mengidentifikasi Pemilik Tim atau Admin Tim yang relevan.
- Tinjau temuan di tingkat tim. Buka daftar temuan dari seluruh proyek tim dan periksa setiap kejadian yang terkait dengan risiko yang sama.
- Telusuri sumber kredensial. Setiap kejadian dapat mengarah ke request, environment, variabel, contoh, atau sumber daya terkait.
- Catat status remediasi. Tandai temuan sebagai selesai dengan alasan seperti Dicabut, Positif palsu, atau Tidak akan diperbaiki.
- Tambahkan pola internal. Administrator tim dapat membuat, mengedit, mengaktifkan, menonaktifkan, atau menghapus pola deteksi kustom untuk format kredensial internal.
Dengan alur ini, tim tidak berhenti di deteksi. Mereka dapat menemukan sumber, menentukan pemilik remediasi, dan menyimpan riwayat penyelesaian yang jelas.
Log Audit Enterprise untuk Melacak Aktivitas Organisasi
Saat organisasi mengelola banyak anggota, tim, proyek, dan izin, administrator membutuhkan catatan aktivitas yang mudah ditelusuri. Tanpa riwayat ini, investigasi perubahan akses atau operasi sensitif dapat memerlukan pemeriksaan manual dari banyak sumber.
Log Audit Enterprise menyediakan tampilan terpusat untuk Pemilik dan Admin Organisasi. Setiap catatan dapat mencakup:
- Operator
- Jenis dan deskripsi peristiwa
- Alamat IP sumber
- Stempel waktu
Filter berdasarkan rentang waktu, jenis peristiwa, atau operator untuk melacak perubahan pada anggota, tim, izin, proyek, dan peristiwa login. Gunakan data ini untuk mendukung tinjauan keamanan, investigasi insiden, dan proses kepatuhan internal.
Alur Kerja Identitas dan SSO yang Lebih Andal
Apidog meningkatkan kompatibilitas SCIM 2.0 untuk lebih banyak integrasi penyedia identitas (IdP). Operasi siklus hidup pengguna dan manajemen grup tingkat organisasi kini lebih tangguh terhadap perbedaan field SCIM dan perilaku endpoint.
Untuk organisasi yang menggunakan IdP seperti JumpCloud, Microsoft Entra ID, dan Okta, pembaruan ini membantu alur kerja berikut:
- Mengaktifkan, memperbarui, dan menyinkronkan pengguna serta grup dengan lebih andal.
- Memetakan grup SAML dari string grup tunggal maupun array multi-grup.
- Memberikan peran organisasi dan tim yang sesuai setelah login SSO.
- Mempertahankan keanggotaan tim yang sudah ada.
- Membuka organisasi dan tim yang tepat secara otomatis setelah login SSO, sehingga pengguna lebih cepat masuk ke proyek yang sesuai.
2. 📦 Migrasi API dan Sinkronisasi Spesifikasi
Migrasi yang baik bukan hanya soal impor berhasil. Request harus tetap mudah dipahami, autentikasi harus tetap berfungsi, variabel harus mempertahankan konteks, dan sinkronisasi berulang tidak boleh menghapus sumber daya yang tidak terkait.
Migrasi Postman yang Lebih Lengkap
Apidog kini mempertahankan dan memetakan lebih banyak data Postman, baik dari impor file lokal maupun impor melalui API Postman.
Perubahan utama:
- Pengaturan autentikasi tingkat Collection dan OAuth 2.0 tingkat endpoint diimpor dengan lebih akurat.
- URL refresh token OAuth 2.0 dipetakan dengan benar.
- Deskripsi variabel dan klasifikasi rahasia dapat dipertahankan.
- Field file
form-datamempertahankan nama file asli saat file lokal tidak dapat ditransfer. - Impor API Postman dapat menyertakan Global, dengan opsi untuk mengecualikannya saat impor.
- Karakter nama variabel yang tidak didukung, seperti spasi atau garis vertikal, diganti dengan garis bawah.
- Impor API Postman berulang lebih kecil kemungkinannya menggunakan data Collection lama yang tersimpan di cache browser.
| Sebelum | Sekarang |
|---|---|
| Detail autentikasi mungkin perlu dibuat ulang setelah migrasi. | Lebih banyak pengaturan autentikasi dan body request dipertahankan. |
| Konteks variabel atau metadata rahasia dapat hilang. | Variabel mempertahankan konteks yang lebih berguna. |
| Global tidak tersedia melalui jalur API Postman. | Global dapat ditinjau dan diimpor. |
| Karakter nama variabel yang tidak didukung dapat merusak referensi. | Nama variabel dinormalisasi untuk template Apidog. |
| Impor berulang kadang menggunakan cache lama. | Migrasi dan sinkronisasi berulang lebih andal. |
Untuk mengurangi pekerjaan pasca-migrasi, verifikasi autentikasi, variabel, dan referensi template segera setelah impor pertama. Setelah itu, gunakan impor berulang untuk menjaga Collection tetap selaras.
Alur Kerja Impor OpenAPI dan Swagger yang Lebih Aman
Impor OpenAPI dan Swagger sering digunakan sebagai mekanisme sinkronisasi berkelanjutan, bukan migrasi satu kali. Karena itu, error parsing, impor tidak lengkap, atau penghapusan resource yang salah dapat berdampak berulang kali.
Apidog kini memberikan detail error yang lebih jelas saat file OpenAPI atau Swagger tidak dapat diimpor. Jika masalah berkaitan dengan format spesifikasi yang dipilih, alur impor memberikan panduan lebih langsung untuk mengganti format dan melanjutkan investigasi.
Peningkatan untuk kasus sinkronisasi yang lebih kompleks mencakup:
- Impor terjadwal dapat memproses definisi dari respons HTTP non-2xx dengan lebih benar.
- Impor OpenAPI 3.1 ke cabang iterasi mempertahankan endpoint, Webhook, folder, deskripsi, dan status tidak terpakai dengan lebih andal.
- Folder tanpa endpoint HTTP lebih kecil kemungkinannya terhapus saat resource tidak lagi ada dalam definisi sumber.
- Referensi skema sirkular ditangani dengan lebih andal.
- Sinkronisasi model lintas modul dan sumber impor terjadwal lebih kecil kemungkinannya menimpa model tidak terkait dengan nama yang sama.
Untuk tim dengan proyek multi-modul, cabang iterasi, atau impor terjadwal, gunakan perubahan ini untuk mengurangi risiko kehilangan resource saat sinkronisasi spesifikasi.
3. 🧪 Pengujian dan Keandalan Alur Kerja
Otomatisasi sulit dipelihara ketika aset pengujian harus diduplikasi, aktivitas skenario sulit dipantau, atau konfigurasi environment besar gagal disimpan. Pembaruan ini mengurangi hambatan tersebut.
Gunakan Kembali Aset Pengujian di Apidog CLI
Saat Apidog CLI menjalankan kasus skenario, langkah skenario kini dapat mereferensikan:
- Endpoint
- Test case
- Skenario lain
Ini memungkinkan tim menyusun skenario secara modular. Gunakan endpoint dan test case yang sama di skrip lokal, pipeline CI/CD, serta alur pengujian otomatis tanpa membuat ulang langkah yang terisolasi.
Praktik yang disarankan:
- Simpan validasi request dasar dalam test case yang dapat digunakan ulang.
- Referensikan test case tersebut dari skenario yang lebih besar.
- Jalankan skenario yang sama secara lokal dan di CI/CD.
- Perbarui aset sumber sekali saat kontrak API berubah.
Lihat Waktu Eksekusi Skenario Terakhir
Daftar skenario pengujian otomatis kini menampilkan waktu eksekusi terbaru selain waktu pembuatan.
Gunakan informasi ini untuk:
- Memeriksa apakah skenario masih dijalankan secara rutin.
- Mengidentifikasi pengujian yang mungkin membutuhkan perhatian.
- Memberikan konteks aktivitas pengujian kepada pemangku kepentingan proyek.
Simpan Konfigurasi Environment Besar dengan Lebih Andal
Proyek besar dapat mengakumulasi nilai kosong yang tidak valid dalam konfigurasi environment. Data ini meningkatkan ukuran request dan terkadang menyebabkan kegagalan penyimpanan.
Apidog kini menghapus data kosong yang tidak digunakan saat environment disimpan. Ini membuat pembaruan konfigurasi lebih andal, terutama pada proyek dengan banyak modul.
🐞 Perbaikan Bug dan Peningkatan Kecil
Rilis ini juga mencakup perbaikan berikut:
- Memperbaiki masalah ketika notifikasi Runner dan hasil eksekusi terbaru dapat menampilkan durasi rata-rata
0setelah skenario selesai. - Memperbaiki masalah ketika klik “Lupa kata sandi” tidak otomatis menggunakan kembali informasi akun yang telah dimasukkan.
- Memperbaiki masalah ketika Pemilik Organisasi dapat kehilangan akses ke pengaturan organisasi setelah batas anggota terlampaui.
- Memperbaiki masalah ketika Pemilik Tim dapat bergabung kembali melalui tautan undangan proyek dengan peran anggota biasa yang salah.
- Memperbaiki offset zona waktu pada aktivitas terbaru di daftar anggota organisasi.
- Memperbaiki masalah ketika kloning proyek dari situs dokumentasi yang diterbitkan dapat menyertakan endpoint dari modul yang belum diterbitkan.
- Memperbaiki masalah ketika langkah test suite dapat hilang setelah disimpan di cabang anak.
- Memperbaiki masalah ketika Runner gagal mengeksekusi test suite di cabang anak.
- Memperbaiki masalah ketika ekspor dokumentasi multi-modul dapat berisi endpoint dari modul yang tidak dipilih.
- Memperbaiki masalah ketika menonaktifkan “Import Authentication” dapat keliru mengubah autentikasi direktori menjadi “No Auth”.
- Meningkatkan pengenalan Secret Scanner untuk pola kredensial tambahan.
- Memperbaiki masalah ketika gambar dalam dokumen Markdown gagal ditampilkan di klien desktop On-Premises.
- Meningkatkan data penggunaan kredit kumulatif agar total peningkatan dan total konsumsi ditampilkan lebih akurat.
🌟 Dampaknya untuk Tim API
| Fokus | Yang ditingkatkan | Mengapa penting |
|---|---|---|
| Keamanan dan akses perusahaan | Secret Scanner, Log Audit, kompatibilitas JumpCloud SCIM dan SAML, serta navigasi workspace SSO yang lebih cepat. | Organisasi dapat menemukan risiko kredensial, melacak aktivitas penting, dan mengelola akses pengguna dengan lebih sedikit celah. |
| Migrasi API dan sinkronisasi spesifikasi | Lebih banyak konteks Postman dipertahankan, sementara impor OpenAPI dan Swagger lebih aman serta lebih mudah ditelusuri saat bermasalah. | Tim menghabiskan lebih sedikit waktu memperbaiki data impor dan menghadapi risiko lebih rendah kehilangan atau menimpa resource proyek. |
| Pengujian dan keandalan alur kerja | Skenario CLI dapat menggunakan kembali aset yang ada, aktivitas skenario lebih mudah dilihat, dan penyimpanan environment besar lebih stabil. | Alur kerja otomatis lebih mudah disusun, dipantau, dan dipelihara. |
Pembaruan ini membantu tim keamanan, administrator, desainer API, dan engineer pengujian bekerja dengan fondasi operasional yang lebih jelas dan andal.
💬 Bergabung dalam Percakapan
Terhubung dengan sesama engineer API dan tim Apidog:
- Bergabunglah dengan komunitas Discord untuk diskusi dan dukungan waktu nyata.
- Berpartisipasi dalam komunitas Slack untuk percakapan teknis.
- Ikuti kami di X (Twitter) untuk pembaruan terbaru.
P.S. Untuk detail lengkap semua pembaruan, periksa Apidog Changelog!
Hormat kami,
Tim Apidog
Top comments (0)