4.15.04.00 - Apigee Edge untuk catatan rilis Private Cloud

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

Pada hari Selasa, 19 Mei 2015, kami merilis versi triwulanan Apigee Edge untuk Private Cloud.

Nama produk sebelumnya "Apigee Edge On-stead" atau "OPDK" kini menjadi "Apigee Edge for Private Cloud".

Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.

Untuk mengetahui daftar semua catatan rilis Apigee Edge, lihat Catatan Rilis Apigee.

Fitur dan peningkatan baru

Berikut adalah sejumlah fitur dan peningkatan baru dalam rilis ini.

OpenLDAP - penginstalan dan upgrade

OpenLDAP kini menjadi satu-satunya server LDAP yang didukung oleh Edge untuk penginstalan baru dan upgrade.

Layanan API

Berikut adalah fitur dan peningkatan baru di Layanan Edge API.

WebSockets

Untuk mengaktifkan komunikasi web real-time antara klien web dan server, Edge mendukung protokol WebSocket. Edge dapat berperan sebagai klien atau server dalam komunikasi WebSocket. Untuk mengetahui informasi tentang cara menyiapkan dan menggunakan WebSockets di Edge, lihat panduan Apigee Edge untuk Private Cloud Menggunakan WebSockets.

Dukungan penyedia autentikasi eksternal untuk pengelolaan API

Edge terintegrasi dengan Active Directory dan sistem LDAP/penyedia autentikasi eksternal lainnya yang berisi pengguna administratif API Anda. Untuk mengetahui informasi selengkapnya, lihat panduan Edge untuk Konfigurasi Autentikasi Eksternal Edge.

Co-branding di UI pengelolaan

Anda dapat memberi brand bersama UI pengelolaan Edge dengan logo kustom Anda sendiri, yang muncul di samping logo Apigee. Untuk informasi selengkapnya, lihat "Menambahkan logo kustom ke menu UI Apigee" di Panduan Operasi Apigee Edge untuk Private Cloud.

Log Node.js di Rekaman Aktivitas

Saat men-debug proxy Node.js API, Anda dapat mengaktifkan fitur Log Node.js di tampilan Trace editor proxy API. Untuk mengaktifkan fitur ini, tetapkan apigee.feature.disableNodeJSLogs="false" dalam file apigee-base.conf atau apigee-onpreorder.conf dalam penginstalan. Untuk informasi selengkapnya tentang Log Node.js, lihat Proses debug dan pemecahan masalah proxy Node.js.

Akhir masa berlaku sandi

Di Edge 4.15.01.x, sandi Edge otomatis habis masa berlakunya setelah 30 hari. Artinya, pengguna tidak dapat mengakses akun kecuali jika mereka mengubah sandinya sebelum masa berlaku sandi berakhir. Namun, hal ini juga menyebabkan masa berlaku sandi administrator sistem berakhir sehingga admin sistem tidak dapat mengakses Edge.

Saat Anda meningkatkan versi ke 4.15.04.00, {i>default<i} berubah sehingga kata sandi tidak kedaluwarsa. Jika perlu, Anda dapat mengonfigurasi sandi Edge agar masa berlakunya berakhir menggunakan skrip /opt/apigee4/bin/apigee-enable-pwlockout.sh. Untuk mengetahui informasi selengkapnya, lihat Panduan Operasi Apigee Edge untuk Private Cloud.

Membatasi akses sysadmin ke domain email tertentu

Anda dapat membatasi keanggotaan peran hanya baca sysadmin atau sysadmin ke pengguna di domain email tertentu. Untuk mengaktifkan fitur ini, tambahkan domain yang diizinkan ke file apigee4/conf/apigee/management-server/security.properties, seperti yang dijelaskan dalam Panduan Operasi Apigee Edge untuk Private Cloud.

Pesan error UI pengelolaan

Tampilan pesan error di UI pengelolaan telah didesain ulang untuk menggunakan ruang layar dengan lebih efisien.

Variabel kesalahan OAuthV2 baru

Variabel baru terkait kesalahan ini ditetapkan oleh kebijakan OAuthV2:

  • oauthV2.<policy-name>.failed - Setel ke true jika kebijakan gagal.
  • oauthv2.<policy_name>.<fault_name> - Nama kesalahan. Misalnya, invalid_request
  • oauthv2.<policy_name>.<fault_cause> - Alasan kesalahan. Misalnya: Token Kedaluwarsa

