4.17.01 - Catatan rilis Edge untuk Private Cloud

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

Pada Rabu, 25 Januari 2017, kami merilis versi baru Apigee Edge untuk Private Cloud.

Sejak Rilis Fitur Edge untuk Private Cloud sebelumnya, rilis berikut telah terjadi dan disertakan dalam Rilis Fitur ini:

Lihat Tentang penomoran rilis untuk memahami cara mengetahui apakah rilis cloud tertentu disertakan dalam versi Edge untuk Private Cloud Anda.

Ringkasan rilis

Rilis ini mencakup sejumlah fitur penting yang membantu Anda mengontrol dan mengamankan API dengan lebih baik.

Alur Bersama dan Flow Hook memungkinkan Anda membuat serangkaian kebijakan dan perilaku yang dapat digunakan kembali di beberapa proxy API.

Peta nilai kunci (KVM), yang sudah menjadi fitur Edge untuk persistensi jangka panjang key-value pair, kini dapat dienkripsi untuk keamanan data yang lebih kuat.

Untuk kontrol yang lebih fleksibel atas akses developer ke API Anda, UI pengelolaan Edge menyediakan lebih banyak opsi untuk membuat dan mengelola kunci dan rahasia API (kredensial), mencabut aplikasi developer, dan menonaktifkan developer. Peningkatan ini memudahkan Anda menerapkan strategi seperti rotasi kunci API dan memungkinkan Anda menonaktifkan beberapa kunci API dengan mencabut aplikasi developer (semua kuncinya dinonaktifkan) atau menonaktifkan developer (semua aplikasi dan kunci developer dinonaktifkan).

Terkait penghentian, fitur Batas Monetisasi telah dihentikan.

Bagian selanjutnya dari topik ini berisi detail tentang semua fitur baru, update, dan perbaikan bug yang ada dalam rilis.

Penghentian penggunaan dan penghentian

Fitur berikut tidak digunakan lagi atau dihentikan dalam rilis ini. Lihat Kebijakan penghentian penggunaan Edge untuk mengetahui informasi selengkapnya.

Tidak digunakan lagi: Batas Monetisasi (UI Cloud 16.10.26)

Fitur Batas monetisasi telah dihapus dari UI pengelolaan (Admin > Batas). Lihat pemberitahuan penghentian penggunaan untuk mengetahui detail selengkapnya, termasuk apa yang harus digunakan sebagai gantinya: http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice. (DEVRT-3259)

Dukungan untuk RedHat/CentOS versi 6.5 dihapus

Jika saat ini Anda menggunakan RedHat/CentOS versi 6.5, Anda harus mengupdate sistem operasi ke versi 6.6 atau yang lebih baru sebelum mengupdate ke Edge 4.17.01.

Fitur dan info terbaru

Berikut adalah fitur dan peningkatan baru dalam rilis ini. Selain peningkatan berikut, rilis ini juga berisi beberapa peningkatan kegunaan, performa, keamanan, dan stabilitas.

Untuk mengetahui detail dan petunjuk lebih lanjut, lihat dokumentasi Edge for Private Cloud.

Cloud Pribadi

Anda dapat menampilkan banner izin saat pengguna pertama kali mengakses UI Edge. Banner izin menampilkan teks berformat HTML dan tombol yang dipilih pengguna untuk melanjutkan ke layar login. Lihat Mengaktifkan banner izin untuk mengetahui informasi selengkapnya.

API BaaS mendukung beberapa pusat data

Anda kini dapat menginstal API BaaS di beberapa pusat data. Lihat Penginstalan Multi-Pusat Data untuk API BaaS untuk mengetahui informasi selengkapnya.

Parameter konfigurasi penginstalan BaaS API baru

Dua parameter konfigurasi baru telah ditambahkan ke file konfigurasi API BaaS:

  • BAAS_CASS_DC_LIST - menentukan nama wilayah pusat data BaaS. Untuk satu pusat data, tentukan nilai yang sama dengan BAAS_CASS_LOCALDC.
  • BAAS_CLUSTER_SEEDS - menentukan node BaaS Stack yang digunakan untuk menentukan seed cluster BaaS.

