4.17.05 - Catatan rilis Edge untuk Private Cloud

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

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

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

Ringkasan rilis

Rilis ini mencakup sejumlah fitur penting yang membantu Anda mengontrol dan mengamankan API, termasuk:

• Alur bersama mendukung deployment tanpa periode nonaktif.
• Penghapusan data monetisasi untuk organisasi sekarang didukung.
• Fitur baru tambahan yang dijelaskan di bawah.

Semenjak penghentian penggunaan, vault kini tidak digunakan lagi.

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

Penghentian penggunaan dan pensiun

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

Pensiun: Menambahkan jalur di tab Performa proxy API

Hingga rilis ini, Anda dapat membuka proxy API di UI pengelolaan, membuka tab Performa, dan buat jalur yang berbeda untuk perbandingan berbasis diagram pada Tab Performa dan di dasbor Transaksi Bisnis. Fitur ini sekarang dihentikan dan tidak lagi tersedia di UI. Untuk alternatif fungsi ini, lihat Apigee berikut Artikel komunitas: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html. (EDGEUI-902)

Pensiun: URL buildInfo untuk portal Layanan Developer

Di versi portal sebelumnya, untuk menentukan versi portal, Anda membuka hal berikut URL di browser:

http://yourportal.com/buildInfo

Pada 4.17.05 tautan ini dihapus. Untuk mengetahui versi, buka Laporan > Entri menu Laporan status di Drupal. Versi portal muncul pada tabel di baris yang bernama Install profile.

Penghentian Apigee penyimpanan aman (vault)

Apigee Secure yang dikenal sebagai "vault", tidak digunakan lagi dan akan dihentikan satu tahun sejak tanggal pengumuman penghentian penggunaan yang ditampilkan pada Penghentian penggunaan dan halaman penghentian. Vault, yang menyediakan penyimpanan terenkripsi untuk key-value pair, dibuat dengan API pengelolaan dan diakses saat runtime dengan fungsi di apigee-access modul Node.js.

Daripada menggunakan penyimpanan yang aman, gunakanlah peta nilai kunci (KVM) yang dienkripsi, seperti yang dijelaskan dalam Menggunakan peta nilai kunci. KVM terenkripsi sama amannya dengan vault dan memberikan lebih banyak opsi atau pengambilan. (MGMT-3848)

Fitur dan info terbaru

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

Cloud Pribadi

Menambahkan parameter konfigurasi SMTP baru yang diperlukan ke penginstalan

Sekarang, Anda harus menggunakan parameter SMTPMailFROM di file konfigurasi penginstalan Edge. Parameter ini menentukan alamat email digunakan saat Edge mengirim email otomatis, seperti saat pengguna meminta untuk mereset sandi. Lihat Instal komponen Edge pada node untuk mengetahui lebih banyak lagi.

(EDGEUI-1020)

Kini dapat menyetel waktu tunggu yang digunakan oleh UI Edge untuk panggilan pengelolaan Edge API

Anda sekarang dapat menentukan durasi waktu tunggu API yang digunakan oleh UI Edge untuk mengontrol berapa lama UI menunggu panggilan pengelolaan API ditampilkan. Properti berikut menentukan waktu tunggu:

• Kumpulan conf_apigee_apigee.feature.apitimeout waktu, dalam detik, saat UI menunggu panggilan ke backend untuk ditampilkan, terlepas dari aktivitas di dalamnya. Jika panggilan tidak selesai pada waktu tersebut, UI akan menampilkan error waktu tunggu. Tujuan nilai defaultnya adalah 180 detik (3 menit).
• conf_apigee_play.ws.timeout.idle menetapkan cara lamanya UI menunggu aktivitas di server, dalam milidetik. Nilai ini dapat ditetapkan ke nilai yang sama sebagai conf_apigee_apigee_apitimeout atau pada nilai yang lebih rendah. Menetapkannya ke nilai yang lebih besar tidak akan berpengaruh. Defaultnya adalah 180.000 milidetik (3 menit).
• Kumpulan conf_apigee_play.ws.timeout.connection untuk berapa lama UI menunggu koneksi dibuat. Nilai ini dapat ditetapkan ke nilai yang sama sebagai conf_apigee_apigee_apitimeout atau pada nilai yang lebih rendah. Menetapkannya ke nilai yang lebih besar tidak akan berpengaruh. Defaultnya adalah 120.000 milidetik (2 menit).

