4.17.09 - Edge สำหรับบันทึกประจำรุ่นของ Private Cloud

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

ตั้งแต่การเปิดตัวฟีเจอร์ Edge for Private Cloud ครั้งก่อน เราได้เปิดตัวรุ่นต่อไปนี้ และรวมไว้ในการเปิดตัวฟีเจอร์นี้แล้ว

ดูเกี่ยวกับหมายเลข รุ่นเพื่อทำความเข้าใจวิธีตรวจสอบว่ารุ่น Cloud ที่เฉพาะเจาะจงรวมอยู่ใน Edge สำหรับ Private Cloud เวอร์ชันของคุณหรือไม่

ภาพรวมของรุ่น

ฟีเจอร์ใหม่ที่สำคัญที่สุดในรุ่นนี้คือการเพิ่มการรองรับ Security Assertion Markup Language (SAML) 2.0 เป็นกลไกการตรวจสอบสิทธิ์สำหรับ Edge, API BaaS และ พอร์ทัลบริการสำหรับนักพัฒนาแอป การใช้ SAML กับ Edge จะช่วยให้คุณรองรับ SSO สำหรับ UI และ API ของ Edge นอกเหนือจากบริการอื่นๆ ที่คุณให้บริการและรองรับ SAML ด้วย

การตรวจสอบสิทธิ์ SAML มีข้อดีหลายประการ การใช้ SAML ช่วยให้คุณทำสิ่งต่อไปนี้ได้

• ควบคุมการจัดการผู้ใช้ได้อย่างเต็มที่ เมื่อผู้ใช้ออกจากองค์กรและ มีการยกเลิกการจัดสรรสิทธิ์จากส่วนกลาง ผู้ใช้จะถูกปฏิเสธการเข้าถึง Edge โดยอัตโนมัติ
• ควบคุมวิธีที่ผู้ใช้ตรวจสอบสิทธิ์เพื่อเข้าถึง Edge คุณเลือกประเภทการตรวจสอบสิทธิ์ ที่แตกต่างกันสำหรับองค์กร Edge ที่แตกต่างกันได้
• ควบคุมนโยบายการตรวจสอบสิทธิ์ ผู้ให้บริการ SAML อาจรองรับนโยบายการตรวจสอบสิทธิ์ ที่สอดคล้องกับมาตรฐานขององค์กรคุณมากขึ้น
• คุณสามารถตรวจสอบการเข้าสู่ระบบ การออกจากระบบ ความพยายามในการเข้าสู่ระบบที่ไม่สำเร็จ และกิจกรรมที่มีความเสี่ยงสูงในการติดตั้งใช้งาน Edge ได้
• โปรดทราบว่า SAML ใช้สำหรับการตรวจสอบสิทธิ์เท่านั้น การให้สิทธิ์ยังคงควบคุมโดยบทบาทของผู้ใช้ Edge

ดูข้อมูลเพิ่มเติมได้ที่การรองรับ SAML ใน Edge สำหรับ Private Cloud

นอกจากนี้ รุ่นนี้ยังมีฟีเจอร์อื่นๆ ที่น่าสนใจอีกมากมาย เช่น

• ความสามารถในการย้ายข้อมูลพอร์ทัลบริการสำหรับนักพัฒนาแอปจาก Apache/MySQL ไปยัง Postgres/Nginx
• คำสั่งเพื่อปิดใช้ TLS ใน UI ของ Edge
• พร็อพเพอร์ตี้ใหม่เพื่อกำหนดค่าการติดตั้ง Edge
• กฎการตั้งชื่อคีย์ผู้ใช้และข้อมูลลับที่กำหนดเอง
• การรองรับ Red Hat/CentOS เวอร์ชัน 7.4

ส่วนที่เหลือของหัวข้อนี้มีรายละเอียดเกี่ยวกับฟีเจอร์ใหม่ การอัปเดต และการแก้ไขข้อบกพร่องทั้งหมด ที่รวมอยู่ในการเปิดตัว

การเลิกใช้งานและการหยุดให้บริการ