Lihat Memperbarui Apigee Edge 4.16.09 ke 4.17.01 untuk mengetahui informasi selengkapnya.

Tidak lagi menjalankan opsi "deploy" dengan perintah apigee-service untuk API BaaS

Opsi deploy untuk perintah apigee-service tidak lagi didukung untuk API BaaS Stack dan Portal. Sebagai gantinya, Anda menggunakan opsi configure dan restart. Lihat Penginstalan BaaS API untuk mengetahui informasi selengkapnya.

Persyaratan port baru untuk API BaaS

Semua node BaaS Stack kini harus membuka port 2551 untuk akses dari semua node Stack lainnya. Jika Anda memiliki beberapa Pusat Data BaaS, port harus dapat diakses dari semua node Stack di semua Pusat Data.

Lihat Penginstalan BaaS API dan Persyaratan Penginstalan untuk mengetahui informasi selengkapnya.

Portal Layanan Developer kini menggunakan Postgres sebagai database dan Nginx sebagai server web-nya

Untuk semua penginstalan baru, portal menggunakan Postgres sebagai database, bukan MySQL dan MariaDB. Pelanggan yang mengupgrade ke 4.17.01 dari versi sebelumnya akan terus menggunakan MySQL atau MariaDB.

Penginstalan baru untuk 4.17.01 juga menginstal Nginx sebagai server web. Pelanggan yang mengupgrade ke 4.17.01 dari versi sebelumnya akan terus menggunakan Apache.

Portal Layanan Developer tidak lagi mengaktifkan SmartDocs secara default

Anda harus mengaktifkan SmartDocs di portal. Untuk mengetahui informasi selengkapnya tentang SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.

Portal Developer Services kini diinstal dari RPM

Portal Layanan Developer versi 4.17.01 diinstal dari RPM menggunakan repo dan alat yang sama dengan Edge dan API BaaS. Lihat Penginstalan portal Layanan Developer untuk mengetahui informasi selengkapnya.

Penginstal berbasis RPM dan pengupdate berbasis .tar menggunakan komponen yang berbeda:

Penginstalan berbasis RPM

Penginstalan berbasis.tar

Server web

Nginx

Apache

Root web

/opt/apigee/apigee-drupal

/var/www/html

Port

8079

80

Database

PostgreSQL

MySQL

PHP

php-fpm (FastCGI)

mod_php (dalam proses dengan Apache)

Qpid telah diupgrade ke versi 1.35

Rilis ini mencakup Qpid versi 1.35.

Cassandra diupgrade ke versi 2.1.16

Rilis ini mencakup Cassandra versi 2.1.16.

Play diupgrade ke versi 2.4

Rilis ini mencakup framework UI Play 2.4.

Menambahkan dukungan untuk RedHat/CentOS versi 7.3

Edge kini mendukung RedHat/CentOS versi 7.3.

Pembaruan pada Dasbor Pemantauan Beta

Dasbor Pemantauan Edge versi Beta telah diperbarui untuk:

  • Menyertakan dasbor baru untuk Cassandra, Zookeeper, OpenLDAP, Postgres, dan Qpid.
  • Mengupgrade versi Influx di 4.16.09 dari 0.11 ke 1.0.2.
  • Menambahkan sejumlah perbaikan stabilitas.

Lihat Ringkasan Beta Dasbor Monitoring Apigee untuk mengetahui informasi selengkapnya.

Sekarang dapat menetapkan sandi Postgres di file konfigurasi penginstalan

Gunakan properti PG_PWD untuk menyetel sandi Postgres di file konfigurasi penginstalan. Lihat Referensi File Konfigurasi Edge untuk mengetahui informasi selengkapnya.

Aktifkan repo EPEL

Anda harus mengaktifkan Extra Packages for Enterprise Linux (atau EPEL) untuk menginstal atau mengupdate Edge. Lihat Persyaratan Penginstalan untuk mengetahui informasi selengkapnya.

Perintah yang Anda gunakan bergantung pada versi RedHat/CentOS Anda:

  • Untuk RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Untuk RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Menonaktifkan pencarian DNS di IPv6 saat menggunakan NSCD (Name Service Cache Daemon)