Lihat Menyetel waktu tunggu digunakan oleh UI Edge untuk panggilan pengelolaan Edge API untuk informasi lebih lanjut.

(EDGEUI-816)

Menambahkan waktu tunggu percobaan ulang Pemroses Pesan ke Router

Menambahkan waktu tunggu sehingga Router berhenti mencoba kembali permintaan ke Pemroses Pesan dan menampilkan pesan error.

Lihat Mengonfigurasi Router untuk mencoba kembali koneksi ke Pemroses Pesan guna mendapatkan izin lainnya.

(APIRT-2912)

Menambahkan prosedur untuk mengubah administrator sistem default

Dokumentasi kini disertakan untuk mengubah administrator sistem {i>default<i}.

Lihat Mengelola Pengguna, Peran, dan Izin untuk mengetahui informasi selengkapnya.

(DOS-4895)

Menambahkan dokumentasi tentang memisahkan tugas penginstalan Edge antara pengguna root dan non-root

Dokumentasi baru menjelaskan langkah-langkah untuk memisahkan tugas penginstalan Edge antara root dan pengguna non-root.

Lihat Penginstalan Edge Ringkasan untuk informasi selengkapnya.

(DOS-4573)

Menambahkan properti guna menetapkan nama host untuk link dalam email yang dibuat

Edge secara otomatis mengirim email sebagai tanggapan terhadap peristiwa tertentu, seperti ketika pengguna ditambahkan ke sebuah organisasi. Banyak dari email ini berisi tautan. Misalnya, ketika pengguna baru ditambahkan ke organisasi, UI Edge mengirimkan email kepada pengguna yang berisi URL login dalam bentuk:

https://domain/login

Domain ditentukan secara otomatis oleh Edge dan biasanya sesuai untuk organisasi. Namun, ada kemungkinan ketika UI Edge berada di balik load balancer, nama domain yang dibuat salah. Jika demikian, Anda dapat menggunakan properti conf_apigee_apigee.emails.hosturl untuk secara eksplisit menetapkan bagian nama domain dari URL yang dihasilkan.

Lihat Menyetel nama host untuk link di email yang dibuat untuk informasi selengkapnya.

(EDGEUI-1044)

Menyetel URL dasar yang ditampilkan oleh UI Edge untuk proxy API

UI Edge menampilkan URL proxy API berdasarkan setelan di host virtual sesuai dengan tempat {i>proxy<i} di-deploy. Layar ini dapat berisi nomor port Router {i>host<i} virtual.

Pada umumnya, URL yang ditampilkan di UI Edge adalah URL yang benar untuk dibuat permintaan ke proxy. Namun, untuk beberapa konfigurasi, URL yang ditampilkan salah. Misalnya, salah satu konfigurasi berikut dapat menyebabkan URL yang ditampilkan tidak sesuai dengan URL sebenarnya yang digunakan untuk membuat permintaan eksternal ke proxy:

• Penghentian SSL terjadi di load balancer
• Pemetaan port terjadi antara load balancer dan router Apigee
• Load balancer yang dikonfigurasi dengan penulisan ulang jalur

Edge untuk Private Cloud 4.17.05 dan yang lebih baru mendukung atribut pada host virtual yang disebut &lt;BaseUrl&gt; yang memungkinkan Anda mengganti URL yang ditampilkan oleh UI Edge. Berikut contoh yang menampilkan objek {i>host<i} virtual dengan &lt;BaseURL&gt; baru . Dalam contoh ini, nilai "http://myCo.com" muncul di UI Edge:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias> 
   </HostAliases> 
   <BaseUrl>http://myCo.com</BaseUrl>     
   <Interfaces/>
   <Port>9005</Port> 
</VirtualHost>

Jika &lt;BaseUrl&gt; tidak ditetapkan, defaultnya, URL default yang dirender oleh UI Edge akan muncul sebagai: "http://DNS_name_or_IP:9005/", sedangkan penyiapan alias host sebenarnya adalah "http://myCo.com".

Anda juga dapat menetapkan URL dasar saat membuat organisasi menggunakan properti VHOST_BASEURL dengan apigee-provision utilitas.

Lihat Mengonfigurasi TLS akses ke API untuk Private Cloud guna mengetahui informasi selengkapnya.

(EDGEUI-5008)

Menambahkan dokumentasi tentang mengaktifkan logging debug

