4.17.09 - Catatan rilis Edge untuk Private Cloud

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

Sejak Rilis Fitur Edge untuk Cloud Pribadi 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

Fitur baru yang paling penting dalam rilis ini adalah tambahan dukungan untuk Keamanan Assertion Markup Language (SAML) 2.0 sebagai mekanisme otentikasi untuk Edge, API BaaS, dan Portal Layanan Developer. Dengan menggunakan SAML dengan Edge, Anda dapat mendukung SSO untuk UI dan API Edge selain layanan lain yang Anda sediakan dan juga mendukung SAML.

Autentikasi SAML menawarkan beberapa keuntungan. Dengan menggunakan SAML, Anda dapat:

• Kontrol sepenuhnya pengelolaan pengguna. Saat pengguna keluar dari organisasi dan dicabut aksesnya secara terpusat, akses ke Edge secara otomatis ditolak.
• Kontrol cara pengguna mengautentikasi untuk mengakses Edge. Anda dapat memilih autentikasi yang berbeda untuk berbagai organisasi Edge.
• Mengontrol kebijakan autentikasi. Penyedia SAML Anda mungkin mendukung kebijakan autentikasi yang lebih sesuai dengan standar perusahaan Anda.
• Anda dapat memantau login, logout, upaya login yang gagal, dan aktivitas berisiko tinggi di deployment Edge Anda.
• Perhatikan bahwa SAML hanya digunakan untuk autentikasi. Otorisasi masih dikontrol oleh Edge peran pengguna.

Lihat Mendukung SAML di Edge untuk Private Cloud untuk mengetahui informasi selengkapnya.

Rilis ini mencakup sejumlah fitur penting lainnya, termasuk:

• Kemampuan untuk memigrasikan portal Layanan Developer dari Apache/MySQL ke Postgres/Nginx
• Perintah untuk menonaktifkan TLS di UI Edge
• Properti baru untuk mengonfigurasi penginstalan Edge
• Aturan penamaan rahasia dan kunci konsumen kustom
• Dukungan untuk Red Hat/CentOS versi 7.4

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 mengetahui informasi selengkapnya.

Penghentian penggunaan

Penghentian layanan Apigee Secure Store (vault)

Apigee Secure yang dikenal sebagai "vault", tidak digunakan lagi dan akan dihentikan pada bulan April 2018. Vault, yang menyediakan penyimpanan terenkripsi untuk key-value pair, dibuat dengan API pengelolaan dan diakses saat runtime dengan fungsi di modul Node.js apigee-access.

Daripada menggunakan penyimpanan aman, gunakan peta nilai kunci (KVM) terenkripsi, seperti yang dijelaskan dalam Menggunakan peta nilai kunci. KVM terenkripsi sama aman dengan vault dan menyediakan lebih banyak opsi untuk pembuatan dan pengambilan. (MGMT-3848)

Penghentian penggunaan untuk menambahkan jalur di tab Performa proxy API

Hingga rilis ini, Anda dapat membuka proxy API di UI pengelolaan, membuka tab Performa, dan membuat jalur yang berbeda untuk perbandingan berbasis diagram di tab Performa proxy 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)

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

Dukungan SAML ditambahkan ke portal Edge, API BaaS, dan Layanan Developer

Edge kini mendukung Security Assertion Markup Language (SAML) 2.0 sebagai autentikasi untuk Edge, API BaaS, dan portal Layanan Developer. SAML mendukung single sign-on (SSO). Dengan menggunakan SAML, Anda dapat mendukung SSO untuk Edge selain layanan lainnya yang Anda berikan dan juga mendukung SAML.

Lihat Mendukung SAML di Edge untuk Private Cloud.

Menambahkan utilitas apigee-ssoadminapi.sh

Setelah mengaktifkan SAML, sekarang Anda dapat menggunakan apigee-ssoadminapi.sh yang baru untuk melakukan banyak tugas administratif, seperti membuat pengguna dan organisasi.

Lihat Menggunakan apigee-ssoadminapi.sh.

