4.15.07.00 - Apigee Edge untuk catatan rilis Private Cloud

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

Sebelum mengupgrade, pastikan Anda telah mengupgrade Cassandra SSTable di setiap node Cassandra:
  1. Periksa versi Cassandra SSTable:
    1. Ubah direktori ke /<install-root>/apigee4/data/cassandra/data.
    2. Jalankan perintah find,
      > temukan . -name *-ic-*
      Hasilnya akan mengembalikan satu set file .db jika Anda menjalankan Cassandra 1.2 SSTable.
    3. 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.
  2. Jika Anda menemukan file *.db dalam format hf, upgrade SSTable dengan menjalankan perintah berikut pada setiap node Cassandra hingga Anda mengupgrade semua Cassandra node:
    &gt; {i>/<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost enhancedstables<i} "-a
  3. Ulangi Langkah 1 untuk memeriksa apakah semua file *.db memiliki format ic untuk Cassandra 1.2 .
  4. Ulangi Langkah 1 sampai 3 pada setiap node Cassandra dalam penginstalan Edge Anda.
  5. Upgrade ke Edge 4.15.07.00.
  6. Setelah upgrade 4.15.07.00, periksa file *.db untuk memastikan semuanya telah di-upgrade ke stabil gaya C* 2.0:
    &gt; cd /&lt;install-root&gt;/apigee4/data/cassandra/data
    &gt; 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 &gt; 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}.

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 menggantikan target.basepath.with.query.
  • TargetServer: loadbalancing.targetserver menggantikan targetserver.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 &gt; 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">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</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

  1. Update dan uji rilis 15.05.27 di lingkungan dev atau test Anda di Pantheon.
  2. 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.
  3. Tetapkan properti keamanan revisi model Anda. Di Konten > SmartDocs > model, pilih Setelan Keamanan.
  4. Periksa autentikasi yang telah dikonfigurasi sebelumnya di halaman setelan model (Konten > SmartDocs) dengan mengklik Setelan di bagian Operasi .
  5. 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.
  6. Render ulang dan publikasikan revisi model Anda.
  7. 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 &lt;ExcludeErrorResponse&gt; 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
Solusinya adalah dengan menjadikan baris IPV6 berikut sebagai komentar di /&lt;install-dir&gt;/apigee4/conf/nginx/conf.d/loadbalancer.conf untuk menjalankan API BaaS Portal, atau mengaktifkan dukungan IPV6:

# listen [::]:8080;

OPDK-1785

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

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}.

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

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:

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

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 &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Jalankan perintah berikut. Biarkan variabel {ORG_ID} sebagaimana 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 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 &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Jalankan perintah berikut. Biarkan variabel {ORG_ID} sebagaimana 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 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
Anda melihat error "hubungkan EINVAL" ketika mencoba mengakses alamat IP lokal.
Solusinya adalah mengedit properti /&lt;install_dir&gt;/apigee4/conf/apigee/message-processor/nodejs.properties pada node Pemroses Pesan untuk menjadikan baris berikut sebagai komentar:

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.