Jika Anda telah menginstal dan mengaktifkan NSCD (Name Service Cache Daemon), Pemroses Pesan akan melakukan dua pencarian DNS: satu untuk IPv4 dan satu untuk IPv6. Anda harus menonaktifkan pencarian DNS di IPv6 saat menggunakan NSCD. Lihat Persyaratan Penginstalan untuk mengetahui informasi selengkapnya.

Untuk menonaktifkan pencarian DNS di IPv6:

  1. Di setiap node Message Processor, edit /etc/nscd.conf.
  2. Tetapkan properti berikut:
    enable-cache hosts no

Layanan API

Alur Bersama dan Hook Alur untuk mengoperasikan proxy API (Cloud 16.09.21)

Fitur "Alur Bersama" baru memungkinkan Anda mengoperasikan fungsi di proxy API. Dengan menggabungkan kebijakan dan resource bersyarat ke dalam Alur Bersama, Anda dapat mereferensikannya dari proxy API mana pun untuk menjalankan logika yang dapat digunakan kembali dan bersumber tunggal. Misalnya, Alur Bersama dapat memverifikasi kunci API, melindungi dari penangkapan lonjakan, dan mencatat data.

Anda menentukan Alur Bersama di UI pengelolaan (APIs > Shared Flows), lalu mereferensikannya dengan dua cara berbeda:

  • Dengan kebijakan Panggilan Alur baru di proxy API
    atau

  • Pada artefak baru bernama Flow Hooks, yang berada di lokasi berikut:

    Titik lampiran ini memungkinkan Anda menjalankan logika operasional sebelum atau setelah titik alur utama setiap proxy. Anda menetapkan Alur Bersama ke lokasi Flow Hook ini di UI pengelolaan (APIs > Environment Configuration > Flow Hooks).

    • Request: Sebelum ProxyEndpoint PreFlow, setelah TargetEndpoint PostFlow
    • Respons: Sebelum TargetEndpoint PreFlow, setelah ProxyEndpoint PostFlow

Untuk mengetahui informasi selengkapnya, lihat Alur bersama yang dapat digunakan kembali dan Melampirkan alur bersama menggunakan hook alur.

Peta nilai kunci terenkripsi (Cloud 16.09.21)

Anda dapat membuat peta nilai kunci (KVM) terenkripsi untuk menyimpan informasi sensitif seperti kredensial atau data PII/HIPAA. Fitur ini berbeda dengan penyimpanan aman Edge (vault) yang ada dan dirancang untuk menggantikannya, karena nilai vault hanya dapat diakses dengan Node.js (selain Management API). Anda dapat mengakses nilai KVM terenkripsi dengan Node.js atau kebijakan Operasi Peta Nilai Kunci.

Membuat KVM terenkripsi

  • Gunakan API pengelolaan KVM yang sudah ada. Saat Anda menyertakan “encrypted”: “true” dalam definisi payload saat membuat KVM, Edge akan membuat kunci enkripsi yang memiliki cakupan yang sama dengan KVM dan mengenkripsi KVM menggunakan kunci tersebut.
  • Anda tidak dapat menggunakan kebijakan Operasi Peta Nilai Kunci untuk membuat KVM terenkripsi. Anda harus membuat KVM terenkripsi menggunakan KVM Management API sebelum menggunakannya dalam kebijakan.
  • Anda tidak dapat mengenkripsi KVM yang tidak dienkripsi yang sudah ada.

Menggunakan KVM terenkripsi

  • Gunakan kebijakan Operasi Peta Nilai Kunci untuk mendapatkan dan memperbarui nilai KVM terenkripsi.
  • Saat mendapatkan nilai kunci terenkripsi, beri awalan pada variabel untuk menyimpan nilai dengan kata kunci "private". Misalnya: <Get assignTo="private.secretVar">. Variabel private.secretVar tersebut menyimpan nilai yang didekripsi.
  • Saat memperbarui nilai dengan kebijakan, Anda tidak perlu melakukan hal khusus. Nilai akan dienkripsi secara otomatis di KVM terenkripsi.
  • Anda juga dapat mengakses nilai yang didekripsi menggunakan modul apigee-access dalam kode Node.js. Gunakan fungsi getKeyValueMap() untuk mengambil KVM berdasarkan nama dan cakupan. Dua fungsi tersedia di objek yang ditampilkan: getKeys(callback) untuk mendapatkan array nama kunci dan get(key, callback) untuk mendapatkan nilai untuk kunci tertentu. Misalnya, kode berikut mendapatkan KVM cakupan apiproxy yang disebut VerySecureKVM dan mengambil nilai terenkripsi dari key1: 
    var apigee = require('apigee-access');
  var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
  encryptedKVM.get('key1', function(err, secretValue) {
  // use the secret value here
});

