4.15.07.00 - Catatan rilis Apigee Edge untuk Private Cloud

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Pada Selasa, 8 September 2015, kami merilis Rilis Fitur utama Apigee Edge untuk Private Cloud.

Sejak rilis kuartalan Edge for Private Cloud sebelumnya (4.15.04.00), rilis berikut telah terjadi dan disertakan dalam rilis kuartalan ini:

Versi Edge yang dapat Anda upgrade ke 4.15.07.00

Bergantung pada versi Edge saat ini, Anda dapat:

  • Mengupgrade langsung ke 4.15.07.00
  • Mengupgrade secara bertahap, yang berarti Anda harus mengupgrade dari versi saat ini ke versi Edge lain, lalu mengupgrade ke 4.15.07.00.

Untuk informasi selengkapnya, lihat Versi Edge for Private Cloud mana yang dapat Anda upgrade ke 4.15.07.00.

Sebelum mengupgrade dari versi 4.15.01.x atau dari versi sebelumnya

Sebelum mengupgrade, pastikan Anda telah mengupgrade SSTable Cassandra di setiap node Cassandra:
  1. Periksa versi SSTable Cassandra:
    1. Ubah direktori ke /<install-root>/apigee4/data/cassandra/data.
    2. Jalankan perintah find,
      > find . -name *-ic-*
      Hasilnya akan menampilkan kumpulan file .db jika Anda menjalankan SSTable Cassandra 1.2.
    3. Jalankan perintah find ini:
      > find . -name *-hf-*
      Hasilnya harus kosong, yang berarti tidak ada file .db dalam format hf. Jika tidak melihat file dalam format hf, berarti Anda sudah selesai dan dapat mengupgrade ke 4.15.07.00.

      Format hf ditujukan untuk SSTable Cassandra 1.0. Jika memiliki file *.db dalam format hf, Anda harus mengupgrade SSTable seperti yang dijelaskan di bagian lain dari prosedur ini.
  2. Jika Anda menemukan file *.db dalam format hf, upgrade SSTable dengan menjalankan perintah berikut di setiap node Cassandra hingga Anda mengupgrade semua node Cassandra:
    > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
  3. Ulangi Langkah 1 untuk memeriksa apakah semua file *.db dalam format ic untuk versi Cassandra 1.2.
  4. Ulangi Langkah 1 hingga 3 di setiap node Cassandra dalam penginstalan Edge Anda.
  5. Mengupgrade ke Edge 4.15.07.00.
  6. Setelah upgrade 4.15.07.00, periksa file *.db untuk memastikan semuanya telah diupgrade ke sstable gaya C* 2.0:
    > cd /<install-root>/apigee4/data/cassandra/data
    > find . -name *-jb-*

    Perintah ini akan menampilkan kumpulan file .db jika Anda menjalankan Cassandra 2.0.

Fitur dan peningkatan baru

Berikut adalah fitur baru dan peningkatan dalam rilis ini.

Penginstalan dan upgrade

Mengupgrade dan meng-uninstal komponen secara selektif

Skrip apigee-upgrade.sh dan apigee-uninstall.sh kini memungkinkan Anda memilih komponen Edge untuk diupgrade atau di-uninstal. Sebelumnya, perintah ini mengupgrade atau meng-uninstal semua komponen di node. (OPDK-1377, OPDK-1175)

Rollback upgrade

Jika apigee-upgrade.sh gagal selama upgrade, Anda kini dapat menggunakan skrip apigee-rollback.sh untuk melakukan rollback upgrade. Setelah memperbaiki masalah upgrade, Anda dapat mencoba lagi upgrade. (OPDK-1275)

Opsi skrip penginstal yang dipersingkat

Skrip penginstalan tidak lagi menggunakan opsi dalam bentuk panjang, seperti --help. Sekarang, opsi ini hanya menggunakan 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 SmartDocs diinstal di lokasi yang diharapkan. Sebelumnya, 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 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, serta menghapus dukungan untuk JDK 1.6. (OPDK-1187)

Dukungan OS

Apigee Edge untuk Cloud Pribadi telah memperluas dukungan sistem operasinya untuk 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 disertakan dalam OPDK 15.07

Rilis ini menginstal Cassandra 2.0.15. Jika Anda mengupgrade 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 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 dalam file keymanagement.properties (di server pengelolaan dan pemroses pesan) mengaktifkan hashing SHA1 otomatis untuk token OAuth. 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 membuat 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 informasi tentang cara mengaktifkan hashing token di organisasi Anda dengan properti baru, lihat "Hashing Token di database" dalam topik Meminta token akses.
  • Untuk informasi tentang hashing massal token yang 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 dalam file message-logging.properties. Untuk informasi selengkapnya, lihat Kebijakan Logging Pesan. (APIRT-1394)

Performa cache lingkungan

Untuk pengelolaan dan penggunaan cache dalam memori yang lebih baik, setelan "Elemen Maksimum dalam Memori" pada resource cache lingkungan tidak digunakan lagi. Total elemen yang ada di seluruh resource cache (termasuk cache default) bergantung pada total memori yang dialokasikan ke cache. Secara default, total memori yang dialokasikan untuk penyimpanan dalam memori di pemroses pesan tertentu adalah 40% dari total memori yang tersedia, yang ditentukan oleh setelan properti cache dalam file cache.properties pemroses pesan Anda. Elemen akan dihapus dari cache dalam memori hanya jika memori cache tidak mencukupi atau elemen berakhir masa berlakunya.

Untuk kembali ke perilaku lama menggunakan properti "Maximum Elements in Memory" 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.

Editor Proxy Baru sebagai default

Editor proxy API baru diaktifkan secara default di UI pengelolaan. Editor baru menyertakan banyak peningkatan kegunaan, termasuk tampilan alur kondisional dan endpoint yang lebih komprehensif di halaman Ringkasan, semua konfigurasi di halaman Pengembangan, penambahan alur kondisional, endpoint, dan kebijakan yang lebih intuitif, tampilan XML yang lebih lengkap, bukan cuplikan kecil, penelusuran yang meng-crawl nama file dan teks, dan banyak lagi. (MGMT-2279)

Kebijakan baru Hapus Info OAuth v2.0

Kebijakan "Delete OAuth v2.0 Info" yang baru memungkinkan Anda menghapus token akses dan kode otorisasi OAuth v2. Kebijakan ini menggantikan fungsi yang sebelumnya disediakan oleh API pengelolaan. Untuk informasi selengkapnya, lihat Menghapus kebijakan Info OAuthV2. (MGMT-2257)

Kebijakan baru Hapus Info OAuth v1.0

Kebijakan "Hapus Info OAuth v1.0" yang baru memungkinkan Anda menghapus token permintaan, token akses, dan kode verifier OAuth v1.0. Kebijakan ini menggantikan fungsi yang sebelumnya disediakan oleh API pengelolaan. 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 daftar yang diizinkan dan daftar yang ditolak saat alamat IP terdapat dalam header HTTP X-FORWARDED-FOR.

Dengan beberapa pemeriksaan alamat IP yang diaktifkan di header (hubungi Dukungan untuk menetapkan fitur.enableMultipleXForwardCheckForACL), elemen <ValidateBasedOn> baru dalam kebijakan memungkinkan Anda memeriksa terhadap IP pertama, IP terakhir, atau semua IP di header. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Kontrol Akses.

Entitas baru dalam kebijakan Entitas Akses

Kebijakan Entitas Akses memberikan akses ke entitas baru berikut: cakupan kunci konsumen, kode otorisasi, token permintaan, dan verifier. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Entitas Akses.

Kebijakan Pengumpul Statistik: konversi otomatis nama statistik menjadi huruf kecil

Saat membuat koleksi analisis kustom di editor proxy API (halaman Develop > Tools > Custom Analytics Collection), variabel pengumpulan (statistik) "Name" harus dalam huruf kecil. Jika Anda memasukkan nama dengan huruf besar, alat ini akan otomatis mengonversi nama Statistik menjadi huruf kecil dalam kebijakan Pengumpul Statistik. (MGMT-740)

Penghapusan Pelacakan Klasik di editor proxy API

Fungsi Trace versi terbaru di editor proxy API telah beralih dari versi 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 pesan error di UI pengelolaan:

  • UI pengelolaan yang digunakan untuk mengelompokkan dan menampilkan semua pesan error di UI selama seluruh sesi login, kecuali jika Anda menutupnya. Dengan update ini, pesan error akan otomatis dihapus saat Anda keluar dari halaman tempat pesan tersebut muncul. (MGMT-2254)
  • UI pengelolaan tidak lagi menyembunyikan pesan error duplikat. (MGMT-2242)

