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-premise" atau "OPDK" sekarang menjadi "Apigee Edge for Private Cloud".
Jika ada pertanyaan, hubungi Dukungan Apigee Edge.
Untuk mengetahui daftar semua catatan rilis Apigee Edge, lihat Catatan Rilis Apigee.
Fitur dan peningkatan baru
Berikut adalah 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 API Edge.
WebSockets
Untuk mengaktifkan komunikasi web real-time antara klien dan server web, 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 for 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 Konfigurasi Autentikasi Eksternal Edge for Private Cloud.
Kerja sama merek di UI pengelolaan
Anda dapat melakukan branding bersama UI pengelolaan Edge dengan logo kustom Anda sendiri, yang muncul di samping logo Apigee. Untuk mengetahui informasi selengkapnya, lihat "Menambahkan logo kustom ke menu UI Apigee" di Panduan Operasi Apigee Edge untuk Private Cloud.
Log Node.js di Trace
Saat men-debug proxy API Node.js, Anda dapat mengaktifkan fitur Log Node.js di tampilan Trace editor proxy API. Untuk mengaktifkan fitur ini, tetapkan
apigee.feature.disableNodeJSLogs="false" di file apigee-base.conf atau
apigee-onpremise.conf dalam penginstalan Anda. Untuk mengetahui informasi selengkapnya tentang Log Node.js, lihat
Men-debug dan memecahkan masalah
proxy Node.js.
Akhir masa berlaku sandi
Di Edge 4.15.01.x, sandi Edge otomatis berakhir setelah 30 hari. Hal ini berarti pengguna akan terkunci kecuali mereka mengubah sandi sebelum masa berlakunya berakhir. Namun, hal ini juga menyebabkan sandi administrator sistem berakhir sehingga admin sistem tidak dapat mengakses Edge.
Saat Anda mengupgrade ke 4.15.04.00, default akan berubah sehingga sandi tidak akan habis masa berlakunya. Jika
perlu, Anda dapat mengonfigurasi masa berlaku sandi Edge menggunakan
skrip /opt/apigee4/bin/apigee-enable-pwlockout.sh. Untuk mengetahui informasi selengkapnya, lihat
Panduan Operasi Apigee Edge untuk Private Cloud.
Membatasi akses admin sistem ke domain email tertentu
Anda dapat membatasi keanggotaan dalam peran sysadmin atau hanya baca sysadmin untuk 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 agar penggunaan ruang layar lebih efisien.
Variabel kesalahan OAuthV2 baru
Variabel baru terkait kesalahan ini ditetapkan oleh kebijakan OAuthV2:
- oauthV2.<policy-name>.failed - Disetel ke benar (true) jika kebijakan gagal.
- oauthv2.<policy_name>.<fault_name> - Nama kesalahan. Misalnya, invalid_request
- oauthv2.<policy_name>.<fault_cause> - Alasan kesalahan. Misalnya: Masa Berlaku Token Berakhir
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
Di halaman Pengguna Organisasi di UI, tombol Hapus diganti dengan tombol Hapus. Hal ini dilakukan untuk 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 API Proxies, Products, Developers, dan Apps di UI pengelolaan, opsi pemfilteran baru tersedia untuk penelusuran.
Alat Offline Trace
Alat Offline Trace memungkinkan Anda melihat dan menganalisis sesi rekaman aktivitas yang sebelumnya disimpan. Sesi rekaman aktivitas yang disimpan pada dasarnya adalah "rekaman" sesi rekaman aktivitas, dan dapat berguna untuk kasus saat pemecahan masalah dan analisis lebih lanjut diperlukan. UI untuk alat Offline Trace mirip dengan alat Trace "live".
Untuk mengetahui informasi selengkapnya, lihat Menggunakan alat Offline Trace.
Peran pengguna yang ditampilkan di Setelan Pengguna
Di halaman Setelan Pengguna pada UI pengelolaan (nama pengguna > Setelan Pengguna), peran pengguna kini ditampilkan.
Peningkatan UI pengelolaan edge
Rilis ini mencakup sejumlah peningkatan kecil pada kegunaan dan konsistensi di UI pengelolaan Edge.
Layanan Analytics
Berikut adalah fitur dan peningkatan baru di Edge Analytics Services.
Data enam bulan tersedia
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 Edge.
Variabel ditambahkan ke analisis
Variabel baru berikut diteruskan ke analisis Edge, yang terlihat di tahap AX pada jendela rekaman aktivitas proxy API.
- apigee.edge.execution.is_target_error - Memungkinkan Anda mengidentifikasi apakah error API adalah error sisi target (nilai "1") atau error non-target untuk respons HTTP yang tidak berhasil (nilai "0"). Nilainya adalah 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 tidak berhasil (nilai "0"). Nilai
adalah null untuk respons HTTP yang berhasil.
Variabel terkait berikut memberikan detail kebijakan yang pertama kali gagal. Nilainya adalah 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 API, Developer, Produk, dan Aplikasi developer telah dipindahkan. Sebelumnya, info ini ditampilkan di bagian bawah halaman utama untuk entitas ini. Sekarang, Anda dapat mengakses diagram dengan memilih tab Analytics di bagian atas setiap halaman.
- Rilis ini mencakup pekerjaan utama pada dasbor yang sudah ada atau baru berikut:
- Dasbor Apigee (Direvisi): Mencakup tiga diagram metrik: Traffic Proxy, Engagement Developer, dan Aplikasi Developer. Setiap diagram menyediakan tampilan "detail selengkapnya" yang memungkinkan Anda melihat perincian setiap metrik. Lihat dasbor Apigee.
- Performa Proxy (Baru): Menampilkan pola traffic proxy API dan waktu pemrosesan. Menggantikan 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 terhadap keseluruhan program API Anda. Lihat Komposisi traffic.
- Analisis Error (Direvisi): Tampilan dan nuansa serta konten yang sepenuhnya direvisi. Menampilkan tingkat error untuk proxy dan target API. Lihat Dasbor Analisis Kode Error.
-
Dasbor yang ada ini telah diganti namanya:
- Performa Endpoint diganti namanya menjadi Performa Target: Menampilkan pola traffic dan metrik performa untuk target backend proxy API. Lihat Target performa.
- Engagement Partner diganti namanya menjadi Engagement Developer: Menunjukkan developer aplikasi terdaftar mana yang menghasilkan traffic API terbanyak. Untuk setiap developer, Anda dapat mengetahui siapa yang menghasilkan traffic API dan error terbanyak. Lihat Interaksi developer.
Layanan Developer
Berikut adalah fitur dan peningkatan baru di Edge Developer Services.
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 fitur dan peningkatan baru dalam monetisasi Edge. Lihat juga bagian "Masalah umum" untuk mengetahui informasi selengkapnya tentang monetisasi.
Penanganan terpisah untuk Perusahaan dan Developer
Perusahaan dan developer kini ditangani secara terpisah, sehingga memungkinkan fleksibilitas yang lebih besar 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 berubah dari "Developer" menjadi "Perusahaan".
Bug yang diperbaiki
Bug berikut telah diperbaiki dalam rilis ini.
| ID Masalah | Deskripsi |
|---|---|
| OPDK-954 | Skema Cassandra 4.15.01 tidak diupgrade |
| MGMT-1986 | Error UI saat menambahkan developer |
| MGMT-1983 | API untuk mendapatkan kode otorisasi OAuth 2.0 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-1894 | Halaman Aplikasi Developer tidak pernah selesai dimuat untuk 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 berisi garis bawah. |
| CORERT-613 | Kegagalan handshake SSL karena "unrecognized_name" |
| APIRT-1346 | OAuth2.0 - Nilai yang di-hash ditampilkan dalam respons token akses saat hash.oauth.tokens.enabled bernilai benar |
Rilis ini juga berisi perbaikan bug dari rilis berikut:
| Edge Cloud | 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 masalah ini, jalankan perintah berikut setelah penginstalan atau upgrade Cassandra untuk menyelesaikan penginstalan/upgrade monetisasi:
|
| CORERT-318 | Panggilan API dengan payload besar (ratusan KB) terkadang dapat terhenti. Untuk mengatasi masalah ini, tetapkan nilai properti berikut dalam file router.properties Anda:HTTPServer.streaming.buffer.limit=0 (setelan defaultnya adalah 10) |