(DOS-5118)

Kini dapat memigrasikan portal Layanan Developer dari Apache/MySQL/MariaDB ke Nginx/postgres

Instalasi portal Layanan Developer berbasis .tar menggunakan Apache dan MySQL atau MariaDB. Sekarang Anda dapat memigrasikan penginstalan portal yang sudah ada untuk menggunakan Nginx dan Postgres. Ini migrasi diperlukan jika Anda ingin memperbarui ke versi portal 4.17.09.

Lihat Mengonversi portal berbasis tar ke portal berbasis RPM.

Menambahkan dukungan untuk Red Hat/CentOS versi 7.4

Sekarang Anda dapat men-deploy Edge untuk Private Cloud, API BaaS, dan portal Layanan Developer di Red Hat/CentOS versi 7.4.

Lihat Software yang didukung dan didukung versi.

Menambahkan properti agar penginstal memeriksa persyaratan CPU dan memori selama penginstalan

File konfigurasi penginstalan Edge sekarang mendukung properti berikut:

ENABLE_SYSTEM_CHECK=y 

Jika "y", penginstal memeriksa apakah sistem memenuhi persyaratan CPU dan memori untuk komponen yang sedang diinstal. Lihat Persyaratan Penginstalan untuk mengetahui persyaratan setiap komponen. Nilai defaultnya adalah "n" untuk menonaktifkan pemeriksaan.

Lihat Edge Referensi File Konfigurasi.

(DOS-4772)

Menambahkan properti agar Anda dapat memilih alamat IP yang digunakan oleh penginstal di server beberapa kartu antarmuka

Jika server memiliki beberapa kartu antarmuka, "nama host -i" menampilkan perintah yang dipisahkan oleh spasi, daftar alamat IP. Secara default, penginstal Edge menggunakan alamat IP pertama yang ditampilkan, yang mungkin tidak benar dalam semua situasi. Atau, Anda dapat menetapkan properti berikut dalam file konfigurasi penginstalan:

ENABLE_DYNAMIC_HOSTIP=y

Dengan properti tersebut ditetapkan ke "y", penginstal akan meminta Anda untuk memilih alamat IP yang akan digunakan sebagai bagian dari penginstalan. Nilai defaultnya adalah "n".

Lihat Referensi File Konfigurasi Edge.

(DOS-5117)

Opsi UI dan API baru yang tersedia untuk mengonfigurasi TLS

Rilis Beta fitur TLS/SSL layanan mandiri baru untuk Cloud kini tersedia di Private Cloud sebagai fitur Beta. Dengan menggunakan versi Beta ini, Anda dapat:

• Membuat, memodifikasi, dan menghapus keystore dan truststore di UI serta API
• Mengupload sertifikat TLS sebagai PKCS12/PFX
• Membuat sertifikat yang ditandatangani sendiri dari UI atau API
• Menguji validitas keystore atau truststore di UI

Dokumentasi Beta (PDF) untuk fitur ini tersedia di:

• Menggunakan UI Edge Cloud untuk membuat Keystore dan Truststore
• Menggunakan Edge API untuk membuat Keystore dan Truststore

Untuk detail selengkapnya, lihat dokumentasi tambahan (PDF):

• Opsi untuk mengonfigurasi TLS
• Mengonfigurasi akses TLS ke API untuk Cloud
• Mengonfigurasi TLS dari Edge ke backend
• Memperbarui sertifikat TLS untuk Cloud

(EDGEUI-1058)

Menambahkan perintah sandi yang di-obfuscate

Menambahkan perintah untuk membuat sandi yang di-obfuscate sehingga komponen apa pun dapat membuat sandi {i>password<i}. Anda dapat membuat {i>password<i} yang di-obfuscate dengan menggunakan perintah berikut di Edge Server Pengelolaan:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Masukkan sandi baru, lalu konfirmasi saat diminta. Untuk alasan keamanan, teks sandi tidak ditampilkan. Perintah ini menampilkan sandi dalam bentuk:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Lihat Mengonfigurasi TLS/SSL untuk Edge On Premises.

