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 Pribadi yang dihosting di Google Cloud.
Sejak rilis tiga bulanan Edge for Private Cloud (4.15.04.00), berikut ini rilis telah terjadi dan disertakan dalam rilis tiga bulanan ini:
Anda dapat mengupgrade ke versi Edge mana 4.15.07.00
Bergantung pada versi Edge saat ini, Anda dapat:
- Langsung meng-upgrade ke 4.15.07.00
- Melakukan upgrade secara bertahap, artinya Anda harus melakukan upgrade dari versi saat ini ke versi lain versi Edge, lalu tingkatkan ke 4.15.07.00.
Untuk informasi selengkapnya, lihat Versi Edge untuk Private Cloud mana yang dapat Anda upgrade 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,
> temukan . -name *-ic-*
Hasilnya akan mengembalikan satu set file .db jika Anda menjalankan Cassandra 1.2 SSTable. - Jalankan perintah cari ini:
> temukan . -name *-hf-*
Hasilnya akan kosong, artinya tidak ada file .db dalam format hf. Jika Anda tidak melihat file dalam hf, maka Anda akan selesai dan dapat meng-upgrade ke 4.15.07.00.
Format hf ditujukan untuk Cassandra 1.0 SSTables. Jika memiliki file *.db dalam format hf, Anda harus mengupgrade SSTable seperti yang dijelaskan dalam prosedur berikutnya.
- Jika Anda menemukan file *.db dalam format hf, upgrade SSTable
dengan menjalankan perintah berikut pada setiap node Cassandra hingga Anda mengupgrade semua Cassandra
node:
> {i>/<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost enhancedstables<i} "-a - Ulangi Langkah 1 untuk memeriksa apakah semua file *.db memiliki format ic untuk Cassandra 1.2 .
- Ulangi Langkah 1 sampai 3 pada setiap node Cassandra dalam penginstalan Edge Anda.
- Upgrade ke Edge 4.15.07.00.
- Setelah upgrade 4.15.07.00, periksa file *.db untuk memastikan semuanya telah di-upgrade
ke stabil gaya C* 2.0:
> cd /<install-root>/apigee4/data/cassandra/data
> temukan . -nama *-jb-*
Perintah ini harus mengembalikan serangkaian file .db jika Anda menjalankan Cassandra 2.0.
Fitur dan peningkatan baru
Berikut adalah fitur dan peningkatan baru dalam rilis ini.
Penginstalan dan upgrade
Mengupgrade dan meng-uninstal komponen selektif
Skrip apigee-upgrade.sh dan apigee-uninstall.sh kini memungkinkan Anda memilih komponen Edge untuk meningkatkan atau meng-uninstal. Sebelumnya, ia 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 apigee-rollback.sh skrip untuk me-roll back upgrade. Setelah memperbaiki masalah upgrade, Anda dapat mencoba lagi upgrade. (OPDK-1275)
Opsi skrip penginstal yang dipersingkat
Skrip penginstalan tidak lagi menggunakan opsi panjang, seperti --help. Mereka sekarang hanya menggunakan opsi huruf tunggal, seperti -h. (OPDK-1356)
Penginstalan SmartDocs
Saat menginstal SmartDocs dengan skrip setup-smartdocs.sh, Anda diminta untuk memasukkan organisasi, lingkungan, dan host virtual, yang memastikan bahwa SmartDocs diinstal di lokasi yang diperkirakan. Sebelumnya, nilai-nilai tersebut di-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 menyetel 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 dengan menyertakan 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 mengupgrade untuk rilis sebelumnya, versi Cassandra akan diupdate. (OPDK-1197)
Dukungan SHA2 untuk hashing token OAuth
Untuk melindungi token OAuth dengan lebih baik jika terjadi pelanggaran keamanan database, Edge mendukung SHA2 untuk melakukan hashing token OAuth (selain SHA1). Dengan tingkat organisasi baru Anda dapat mengaktifkan dan mengonfigurasi {i>hashing<i} untuk token baru serta mempertahankan {i>hashing<i} pada token apa pun yang ada sebelum fitur baru ini. Sebelumnya di Edge untuk Private Cloud, bernama hash.oauth.tokens.enabled di file keymanagement.properties (di server pengelolaan dan pemroses pesan) mengaktifkan hashing SHA1 otomatis untuk token OAuth. Ini kini tidak digunakan lagi.
Jika sebelumnya Anda menggunakan properti hash.oauth.tokens.enabled untuk mengaktifkan hashing SHA1, skrip upgrade untuk rilis ini akan otomatis membuat properti tingkat org baru untuk Anda. Kepada verifikasi setelah upgrade, lakukan GET sebagai administrator sistem dengan API ini: https://{host}:{port}/v1/o/{your_org}.
- Untuk informasi tentang cara mengaktifkan hashing token di organisasi dengan properti baru, lihat "Hashing Token dalam database" di bagian Meminta token akses topik.
- Untuk mendapatkan informasi tentang hashing token yang ada secara massal, lihat artikel Edge for Private Cloud Panduan Pengoperasian. (APIRT-1389)
Struktur direktori datar untuk file log
Anda dapat mengonfigurasi Edge untuk menyimpan file log dalam struktur direktori datar dengan menyetel
Properti enable.flat.directory.structure
ke benar (true) di message-logging.properties
. Untuk informasi selengkapnya, lihat kebijakan Logging Pesan.
(APIRT-1394)
Performa cache lingkungan
Untuk pengelolaan dan pemanfaatan cache dalam memori yang lebih baik, "Elemen Maksimum dalam Memori" setelan pada resource cache lingkungan tidak digunakan lagi. Total elemen yang ada di semua sumber daya cache (termasuk cache default) tergantung pada total memori yang dialokasikan di cache oleh pengguna. Secara default, total memori yang dialokasikan untuk caching dalam memori pada pemroses pesan tertentu adalah 40% dari total memori yang tersedia, ditentukan oleh setelan properti cache dalam pesan Anda prosesor cache.properties. Elemen akan dikeluarkan dari cache dalam memori hanya jika ada memori cache tidak mencukupi atau elemen kedaluwarsa.
Untuk kembali ke perilaku lama penggunaan "Elemen Maksimum di Memori" properti untuk
pengelolaan cache, tetapkan properti overrideMaxElementsInCacheResource=false
di
cache.properties. (APIRT-1140)
Layanan API
Berikut adalah fitur Layanan API baru yang disertakan dalam rilis ini.
Editor Proxy baru sebagai default
Editor proxy API baru diaktifkan secara default di UI pengelolaan. Editor baru ini menyertakan banyak peningkatan kegunaan, termasuk pandangan yang lebih komprehensif tentang alur bersyarat dan di halaman Overview, semua konfigurasi pada halaman Develop, dan lebih intuitif, menambahkan alur bersyarat, endpoint, dan kebijakan, tampilan XML yang lebih lengkap daripada cuplikan kecil, penelusuran yang menelusuri nama file dan teks, dan banyak lagi. (MGMT-2279)
Kebijakan Hapus Info OAuth v2.0 yang baru
"Hapus Info OAuth v2.0" yang baru kebijakan memungkinkan Anda menghapus token dan otorisasi akses OAuth v2 kode program. Kebijakan ini akan menggantikan fungsi yang sebelumnya disediakan oleh API pengelolaan. Untuk selengkapnya informasi tambahan, lihat Menghapus Kebijakan Info OAuthV2 Anda. (MGMT-2257)
Kebijakan baru untuk Menghapus Info OAuth v1.0
"Hapus Info OAuth v1.0" yang baru memungkinkan Anda menghapus token permintaan OAuth v1.0, akses token, dan kode pemverifikasi. Kebijakan ini menggantikan fungsi yang sebelumnya disediakan oleh Google Cloud Management API. Untuk 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 membuat daftar yang diizinkan dan ditolak
saat alamat IP tercantum dalam
Header HTTP X-FORWARDED-FOR
.
Dengan beberapa pemeriksaan alamat IP yang diaktifkan pada header (hubungi Dukungan untuk menyetel
feature.enableMultipleXForwardCheckForACL), sebuah
elemen <ValidateBasedOn>
baru dalam kebijakan memungkinkan Anda memeriksa
IP pertama, IP terakhir, atau semua IP di {i>header<i}. Untuk informasi selengkapnya, lihat kebijakan Kontrol Akses.
Entitas baru dalam kebijakan Entitas Akses
Kebijakan Entitas Akses memberikan akses ke entitas baru berikut: {i>consumerkey-scopes<i}, otorisasi kode, {i>requesttoken<i}, dan pemverifikasi. Untuk mengetahui informasi selengkapnya, lihat kebijakan Entitas Akses.
Kebijakan Statistics Collector: konversi otomatis nama statistik menjadi huruf kecil
Saat membuat kumpulan analisis kustom di editor proxy API (Halaman pengembangan > Alat > Koleksi Analytics Kustom), "Nama" variabel kolektor (statistik) harus huruf kecil. Jika Anda memasukkan nama dengan huruf besar, alat bantu akan secara otomatis mengubah nama Statistik menjadi huruf kecil dalam kebijakan Statistics Collector. (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 opsi "Akses versi klasik trace" link 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 pesan error dalam UI pengelolaan:
- UI pengelolaan yang digunakan untuk mengelompokkan dan menampilkan semua pesan error di UI untuk seluruh sesi login kecuali Anda menutupnya. Dengan pembaruan ini, pesan error akan dihapus secara otomatis saat Anda meninggalkan laman tempat hal itu terjadi. (MGMT-2254)
- UI pengelolaan tidak lagi menyembunyikan pesan error duplikat. (MGMT-2242)
Peningkatan performa UI dan error
Peningkatan umum dilakukan pada berbagai area UI pengelolaan, termasuk tampilan halaman kinerja dan pembersihan pesan {i>error<i}.
Hyperlink peran pada halaman Pengguna Organisasi di UI pengelolaan
Di halaman Pengguna Organisasi di UI pengelolaan (Admin > Pengguna Organisasi), peran nama kini memiliki hyperlink, yang memungkinkan Anda membuka halaman peran dengan cepat. (MGMT-1055)
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 TargetEndpoint Elemen<LoadBalancer>
HTTPTargetConnection.
Dukungan Server Name Indication (SNI)
Edge mendukung penggunaan Server Name Indication ke arah selatan (dari prosesor pesan ke target endpoint). Jika Anda ingin menggunakan SNI, hubungi Dukungan Apigee.
Java 1.7 wajib diisi.
Dengan SNI, yang merupakan perluasan dari TLS/SSL, beberapa target HTTPS dapat ditayangkan di luar jaringan Alamat IP dan port tanpa mengharuskan semua target tersebut menggunakan sertifikat yang sama.
Konfigurasi khusus Edge tidak diperlukan. Jika lingkungan Anda dikonfigurasi untuk arah selatan SNI (Edge cloud secara default), Edge 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 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" di detail Sertifikat SSL
"Algoritma Tanda Tangan" yang baru telah ditambahkan ke detail sertifikat SSL, dapat dilihat di UI pengelolaan (Admin > Sertifikat SSL) dan API pengelolaan (Dapatkan Detail Sertifikat dari Keystore atau Truststore). Kolom ini menampilkan "sha1WithRSAEncryption" atau "sha256WithRSAEncryption", bergantung pada jenis algoritma {i>hashing <i}yang digunakan untuk menghasilkan CA {i>root<i}.
Menampilkan sertifikat SSL yang hampir habis masa berlakunya
Halaman Sertifikat SSL di UI pengelolaan (Admin > Sertifikat SSL) menunjukkan waktu Masa berlaku sertifikat SSL akan berakhir dalam waktu 10, 15, 30, atau 90 hari, bergantung pada pilihan Anda di masa berlaku yang baru.
Konfigurasi error perlindungan ancaman
Secara default, Edge menampilkan kode status Error Server Internal HTTP 500 dan ExecutionFailed
error jika pesan tidak berhasil melewati kebijakan JSON atau XML Threat Protection. Anda dapat mengubah
perilaku error tersebut dengan properti tingkat organisasi yang baru. Saat menetapkan organisasi
properti features.isPolicyHttpStatusEnabled
ke benar (true), hal berikut
perilaku itu terjadi:
- Permintaan: Dengan kebijakan perlindungan ancaman yang dilampirkan ke setiap alur permintaan, pesan tidak valid mengembalikan kode status 400, bersama dengan pesan {i>error<i} kebijakan yang sesuai.
- Respons: Dengan kebijakan perlindungan ancaman yang dilampirkan ke alur respons apa pun, pesan tidak valid masih menampilkan kode status 500, dan salah satu pesan error kebijakan yang sesuai ditampilkan (bukan hanya ExecutionFailed).
Pelanggan Cloud harus menghubungi Dukungan Apigee untuk menetapkan properti organisasi. Fitur ini akan tersedia untuk pelanggan Edge Private Cloud pada tanggal Private Cloud per kuartal.
Memperbarui skema untuk endpoint, proxy, dan entity 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 akan beralih dari versi beta menjadi ketersediaan umum. Update dan fitur baru termasuk:
- Dukungan untuk Swagger 2.0, termasuk impor berdasarkan file atau URL, termasuk dukungan untuk objek keamanan bernama khusus.
- Peningkatan desain visual dalam template yang menghasilkan SmartDocs.
- Peningkatan kegunaan dan alur kerja di Portal Developer, yang tersedia melalui Konten > Menu SmartDocs di Drupal.
- Apa yang disebut sebagai "Token Kustom" autentikasi kini disebut "API Key".
- Autentikasi "keamanan" objek yang didefinisikan di level revisi.
- Konfigurasi autentikasi klien di tingkat template. Revisi baru tidak lagi direset kredensial klien SmartDocs yang telah dikonfigurasi sebelumnya.
Untuk deskripsi fitur lainnya, lihat blog ini postingan Anda.
Untuk dokumentasi SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan Google Cloud API.
Nama aplikasi developer yang ditampilkan di UI pengelolaan
Aplikasi pengembang di Edge memiliki Nama internal yang tidak berubah dan Nama Tampilan yang yang dapat Anda ubah. Pada halaman Aplikasi Developer di UI pengelolaan (Publikasikan > Aplikasi Developer > nama aplikasi), "Nama" internal aplikasi ditampilkan bersama dengan "Nama Tampilan", sehingga memudahkan untuk mengidentifikasi aplikasi secara visual berdasarkan nama internalnya untuk pemecahan masalah dan pengelolaan API.
Layanan Analisis
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 sudah lebih 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 dihapus dari UI pengelolaan
Versi klasik opsional dari laporan analisis kustom tidak lagi tersedia di UI manajemen proyek.
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 pada paket tarif berikat volume atau paket yang telah mereka beli. Sebagai detail, lihat Menyiapkan notifikasi menggunakan template notifikasi.
Sinkronisasi Biaya Berulang dan periode Dasar Agregasi
Dalam paket tarif, kemungkinan ada dua jangka waktu berbeda yang berlaku:
- Periode Biaya Berulang, yang dikonfigurasi pada tab Biaya dalam paket tarif, yang menentukan developer ditagih biaya berulang.
- Periode Dasar Agregasi, yang ditentukan pada kartu tarif untuk paket Volume Berikat atau Paket, yang ditentukan saat penggunaan paket direset untuk developer.
Kedua periode tersebut sekarang disinkronkan. Jika biaya berulang bukan nol dan Volume Banded atau Kartu tarif paket ada dalam paket tarif, periode biaya berulang digunakan untuk keduanya. Misalnya, jika terdapat biaya berulang bulanan, paket kartu tarif juga akan direset setiap bulan (secara default sebesar 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, lalu penggunaan paket direset sebulan setelah tanggal 19.
Dasar Agregasi tidak digunakan lagi dan akan dihapus dari monetisasi pada masa mendatang data. Untuk informasi selengkapnya, lihat Menentukan paket kartu tarif detail.
Atribut Khusus dalam laporan pendapatan ringkasan
Kebijakan pencatatan transaksi memungkinkan Anda secara opsional mengambil data atribut khusus dari transaksi, dan kini Anda dapat menyertakan atribut transaksi kustom tersebut dalam laporan. Dengan menambahkan properti MINT.SUMMARY_CUSTOM_ATTRIBUTES ke organisasi, Anda dapat menunjukkan atribut khusus yang ditambahkan ke tabel {i>database<i} untuk digunakan dalam laporan.
Apigee Edge untuk pelanggan Private Cloud dapat menyetel tanda dengan panggilan API berikut dan Kredensial Administrator Sistem.
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 sudah menggunakan SmartDocs selama periode beta, fitur dan kemampuan baru dalam versi ketersediaan umum mengharuskan Anda mengupgrade SmartDocs di developer portal.
Setiap halaman SmartDocs yang telah dipublikasikan di portal developer Anda akan terus bekerja, tetapi Anda harus mengikuti proses pembaruan sebelum mengedit atau mempublikasikan perubahan apa pun pada atau halaman baru.
Perlu diingat bahwa meskipun Anda dapat merender dan memublikasikan SmartDocs di dalam portal developer, SmartDocs dihasilkan dari model API yang berada dalam Pengelolaan Edge API Apigee Layanan. Setiap perubahan yang Anda buat pada model API di Edge akan sama di semua Pantheon (serupa dengan bagaimana developer ada di 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 apa pun yang telah Anda gunakan.
- Jika Anda telah mengimpor dokumen Swagger atau WADL, impor lagi dokumen tersebut ke revisi.
- Jika Anda telah mempertahankan model API melalui modul SmartDocs, ekspor sebagai SmartDocs JSON dan impor ke dalam model baru Anda menggunakan lampiran file.
- Tetapkan properti keamanan revisi model Anda. Di Konten >
SmartDocs > model, pilih Setelan Keamanan.
- Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Konten >
SmartDocs) dengan mengklik Setelan di bagian Operasi
.
- Perbarui template kustom apa pun untuk menggunakan aset CSS dan JS v6, lalu buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk mengetahui informasi tentang cara mengupdate SmartDocs template, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
- Render ulang dan publikasikan revisi model Anda.
- Setelah memvalidasi dokumentasi baru, perbarui portal production ke rilis 15.05.27.
Jika Anda adalah pelanggan Edge Enterprise dan memiliki pertanyaan atau masalah terkait upgrade proses ini, kirim email ke marsh@apigee.com dan cnovak@apigee.com. Atau, gunakan Komunitas Apigee untuk yang dihasilkan.
Perubahan dan peningkatan fitur mendatang
Bagian ini mempratinjau perubahan dan peningkatan yang diharapkan pada fitur mendatang:
Ubah menjadi Perilaku kebijakan Cache respons
Pada rilis mendatang (akan ditentukan), perilaku default <ExcludeErrorResponse> dari kebijakan Cache Respons akan berubah.
Perilaku saat ini: Elemen <ExcludeErrorResponse> di kebijakan cache respons adalah false secara default. Ini berarti bahwa, secara default, respons dengan kode status HTTP yang mungkin (termasuk 3xx) di-cache oleh kebijakan Cache Respons.
Perilaku pada masa mendatang: Elemen <ExcludeErrorResponse> di Kebijakan Cache Respons akan ditetapkan secara default ke benar (true). Ini berarti bahwa, secara {i>default<i}, hanya respons dengan HTTP Kode status 200 hingga 205 akan di-cache. Untuk mengganti perilaku ini dan meng-cache respons bagi semua kode status, Anda perlu menyetel elemen <ExcludeErrorResponse> dapat benar secara eksplisit.
Solusi saat ini: Untuk Private Cloud 4.15.07.00 dan rilis yang lebih lama, jika jika Anda ingin menyimpan respons ke dalam cache hanya dengan kode Status 200 hingga 205, Anda harus menyetel elemen <ExcludeErrorResponse> ke true.
Bug 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 kustom tidak diterapkan ke admin Apigee pengguna |
OPDK-1097 | Pengecualian keyspace selama upgrade OPDK |
OPDK-1068 | Dapat mengubah sandi admin jika gagal selama penginstalan |
OPDK-1053 | Zookeeper berjalan sebagai root |
OPDK-967 | Saat menyetel OpenLDAP ke autostart menggunakan set-autostart.sh, all-status.sh melaporkannya sebagai mati |
OPDK-905 | Produk Smartdocs sudah terdaftar di grup axgroup001 |
OPDK-899 | Terjadi error saat orientasi |
OPDK-847 | Pengguna yang dibuat saat orientasi tidak menerima email untuk mereset sandi |
OPDK-817 | skrip init.d menampilkan error |
OPDK-815 | Skrip ax-purge.sh memerlukan penghapusan tabel pengambilan sampel |
MGMT-2246 | Halaman buat laporan kustom tidak ditampilkan dengan benar di bagian pengelolaan UI |
MGMT-2235 | Untuk sertifikat SSL yang habis masa berlakunya, Waktu relatif masa berlaku mungkin membingungkan
dibulatkan Untuk sertifikat SSL yang habis masa berlakunya, waktu relatif tanggal habis masa berlaku selalu ditampilkan dalam hari alih-alih dibulatkan menjadi beberapa bulan, saat masa berlaku sertifikat habis dalam 90 hari atau lebih sedikit. |
MGMT-2193 | Memuat indikator lingkaran berputar saat mengedit API |
MGMT-2173 | UI Trace tidak mengizinkan URL resmi UI Trace kini memungkinkan Anda mengirim permintaan dengan nilai parameter kueri yang berisi data bertingkat parameter kueri. |
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 harus menampilkan error yang tepat selama deployment |
MGMT-2067 | Trace: Jika revisi proxy API di-deploy di 2 lingkungan, memilih revisi dan yang tidak berfungsi dengan benar |
MGMT-2061 | Lupa Sandi hanya boleh mengirim email kepada pengguna terdaftar Opsi "Lupa sandi?" di halaman login UI pengelolaan hanya mengirim email ke alamat email pengguna Apigee. |
MGMT-2048 | Pengguna dengan peran khusus yang membatasi izin deployment hanya untuk satu env dapat men-deploy di negara 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 gagal: "Mengambil Kesalahan WSDL: Kesalahan pemrosesan WSDL". |
MGMT-1986 | Terjadi error UI saat menambahkan developer |
MGMT-1983 | Mendapatkan kode otorisasi OAuth 2.0, API yang 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, UI untuk membuat dan mengedit Kebijakan Perekaman Transaksi kini dinonaktifkan. |
MGMT-1899 | Jalur resource dihapus setelah menyimpan setelan produk Saat mengedit produk API, jalur resource produk dapat dihapus jika pengguna mengeklik dua kali tombol {i>Save<i}. Masalah ini sudah teratasi. |
MGMT-1894 | Halaman Aplikasi Developer tidak pernah selesai dimuat untuk developer kolom |
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 satu mereka |
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 {i>sysadmin<i} tidak memiliki opsi untuk mengubah {i>password<i} 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 | Menambahkan validasi TargetEndpoint selama impor Mirip dengan ProxyEndpoint, TargetEndpoint akan divalidasi yang digunakan dalam kondisi selama impor proxy API. |
MGMT-1804 | Node.js API dalam beberapa kasus mengirimkan JSON yang tidak valid Layar log Node.js digunakan untuk menampilkan log yang tidak terformat jika data json tidak valid karakter. Hal ini telah diperbaiki dalam rilis ini dan UI kini menampilkan node.js yang diformat dengan baik log. |
MGMT-1802 | URL reset sandi #118 Jika UI pengelolaan berada di belakang server penghentian SSL, UI pengelolaan kini sudah benar membuat email kata sandi pengaturan ulang dengan tautan 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" Mulai segera, kami telah menghapus dukungan branding kustom di Edge OPDK. Meskipun kita menyadari bahwa hal ini mungkin mengecewakan beberapa pelanggan yang menggunakannya, ini bukan yang secara langsung meningkatkan kemampuan Edge seputar pengelolaan API. |
MGMT-1569 | Terjadi masalah saat melampirkan proxy API ke produk API yang sudah ada Perbaikan Proxy API ke produk API di UI Pengelolaan saat Proxy API memiliki sumber daya untuk "/" . |
MGMT-1563 | Tombol kirim di Trace tetap dinonaktifkan jika terjadi error |
MGMT-1362 | Email Lupa Sandi tidak berfungsi jika alamat Email berisi
'_' Memperbaiki masalah reset sandi di OPDK dengan alamat email yang berisi garis bawah. |
MGMT-1345 | Impor WSDL dengan beberapa namespace menghasilkan Build SOAP yang salah Langkah |
MGMT-1193 | Menyimpan proxy sebagai revisi baru secara tiba-tiba akan mengubah aturan rute |
MGMT-1061 | SmartDocs: Deskripsi parameter jenis isi dalam definisi Swagger tidak ditampilkan UI di dokumen |
MGMT-800 | Membuat resource dengan nama 'default' menyebabkan UI yang rusak |
MGMT-787 | Masalah kegunaan pemberitahuan UI Di UI pengelolaan, saat mengklik + Proxy API 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 saat endpoint tidak memiliki PreFlow/PostFlow menyebabkan error |
MGMT-460 | Mengganti nama kebijakan akan menyebabkan perilaku glitch, kebijakan duplikat yang tidak dapat dihapus |
DEVRT-1644 | Pencarian notifikasi menurut nama menyebabkan email yang salah dikirim |
DEVRT-1583 | UI monetisasi menampilkan "Future" badge 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 bertanya |
AXAPP-1707 | Meningkatkan performa analisis pod secara gratis |
AXAPP-1690 | "Error API Tidak Valid" tentang laporan kustom |
AXAPP-1533 | Geomap Analytics menampilkan error Panggilan API Tidak Valid |
AXAPP-1493 | Meng-cache statistik performa 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 di Javacallout kebijakan |
APIRT-1346 | OAuth2.0 - Nilai yang di-hash ditampilkan dalam respons token akses saat hash.oauth.tokens.enabled benar |
APIRT-1206 | target_ip tidak dicatat dalam tabel fakta untuk 503 dan sebagian besar 504 dtk |
APIRT-1170 | File resource tidak ada karena MP gagal memuat lingkungan |
APIRT-1148 | GET variabel {message.version} di ResponseFlow, untuk target Node.js akan menampilkan NPE |
APIRT-1054 | Pencatatan Log Pesan gagal saat mencoba masuk ke direktori selain default |
APIRT-387 | Membuat OrganizationService berjalan dengan nuansa 'lainnya' di MP |
APIRT-67 | Kebijakan GenerateAccessToken OAuth tidak menetapkan variabel oauthV2.failed dengan benar |
APIRT-52 | Laporan Kustom: Kode status respons untuk banyak API bersifat 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 |
Instal komponen monetisasi di Edge yang diupgrade
lingkungan
Solusinya adalah menetapkan versi Monetisasi yang tepat pada file apigee-env.sh
sebelum Anda mencoba menginstal Monetisasi. Untuk mendapatkan versi Monetisasi di 4.15.07
(setelah Anda meningkatkan versi 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 contoh di atas perlu 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 menjalankan langkah-langkah di atas,
instalasi gagal dan kemungkinan ada {i>
symlink<i} yang mati di direktori berbagi. Anda perlu
untuk menghapus symlink tersebut:
> rm /install-dir/apigee4/share/monetization
Setelah menghapus symlink, lakukan 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 Pada CentOS dan RedHat 7.0, beberapa skrip di {i>bin/qpid-stat.sh<i} dan {i>bin/qpid-config.sh<i} dikodekan keras untuk menggunakan Python versi 2.6. Solusi untuk masalah ini adalah dengan mengubah baris yang mengekspor PYTHONPATH di {i>qpid-stat.sh<i} dan {i>qpid-config.sh<i} di direktori {i>apigee4/bin<i}.
Untuk menentukan versi Python di sistem Anda, periksa versi Python di direktori {i> /opt/apigee4/share/apache-qpid/lib<i}. Direktori tersebut kemungkinan besar adalah python2.7. Anda kemudian perlu memperbarui pengaturan PYTHONPATH di qpid-stat.sh dan qpid-config.sh dengan jalur yang benar. Contoh:
|
DEVRT-1574 | Saldo dan penggunaan tidak konsisten untuk developer dengan beberapa rasio aktif
paket Dalam monetisasi, jika developer aktif di lebih dari satu paket tarif yang memiliki panggilan per API biaya tambahan, maka penggunaan saldo moneter terkadang tidak konsisten. |
APIBAAS-1647 | Setelah login sebagai admin sistem, UI BaaS menampilkan 'Error mendapatkan peran'
pesan Pesan {i>error <i}ini muncul saat pertama kali {i>log in <i}ke sistem oleh admin sistem setelah meningkatkan dari 4.15.01 ke 4.15.07. Anda dapat mengabaikan pesan ini. |
DEVRT-1834 |
Upgrade monetisasi ke upgrade 4.15.07 Skrip apigee-upgrade.sh mencetak pesan berikut di bagian akhir yang meminta Anda untuk mengeksekusi 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 berikut untuk notifikasi monetisasi tidak ada. Hal ini berkaitan dengan
jenis notifikasi pada Admin > Halaman notifikasi 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
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 notifikasi 4.14.07.00 tidak ada
konfigurasi
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, yang menyebabkan
laporan monetisasi berfungsi dengan tidak semestinya.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
Untuk mengatasi masalah ini, ikuti langkah-langkah berikut. Anda memerlukan alamat IP
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 dalam beberapa penginstalan pusat data Panduan penginstalan Edge menentukan untuk menetapkan nama Pod sebagai "gateway-1" dan "gateway-2" di instalasi otomatis untuk beberapa instalasi pusat data. Namun, mengganti nama Pod mencegah {i>Router<i} dan Pemroses Pesan tidak terdaftar dengan benar dan tidak dapat diakses. Masalah ini juga mencegah skrip setup-org.sh dapat menemukan Pemroses Pesan yang tersedia. Solusinya adalah menetapkan nama Pod, menggunakan properti MP_POD, ke "gateway" di instalasi otomatis 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 Pemroses Pesan:
<install_dir>/apigge4/bin/apigee-service message-processor restart
|
OPDK-1958 | Saat melakukan upgrade, semua node akan memerlukan akses ke port 8080 di Pengelolaan
Server Saat runtime, komponen berikut memerlukan akses ke port 8080 di Server Pengelolaan: {i>Router<i}, Pemroses Pesan, UI, Postgres, dan Qpid. Namun, saat upgrade, semua node akan memerlukan akses ke port 8080 di Server Pengelolaan, termasuk Cassandra dan Zookeeper node. |
OPDK-1962 | Harus mengonfigurasi ulang SSL untuk Edge API setelah upgrade Jika Anda telah mengonfigurasi Edge API untuk menggunakan SSL sebelum meningkatkan ke 4.15.07.00, maka Anda harus mengkonfigurasi ulang SSL setelah peningkatan versi. Lihat Panduan Pengoperasian Edge untuk untuk mengonfigurasi SSL untuk Edge API. |