ฟีเจอร์ต่อไปนี้ถูกเลิกใช้งานหรือหยุดให้บริการในรุ่นนี้ ดูข้อมูลเพิ่มเติมได้ในนโยบายการเลิกใช้งาน Edge

การเลิกใช้งาน

การเลิกใช้งานที่เก็บข้อมูลที่ปลอดภัย (Vault) ของ Apigee

เรากำลังจะเลิกใช้งานที่เก็บข้อมูลที่ปลอดภัยของ Apigee หรือที่เรียกว่า "Vault" และจะหยุดให้บริการในเดือนเมษายน 2018 Vault ซึ่งจัดเก็บคู่คีย์/ค่าที่เข้ารหัสจะสร้างขึ้นด้วย Management API และเข้าถึงได้ที่รันไทม์ด้วยฟังก์ชันในโมดูล apigee-access Node.js

ให้ใช้แผนที่ค่าคีย์ (KVM) ที่เข้ารหัสแทนการใช้ที่เก็บข้อมูลที่ปลอดภัย ตามที่อธิบายไว้ใน การทำงานกับแผนที่ค่าคีย์ KVM ที่เข้ารหัสมีความปลอดภัยเช่นเดียวกับ Vault และมีตัวเลือกเพิ่มเติมสำหรับการสร้างและ การดึงข้อมูล (MGMT-3848)

การเลิกใช้งานการเพิ่มเส้นทางในแท็บประสิทธิภาพของพร็อกซี API

ก่อนการเปิดตัวนี้ คุณสามารถไปที่พร็อกซี API ใน UI การจัดการ ไปที่แท็บประสิทธิภาพ และสร้างเส้นทางต่างๆ สำหรับการเปรียบเทียบแบบชาร์ตในแท็บประสิทธิภาพของพร็อกซีและในแดชบอร์ดธุรกรรมทางธุรกิจ เราเลิกใช้งานฟีเจอร์นี้แล้วและจะไม่มีให้บริการใน UI อีกต่อไป หากต้องการใช้ฟังก์ชันนี้ในรูปแบบอื่น โปรดดูบทความในชุมชน Apigee ต่อไปนี้ ทางเลือกแทน Business Transactions API (EDGEUI-902)

ฟีเจอร์และการอัปเดตใหม่ๆ

ฟีเจอร์ใหม่และการปรับปรุงในรุ่นนี้มีดังนี้ นอกจากการปรับปรุงต่อไปนี้แล้ว รุ่นนี้ยังมีการปรับปรุงด้านความสามารถในการใช้งาน ประสิทธิภาพ ความปลอดภัย และความเสถียรอีกหลายอย่าง

Private Cloud

เพิ่มการรองรับ SAML ในพอร์ทัล Edge, API BaaS และ Developer Services

ตอนนี้ Edge รองรับภาษามาร์กอัปเพื่อยืนยันความปลอดภัย (SAML) 2.0 เป็นกลไกการตรวจสอบสิทธิ์สำหรับ Edge, API BaaS และพอร์ทัลบริการสำหรับนักพัฒนาแอปแล้ว SAML รองรับสภาพแวดล้อมการลงชื่อเพียงครั้งเดียว (SSO) การใช้ SAML จะช่วยให้คุณรองรับ SSO สำหรับ Edge นอกเหนือจากบริการอื่นๆ ที่คุณให้บริการและรองรับ SAML ด้วย

ดูการรองรับ SAML ใน Edge สำหรับ Private Cloud

เพิ่มยูทิลิตี apigee-ssoadminapi.sh

หลังจากเปิดใช้ SAML แล้ว คุณจะใช้ apigee-ssoadminapi.sh ใหม่เพื่อทำงานด้านการดูแลระบบหลายอย่าง เช่น การสร้างผู้ใช้และองค์กร

ดูการใช้ apigee-ssoadminapi.sh

(DOS-5118)

ตอนนี้ย้ายข้อมูลพอร์ทัลบริการสำหรับนักพัฒนาแอปจาก Apache/MySQL/MariaDB ไปยัง Nginx/postgres ได้แล้ว

