Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Pada hari Selasa, 8 September 2015, kami merilis Rilis Fitur utama Apigee Edge untuk Private Cloud.
Sejak rilis kuartalan Edge untuk Private Cloud sebelumnya (4.15.04.00), rilis berikut telah terjadi dan disertakan dalam rilis kuartalan ini:
Versi Edge mana saja yang dapat Anda upgrade ke 4.15.07.00
Bergantung pada versi Edge saat ini, Anda dapat:
- Langsung upgrade ke 4.15.07.00
- Upgrade secara bertahap, artinya Anda harus mengupgrade dari versi Edge saat ini ke versi Edge lainnya, lalu mengupgrade ke versi 4.15.07.00.
Untuk mengetahui informasi selengkapnya, lihat versi Edge untuk Private Cloud mana yang dapat diupgrade ke 4.15.07.00.
Sebelum mengupgrade dari versi 4.15.01.x atau dari versi sebelumnya
- Periksa versi Cassandra SSTable:
- Ubah direktori ke /<install-root>/apigee4/data/cassandra/data.
- Jalankan perintah find,
> find . -name *-ic-*
Hasilnya akan menampilkan kumpulan file .db jika Anda menjalankan Cassandra 1.2 SSTable. - Jalankan perintah find ini:
> find . -name *-hf-*
Hasilnya harus kosong, yang berarti tidak ada file .db yang memiliki format hf. Jika tidak melihat file dalam format hf, berarti Anda sudah selesai dan dapat mengupgrade ke 4.15.07.00.
Format hf adalah untuk Cassandra 1.0 SSTables. Jika memiliki file *.db dalam format hf, Anda harus mengupgrade SSTable seperti yang dijelaskan dalam prosedur selanjutnya.
- Jika Anda menemukan file *.db dalam format hf, upgrade SSTable dengan menjalankan perintah berikut pada setiap node Cassandra hingga Anda mengupgrade semua node Cassandra:
> /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradestables -a - Ulangi Langkah 1 untuk memeriksa apakah semua file *.db menggunakan format ic untuk versi Cassandra 1.2.
- Ulangi Langkah 1 hingga 3 pada setiap node Cassandra di penginstalan Edge.
- Upgrade ke Edge 4.15.07.00.
- Setelah upgrade 4.15.07.00, periksa file *.db untuk memastikan semuanya telah diupgrade
ke gaya C* 2.0 stabil:
> cd /<install-root>/apigee4/data/cassandra/data
> cari . -name *-jb-*
Perintah ini akan menampilkan kumpulan file .db jika Anda menjalankan Cassandra 2.0.
Fitur dan peningkatan baru
Berikut adalah sejumlah fitur dan peningkatan baru dalam rilis ini.
Penginstalan dan upgrade
Upgrade dan uninstal komponen selektif
Skrip apigee-upgrade.sh dan apigee-uninstall.sh sekarang memungkinkan Anda memilih komponen Edge untuk diupgrade atau di-uninstal. Sebelumnya, tindakan ini telah mengupgrade atau meng-uninstal semua komponen pada node. (OPDK-1377, OPDK-1175)
Upgrade rollback
Jika apigee-upgrade.sh gagal selama upgrade, Anda kini dapat menggunakan skrip apigee-rollback.sh untuk melakukan roll back upgrade. Setelah memperbaiki masalah upgrade, Anda dapat mencoba mengupgrade kembali. (OPDK-1275)
Opsi skrip penginstal yang dipersingkat
Skrip instal tidak lagi menggunakan opsi yang panjang, seperti --help. Sekarang elemen tersebut hanya mengambil opsi satu huruf, seperti -h. (OPDK-1356)
Penginstalan SmartDocs
Saat menginstal SmartDocs dengan skrip setup-smartdocs.sh, Anda akan diminta untuk memasukkan organisasi, lingkungan, dan host virtual, yang memastikan bahwa SmartDocs diinstal di lokasi yang diharapkan. Sebelumnya, nilai tersebut merupakan hard code dalam skrip. (OPDK-1310)
Menjalankan update-cass-pwd-in-config.sh tanpa perintah
Skrip update-cass-pwd-in-config.sh dapat berjalan tanpa perintah jika Anda menetapkan variabel lingkungan ENABLE_CASS_AUTH, CASS_USERNAME, dan CASS_PASSWORD. (OPDK-1309)
Platform Edge
Berikut adalah fitur platform Edge baru yang disertakan dalam rilis ini.
OpenJDK 1.7 didukung oleh Edge Private Cloud
Rilis Edge ini mendukung Oracle JDK 1.7 dan OpenJDK 7, dan menghapus dukungan untuk JDK 1.6. (OPDK-1187)
Dukungan OS
Apigee Edge untuk Private Cloud telah memperluas dukungan sistem operasinya hingga mencakup Red Hat Enterprise Linux 6.6 & 7.0 (64-bit), CentOS 6.5, 6.6, & 7.0 (64-bit), dan Oracle Linux 6.5.
Cassandra 2.0.15 termasuk dalam OPDK 15.07
Rilis ini menginstal Cassandra 2.0.15. Jika Anda melakukan upgrade untuk rilis sebelumnya, versi Cassandra Anda akan diupdate. (OPDK-1197)
Dukungan SHA2 untuk hashing token OAuth
Untuk melindungi token OAuth dengan lebih baik jika terjadi pelanggaran keamanan database, Edge mendukung algoritma SHA2 untuk melakukan hashing token OAuth (selain SHA1). Dengan properti tingkat organisasi yang baru, Anda dapat mengaktifkan dan mengonfigurasi hashing untuk token baru serta mempertahankan hashing lama pada token apa pun yang ada sebelum fitur baru ini. Sebelumnya di Edge untuk Private Cloud, properti yang disebut hash.oauth.tokens.enabled di file keymanagement.properites (di server pengelolaan dan pemroses pesan Anda) mengaktifkan hashing SHA1 token OAuth otomatis. Properti ini sekarang tidak digunakan lagi.
Jika sebelumnya Anda menggunakan properti hash.oauth.tokens.enabled untuk mengaktifkan hashing SHA1, skrip upgrade untuk rilis ini akan otomatis menghasilkan properti tingkat organisasi baru untuk Anda. Untuk memverifikasi setelah upgrade, lakukan GET sebagai administrator sistem dengan API ini: https://{host}:{port}/v1/o/{your_org}.
- Untuk mengetahui informasi tentang cara mengaktifkan hashing token di organisasi Anda dengan properti baru, lihat "Hashing Tokens in the database" dalam topik Meminta token akses.
- Untuk mengetahui informasi tentang hashing massal token yang sudah ada, lihat Panduan Operasi Edge untuk Private Cloud. (APIRT-1389)
Struktur direktori datar untuk file log
Anda dapat mengonfigurasi Edge untuk menyimpan file log dalam struktur direktori datar dengan menetapkan properti enable.flat.directory.structure
baru ke benar (true) dalam file message-logging.properties. Untuk mengetahui informasi selengkapnya, lihat kebijakan Logging Pesan.
(APIRT-1394)
Performa cache lingkungan
Untuk pengelolaan dan pemanfaatan cache dalam memori yang lebih baik, setelan "Elemen Maksimum dalam Memori" pada resource cache lingkungan sudah tidak digunakan lagi. Total elemen yang ada di semua resource cache (termasuk cache default) bergantung pada total memori yang dialokasikan ke cache. Secara default, total memori yang dialokasikan untuk caching dalam memori pada prosesor pesan tertentu adalah 40% dari total memori yang tersedia, ditentukan oleh setelan properti cache di file cache.properties pemroses pesan Anda. Elemen akan dikeluarkan dari cache dalam memori hanya jika memori cache tidak cukup atau masa berlaku elemen habis.
Untuk kembali ke perilaku lama penggunaan properti "Elemen Maksimum di Memori" untuk
pengelolaan cache, tetapkan properti overrideMaxElementsInCacheResource=false
dalam
file cache.properties. (APIRT-1140)
Layanan API
Berikut adalah fitur Layanan API baru yang disertakan dalam rilis ini.
Proxy Editor baru sebagai default
Editor proxy API baru diaktifkan secara default di UI pengelolaan. Editor baru menyertakan banyak peningkatan kegunaan, termasuk tampilan alur bersyarat dan endpoint yang lebih komprehensif di halaman Ringkasan, semua konfigurasi di halaman Pengembangan, penambahan alur bersyarat, endpoint, dan kebijakan yang lebih intuitif, tampilan XML yang lebih lengkap daripada cuplikan kecil, penelusuran yang meng-crawl nama file dan teks, dan lainnya. (MGMT-2.279)
Kebijakan Hapus OAuth v2.0 yang baru
Kebijakan "Hapus Info OAuth v2.0" yang baru memungkinkan Anda menghapus token akses dan kode otorisasi OAuth v2. Kebijakan ini menggantikan fungsi yang sebelumnya disediakan oleh API pengelolaan. Untuk mengetahui informasi selengkapnya, lihat Menghapus kebijakan Info OAuthV2. (MGMT-2.257)
Kebijakan Hapus OAuth v1.0 yang baru
Kebijakan "Hapus Info OAuth v1.0" yang baru memungkinkan Anda menghapus token permintaan OAuth v1.0, token akses, dan kode pemverifikasi. Kebijakan ini menggantikan fungsi yang sebelumnya disediakan oleh API pengelolaan. Untuk mengetahui informasi selengkapnya, lihat Menghapus kebijakan Info OAuth V1. (APIRT-1351)
Kebijakan Kontrol Akses
Kebijakan Kontrol Akses telah ditingkatkan untuk memungkinkan evaluasi alamat IP yang lebih terperinci untuk pemberian izin dan daftar yang ditolak saat alamat IP terdapat dalam header HTTP X-FORWARDED-FOR
.
Dengan mengaktifkan beberapa pemeriksaan alamat IP di header (hubungi Dukungan untuk menetapkan feature.enableMultipleXForwardCheckForACL), elemen <ValidateBasedOn>
baru dalam kebijakan memungkinkan Anda memeriksa IP pertama, IP terakhir, atau semua IP di header. Untuk mengetahui informasi selengkapnya, lihat kebijakan Kontrol Akses.
Entity baru dalam kebijakan Access Entity
Kebijakan Access Entity memberikan akses ke entity baru berikut: Consumerkey-scopes, authorizationcode, requesttoken, dan verifier. Untuk mengetahui informasi selengkapnya, lihat kebijakan Akses Entitas.
Kebijakan Kolektor Statistik: konversi otomatis nama statistik menjadi huruf kecil
Saat membuat kumpulan analisis kustom di editor proxy API (Halaman pengembangan > Alat > Pengumpulan Analytics Kustom), "Nama" variabel kolektor (statistik) harus huruf kecil. Jika Anda memasukkan nama dengan huruf besar, alat tersebut akan otomatis mengubah nama Statistik menjadi huruf kecil pada kebijakan Kolektor Statistik. (MGMT-740)
Penghapusan Trace Klasik di editor proxy API
Versi terbaru fungsi Trace di editor proxy API telah dipindahkan dari beta ke ketersediaan umum. Akses ke "rekaman aktivitas klasik" dengan link "Akses rekaman aktivitas versi klasik" tidak lagi tersedia.
Akses komunitas Apigee dari menu Bantuan UI pengelolaan
Anda dapat mengakses Komunitas Apigee dari menu Bantuan UI pengelolaan.
Pesan Error di UI pengelolaan
Berikut adalah peningkatan kualitas pesan error di UI pengelolaan:
- UI pengelolaan yang digunakan untuk mengelompokkan dan menampilkan semua pesan error di UI untuk seluruh sesi login, kecuali jika Anda menutupnya. Dengan pembaruan ini, pesan error akan otomatis dihapus saat Anda keluar dari halaman tempat pesan error tersebut terjadi. (MGMT-2.254)
- UI pengelolaan tidak lagi menyembunyikan pesan error duplikat. (MGMT-2.242)
Peningkatan performa dan error UI
Penyempurnaan umum dilakukan pada berbagai area UI pengelolaan, termasuk performa tampilan halaman dan pembersihan pesan error.
Hyperlink peran pada halaman Pengguna Organisasi di UI pengelolaan
Di halaman Organization Users di UI pengelolaan (Admin > Organization Users), nama peran kini sudah dijadikan hyperlink, sehingga Anda dapat membuka halaman peran dengan cepat. (MGMT-1.055)
Variabel target baru dalam alur pesan
Variabel baru dalam alur pesan memberikan informasi URL yang lebih lengkap untuk endpoint target dan server target:
-
TargetEndpoint:
request.url
menggantikantarget.basepath.with.query
. -
TargetServer:
loadbalancing.targetserver
menggantikantargetserver.name
. Selain itu,target.basepath
hanya diisi saat elemen<Path>
digunakan dalam elemen<LoadBalancer>
HTTPTargetConnection dari TargetEndpoint.
Dukungan Server Name Indication (SNI)
Edge mendukung penggunaan Indikasi Nama Server ke arah selatan (dari pemroses pesan ke endpoint target). Jika Anda ingin menggunakan SNI, hubungi Dukungan Apigee.
Java 1.7 wajib diisi.
Dengan SNI, yang merupakan ekstensi TLS/SSL, beberapa target HTTPS dapat disalurkan dari alamat IP dan port yang sama tanpa mengharuskan semua target tersebut menggunakan sertifikat yang sama.
Tidak memerlukan konfigurasi khusus Edge. Jika lingkungan Anda dikonfigurasi untuk SNI arah selatan (Edge cloud secara default), Edge akan mendukungnya.
Edge secara otomatis mengekstrak nama host dari URL permintaan dan menambahkannya ke permintaan handshake SSL. Misalnya, jika host target adalah https://example.com/request/path, Edge akan menambahkan ekstensi server_name seperti yang ditunjukkan di bawah ini:
Untuk informasi selengkapnya tentang SNI, lihat http://en.wikipedia.org/wiki/Server_Name_Indication.
"Algoritma Tanda Tangan" dalam detail Sertifikat SSL
Kolom "Signature Algorithm" telah ditambahkan ke detail sertifikat SSL, yang dapat dilihat di UI pengelolaan (Admin > SSL Certificates) dan API pengelolaan (Dapatkan Detail Sertifikat dari Keystore atau Truststore). Kolom ini menampilkan "sha1WithRSAEncryption" atau "sha256WithRSAEncryption", bergantung pada jenis algoritma hashing yang digunakan untuk membuat sertifikat.
Menampilkan sertifikat SSL yang hampir habis masa berlakunya
Halaman Sertifikat SSL di UI pengelolaan (Admin > Sertifikat SSL) menunjukkan kapan masa berlaku sertifikat SSL berakhir dalam 10, 15, 30, atau 90 hari, bergantung pada pilihan Anda di kolom drop-down masa berlaku yang baru.
Konfigurasi error perlindungan terhadap ancaman
Secara default, Edge akan menampilkan kode status Error Server Internal HTTP 500 dan error ExecutionFailed
jika pesan tidak melewati kebijakan JSON atau XML Threat Protection. Anda dapat mengubah perilaku error tersebut dengan properti tingkat organisasi baru. Jika menetapkan properti org
features.isPolicyHttpStatusEnabled
ke benar (true), perilaku
berikut akan terjadi:
- Permintaan: Dengan kebijakan perlindungan ancaman yang disertakan pada alur permintaan apa pun, pesan yang tidak valid akan menampilkan kode status 400, beserta pesan error kebijakan yang sesuai.
- Respons: Dengan kebijakan perlindungan ancaman yang disertakan pada alur respons apa pun, pesan yang tidak valid tetap menampilkan kode status 500, dan salah satu pesan error kebijakan yang sesuai akan ditampilkan (bukan hanya ExecutionFailed).
Pelanggan cloud harus menghubungi Dukungan Apigee untuk menetapkan properti organisasi. Fitur ini akan tersedia untuk pelanggan Edge Private Cloud pada rilis kuartalan Private Cloud berikutnya.
Skema yang diperbarui untuk endpoint, proxy, dan entitas lainnya
Skema referensi telah diperbarui untuk entitas non-kebijakan seperti TargetEndpoint, ProxyEndpoint, APIProxy, dan banyak lagi. Lihat https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)
Layanan Developer
Berikut adalah fitur baru Layanan Developer yang disertakan dalam rilis ini.
Ketersediaan umum SmartDocs
SmartDocs dirilis dari versi beta ke ketersediaan umum. Update dan fitur baru meliputi:
- Dukungan untuk Swagger 2.0, termasuk impor menurut file atau URL, termasuk dukungan untuk objek keamanan bernama khusus.
- Peningkatan desain visual dalam template yang membuat SmartDocs.
- Peningkatan kegunaan dan alur kerja di Portal Developer, tersedia melalui menu Content > SmartDocs di Drupal.
- Apa yang sebelumnya dikenal sebagai autentikasi "Token Kustom" kini disebut "Kunci API".
- Objek "keamanan" autentikasi yang ditentukan di tingkat revisi.
- Konfigurasi autentikasi klien di level template. Revisi baru tidak lagi mereset kredensial klien SmartDocs yang telah dikonfigurasi sebelumnya.
Untuk deskripsi fitur lainnya, lihat postingan blog ini.
Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
Nama aplikasi developer yang ditampilkan di UI pengelolaan
Aplikasi developer di Edge memiliki Nama internal yang tidak berubah dan Nama Tampilan yang dapat Anda ubah. Pada halaman Aplikasi Developer di UI pengelolaan (Publikasikan > Aplikasi Developer > nama aplikasi), "Nama" internal aplikasi akan ditampilkan bersama dengan "Nama Tampilan", sehingga memudahkan identifikasi aplikasi secara visual berdasarkan nama internalnya untuk pemecahan masalah dan pengelolaan API.
Layanan Analytics
Berikut adalah fitur Layanan Analytics baru yang disertakan dalam rilis ini.
Batas waktu data yang dipertahankan
Saat membuat laporan analisis dengan UI atau API pengelolaan, data yang lebih lama dari enam bulan dari tanggal saat ini tidak dapat diakses secara default. Jika Anda ingin mengakses data yang lebih lama dari enam bulan, hubungi Dukungan Apigee.
Versi klasik laporan kustom yang dihapus dari UI pengelolaan
Versi klasik opsional dari laporan analisis kustom tidak lagi tersedia di UI pengelolaan.
Performa widget Engagement Developer
Widget funnel di dasbor analisis utama (bagian Engagement Developer) telah ditingkatkan untuk memberikan performa yang lebih baik.
Monetisasi
Berikut adalah fitur monetisasi baru yang disertakan dalam rilis ini.
Notifikasi email paket tarif
Jenis notifikasi email Paket Tarif baru memungkinkan Anda memberi tahu developer saat mereka mencapai batas transaksi atau dolar tertentu dalam paket tarif paket atau volume yang telah mereka beli. Untuk mengetahui detailnya, lihat Menyiapkan notifikasi menggunakan template notifikasi.
Sinkronisasi periode Biaya Berulang dan Dasar Agregasi
Dalam paket tarif, mungkin ada dua jangka waktu berbeda yang berlaku:
- Periode Biaya Berulang, yang dikonfigurasi pada tab Biaya pada paket tarif, yang menentukan kapan developer ditagih biaya berulang.
- Periode Dasar Agregasi, yang ditentukan pada kartu tarif untuk paket Volume Banded atau Paket, yang menentukan kapan penggunaan paket direset untuk developer.
Kedua periode tersebut sekarang disinkronkan. Jika biaya berulang bukan nol dan kartu tarif Volume Banded atau Paket ada dalam paket tarif, periode biaya berulang akan digunakan untuk keduanya. Misalnya, jika ada biaya berulang bulanan, paket kartu tarif juga akan direset setiap bulan (secara default pada awal bulan).
Jika tidak ada biaya berulang, paket akan direset berdasarkan Dasar Agregasi yang ditentukan pada kartu tarif. Misalnya, jika developer mulai menggunakan kartu tarif pada tanggal 19 setiap bulan, dan Dasar Agregasi adalah setiap bulan, penggunaan paket akan direset satu bulan setelah tanggal 19.
Basis Agregasi tidak digunakan lagi dan akan dihapus dari monetisasi dalam rilis mendatang. Untuk mengetahui informasi selengkapnya, lihat Menentukan detail paket kartu tarif.
Atribut Khusus dalam ringkasan laporan pendapatan
Kebijakan pencatatan transaksi memungkinkan Anda secara opsional mengambil data atribut khusus dari transaksi, dan kini Anda dapat menyertakan atribut transaksi khusus tersebut dalam laporan pendapatan ringkasan. Dengan menambahkan properti MINT.SUMMARY_CUSTOM_ATTRIBUTES ke organisasi, Anda dapat menunjukkan atribut khusus yang ditambahkan ke tabel database untuk digunakan dalam laporan.
Apigee Edge untuk pelanggan Private Cloud dapat menyetel flag dengan panggilan API dan kredensial Administrator Sistem berikut.
curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \ "<Organization type="trial" name="MyOrganization"> <Properties> <Property name="features.isMonetizationEnabled">true</Property> <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">["my_attribute_1","my_attribute_2"]</Property> <Property name="features.topLevelDevelopersAreCompanies">false</Property> </Properties> </Organization>"
Perhatikan bahwa array atribut khusus dalam panggilan API dienkode ke URL.
Proses upgrade SmartDocs
Jika Anda telah menggunakan SmartDocs selama periode beta, fitur dan kemampuan baru dalam versi ketersediaan umum mengharuskan Anda mengupgrade SmartDocs dalam portal developer.
Setiap halaman SmartDocs yang telah dipublikasikan di portal developer Anda akan tetap berfungsi, tetapi Anda harus mengikuti proses pembaruan sebelum mengedit atau memublikasikan perubahan apa pun ke halaman yang sudah ada atau baru.
Perlu diingat bahwa meskipun Anda dapat merender dan memublikasikan SmartDocs di dalam portal developer, SmartDocs dibuat dari model API yang berada dalam Layanan Pengelolaan Edge API Apigee. Perubahan apa pun yang Anda buat pada model API di Edge akan sama di semua lingkungan Pantheon (serupa dengan cara developer berada di seluruh lingkungan Pantheon).
Untuk mengupgrade dari SmartDocs beta ke ketersediaan umum
- Update dan uji rilis 15.05.27 di lingkungan dev atau test Anda di Pantheon.
- Buat model baru untuk menggantikan model API yang ada yang telah Anda gunakan.
- Jika Anda telah mengimpor dokumen Swagger atau WADL, impor lagi ke revisi baru.
- Jika Anda telah mempertahankan model API melalui modul SmartDocs, ekspor sebagai JSON SmartDocs dan impor ke model baru menggunakan lampiran file.
- Tetapkan properti keamanan revisi model Anda. Di halaman Konten >
SmartDocs > model, pilih Setelan Keamanan.
- Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Content > SmartDocs) dengan mengklik Settings di kolom Operations.
- Update template kustom apa pun agar menggunakan aset CSS dan JS v6, lalu buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk mengetahui informasi tentang cara mengupdate template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
- Render ulang dan publikasikan revisi model Anda.
- Setelah memvalidasi dokumentasi baru, update portal production Anda ke rilis 15.05.27.
Jika Anda adalah pelanggan Edge Enterprise dan memiliki pertanyaan atau masalah terkait proses upgrade, kirim email ke marsh@apigee.com dan cnovak@apigee.com. Atau, gunakan Komunitas Apigee untuk mendapatkan respons terbaik.
Perubahan dan peningkatan fitur mendatang
Bagian ini mempratinjau perubahan dan peningkatan fitur mendatang yang diperkirakan:
Perubahan pada perilaku kebijakan Cache Respons
Segera hadir dalam rilis mendatang (akan ditentukan), perilaku default elemen <ExcludeErrorResponse> kebijakan Cache Respons akan berubah.
Perilaku saat ini: Elemen <ExcludeErrorResponse> dalam kebijakan cache respons bernilai false secara default. Artinya, secara default, respons dengan kode status HTTP apa pun yang memungkinkan (termasuk 3xx) akan di-cache oleh kebijakan Response Cache.
Perilaku mendatang: Elemen <ExcludeErrorResponse> dalam kebijakan Cache Respons akan ditetapkan secara default ke benar (true). Ini berarti bahwa, secara default, hanya respons dengan kode Status HTTP 200 hingga 205 yang akan di-cache. Untuk mengganti perilaku ini dan meng-cache respons untuk semua kode status, Anda harus menyetel elemen <ExcludeErrorResponse> ke true secara eksplisit.
Solusi saat ini: Untuk Private Cloud 4.15.07.00 dan rilis yang lebih lama, jika ingin meng-cache respons hanya dengan kode Status 200 hingga 205, Anda harus menetapkan elemen <ExcludeErrorResponse> secara eksplisit ke true.
Bug telah diperbaiki
Bug berikut telah diperbaiki dalam rilis ini.
ID Masalah | Deskripsi |
---|---|
OPDK-1521 | Masalah enkripsi sandi |
OPDK-1201 | Tidak dapat memulihkan data UI |
OPDK-1112 | Kebijakan sandi LDAP khusus tidak diterapkan ke pengguna admin Apigee |
OPDK-1097 | Pengecualian ruang kunci selama upgrade OPDK |
OPDK-1068 | Dapat mengubah sandi admin jika gagal selama penginstalan |
OPDK-1053 | Zookeeper berjalan sebagai root |
OPDK-967 | Saat menyetel OpenLDAP agar otomatis menggunakan set-autostart.sh, all-status.sh akan melaporkannya sebagai dead |
OPDK-905 | Smartdocs prod sudah terdaftar di grup axgroup001 |
OPDK-899 | Error selama orientasi |
OPDK-847 | Pengguna yang dibuat selama orientasi tidak menerima email untuk mereset sandi |
OPDK-817 | Skrip init.d menampilkan error |
OPDK-815 | Skrip ax-purge.sh memerlukan penghapusan permanen tabel sampling |
MGMT-2246 | Halaman Buat laporan kustom tidak ditampilkan dengan benar di UI pengelolaan |
MGMT-2235 | Untuk sertifikat SSL yang masa berlakunya habis, waktu relatif Masa berlaku habis dapat dibulatkan Untuk sertifikat SSL yang akan habis masa berlakunya, waktu relatif tanggal habis masa berlaku selalu ditampilkan dalam hari, bukan dibulatkan ke bulan, saat masa berlaku sertifikat berakhir dalam 90 hari atau kurang. |
MGMT-2193 | Indikator lingkaran berputar pemuatan saat mengedit API |
MGMT-2173 | UI Trace tidak mengizinkan URL resmi UI Trace kini memungkinkan Anda mengirim permintaan dengan nilai parameter kueri yang berisi parameter kueri bertingkat. |
MGMT-2162 | Masalah kompilasi JavaScript |
MGMT-2124 | Izin peran pelanggan direset saat menyimpan izin di UI |
MGMT-2114 | IP Syslog yang tidak valid dalam kebijakan MessageLogging akan menampilkan error yang benar selama deployment |
MGMT-2067 | Pelacakan: Jika revisi proxy API di-deploy di 2 lingkungan, memilih revisi dan lingkungan tidak berfungsi dengan benar |
MGMT-2061 | Lupa Sandi hanya boleh mengirim email ke pengguna terdaftar Link "Lupa sandi?" di halaman login UI pengelolaan hanya mengirim email ke pengguna Apigee yang terdaftar. |
MGMT-2048 | Pengguna dengan peran khusus yang membatasi izin deployment ke satu lingkungan dapat di-deploy di lingkungan lain |
MGMT-2041 | Hapus elemen FaultRules dari template lampiran default Elemen FaultRules, yang tidak digunakan dalam kebijakan atau langkah proxy API, tidak lagi otomatis ditambahkan saat Anda membuat proxy API atau menambahkan kebijakan. |
MGMT-2034 | Pengambilan WSDL menampilkan kegagalan: "Pengambilan Error WSDL: Error memproses WSDL". |
MGMT-1986 | Error UI saat menambahkan developer |
MGMT-1983 | Mendapatkan API kode otorisasi OAuth 2.0 menampilkan status yang salah |
MGMT-1962 | Terjadi error saat login ke UI pengelolaan dengan sandi kuat Login ke UI dengan karakter khusus tertentu, seperti tanda persen, tidak lagi gagal. |
MGMT-1947 | Peran yang tidak intuitif dalam UI pengelolaan Jika pengguna tidak memiliki izin untuk membuat atau mengedit Kebijakan Pencatatan Transaksi, tombol UI untuk membuat dan mengedit Kebijakan Pencatatan Transaksi kini dinonaktifkan. |
MGMT-1899 | Jalur resource dihapus setelah menyimpan setelan produk Saat mengedit produk API, jalur resource produk dapat terhapus jika pengguna mengklik dua kali tombol Simpan. Masalah ini sudah teratasi. |
MGMT-1894 | Halaman Aplikasi Developer tidak pernah selesai memuat kolom developer |
MGMT-1882 | Proxy API baru dari WSDL hanya menampilkan detail parameter terakhir |
MGMT-1878 | Jika beberapa revisi di-deploy ke suatu lingkungan, Trace hanya akan menampilkan salah satunya |
MGMT-1872 | Tidak dapat mendownload laporan kustom |
MGMT-1863 | Log Node.js tidak dapat dilihat di UI pengelolaan |
MGMT-1843 | Proxy API Tidak Dapat Dibuka |
MGMT-1833 | pengguna sysadmin tidak memiliki opsi untuk mengubah sandi di UI untuk OPDK |
MGMT-1825 | Bug pembuatan skrip lintas situs (XSS) |
MGMT-1824 | Mengambil error WSDL saat mengimpor file WSDL dengan ekstensi .xml |
MGMT-1812 | Tambahkan validasi TargetEndpoint selama impor Serupa dengan ProxyEndpoint, TargetEndpoint akan divalidasi untuk skema dan ekspresi yang tepat yang digunakan dalam kondisi selama impor proxy API. |
MGMT-1804 | Dalam beberapa kasus, Node.js API mengirimkan JSON yang tidak valid Layar log Node.js yang digunakan untuk menampilkan log tidak berformat jika data JSON memiliki karakter yang tidak valid. Masalah ini telah diperbaiki dalam rilis ini dan UI kini menampilkan log node.js yang diformat dengan baik. |
MGMT-1802 | password reset url #118 Jika UI pengelolaan berada di balik server penghentian SSL, UI pengelolaan kini akan membuat email reset sandi dengan benar yang berisi link ke URL https, bukan URL http. |
MGMT-1799 | Permintaan pengiriman kerentanan keamanan UI di Trace |
MGMT-1777 | Tidak dapat menambahkan pengguna dengan alamat email yang memiliki TLD .acn |
MGMT-1735 | Branding "Error saat mengambil W" Segera setelah itu, kami telah menghapus dukungan branding kustom di Edge OPDK. Meskipun kami menyadari bahwa hal ini dapat mengecewakan beberapa pelanggan yang menggunakannya, ini bukanlah fitur yang secara langsung meningkatkan kemampuan Edge seputar pengelolaan API. |
MGMT-1569 | Masalah melampirkan proxy API ke produk API yang ada Memperbaiki penambahan Proxy API ke produk API di UI Pengelolaan saat Proxy API memiliki resource untuk jalur "/". |
MGMT-1563 | Tombol kirim di Trace tetap dinonaktifkan jika mengalami error |
MGMT-1362 | Email Lupa Sandi tidak berfungsi jika Alamat email berisi
'_' Memperbaiki masalah reset sandi di OPDK dengan alamat email yang memiliki garis bawah. |
MGMT-1345 | Impor WSDL dengan beberapa namespace menghasilkan Langkah Build SOAP yang salah |
MGMT-1193 | Menyimpan proxy karena revisi baru tiba-tiba mengubah aturan rute |
MGMT-1061 | SmartDocs: Deskripsi parameter jenis tubuh dalam definisi Swagger tidak ditampilkan di UI dokumen |
MGMT-800 | Membuat resource dengan nama 'default' menyebabkan UI tidak berfungsi |
MGMT-787 | Masalah kegunaan pemberitahuan UI Di UI pengelolaan, saat Anda mengklik + API Proxy dan dialog New API Proxy muncul, Anda dapat menekan Esc untuk menutup dialog. |
MGMT-619 | Mengaktifkan penomoran halaman di halaman UI proxy API |
MGMT-602 | Tampilan Pengembangan Proxy API: Menambahkan kebijakan Cache Respons jika endpoint tidak memiliki PreFlow/PostFlow yang menyebabkan error |
MGMT-460 | Penggantian nama kebijakan akan menghasilkan perilaku gangguan, kebijakan duplikat yang tidak dapat dihapus |
DEVRT-1644 | Pencarian notifikasi menurut nama menyebabkan email yang dikirim salah |
DEVRT-1583 | UI Monetisasi menampilkan badge "Masa Depan" untuk paket tarif saat ini |
DEVRT-1546 | Batas paket tidak berfungsi |
DEVRT-1511 | error mint.resourceDoesNotExist untuk developer yang sudah ada |
CORERT-639 | TCPSysLogSocket harus asinkron |
CORERT-613 | Kegagalan handshake SSL karena "unrecognized_name" |
AXAPP-1728 | Mengabaikan variabel monetisasi di Analytics |
AXAPP-1708 | Analytics API tampaknya menghasilkan angka yang berbeda untuk statistik yang sama, tergantung cara saya menanyakannya |
AXAPP-1707 | Meningkatkan performa analisis pod gratis |
AXAPP-1690 | "Error API tidak valid" pada laporan kustom |
AXAPP-1533 | Peta Geo Analytics menampilkan error Panggilan API Tidak Valid |
AXAPP-1493 | Statistik performa cache salah |
APIRT-1436 | Membuat alat/skrip untuk melakukan hashing pada token yang tidak di-hash |
APIRT-1425 | Atribut continueOnError saat ditetapkan ke "true" tidak berpengaruh pada kebijakan JavaCallout |
APIRT-1346 | OAuth2.0 - Nilai yang di-hash ditampilkan dalam respons token akses jika hash.oauth.tokens.enabled bernilai benar |
APIRT-1206 | target_ip tidak dicatat dalam tabel fakta untuk 503 dan sebagian besar 504 |
APIRT-1170 | File resource tidak ada yang menyebabkan MP gagal memuat lingkungan |
APIRT-1148 | GET dari variabel {message.version} di ResponseFlow, untuk target Node.js yang memunculkan NPE |
APIRT-1054 | Logging Pesan gagal saat mencoba mencatat ke direktori lain selain default |
APIRT-387 | Membuat OrganizationService berjalan dengan rasa 'lainnya' di MP |
APIRT-67 | Kebijakan OAuth GenerateAccessToken tidak menetapkan variabel oauthV2.failed dengan benar |
APIRT-52 | Laporan Kustom: Kode status respons untuk banyak API adalah null |
Masalah umum
Rilis ini memiliki masalah umum berikut.
ID Masalah | Deskripsi |
---|---|
OPDK-1586 |
Portal API BaaS gagal dimulai jika dukungan IPV6 tidak diaktifkan
|
OPDK-1785 |
Menginstal komponen monetisasi di lingkungan terinstal Edge yang telah diupgrade
Solusinya adalah menetapkan versi Monetisasi yang tepat dalam file apigee-env.sh sebelum Anda mencoba menginstal Monetisasi. Untuk mendapatkan versi Monetisasi dalam 4.15.07 (setelah Anda mengupgrade ke Edge 4.15.07), jalankan:
> source /{install-dir}/apigee4/bin/apigee-env.sh > VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`
Secara default, install-dir adalah /opt.
Nilai VER dari atas harus ditetapkan di apigee-env.sh:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
Jika Anda mencoba menginstal Monetisasi tanpa melakukan langkah-langkah di atas, penginstalan akan gagal dan kemungkinan terdapat symlink yang mati dalam direktori berbagi. Anda harus menghapus symlink tersebut:
> rm /install-dir/apigee4/share/monetization
Setelah menghapus symlink, lakukan langkah-langkah di atas untuk menetapkan versi Monetisasi, lalu coba lagi penginstalan Monetisasi.
|
OPDK-1857 |
Versi Python 2.6 hard code di bin/qpid-stat.sh dan
bin/qpid-config.sh Di CentOS dan RedHat 7.0, beberapa skrip di bin/qpid-stat.sh dan bin/qpid-config.sh di-hard code agar menggunakan Python versi 2.6. Solusi untuk masalah ini adalah mengubah baris yang mengekspor PYTHONPATH di qpid-stat.sh dan qpid-config.sh pada direktori apigee4/bin.
Untuk menentukan versi Python di sistem Anda, periksa versi Python di direktori /opt/apigee4/share/apache-qpid/lib. Direktorinya kemungkinan besar adalah python2.7. Selanjutnya, Anda perlu memperbarui setelan PYTHONPATH di qpid-stat.sh dan qpid-config.sh dengan jalur yang benar. Contoh:
|
DEVRT-1574 | Saldo dan penggunaan yang tidak konsisten untuk developer dengan beberapa paket tarif
aktif Dalam monetisasi, jika developer aktif di lebih dari satu paket tarif yang memiliki tagihan panggilan per-API, penggunaan saldo uang terkadang mungkin tidak konsisten. |
APIBAAS-1647 | Setelah login sebagai admin sistem, UI BaaS UI mengeluarkan pesan 'Error get roles' Pesan error ini muncul saat admin sistem pertama kali login ke sistem setelah melakukan upgrade dari versi 4.15.01 ke 4.15.07. Anda dapat mengabaikan pesan ini. |
DEVRT-1834 |
Upgrade monetisasi ke 4.15.07 Skrip apigee-upgrade.sh mencetak pesan berikut di bagian akhir yang meminta Anda untuk menjalankan skrip lain: ************************************** In order to complete the monetization upgrade please run: sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/ 365-create-notification-condition.sh ************************************** Anda dapat mengabaikan pesan ini. Skrip tersebut tidak diperlukan dan tidak dapat dijalankan. |
DEVRT-1951 |
Penginstalan baru monetisasi tidak memiliki konfigurasi notifikasi
Pada penginstalan baru Apigee Edge untuk Private Cloud versi 4.15.07.00, konfigurasi untuk notifikasi monetisasi berikut tidak ada. Ini berkaitan dengan jenis notifikasi pada halaman Admin > Notifications di UI pengelolaan.
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
Untuk mengatasi masalah ini, ikuti langkah-langkah berikut. Anda memerlukan alamat IP instance Cassandra. Untuk menemukannya, lihat
<installation-root>/apigee4/conf/cassandra/cassandra.yaml atau
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
DEVRT-1952 |
Upgrade monetisasi dari 4.14.07.00 tidak memiliki konfigurasi notifikasi
Pada upgrade Apigee Edge untuk Private Cloud dari versi 4.14.07.00 ke 4.15.07.00, konfigurasi untuk notifikasi monetisasi berikut tidak ada, sehingga menyebabkan laporan monetisasi tidak berfungsi.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
Untuk mengatasi masalah ini, ikuti langkah-langkah berikut. Anda memerlukan alamat IP instance Cassandra. Untuk menemukannya, lihat
<installation-root>/apigee4/conf/cassandra/cassandra.yaml atau
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
OPDK-1878 | Tidak dapat menetapkan nama Pod di beberapa penginstalan pusat data Panduan penginstalan Edge menentukan untuk menetapkan nama Pod sebagai "gateway-1" dan "gateway-2" dalam file penginstalan senyap untuk beberapa penginstalan beberapa pusat data. Namun, mengganti nama Pod akan membuat Router dan Pemroses Pesan tidak terdaftar dengan benar dan tidak dapat diakses. Masalah ini juga mencegah skrip setup-org.sh menemukan Prosesor Pesan yang tersedia. Solusinya adalah menetapkan nama Pod, menggunakan properti MP_POD, ke "gateway" di file penginstalan senyap untuk kedua pusat data. |
OPDK-1886 |
Node tidak dapat mengakses alamat IP lokal seperti 192.168.x.y
connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32
Kemudian, mulai ulang node Message Processor:
<install_dir>/apigge4/bin/apigee-service message-processor restart
|
OPDK-1958 | Saat melakukan upgrade, semua node akan memerlukan akses ke port 8080 di Server
Pengelolaan Saat runtime, komponen berikut memerlukan akses ke port 8080 di Server Pengelolaan: Router, Prosesor Pesan, UI, Postgres, dan Qpid. Namun, saat melakukan upgrade, semua node akan memerlukan akses ke port 8080 di Server Pengelolaan, termasuk node Cassandra dan Zookeeper. |
OPDK-1962 | Harus mengonfigurasi ulang SSL untuk Edge API setelah upgrade Jika Anda telah mengonfigurasi Edge API untuk menggunakan SSL sebelum mengupgrade ke 4.15.07.00, Anda harus mengonfigurasi ulang SSL setelah upgrade. Lihat Panduan Operasi Edge untuk mengetahui prosedur mengonfigurasi SSL untuk Edge API. |