Lihat http://apigee.com/docs/api-services/content/oauthv2-policy.

Pembuatan produk

Saat membuat produk baru, Anda kini dapat menentukan nama produk selain nama tampilan.

Lihat http://apigee.com/docs/developer-services/content/creating-api-products.

UI untuk menghapus pengguna dari organisasi

Pada halaman Organization Users di UI, tombol Delete diganti dengan tombol Remove. Hal ini untuk membantu memperjelas bahwa saat Anda menghapus pengguna dari organisasi, akun Apigee pengguna tersebut tetap aktif.

Lihat http://apigee.com/docs/api-services/content/managing-organization-users.

Opsi pemfilteran di UI pengelolaan

Di halaman Proxy API, Produk, Developer, dan Aplikasi di UI pengelolaan, opsi pemfilteran baru tersedia untuk penelusuran.

Alat Pelacakan Offline

Alat Pelacakan Offline memungkinkan Anda melihat dan menganalisis sesi pelacakan yang telah disimpan sebelumnya. Sesi pelacakan yang tersimpan pada dasarnya adalah "perekaman" sesi pelacakan, dan dapat berguna untuk kasus yang memerlukan pemecahan masalah dan analisis lebih lanjut. UI untuk alat Pelacakan Offline mirip dengan alat Rekaman Aktivitas "aktif".

Untuk informasi selengkapnya, lihat Menggunakan alat Pelacakan Offline.

Peran pengguna yang ditampilkan di Setelan Pengguna

Di halaman Setelan Pengguna pada UI pengelolaan (nama pengguna > Setelan Pengguna), peran pengguna kini ditampilkan.

Penyempurnaan UI pengelolaan edge

Rilis ini mencakup sejumlah peningkatan kegunaan dan konsistensi kecil di UI pengelolaan Edge.

Layanan Analytics

Berikut adalah fitur dan peningkatan baru di Layanan Analisis Edge.

Data tersedia selama enam bulan

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.

Variabel ditambahkan ke analisis

Variabel baru berikut diteruskan ke analisis Edge, yang terlihat di tahap AX di jendela rekaman aktivitas proxy API.

  • apigee.edge.execution.is_target_error - Memungkinkan Anda mengidentifikasi apakah error API merupakan error sisi target (nilai "1") atau error bukan target untuk respons HTTP yang gagal (nilai "0"). Nilainya null untuk respons HTTP yang berhasil.
  • apigee.edge.execution.is_policy_error - Memungkinkan Anda mengidentifikasi apakah kebijakan gagal (nilai "1") atau tidak ada kebijakan yang gagal dalam respons HTTP yang gagal (nilai "0"). Nilainya null untuk respons HTTP yang berhasil.
    Variabel terkait berikut memberikan detail kebijakan yang gagal terlebih dahulu. Nilainya akan null jika tidak ada kebijakan yang gagal.
    • apigee.edge.execution.fault_policy_name - Nama kebijakan yang gagal.
    • apigee.edge.execution.fault_flow_name - Nama alur dalam kebijakan yang gagal (seperti PreFlow, PostFlow, atau alur yang ditentukan pengguna).
    • apigee.edge.execution.fault_flow_state - Lokasi tempat kebijakan dilampirkan dalam alur. Nilai yang mungkin: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.