Untuk mengetahui informasi selengkapnya, lihat Bekerja dengan peta nilai kunci dan Mengakses peta nilai kunci di Node.js.

(APIRT-1197)

Membuat peta nilai kunci terenkripsi di UI (UI 16.10.26)

Saat membuat peta nilai kunci (KVM) yang tercakup dalam lingkungan di UI pengelolaan (APIs > Environment Configuration > Key Value Maps), kotak centang Encrypted baru memungkinkan Anda membuat KVM terenkripsi. Setelah Anda menambahkan kunci ke KVM, nilai terenkripsi akan muncul di UI pengelolaan sebagai tanda bintang (*****). Anda menambahkan kunci/nilai ke KVM terenkripsi persis seperti yang Anda lakukan untuk KVM yang tidak terenkripsi. Dukungan backend penuh untuk KVM terenkripsi tersedia di rilis cloud 160921. (EDGEUI-764)

URL Spesifikasi OpenAPI yang disertakan dalam metadata proxy API (Cloud 16.09.21)

Saat Anda membuat proxy API berdasarkan Spesifikasi OpenAPI, lokasi Spesifikasi OpenAPI disimpan dalam metadata proxy API. Misalnya, jika Anda menggunakan API pengelolaan untuk mendapatkan detail revisi proxy, metadata mencakup jalur ke Spesifikasi OpenAPI dalam format berikut:

"spec" : "https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"

Peningkatan ini mendukung Edge versi generasi berikutnya, yang menautkan Spesifikasi OpenAPI ke proxy API, produk API, dan dokumen referensi API di portal developer baru. (MGMT-2913)

Pembuatan Spesifikasi OpenAPI untuk proxy SOAP (UI Cloud 16.10.05)

Saat Anda membuat proxy "REST ke SOAP ke REST" berdasarkan WSDL, Edge akan otomatis membuat Spesifikasi OpenAPI yang dihosting berdasarkan resource proxy. Anda dapat mengakses spesifikasi di http(s)://[edge_domain]/[proxy_base_path]/openapi.json. Namun, konversi tidak selalu akurat, karena tidak semua aturan skema XML dapat ditampilkan dalam Spesifikasi OpenAPI. (EDGEUI-718)

WSDL yang dihosting di Edge untuk proxy SOAP passthrough (UI Cloud 16.10.05)

Saat Anda membuat proxy "Pass-Through SOAP" berdasarkan WSDL, Edge akan menghosting WSDL dan membuat alur di proxy agar Anda dapat mengaksesnya. Anda dapat mengakses WSDL yang dihosting di http(s)://[edge_domain]/[proxy_base_path]?wsdl, yang merupakan URL endpoint layanan baru untuk klien yang memanggil layanan SOAP melalui proxy. (EDGEUI-718)

WSDL kutipan saham contoh baru di wizard proxy API (Cloud 16.08.24.01)

Saat membuat SOAP service API dengan wizard proxy API, WSDL kutipan saham pengganti tersedia di contoh: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL. (EDGEUI-655)

Layanan Developer

Kualitas pengelolaan aplikasi developer di UI (UI Cloud 16.10.05)