การติดตั้งพอร์ทัลบริการสำหรับนักพัฒนาแอปที่อิงตาม .tar จะใช้ Apache และ MySQL หรือ MariaDB ตอนนี้คุณย้ายข้อมูลการติดตั้งพอร์ทัลที่มีอยู่เพื่อใช้ Nginx และ Postgres ได้แล้ว คุณต้องทำการย้ายข้อมูลนี้หากต้องการอัปเดตเป็นพอร์ทัลเวอร์ชัน 4.17.09

ดูแปลงพอร์ทัลที่ใช้ tar เป็นพอร์ทัลที่ใช้ RPM

เพิ่มการรองรับ Red Hat/CentOS เวอร์ชัน 7.4

ตอนนี้คุณสามารถติดตั้งใช้งาน Edge สำหรับ Private Cloud, API BaaS และพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ ใน Red Hat/CentOS เวอร์ชัน 7.4 ได้แล้ว

ดูซอฟต์แวร์และเวอร์ชันที่รองรับ

เพิ่มพร็อพเพอร์ตี้เพื่อให้โปรแกรมติดตั้งตรวจสอบข้อกำหนดของ CPU และหน่วยความจำระหว่างการติดตั้ง

ตอนนี้ไฟล์กำหนดค่าการติดตั้ง Edge รองรับพร็อพเพอร์ตี้ต่อไปนี้แล้ว

ENABLE_SYSTEM_CHECK=y 

หากเป็น "y" โปรแกรมติดตั้งจะตรวจสอบว่าระบบตรงตามข้อกำหนดของ CPU และหน่วยความจำสำหรับคอมโพเนนต์ที่กำลังติดตั้งหรือไม่ ดูข้อกำหนดของแต่ละคอมโพเนนต์ได้ที่ข้อกำหนดในการติดตั้ง ค่าเริ่มต้นคือ "n" เพื่อปิดใช้การตรวจสอบ

ดูการอ้างอิงไฟล์การกำหนดค่า Edge

(DOS-4772)

เพิ่มพร็อพเพอร์ตี้เพื่อให้คุณเลือกที่อยู่ IP ที่ใช้โดยโปรแกรมติดตั้งในเซิร์ฟเวอร์ที่มี การ์ดอินเทอร์เฟซหลายรายการ

หากเซิร์ฟเวอร์มีอินเทอร์เฟซการ์ดหลายรายการ คำสั่ง "hostname -i" จะแสดงรายการที่อยู่ IP ที่คั่นด้วยช่องว่าง โดยค่าเริ่มต้น โปรแกรมติดตั้ง Edge จะใช้ที่อยู่ IP แรกที่แสดง ซึ่งอาจไม่ถูกต้องในบางสถานการณ์ หรือคุณจะตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในไฟล์การกำหนดค่าการติดตั้งก็ได้

ENABLE_DYNAMIC_HOSTIP=y

เมื่อตั้งค่าพร็อพเพอร์ตี้นี้เป็น "y" โปรแกรมติดตั้งจะแจ้งให้คุณเลือกที่อยู่ IP ที่จะใช้เป็นส่วนหนึ่งของการติดตั้ง ค่าเริ่มต้นคือ "n"

ดูการอ้างอิงไฟล์การกำหนดค่า Edge

(DOS-5117)

ตัวเลือก UI และ API ใหม่พร้อมให้ใช้งานสำหรับการกำหนดค่า TLS

ตอนนี้ฟีเจอร์ TLS/SSL แบบบริการตนเองใหม่สำหรับระบบคลาวด์พร้อมให้บริการในเวอร์ชันเบต้าแล้วใน Private Cloud เป็นฟีเจอร์เบต้า คุณจะทำสิ่งต่อไปนี้ได้เมื่อใช้เวอร์ชันเบต้านี้

• สร้าง แก้ไข และลบที่เก็บคีย์และที่เก็บที่เชื่อถือได้ใน UI รวมถึง API
• อัปโหลดใบรับรอง TLS เป็น PKCS12/PFX
• สร้างใบรับรองที่ลงนามด้วยตนเองจาก UI หรือ API
• ทดสอบความถูกต้องของ Keystore หรือ Truststore ใน UI