Peningkatan performa dan error UI

Peningkatan umum dilakukan pada berbagai area UI pengelolaan, termasuk performa tampilan halaman dan pembersihan pesan error.

Di halaman Pengguna Organisasi di UI pengelolaan (Admin > Pengguna Organisasi), nama peran kini memiliki hyperlink, sehingga Anda dapat 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 menggantikan target.basepath.with.query.
  • TargetServer: loadbalancing.targetserver menggantikan targetserver.name. Selain itu, target.basepath hanya diisi saat elemen <Path> digunakan dalam elemen <LoadBalancer> HTTPTargetConnection TargetEndpoint.

Dukungan Server Name Indication (SNI)

Edge mendukung penggunaan Server Name Indication southbound (dari pemroses pesan ke endpoint target). Jika Anda ingin menggunakan SNI, hubungi Dukungan Apigee.

Java 1.7 diperlukan.

Dengan SNI, yang merupakan ekstensi TLS/SSL, beberapa target HTTPS dapat ditayangkan dari alamat IP dan port yang sama tanpa mengharuskan semua target tersebut menggunakan sertifikat yang sama.

Tidak diperlukan konfigurasi khusus Edge. Jika lingkungan Anda dikonfigurasi untuk SNI southbound (Edge cloud secara default), Edge akan mendukungnya.

Edge 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:

Untuk informasi selengkapnya tentang SNI, lihat http://en.wikipedia.org/wiki/Server_Name_Indication.

"Signature Algorithm" di detail Sertifikat SSL

Kolom "Signature Algorithm" baru telah ditambahkan ke detail sertifikat SSL, yang dapat dilihat di UI pengelolaan (Admin > SSL Certificates) dan API pengelolaan (Get Cert Details from a Keystore or 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 sertifikat SSL akan berakhir dalam waktu 10, 15, 30, atau 90 hari, bergantung pada pilihan Anda di kolom drop-down masa berlaku baru.

Konfigurasi error perlindungan terhadap ancaman

Secara default, Edge menampilkan kode status HTTP 500 Internal Server Error dan error ExecutionFailed jika pesan tidak berhasil melewati kebijakan Perlindungan Ancaman JSON atau XML. Anda dapat mengubah perilaku error tersebut dengan properti tingkat organisasi baru. Saat menetapkan properti org features.isPolicyHttpStatusEnabled ke benar, perilaku berikut akan terjadi:

  • Permintaan: Dengan kebijakan perlindungan dari ancaman yang dilampirkan ke alur permintaan apa pun, pesan yang tidak valid akan menampilkan kode status 400, beserta pesan error kebijakan yang sesuai.
  • Respons: Dengan kebijakan perlindungan dari ancaman yang dilampirkan ke alur respons, pesan yang tidak valid masih 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 bagi pelanggan Edge Private Cloud pada rilis kuartalan Private Cloud berikutnya.

Skema yang diperbarui untuk endpoint, proxy, dan entity lainnya

Skema referensi telah diperbarui untuk entity 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 lulus dari versi beta ke ketersediaan umum. Pembaruan dan fitur baru meliputi:

  • Dukungan untuk Swagger 2.0, termasuk impor menurut file atau URL, termasuk dukungan untuk objek keamanan bernama kustom.
  • Peningkatan desain visual pada template yang menghasilkan SmartDocs.
  • Peningkatan kegunaan dan alur kerja di Portal Developer, yang tersedia melalui menu Konten > SmartDocs di Drupal.
  • Yang sebelumnya dikenal sebagai autentikasi "Token Kustom" kini disebut "Kunci API".
  • Objek "keamanan" autentikasi yang ditentukan di tingkat revisi.
  • Konfigurasi autentikasi klien di tingkat template. Revisi baru tidak lagi mereset kredensial klien SmartDocs yang telah dikonfigurasi sebelumnya.

Untuk deskripsi fitur selengkapnya, 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. Di halaman Aplikasi Developer di UI pengelolaan (Publikasi > Aplikasi Developer > nama aplikasi), "Nama" internal aplikasi ditampilkan bersama dengan "Nama Tampilan", sehingga memudahkan identifikasi aplikasi secara visual berdasarkan nama internalnya untuk pemecahan masalah dan pengelolaan API.


Layanan Analisis

Berikut adalah fitur Layanan Analisis 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.

Laporan kustom versi klasik dihapus dari UI pengelolaan

Laporan analisis kustom versi klasik opsional 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 mereka beli. Untuk mengetahui detailnya, lihat Menyiapkan notifikasi menggunakan template notifikasi.

Sinkronisasi periode Biaya Berulang dan Dasar Agregasi

Dalam paket tarif, berpotensi ada dua jangka waktu yang berlaku:

  • Periode Biaya berulang, yang dikonfigurasi di tab Biaya pada paket tarif, yang menentukan kapan developer dikenai 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 kini disinkronkan. Jika biaya berulang yang 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 tarif juga akan direset setiap bulan (secara default pada awal bulan).

Jika tidak ada biaya berulang, paket akan direset berdasarkan Dasar Agregasi yang ditentukan di kartu tarif. Misalnya, jika developer mulai menggunakan tarif pada tanggal 19 bulan ini, dan Basis Agregasi adalah setiap bulan, penggunaan paket akan direset sebulan setelah tanggal 19.

Dasar Agregasi tidak digunakan lagi dan akan dihapus dari monetisasi dalam rilis mendatang. Untuk informasi selengkapnya, lihat Menentukan detail paket tarif.

Atribut Kustom dalam laporan ringkasan pendapatan

Kebijakan perekaman transaksi memungkinkan Anda secara opsional mengambil data atribut kustom dari transaksi, dan kini Anda dapat menyertakan atribut transaksi kustom tersebut dalam laporan pendapatan ringkasan. Dengan menambahkan properti MINT.SUMMARY_CUSTOM_ATTRIBUTES ke organisasi, Anda dapat menunjukkan atribut kustom mana yang ditambahkan ke tabel database untuk digunakan dalam laporan.

Pelanggan Apigee Edge untuk Private Cloud dapat menetapkan tanda dengan panggilan API berikut dan kredensial System Administrator.

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">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

Perhatikan bahwa array atribut kustom dalam panggilan API dienkode 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 portal developer.

Setiap halaman SmartDocs yang telah dipublikasikan di portal developer Anda akan terus berfungsi, tetapi Anda harus mengikuti proses pembaruan sebelum mengedit atau memublikasikan perubahan apa pun pada halaman yang ada atau baru.

Perlu diingat bahwa meskipun Anda dapat merender dan memublikasikan SmartDocs di dalam portal developer, SmartDocs dibuat dari model API yang ada dalam Layanan Pengelolaan API Tepi Apigee. Setiap perubahan yang Anda buat pada model API di Edge akan sama di semua lingkungan Pantheon (mirip dengan cara developer berada di seluruh lingkungan Pantheon).

Untuk mengupgrade dari SmartDocs versi beta ke versi yang tersedia secara umum

  1. Update dan uji rilis 15.05.27 di lingkungan dev atau test di Pantheon.
  2. 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 mengelola model API melalui modul SmartDocs, ekspor sebagai JSON SmartDocs dan impor ke model baru menggunakan lampiran file.
  3. Tetapkan properti keamanan revisi model Anda. Di halaman Konten > SmartDocs > model, pilih Setelan Keamanan.
  4. Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Konten > SmartDocs) dengan mengklik Setelan di kolom Operasi.
  5. Perbarui template kustom apa pun untuk menggunakan aset CSS dan JS v6, dan buat perubahan untuk mencerminkan nama objek baru, seperti authSchemes dan apiSchema. Untuk informasi tentang cara mengupdate template SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.
  6. Render ulang dan publikasikan revisi model Anda.
  7. Setelah memvalidasi dokumentasi baru, update portal produksi 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. Jika tidak, gunakan Komunitas Apigee untuk mendapatkan respons terbaik.


Perubahan dan peningkatan fitur mendatang

Bagian ini memberikan pratinjau perubahan dan peningkatan fitur yang diharapkan pada masa mendatang:

Perubahan pada Perilaku kebijakan Cache Respons

Dalam rilis mendatang (akan ditentukan), perilaku default elemen <ExcludeErrorResponse> dari kebijakan Cache Respons akan berubah.

Perilaku saat ini: Elemen <ExcludeErrorResponse> dalam kebijakan cache respons bernilai salah secara default. Artinya, secara default, respons dengan kode status HTTP yang mungkin (termasuk 3xx) di-cache oleh kebijakan Cache Respons.

Perilaku mendatang: Elemen <ExcludeErrorResponse> dalam kebijakan Cache Respons akan ditetapkan secara default ke true (benar). Artinya, 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 menetapkan elemen <ExcludeErrorResponse> ke benar secara eksplisit.

Solusi saat ini: Untuk rilis Private Cloud 4.15.07.00 dan yang lebih lama, jika Anda ingin meng-cache respons hanya dengan Kode status 200 hingga 205, Anda harus menetapkan elemen <ExcludeErrorResponse> secara eksplisit ke benar.


Bug yang diperbaiki

Bug berikut 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 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 untuk memulai otomatis menggunakan set-autostart.sh, all-status.sh melaporkannya sebagai mati
OPDK-905 Smartdocs prod sudah terdaftar di grup axgroup001
OPDK-899 Error selama orientasi
OPDK-847 Pengguna yang dibuat selama orientasi tidak mendapatkan email untuk mereset sandi
OPDK-817 Skrip init.d menampilkan error
OPDK-815 Skrip ax-purge.sh memerlukan penghapusan tabel sampling
MGMT-2246 Halaman Buat laporan kustom tidak ditampilkan dengan benar di UI pengelolaan
MGMT-2235 Untuk sertifikat SSL yang akan berakhir masa berlakunya, Waktu relatif masa berlaku dapat dibulatkan dengan cara yang membingungkan
Untuk sertifikat SSL yang akan berakhir masa berlakunya, waktu relatif tanggal habis masa berlakunya selalu ditampilkan dalam hari, bukan dibulatkan ke bulan, jika sertifikat akan berakhir masa berlakunya dalam 90 hari atau kurang.
MGMT-2193 Spinner pemuatan saat mengedit API
MGMT-2173 Trace UI tidak mengizinkan URL hukum
Trace UI 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 sesuai selama deployment
MGMT-2067 Trace: 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 kepada pengguna terdaftar
Link "Lupa sandi?" di halaman login UI pengelolaan hanya mengirim email kepada pengguna Apigee terdaftar.
MGMT-2048 Pengguna dengan peran khusus yang membatasi izin deployment ke satu lingkungan dapat melakukan deployment di lingkungan lain
MGMT-2041 Menghapus elemen FaultRules dari template lampiran default
Elemen FaultRules, yang tidak digunakan dalam kebijakan atau langkah proxy API, tidak lagi ditambahkan secara otomatis saat Anda membuat proxy API atau menambahkan kebijakan.
MGMT-2034 Pengambilan WSDL menampilkan kegagalan: "Error Pengambilan WSDL: Error pemrosesan WSDL".
MGMT-1986 Error UI saat menambahkan developer
MGMT-1983 API Get OAuth 2.0 authorization code menampilkan status yang salah
MGMT-1962 Error saat login ke UI pengelolaan dengan sandi yang kuat
Login ke UI dengan karakter khusus tertentu, seperti tanda persen, tidak lagi gagal.
MGMT-1947 Peran yang tidak intuitif di UI pengelolaan
Jika pengguna tidak memiliki izin untuk membuat atau mengedit Kebijakan Perekaman Transaksi, tombol 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 mengklik dua kali tombol Simpan. Masalah ini sudah teratasi.
MGMT-1894 Halaman Aplikasi Developer tidak pernah selesai dimuat untuk kolom developer
MGMT-1882 Proxy API baru dari WSDL hanya menampilkan detail parameter terakhir
MGMT-1878 Jika beberapa revisi di-deploy ke lingkungan, Trace hanya menampilkan salah satu revisi tersebut
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 boleh memiliki opsi untuk mengubah sandi di UI untuk OPDK
MGMT-1825 Bug pembuatan skrip lintas situs (XSS)
MGMT-1824 Error pengambilan WSDL saat mengimpor file WSDL dengan ekstensi .xml
MGMT-1812 Menambahkan 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 Node.js API mengirim JSON yang tidak valid dalam beberapa kasus
Layar log Node.js digunakan untuk menampilkan log yang tidak diformat jika data JSON memiliki karakter yang tidak valid. Masalah ini telah diperbaiki dalam rilis ini dan UI kini menampilkan log node.js yang berformat baik.
MGMT-1802 url reset sandi #118
Jika UI pengelolaan berada di belakang server penghentian SSL, UI pengelolaan kini membuat email reset sandi dengan link ke URL https, bukan URL http.
MGMT-1799 Kerentanan keamanan UI yang mengirim permintaan di Trace
MGMT-1777 Tidak dapat menambahkan pengguna dengan alamat email yang memiliki TLD .acn
MGMT-1735 Branding "Error while fetching W"
Mulai sekarang, kami telah menghapus dukungan branding kustom di Edge OPDK. Meskipun kami menyadari bahwa hal ini mungkin mengecewakan beberapa pelanggan yang menggunakannya, ini bukan fitur yang secara langsung meningkatkan kemampuan Edge seputar pengelolaan API.
MGMT-1569 Masalah saat melampirkan proxy API ke produk API yang ada
Memperbaiki masalah saat melampirkan Proxy API ke produk API di UI Pengelolaan jika 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 berisi garis bawah.
MGMT-1345 Impor WSDL dengan beberapa namespace menghasilkan Langkah Build SOAP yang salah
MGMT-1193 Menyimpan proxy saat revisi baru secara tidak terduga mengubah aturan rute
MGMT-1061 SmartDocs: Deskripsi parameter jenis isi dalam definisi Swagger tidak ditampilkan di UI dokumen
MGMT-800 Membuat resource dengan nama 'default' akan menyebabkan UI rusak
MGMT-787 Masalah kegunaan notifikasi UI
Di UI pengelolaan, saat 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 API Proxy: Menambahkan kebijakan Cache Respons saat endpoint tidak memiliki PreFlow/PostFlow yang menyebabkan error
MGMT-460 Penggantian nama kebijakan menyebabkan perilaku error, kebijakan duplikat yang tidak dapat dihapus
DEVRT-1644 Penelusuran notifikasi menurut nama menyebabkan email yang salah dikirim
DEVRT-1583 UI Monetisasi menampilkan badge "Mendekati" 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, bergantung pada cara saya memintanya
AXAPP-1707 Meningkatkan performa analisis pod gratis
AXAPP-1690 "Error API Tidak Valid" pada laporan kustom
AXAPP-1533 Geomap 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 jika ditetapkan ke "true" tidak akan berpengaruh dalam 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 yang tidak ada menyebabkan MP gagal memuat lingkungan
APIRT-1148 GET variabel {message.version} di ResponseFlow, untuk target Node.js menampilkan NPE
APIRT-1054 Pembuatan Log Pesan gagal saat mencoba login ke direktori lain selain default
APIRT-387 Membuat OrganizationService berjalan dalam ragam 'others' di MP
APIRT-67 Kebijakan GenerateAccessToken OAuth tidak menetapkan variabel oauthV2.failed dengan benar
APIRT-52 Laporan Kustom: Kode status respons untuk banyak API bernilai null