Dokumentasi telah ditambahkan untuk menjelaskan cara mengaktifkan/menonaktifkan logging debugg untuk Edge komponen.

Lihat Mengaktifkan logging debug untuk lebih banyak.

(APIRT-4018)

Sintaksis perintah dan penginstal baru untuk utilitas apigee-analytics-collector

Semua pelanggan Edge untuk Private Cloud harus mengirimkan statistik Apigee tentang API ke statistik Apigee traffic proxy menggunakan rilis command line apigee-analytics-collector versi Beta utilitas. Utilitas ini mengirimkan laporan volume panggilan API kembali ke Apigee.

Rilis Edge ini berisi petunjuk instalasi baru dan sintaks perintah untuk apigee-analytics-collector utilitas. Dalam rilis ini, Anda sekarang menggunakan apigee-service untuk menginstal utilitas apigee-analytics-collector, bukan npm, dan panggil utilitas apigee-analytics-collector melalui apigee-service, bukan sebagai perintah yang berdiri sendiri.

Lihat Mengupload API Data Traffic ke Apigee - Rilis Beta untuk mengetahui informasi lebih lanjut.

Direktori penginstalan default baru setelah update portal Layanan Developer dari Nginx/Postgres dari instalasi 4.17.01 baru

Setelah memperbarui instalasi baru 4.17.01 yang menggunakan Nginx/Postgres, direktori {i>root<i} diubah dari:

/opt/apigee/apigee-drupal

menjadi:

/opt/apigee/apigee-drupal/wwwroot

Layanan API

Validasi input yang lebih ketat untuk entity

Validasi input yang lebih ketat telah diterapkan di semua entitas organisasi Apigee Edge. Karakter yang diizinkan biasanya berupa alfabet (semua huruf besar/kecil), angka, garis bawah.

Entitas yang terkena dampak meliputi:

• Organisasi
• Lingkungan
• Proxy API
• Revisi proxy API
• Nama kebijakan di proxy API
• Men-debug ID konfigurasi trace mask
• Nama resource (info Java, xsl, semua resource)
• Keystore
• CRLstores
• Referensi resource
• Server target

(MGMT-3840)

Deployment tanpa periode nonaktif alur bersama

Saat Anda ingin men-deploy alur bersama dan memastikan bahwa hanya sedikit atau tidak ada traffic masuk yang ditolak selama deployment, Anda kini dapat menggunakan API pengelolaan deployment tanpa periode nonaktif. Prosesnya adalah hampir sama dengan deployment tanpa periode nonaktif untuk proxy API yang menggunakan API pengelolaan. Satu-satunya perbedaannya adalah resource API pengelolaan.

Panggilan berikut men-deploy revisi alur bersama yang ditunjukkan di URI, lalu membatalkan deployment revisi yang sebelumnya di-deploy (parameter kueri override=true memungkinkan hal ini):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monetisasi

Menghapus data monetisasi untuk organisasi

Anda dapat menghapus data monetisasi untuk organisasi Anda dalam skenario berikut:

• Hapus organisasi Anda. Dalam hal ini, Anda harus menghapus data monetisasi sebelum dapat menghapus organisasi.
• Hapus data monetisasi dari organisasi pengujian yang ingin Anda gunakan kembali. Di sini Anda harus menyinkronkan data Apigee Edge setelah menghapus data monetisasi.

Untuk informasi selengkapnya, lihat Menghapus data monetisasi dari organisasi Anda. (DEVRT-2581)

Menambahkan API untuk mengaktifkan monetisasi bagi organisasi

Anda kini dapat menggunakan API untuk mengaktifkan monetisasi untuk sebuah organisasi.

Lihat Mengaktifkan monetisasi untuk organisasi untuk informasi lebih lanjut.

(DEVRT-2383)

Bug diperbaiki

Bug berikut telah diperbaiki dalam rilis ini. Daftar ini terutama ditujukan bagi pengguna yang ingin memeriksa jika tiket dukungan telah diperbaiki. Ini tidak dirancang untuk memberikan informasi terperinci tentang semua pengguna.

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (monetisasi)

Cloud 17.03.13.01 (monetisasi)

Cloud 17.03.13 (Pengelolaan API)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (runtime API)

Cloud 17.02.13 (Pengelolaan API)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (Pengelolaan API)

Cloud 17.01.16 (monetisasi)