เอกสารประกอบเวอร์ชันเบต้า (PDF) สำหรับฟีเจอร์เหล่านี้มีอยู่ที่

• การใช้ UI ของ Edge Cloud เพื่อสร้างที่เก็บคีย์และที่เก็บที่เชื่อถือ
• การใช้ Edge API เพื่อสร้าง Keystore และ Truststore

โปรดดูรายละเอียดทั้งหมดในเอกสารประกอบเพิ่มเติม (PDF)

• ตัวเลือกสำหรับการกำหนดค่า TLS
• การกำหนดค่าการเข้าถึง TLS ไปยัง API สำหรับระบบคลาวด์
• การกำหนดค่า TLS จาก Edge ไปยังแบ็กเอนด์
• อัปเดตใบรับรอง TLS สำหรับ Cloud

(EDGEUI-1058)

เพิ่มคำสั่งรหัสผ่านที่ผ่านการปกปิด

เพิ่มคำสั่งเพื่อสร้างรหัสผ่านที่ผ่านการปกปิดข้อมูลเพื่อให้คอมโพเนนต์ใดก็ตามสร้างรหัสผ่านที่เข้ารหัสได้ คุณสร้างรหัสผ่านที่คลุมเครือได้โดยใช้คำสั่งต่อไปนี้ในเซิร์ฟเวอร์การจัดการ Edge

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

ป้อนรหัสผ่านใหม่ แล้วยืนยันที่ข้อความแจ้ง ระบบจะไม่แสดงข้อความของรหัสผ่านเนื่องจากเหตุผลด้านความปลอดภัย คำสั่งนี้จะแสดงรหัสผ่านในรูปแบบต่อไปนี้

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

ดูการกำหนดค่า TLS/SSL สำหรับ Edge On Premises

(TBD-250)

เพิ่มคำสั่งใหม่เพื่อปกปิดรหัสผ่านใหม่เมื่อเปลี่ยนรหัสผ่านของผู้ใช้ในองค์กร

หากต้องการรีเซ็ตรหัสผ่านสำหรับผู้ใช้ในองค์กร ตอนนี้คุณต้องใช้ยูทิลิตี apigee-service เพื่อเรียกใช้ apigee-openldap

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

ระบบจะแจ้งให้คุณป้อนรหัสผ่านของผู้ดูแลระบบ แล้วป้อนรหัสผ่านของผู้ใช้ใหม่ ระบบจะไม่แสดงข้อความของรหัสผ่านขณะที่คุณป้อนเนื่องด้วยเหตุผลด้านความปลอดภัย

ดูการรีเซ็ตรหัสผ่านของ Edge

(DBS-1733)

เพิ่มคำสั่งเพื่อปิดใช้ TLS ใน Edge UI

ตอนนี้คุณใช้คำสั่งต่อไปนี้เพื่อปิดใช้ TLS ใน Edge UI ได้แล้ว

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

ดูการกำหนดค่า TLS สำหรับ UI การจัดการ

(EDGEUI-1114)

เพิ่มพร็อพเพอร์ตี้เพื่อควบคุมรูปแบบของการประทับเวลาในข้อความบันทึก

โดยค่าเริ่มต้น การประทับเวลาในข้อความบันทึกที่สร้างขึ้นตามนโยบายการบันทึกข้อความจะมีรูปแบบ

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

เช่น

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

คุณใช้พร็อพเพอร์ตี้ conf_system_apigee.syslogger.dateFormat ในตัวประมวลผลข้อความ Edge เพื่อควบคุมรูปแบบดังกล่าวได้

ดูนโยบายการบันทึกข้อความ

(APIRT-4196)

เพิ่มพารามิเตอร์การกำหนดค่า SMTP ที่จำเป็นใหม่ในการติดตั้ง API BaaS

ตอนนี้คุณต้องใช้พารามิเตอร์ SMTPMAILFROM ในไฟล์การกำหนดค่าการติดตั้ง API BaaS พารามิเตอร์นี้ระบุอีเมลที่ใช้เมื่อ API BaaS ส่งอีเมลอัตโนมัติ เช่น เมื่อผู้ใช้ขอรีเซ็ตรหัสผ่าน

ดูข้อมูลอ้างอิงไฟล์กำหนดค่า BaaS

(APIBAAS-2103)

เพิ่มการรองรับเพื่อให้เราเตอร์ Edge และเว็บเซิร์ฟเวอร์ Nginx สำหรับพอร์ทัลเข้าถึงพอร์ต ที่ต่ำกว่า 1000 ได้

ตอนนี้คุณสามารถใช้เว็บเซิร์ฟเวอร์ Router และ Nginx สำหรับพอร์ทัลเพื่อเข้าถึงพอร์ตที่ต่ำกว่า 1000 ได้โดยไม่ต้องเรียกใช้ในฐานะผู้ใช้รายอื่น ในรุ่นก่อนหน้า เว็บเซิร์ฟเวอร์ Router และ Nginx ไม่สามารถเข้าถึงพอร์ตที่ต่ำกว่า 1000 ได้หากไม่ได้เรียกใช้ในฐานะผู้ใช้พิเศษ

เปลี่ยนวิธีกำหนดค่าระดับการบันทึกสำหรับ UI ของ Edge

มีการเปลี่ยนแปลงพร็อพเพอร์ตี้ที่ใช้กำหนดค่าระดับการบันทึกสำหรับ Edge UI ดูพร็อพเพอร์ตี้และขั้นตอนใหม่ได้ที่ การตั้งค่าระดับบันทึกสำหรับ คอมโพเนนต์ Edge

(EDGEUI-886)

บริการ API

กฎการตั้งชื่อคีย์ผู้ใช้และข้อมูลลับที่กำหนดเอง

เราได้อัปเดตกฎการตั้งชื่อและการตรวจสอบสำหรับ การสร้างคีย์และข้อมูลลับของผู้บริโภคที่กำหนดเองสำหรับแอปของนักพัฒนาซอฟต์แวร์ คีย์และข้อมูลลับของผู้บริโภคสามารถ มีตัวอักษร ตัวเลข ขีดล่าง และขีดกลาง ไม่อนุญาตให้ใช้สัญลักษณ์พิเศษอื่นๆ

กระบวนการสร้างคีย์/ข้อมูลลับที่กำหนดเองมีการบันทึกไว้อย่างละเอียดในนำเข้าคีย์และข้อมูลลับของผู้บริโภคที่มีอยู่ (MGMT-3916)

การตรวจสอบชื่อ Keystore และ Target Server

ชื่อของคลังคีย์และเซิร์ฟเวอร์เป้าหมายมีความยาวได้สูงสุด 255 อักขระ และมีตัวอักษร ตัวเลข ช่องว่าง ขีดกลาง ขีดล่าง และจุดได้ ตอนนี้ Edge จะตรวจสอบความถูกต้องนี้ในเวลาที่สร้าง (MGMT-4098)

แก้ไขข้อบกพร่องแล้ว

ข้อบกพร่องต่อไปนี้ได้รับการแก้ไขในรุ่นนี้ โดยรายการนี้มีไว้สำหรับผู้ใช้ที่ต้องการตรวจสอบว่า คำขอรับการสนับสนุนได้รับการแก้ไขแล้วหรือไม่เป็นหลัก ไม่ได้ออกแบบมาเพื่อให้ข้อมูลโดยละเอียดแก่ผู้ใช้ทุกคน

Private Cloud 4.17.09

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

Cloud 17.08.16 (UI)

Cloud 17.08.14 (การจัดการ API และ รันไทม์)

Cloud 17.07.31 (การจัดการ API)

Cloud 17.07.17 (การจัดการ API และ รันไทม์)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (การสร้างรายได้)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (การจัดการ API)

Cloud 17.05.08 (UI)

Cloud 17.04.22 (การจัดการ API)

ปัญหาที่ทราบ

รุ่นนี้มีปัญหาที่ทราบดังต่อไปนี้