Dasbor

  • Diagram performa untuk aplikasi API, Developer, Produk, dan Developer telah dipindahkan. Sebelumnya ditampilkan di bagian bawah halaman utama entitas ini. Sekarang, Anda dapat mengakses diagram dengan memilih tab Analytics di bagian atas setiap halaman.
  • Rilis ini mencakup pekerjaan besar pada dasbor yang ada atau baru:
    • Dasbor Apigee (Direvisi): Mencakup tiga diagram metrik: Traffic Proxy, Engagement Developer, dan Aplikasi Developer. Setiap diagram memberikan tampilan "detail selengkapnya" yang memungkinkan Anda melihat perincian setiap metrik. Lihat Dasbor Apigee.
    • Performa Proxy (Baru): Menampilkan pola traffic proxy API dan waktu pemrosesan. Mengganti dasbor Performa Proxy API. Lihat Performa Proxy API.
    • Komposisi Traffic (Direvisi): Tampilan dan nuansa serta konten dasbor yang sepenuhnya direvisi. Mengukur kontribusi relatif dari API, aplikasi, developer, dan produk teratas Anda terhadap program API secara keseluruhan. Lihat Komposisi traffic.
    • Error Analysis (Direvisi): Revisi tampilan dan nuansa serta konten sepenuhnya. Menampilkan tingkat error untuk proxy dan target API. Lihat Dasbor Analisis Kode Error.
  • Dasbor yang ada ini telah diganti namanya:
    • Endpoint Performance diganti namanya menjadi Target Performance: Menampilkan pola traffic dan metrik performa untuk target backend proxy API. Lihat Target performa.
    • Partner Engagement diganti namanya menjadi Developer Engagement: Menunjukkan developer aplikasi terdaftar Anda yang menghasilkan traffic API paling banyak. Untuk setiap developer, Anda dapat mengetahui siapa yang menghasilkan traffic API terbanyak dan error terbanyak. Lihat Engagement developer.

Layanan Developer

Berikut adalah fitur dan peningkatan baru di Layanan Developer Edge.

Dukungan Swagger 2.0 untuk SmartDocs

SmartDocs mendukung pengimporan dokumen spesifikasi Swagger 2.0 dan mempertahankan kompatibilitas mundur dengan Swagger 1.2. Dukungan untuk objek skema keamanan dan skema terpusat akan tersedia di rilis selanjutnya.

Monetisasi

Berikut adalah sejumlah fitur dan peningkatan baru dalam monetisasi Edge. Lihat juga bagian "Masalah umum" untuk mengetahui informasi lebih lanjut tentang monetisasi.

Penanganan yang terpisah untuk Perusahaan dan Developer

Perusahaan dan developer kini ditangani secara terpisah, sehingga lebih fleksibel dalam menambahkan beberapa perusahaan ke developer dan beberapa developer ke perusahaan. UI pengelolaan kini menyediakan jendela terpisah untuk "Perusahaan" dan "Developer" (dapat diakses dari menu "Publikasikan").

Lihat Mengelola perusahaan dan developer.

Dalam laporan monetisasi, perusahaan tetap menjadi filter utama, meskipun label filter telah diubah dari "Developer" menjadi "Perusahaan".

Bug telah diperbaiki

Bug berikut telah diperbaiki dalam rilis ini.

ID Masalah Deskripsi
OPDK-954 4.15.01 Skema Cassandra tidak diupgrade
MGMT-1986 Error UI saat menambahkan developer
MGMT-1983 Mendapatkan API kode otorisasi OAuth 2.0 menampilkan status yang salah
MGMT-1962 Terjadi error saat login ke UI pengelolaan dengan sandi kuat
Login ke UI dengan karakter khusus tertentu, seperti tanda persen, tidak lagi gagal.
MGMT-1894 Halaman Aplikasi Developer tidak pernah selesai memuat kolom developer
MGMT-1872 Tidak dapat mendownload laporan kustom
MGMT-1777 Tidak dapat menambahkan pengguna dengan alamat email yang memiliki TLD .acn
MGMT-1362 Email Lupa Sandi tidak berfungsi jika Alamat email berisi '_'
Memperbaiki masalah reset sandi di Private Cloud dengan alamat email yang memiliki garis bawah.
CORERT-613 Kegagalan handshake SSL karena "unrecognized_name"
APIRT-1346 OAuth2.0 - Nilai yang di-hash ditampilkan dalam respons token akses jika hash.oauth.tokens.enabled bernilai benar

Rilis ini juga berisi perbaikan bug dari rilis berikut:

Cloud Edge Edge untuk Private Cloud

Masalah umum

Rilis ini memiliki masalah umum berikut.

ID Masalah Deskripsi
T/A

Dua skrip Cassandra, yang digunakan penginstal dalam penginstalan atau upgrade monetisasi, tidak disertakan dalam rilis.

Untuk mengatasi hal ini, jalankan perintah berikut setelah penginstalan atau upgrade Cassandra untuk menyelesaikan penginstalan/upgrade monetisasi:

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318 Panggilan API dengan payload besar (100 KB) terkadang dapat mengalami hang. Untuk mengatasi masalah ini, tetapkan nilai properti berikut di file router.properties Anda:
HTTPServer.streaming.buffer.limit=0 (setelan default adalah 10)