(TBD-250)

Menambahkan perintah baru untuk menyamarkan sandi baru saat mengubah nama pengguna organisasi kata sandi

Untuk mereset sandi pengguna organisasi, Anda sekarang dapat menggunakan utilitas apigee-service untuk memanggil apigee-openldap:

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Anda akan diminta memasukkan sandi admin sistem, lalu sandi pengguna baru. Untuk alasan keamanan, teks sandi tidak ditampilkan saat Anda memasukkannya.

Lihat Mereset Sandi Edge.

(DBS-1733)

Menambahkan perintah untuk menonaktifkan TLS di UI Edge

Sekarang Anda dapat menggunakan perintah berikut untuk menonaktifkan TLS di UI Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

Lihat Mengonfigurasi TLS untuk UI pengelolaan.

(EDGEUI-1114)

Menambahkan properti untuk mengontrol format stempel waktu dalam pesan log

Secara default, stempel waktu dalam pesan log yang dibuat oleh kebijakan Logging Pesan memiliki format:

yyyy-MM-dd'T'HH:mm:ss.sssZ

Contoh:

2017-05-08T13:33:00.000+0000

Anda dapat menggunakan konfigurasi conf_system_apigee.syslogger.dateFormat di Edge Message Processor untuk mengontrol format tersebut.

Lihat Pencatatan Pesan kebijakan kami.

(APIRT-4196)

Menambahkan parameter konfigurasi SMTP baru yang diperlukan ke penginstalan API BaaS

Sekarang Anda harus menggunakan parameter SMTPMAILFROM dalam file konfigurasi penginstalan API BaaS. Parameter ini menentukan alamat email yang digunakan saat API BaaS mengirim email otomatis, seperti saat pengguna meminta untuk mengatur ulang {i>password<i}.

Lihat BaaS Referensi File Konfigurasi.

(APIBAAS-2103)

Menambahkan dukungan untuk mengizinkan Edge Router dan server web Nginx agar portal dapat mengakses port di bawah 1.000

Anda kini dapat menggunakan server web Router dan Nginx agar portal dapat mengakses port di bawah 1.000 tanpa harus menjalankannya sebagai pengguna yang berbeda. dalam rilis sebelumnya, web Router dan Nginx server tidak dapat mengakses porta di bawah 1000 tanpa menjalankannya sebagai pengguna khusus.

Mengubah cara mengonfigurasi tingkat logging untuk UI Edge

Properti yang digunakan untuk mengonfigurasi level logging untuk UI Edge telah berubah. Lihat Menyetel level log untuk komponen Edge untuk properti dan prosedur baru.

(EDGEUI-886)

Layanan API

Aturan penamaan rahasia dan kunci konsumen kustom

Aturan penamaan dan validasi telah diperbarui untuk membuat kunci dan rahasia konsumen kustom untuk aplikasi developer. Kunci dan rahasia konsumen dapat berisi huruf, angka, garis bawah, dan tanda hubung. Karakter khusus lainnya tidak diizinkan.

Proses pembuatan kunci/rahasia kustom didokumentasikan secara lebih lengkap di Mengimpor kunci dan rahasia konsumen yang ada. (MGMT-3916)

Validasi nama Keystore dan Server Target

Nama keystore dan Server Target tidak boleh lebih dari 255 karakter dan dapat berisi huruf, angka, spasi, tanda hubung, garis bawah, dan titik. Edge kini memvalidasi hal ini pada waktu pembuatan. (MGMT-4098)

Bug yang diperbaiki

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

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (pengelolaan API dan runtime)

Cloud 17.07.31 (pengelolaan API)

Cloud 17.07.17 (pengelolaan API dan runtime)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (Monetisasi)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (pengelolaan API)

Cloud 17.05.08 (UI)

Cloud 17.04.22 (Pengelolaan API)

Masalah Umum

Rilis ini memiliki masalah umum berikut: