Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi
Apigee X. info
Pada Selasa, 19 Mei 2015, kami merilis versi kuartalan Apigee Edge untuk Private Cloud.
Nama produk sebelumnya "Apigee Edge On-premises" atau "OPDK" kini menjadi "Apigee Edge for Private Cloud".
Jika ada pertanyaan, buka Dukungan Pelanggan Apigee.
Untuk daftar semua catatan rilis Apigee Edge, lihat Catatan Rilis Apigee.
Fitur dan peningkatan baru
Berikut adalah fitur baru dan peningkatan 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 baru dan peningkatan di Layanan Edge API.
WebSockets
Untuk mengaktifkan komunikasi web secara 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 WebSocket di Edge, lihat panduan Apigee Edge untuk Cloud Pribadi Menggunakan WebSocket.
Dukungan penyedia autentikasi eksternal untuk pengelolaan API
Edge terintegrasi dengan Active Directory dan penyedia autentikasi eksternal/sistem LDAP lainnya yang berisi pengguna administratif API Anda. Untuk mengetahui informasi selengkapnya, lihat panduan Konfigurasi Autentikasi Eksternal Edge untuk Cloud Pribadi.
Kerja sama merek di UI pengelolaan
Anda dapat melakukan co-branding pada 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 Cloud Pribadi.
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" dalam file apigee-base.conf atau apigee-onpremise.conf dalam penginstalan Anda. Untuk 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, masa berlaku sandi Edge akan otomatis berakhir setelah 30 hari. Artinya, pengguna akan terkunci kecuali jika mereka mengubah sandi sebelum masa berlakunya habis. Namun, hal ini juga menyebabkan masa berlaku sandi administrator sistem berakhir sehingga admin sistem terkunci dari Edge.
Saat Anda mengupgrade ke 4.15.04.00, setelan default akan berubah sehingga masa berlaku sandi tidak akan berakhir. Jika
perlu, Anda dapat mengonfigurasi sandi Edge agar berakhir masa berlakunya menggunakan
skrip /opt/apigee4/bin/apigee-enable-pwlockout.sh. Untuk informasi selengkapnya, lihat
Panduan Operasi Apigee Edge untuk Cloud Pribadi.
Membatasi akses sysadmin ke domain email tertentu
Anda dapat membatasi keanggotaan dalam peran sysadmin atau sysadmin hanya baca 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 Apigee Edge untuk Operasi Cloud Pribadi.
Pesan error UI pengelolaan
Tampilan pesan error di UI pengelolaan telah didesain ulang untuk menggunakan ruang layar secara lebih efisien.
Variabel error OAuthV2 baru
Variabel terkait error baru ini ditetapkan oleh kebijakan OAuthV2:
- oauthV2.<policy-name>.failed - Tetapkan ke true jika kebijakan gagal.
- oauthv2.<policy_name>.<fault_name> - Nama error. Misalnya, invalid_request
- oauthv2.<policy_name>.<fault_cause> - Alasan error. Misalnya: Token Expired
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 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 Trace Offline 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 Trace Offline mirip dengan alat Trace "live".
Untuk mengetahui informasi selengkapnya, lihat Menggunakan alat Trace Offline.
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 baru dan peningkatan di Layanan Analisis Edge.
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.
Variabel yang 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 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
null untuk respons HTTP yang berhasil.
Variabel terkait berikut memberikan detail kebijakan yang gagal terlebih dahulu. Nilainya 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. Kolom ini digunakan untuk 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 ada atau baru ini:
- 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. 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 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 Performa target.
- Interaksi Partner diganti namanya menjadi Interaksi Developer: Menampilkan developer aplikasi terdaftar mana yang menghasilkan traffic API terbanyak. Untuk setiap developer, Anda dapat mengetahui siapa yang menghasilkan traffic API terbanyak dan error terbanyak. Lihat Interaksi developer.
Layanan Developer
Berikut adalah fitur baru dan peningkatan 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 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 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 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-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 Cloud Pribadi dengan alamat email yang berisi garis bawah. |
| CORERT-613 | Kegagalan handshake SSL karena "unrecognized_name" |
| APIRT-1346 | OAuth2.0 - Nilai hash ditampilkan dalam respons token akses jika hash.oauth.tokens.enabled bernilai benar |
Rilis ini juga berisi perbaikan bug dari rilis berikut:
| Edge Cloud | Edge untuk Cloud Pribadi |
|---|---|
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 mengatasinya, jalankan perintah berikut setelah penginstalan atau upgrade Cassandra untuk menyelesaikan penginstalan/upgrade monetisasi:
|
| CORERT-318 | Panggilan API dengan payload besar (ratusan KB) terkadang dapat mengalami hang. Untuk mengatasi masalah ini, tetapkan nilai properti berikut dalam file router.properties:HTTPServer.streaming.buffer.limit=0 (setelan defaultnya adalah 10) |