Masalah umum

Rilis ini memiliki masalah umum berikut.

ID Masalah Deskripsi
OPDK-1586

Portal API BaaS gagal dimulai jika dukungan IPV6 tidak diaktifkan
Solusi untuk masalah ini adalah dengan mengomentari baris IPV6 berikut di /<install-dir>/apigee4/conf/nginx/conf.d/loadbalancer.conf agar Portal API BaaS dapat berjalan, atau aktifkan dukungan IPV6:

# listen [::]:8080;

OPDK-1785

Menginstal komponen monetisasi di lingkungan yang diinstal Edge yang diupgrade
Jika mengupgrade penginstalan Edge ke 4.15.07.00, dan Anda belum menggunakan monetisasi sebelum upgrade, Anda tidak dapat menginstal monetisasi di Edge versi 4.15.07.00.

Solusi untuk mengatasinya adalah dengan menetapkan versi Monetisasi yang tepat dalam file apigee-env.sh sebelum Anda mencoba menginstal Monetisasi. Untuk mendapatkan versi Monetisasi di 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 ada symlink yang tidak berfungsi di direktori bersama. 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 yang di-hardcode 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-hardcode untuk menggunakan Python versi 2.6.

Solusi untuk masalah ini adalah mengubah baris yang mengekspor PYTHONPATH di qpid-stat.sh dan qpid-config.sh di direktori apigee4/bin.