Pengelolaan aplikasi developer di UI Edge menjadi lebih canggih dengan sejumlah peningkatan:

  • Anda dapat mencabut dan menyetujui aplikasi (dalam mode edit) di kolom "Status Aplikasi" yang baru. Dalam mode tampilan, kolom juga menampilkan status aplikasi saat ini. Jika akses aplikasi dicabut, tidak ada kunci API-nya yang valid untuk panggilan API. Kunci itu sendiri tidak dicabut dan tersedia lagi untuk digunakan jika developer disetujui kembali. Label "Disetujui" untuk kunci API ditampilkan dalam teks yang dicoret saat aplikasi dalam status dicabut.
  • Tanggal habis masa berlaku kunci API kini ditampilkan di halaman Detail Aplikasi Developer, dan kunci diatur menurut tanggal habis masa berlakunya di bagian "Kredensial". Misalnya, kunci tanpa masa berlaku ditampilkan dalam satu grup dengan produk API terkaitnya, dan kunci yang akan berakhir dalam 90 hari ditampilkan dalam grup lain dengan produk terkaitnya. Anda tidak dapat mengubah masa berlaku kredensial yang ada.
  • Dengan tombol Tambahkan kredensial baru dalam mode edit Aplikasi Developer, Anda dapat membuat kunci API dengan waktu atau tanggal habis masa berlaku tertentu (atau tanpa habis masa berlaku). Saat (atau setelah) membuat kredensial, Anda dapat menambahkan produk API ke kredensial tersebut.
    Fungsi ini menggantikan tombol "Buat Ulang Kunci" di halaman Detail Aplikasi Developer. Tombol tersebut telah dihapus.

Peningkatan ini menambahkan fitur di UI yang sudah tersedia di Management API. (EDGEUI-104)

Mengaktifkan/Menonaktifkan developer aplikasi di UI (UI Cloud 16.10.05)

Anda dapat mengubah status developer aplikasi antara aktif dan nonaktif di UI Edge (halaman Detail Developer, mode edit, tombol Aktifkan/Nonaktifkan). Jika developer tidak aktif, tidak ada kunci API aplikasi developer atau token OAuth yang dibuat dengan kunci tersebut yang valid dalam panggilan ke proxy API. (EDGEUI-304)

Indikator developer tidak aktif di UI (UI 26.10.16)

Jika developer aplikasi ditetapkan ke "Tidak aktif", aplikasi dan kredensial developer tidak lagi valid meskipun tetap dalam status "Disetujui". Sekarang, saat melihat aplikasi dan kredensial developer yang tidak aktif di UI pengelolaan, label status "Disetujui" pada aplikasi dan kredensial ditampilkan dalam teks yang dicoret, dan tooltip saat kursor diarahkan ke label menunjukkan bahwa developer tidak aktif. Jika developer dipulihkan ke "Aktif", aplikasi dan kredensialnya yang disetujui akan valid kembali, dan teks yang dicoret pada label "Disetujui" akan dihapus. (EDGEUI-728)

Layanan Analytics

Mengganti nama dasbor "Analisis Kode Error" (UI 26.10.16)

Dasbor "Analisis Error" telah berganti nama menjadi "Analisis Kode Error". Dasbor mencakup panggilan API dengan kode status HTTP 4xx dan 5xx. (EDGEUI-738)

Data TPS di dasbor proxy (UI 26.10.16)

Data untuk transaksi rata-rata per detik ("TPS Rata-Rata") telah ditambahkan ke dasbor Traffic Proxy utama. Selain itu, saat Anda mengarahkan kursor ke masing-masing titik data pada diagram Traffic Proxy dan Performa Proxy, TPS untuk interval waktu tersebut akan ditampilkan di tooltip. (EDGEUI-668)

Tampilan error Analytics (UI 26.10.16)

Saat dasbor analisis menerima error 500, UI pengelolaan akan menampilkan "Waktu tunggu laporan habis" terlepas dari errornya. Untuk memberikan kemampuan pemecahan masalah yang lebih baik, UI kini menampilkan error sebenarnya. (EDGEUI-753)

Bug yang diperbaiki

Bug berikut telah diperbaiki dalam rilis ini. Daftar ini terutama ditujukan bagi pengguna yang memeriksa apakah tiket dukungan mereka telah diselesaikan. Fitur ini tidak dirancang untuk memberikan informasi mendetail bagi semua pengguna.

Edge for Private Cloud 4.17.01

ID Masalah Deskripsi
APIBAAS-1990 Stack BaaS API tidak lagi mencoba melakukan autentikasi ke SMTP saat smtp.auth adalah false
APIRT-3032

Menjalankan perintah "apigee-service baas-usergrid restart" sekarang juga menjalankan "configure"

Anda tidak perlu lagi menjalankan "apigee-service baas-usergrid configure" yang diikuti dengan "apigee-service baas-usergrid restart" untuk BaaS Stack.

APIRT-3032

Jangan lakukan pencarian DNS jika nama host adalah alamat IP.
DOS-4070

"apigee-all -version" kini menampilkan versi RPM edge-mint-*
DOS-4359

Menambahkan opsi "pdb" untuk menginstal database Postgres saja.

Hanya digunakan saat menginstal portal Developer Services. Lihat Penginstalan portal Layanan Developer.

Cloud 16.10.26 (UI)

ID Masalah Deskripsi
EDGEUI-768 Pembuatan proxy dengan StockQuote WSDL gagal

Cloud 16.09.21_9

ID Masalah Deskripsi
MGMT-3674 Tidak dapat membuat KVM atau Vault terenkripsi untuk organisasi yang mendukung HIPAA
MGMT-3647 Akses userrole untuk pengguna dengan email yang Ditulis dengan Huruf Kapital menampilkan error 403

Cloud 16.09.21

ID Masalah Deskripsi
APIRT-3507 Error berselang-seling (seperti error SNI) pada layanan JavaScript callout
APIRT-3408 MP release 160817 apigee-access analytics module processing messages differently
APIRT-3390

Perubahan respons error yang ditampilkan oleh kebijakan token akses refresh
APIRT-3389
APIRT-3381 Latensi tinggi pada proxy produksi pelanggan
APIRT-3366 Kebijakan JavaScript gagal di semua organisasi uji coba baru
APIRT-3363 Penguraian URL yang tidak valid menampilkan status 500 dengan ApplicationNotFound
APIRT-3356 Pesan token OAuth tidak valid
APIRT-3355 Error 403 sesekali pada proxy OAuth
APIRT-3285
APIRT-3261 Kredensial divalidasi terhadap aplikasi developer lain dalam produksi
APIRT-3234 Aplikasi Node.js menampilkan NPE
APIRT-3223 Masalah cache usang Apigee
APIRT-3193 Server target Node.js mengalami error setelah dipindahkan ke ASG
APIRT-3152 panggilan pengelolaan cachedlogs menyebabkan pesan log terpecah
APIRT-3117 MP mencapai penggunaan CPU 100% dan berhenti menyajikan traffic
APIRT-3064 Router - pesan error 503 kustom dari router
APIRT-2620 Kumpulan thread terpisah untuk beberapa langkah pemblokiran guna meningkatkan penanganan beban
CORESERV-774 Akses menggunakan kunci yang valid dengan referensi apiproduct yang tidak valid menyebabkan error server internal

Cloud 16.10.05 (UI)

ID Masalah Deskripsi
EDGEUI-697 Tombol ekspor halaman laporan
Tombol Ekspor telah dihapus dari halaman beranda Laporan Kustom. Ekspor laporan tersedia di setiap halaman laporan kustom.

Cloud 16.08.24.01

ID Masalah Deskripsi
EDGEUI-663 Proxy yang dibuat untuk port WeatherHttpGet Weather.wsdl gagal saat runtime dengan error 500
Saat membuat proxy API untuk layanan SOAP, port WSDL tanpa binding protokol SOAP tidak lagi terlihat di wizard proxy API. Hal ini sudah didesain seperti itu, karena wizard hanya membuat permintaan SOAP.
EDGEUI-658 Masalah nama operasi passthrough WSDL SOAP
EDGEUI-653 Error saat membuat Proxy API node.js ketika opsi Enable Cors dipilih
EDGEUI-648 Panggilan Dari UI yang berlangsung antara 2 dan 3 menit akan mengalami waktu tunggu
EDGEUI-623 Tombol Ubah tanggal histori organisasi tidak berfungsi di Firefox
Sebelumnya
4.17.01.01
Berikutnya
4.16.09.04