export PYTHONPATH="${QPID_DIR}/lib/python2.6/site-packages"

Untuk menentukan versi Python di sistem Anda, periksa versi Python di direktori /opt/apigee4/share/apache-qpid/lib. Direktori tersebut kemungkinan besar adalah python2.7.

Kemudian, Anda perlu memperbarui setelan PYTHONPATH di qpid-stat.sh dan qpid-config.sh dengan jalur yang benar. Contoh:

export PYTHONPATH="${QPID_DIR}/lib/python2.7/site-packages"

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 per panggilan API, penggunaan saldo moneter terkadang mungkin tidak konsisten.
APIBAAS-1647 Setelah login sebagai admin sistem, UI BaaS menampilkan pesan 'Error getting roles'
Pesan error ini muncul saat admin sistem login pertama kali ke sistem setelah mengupgrade dari 4.15.01 ke 4.15.07. Anda dapat mengabaikan pesan ini.
DEVRT-1834 Upgrade monetisasi ke 4.15.07
Skrip apigee-upgrade.sh akan 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 dieksekusi.

DEVRT-1951 Konfigurasi notifikasi tidak ada pada penginstalan baru monetisasi
Pada penginstalan baru Apigee Edge untuk Private Cloud versi 4.15.07.00, konfigurasi berikut untuk notifikasi monetisasi tidak ada. Hal ini sesuai dengan jenis notifikasi di halaman Admin > 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 instance Cassandra Anda. Untuk menemukannya, lihat di <installation-root>/apigee4/conf/cassandra/cassandra.yaml atau <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Jalankan perintah berikut. Biarkan variabel {ORG_ID} apa adanya, tetapi ganti <org_name>, <installation-root>, dan <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/ui/mint-org-specific-ui-schedulers.txt > /tmp/mint-org-specific-ui-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-ui-schedulers.txt
  2. Mulai ulang server pengelolaan.
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 berikut untuk notifikasi monetisasi tidak ada, yang menyebabkan laporan monetisasi tidak berfungsi dengan benar.
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 Anda. Untuk menemukannya, lihat di <installation-root>/apigee4/conf/cassandra/cassandra.yaml atau <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Jalankan perintah berikut. Biarkan variabel {ORG_ID} apa adanya, tetapi ganti <org_name>, <installation-root>, dan <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/system/mint-org-specific-system-schedulers.txt > /tmp/mint-org-specific-system-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-system-schedulers.txt
  2. Mulai ulang server pengelolaan.
OPDK-1878 Tidak dapat menetapkan nama Pod di beberapa penginstalan datacenter
Panduan penginstalan Edge menentukan untuk menetapkan nama Pod sebagai "gateway-1" dan "gateway-2" dalam file penginstalan senyap untuk beberapa penginstalan datacenter. Namun, mengganti nama Pod akan mencegah Router dan Message Processor didaftarkan dengan benar dan tidak dapat diakses. Masalah ini juga mencegah skrip setup-org.sh menemukan Message Processor yang tersedia.

Solusi untuk mengatasinya adalah menetapkan nama Pod, menggunakan properti MP_POD, ke "gateway" dalam file penginstalan senyap untuk kedua datacenter.
OPDK-1886

Node tidak dapat mengakses alamat IP lokal seperti 192.168.x.y
Anda melihat error "connect EINVAL" saat mencoba mengakses alamat IP lokal.
Solusi untuk mengatasinya adalah dengan mengedit file /<install_dir>/apigee4/conf/apigee/message-processor/nodejs.properties di node Message Processor untuk mengomentari baris berikut:

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 mengupgrade, semua node akan memerlukan akses ke port 8080 di Server Pengelolaan
Saat runtime, komponen berikut memerlukan akses ke port 8080 di Server Pengelolaan: Router, Message Processor, UI, Postgres, dan Qpid. Namun, saat mengupgrade, 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 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.