4.15.04.00 - บันทึกประจํารุ่น Apigee Edge ของ Private Cloud

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

เมื่อวันอังคารที่ 19 พฤษภาคม 2015 เราได้เปิดตัว Apigee Edge สำหรับ Private Cloud เวอร์ชันรายไตรมาส

ชื่อผลิตภัณฑ์เดิม "Apigee Edge On-Premises" หรือ "OPDK" เปลี่ยนเป็น "Apigee Edge สำหรับ Private Cloud" แล้ว

หากมีข้อสงสัย โปรดติดต่อทีมสนับสนุน Apigee Edge

ดูรายการบันทึกประจำรุ่นของ Apigee Edge ทั้งหมดได้ที่บันทึกประจำรุ่นของ Apigee

ฟีเจอร์ใหม่และการปรับปรุง

ฟีเจอร์ใหม่และการปรับปรุงในรุ่นนี้มีดังนี้

OpenLDAP - การติดตั้งและ การอัปเกรด

ตอนนี้ OpenLDAP เป็นเซิร์ฟเวอร์ LDAP เพียงเซิร์ฟเวอร์เดียวที่ Edge รองรับสำหรับการติดตั้งใหม่และการอัปเกรด

บริการ API

ฟีเจอร์ใหม่และการเพิ่มประสิทธิภาพในบริการ Edge API มีดังนี้

WebSockets

Edge รองรับโปรโตคอล WebSocket เพื่อเปิดใช้การสื่อสารผ่านเว็บแบบเรียลไทม์ระหว่างไคลเอ็นต์และเซิร์ฟเวอร์ของเว็บ Edge สามารถทำหน้าที่เป็นไคลเอ็นต์หรือเซิร์ฟเวอร์ในการสื่อสารผ่าน WebSocket ได้ ดูข้อมูลเกี่ยวกับการตั้งค่าและการใช้ WebSocket ใน Edge ได้ที่คู่มือ Apigee Edge สำหรับ Private Cloud โดยใช้ WebSocket

การรองรับผู้ให้บริการตรวจสอบสิทธิ์ภายนอกสำหรับการจัดการ API

Edge ผสานรวมกับ Active Directory และผู้ให้บริการตรวจสอบสิทธิ์ภายนอก/ระบบ LDAP อื่นๆ ที่มีผู้ใช้ที่เป็นผู้ดูแลระบบ API ดูข้อมูลเพิ่มเติมได้ที่คู่มือการกำหนดค่าการตรวจสอบสิทธิ์ภายนอกสำหรับ Edge สำหรับ Private Cloud

การสร้างแบรนด์ร่วมใน UI การจัดการ

คุณสามารถร่วมสร้างแบรนด์ UI การจัดการ Edge ด้วยโลโก้ที่กำหนดเองของคุณเอง ซึ่งจะปรากฏข้างโลโก้ Apigee ดูข้อมูลเพิ่มเติมได้ที่ "การเพิ่มโลโก้ที่กำหนดเองลงในเมนู UI ของ Apigee" ในคู่มือการใช้งาน Apigee Edge สำหรับ Private Cloud

บันทึก Node.js ใน Trace

เมื่อแก้ไขข้อบกพร่องของพร็อกซี API ของ Node.js คุณจะเปิดใช้ฟีเจอร์บันทึกของ Node.js ในมุมมองการติดตามของเครื่องมือแก้ไขพร็อกซี API ได้ หากต้องการเปิดใช้ฟีเจอร์นี้ ให้ตั้งค่า apigee.feature.disableNodeJSLogs="false" ในไฟล์ apigee-base.conf หรือ apigee-onpremise.conf ในการติดตั้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับบันทึก Node.js ได้ที่ การแก้ไขข้อบกพร่องและการแก้ปัญหา พร็อกซี Node.js

การหมดอายุของรหัสผ่าน

ใน Edge 4.15.01.x รหัสผ่านของ Edge จะหมดอายุโดยอัตโนมัติหลังจากผ่านไป 30 วัน ซึ่งหมายความว่าผู้ใช้ จะถูกล็อกไม่ให้เข้าถึงบัญชีจนกว่าจะเปลี่ยนรหัสผ่านก่อนที่รหัสผ่านจะหมดอายุ แต่ก็ทำให้รหัสผ่านของผู้ดูแลระบบหมดอายุด้วย จึงทำให้ผู้ดูแลระบบถูกล็อกไม่ให้เข้า Edge

เมื่ออัปเกรดเป็น 4.15.04.00 ค่าเริ่มต้นจะเปลี่ยนเพื่อให้รหัสผ่านไม่หมดอายุ หากจำเป็น คุณสามารถกำหนดค่าให้รหัสผ่านของ Edge หมดอายุได้โดยใช้สคริปต์ /opt/apigee4/bin/apigee-enable-pwlockout.sh ดูข้อมูลเพิ่มเติมได้ในคู่มือการใช้งาน Apigee Edge สำหรับ Private Cloud

การจำกัดสิทธิ์เข้าถึงของผู้ดูแลระบบให้เฉพาะโดเมนอีเมลที่เจาะจง

คุณสามารถจำกัดการเป็นสมาชิกในบทบาทผู้ดูแลระบบหรือบทบาทผู้ดูแลระบบแบบอ่านอย่างเดียวไว้เฉพาะผู้ใช้ในโดเมนอีเมลที่เฉพาะเจาะจงได้ หากต้องการเปิดใช้ฟีเจอร์นี้ ให้เพิ่มโดเมนที่อนุญาตลงในไฟล์ apigee4/conf/apigee/management-server/security.properties ตามที่อธิบายไว้ในคู่มือการปฏิบัติงาน Apigee Edge สำหรับ Private Cloud

ข้อความแสดงข้อผิดพลาดของ UI การจัดการ

เราได้ออกแบบการแสดงข้อความแสดงข้อผิดพลาดใน UI การจัดการใหม่เพื่อให้ใช้พื้นที่หน้าจอได้อย่างมีประสิทธิภาพมากขึ้น

ตัวแปรข้อผิดพลาด OAuthV2 ใหม่

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

• oauthV2.<policy-name>.failed - ตั้งค่าเป็น "จริง" หากนโยบาย ล้มเหลว
• oauthv2.<policy_name>.<fault_name> - ชื่อของ ข้อผิดพลาด เช่น invalid_request
• oauthv2.<policy_name>.<fault_cause> - เหตุผลที่เกิดข้อผิดพลาด เช่น โทเค็นหมดอายุแล้ว

ดู http://apigee.com/docs/api-services/content/oauthv2-policy

การสร้างผลิตภัณฑ์

ตอนนี้เมื่อสร้างผลิตภัณฑ์ใหม่ คุณจะระบุชื่อผลิตภัณฑ์นอกเหนือจากชื่อที่แสดงได้แล้ว

ดู http://apigee.com/docs/developer-services/content/creating-api-products

UI สำหรับการนำผู้ใช้ออกจากองค์กร

ในหน้าผู้ใช้ขององค์กรใน UI เราได้แทนที่ปุ่มลบด้วยปุ่มนำออก เพื่อช่วยให้ทราบอย่างชัดเจนว่าเมื่อคุณนำผู้ใช้ออกจากองค์กร บัญชี Apigee ของผู้ใช้รายนั้นจะยังคงใช้งานได้

ดู http://apigee.com/docs/api-services/content/managing-organization-users

ตัวเลือกการกรองใน UI การจัดการ

ในหน้า API Proxy, ผลิตภัณฑ์, นักพัฒนาแอป และแอปใน UI การจัดการ จะมีตัวเลือกการกรองใหม่สำหรับการค้นหา

เครื่องมือการติดตามแบบออฟไลน์

เครื่องมือการติดตามแบบออฟไลน์ช่วยให้คุณดูและวิเคราะห์เซสชันการติดตามที่บันทึกไว้ก่อนหน้านี้ได้ เซสชันการติดตามที่บันทึกไว้โดยพื้นฐานแล้วคือ "การบันทึก" เซสชันการติดตาม และอาจมีประโยชน์ในกรณีที่ต้องแก้ปัญหาและวิเคราะห์เพิ่มเติม UI ของเครื่องมือติดตามแบบออฟไลน์จะ คล้ายกับเครื่องมือติดตาม "สด"

ดูข้อมูลเพิ่มเติมได้ที่การใช้เครื่องมือติดตามแบบออฟไลน์

บทบาทของผู้ใช้ที่แสดงในการตั้งค่าผู้ใช้

ตอนนี้บทบาทของผู้ใช้จะแสดงในหน้าการตั้งค่าผู้ใช้ของ UI การจัดการ (ชื่อผู้ใช้ > การตั้งค่าผู้ใช้) แล้ว

การเพิ่มประสิทธิภาพ UI การจัดการ Edge

รุ่นนี้มีการปรับปรุงการใช้งานและความสอดคล้องเล็กๆ น้อยๆ หลายอย่างใน UI การจัดการ Edge

บริการ Analytics

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

ข้อมูล 6 เดือนที่พร้อมใช้งาน

เมื่อสร้างรายงานข้อมูลวิเคราะห์ด้วย UI หรือ API การจัดการ ระบบจะเข้าถึงข้อมูลที่เก่ากว่า 6 เดือนนับจากวันที่ปัจจุบันไม่ได้โดยค่าเริ่มต้น หากต้องการเข้าถึงข้อมูลที่เก่ากว่า 6 เดือน โปรดติดต่อทีมสนับสนุนของ Apigee Edge

เพิ่มตัวแปรลงในข้อมูลวิเคราะห์แล้ว

ระบบจะส่งตัวแปรใหม่ต่อไปนี้ไปยังการวิเคราะห์ที่ Edge ซึ่งจะแสดงในขั้นตอน AX ของหน้าต่างการติดตามพร็อกซี API

• apigee.edge.execution.is_target_error - ช่วยให้คุณระบุได้ว่าข้อผิดพลาดของ API เป็นข้อผิดพลาดฝั่งเป้าหมาย (ค่า "1") หรือข้อผิดพลาดที่ไม่ใช่เป้าหมายสำหรับการตอบกลับ HTTP ที่ไม่สำเร็จ (ค่า "0") ค่าจะเป็น Null สำหรับการตอบกลับ HTTP ที่สำเร็จ
• apigee.edge.execution.is_policy_error - ช่วยให้คุณระบุได้ว่านโยบาย ล้มเหลว (ค่า "1") หรือไม่มีนโยบายใดล้มเหลวในการตอบกลับ HTTP ที่ไม่สําเร็จ (ค่า "0") ค่า จะเป็น Null สำหรับการตอบกลับ HTTP ที่สำเร็จ
  ตัวแปรที่เกี่ยวข้องต่อไปนี้จะให้รายละเอียดของนโยบายที่ล้มเหลวก่อน ค่า จะเป็น Null หากไม่มีนโยบายใดล้มเหลว
  • apigee.edge.execution.fault_policy_name - ชื่อนโยบาย ที่ไม่สำเร็จ
  • apigee.edge.execution.fault_flow_name - ชื่อของโฟลว์ใน นโยบายที่ไม่สำเร็จ (เช่น PreFlow, PostFlow หรือโฟลว์ที่ผู้ใช้กำหนด)
  • apigee.edge.execution.fault_flow_state - ตำแหน่งที่แนบนโยบายในโฟลว์ ค่าที่เป็นไปได้ ได้แก่ PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW

แดชบอร์ด

• แผนภูมิประสิทธิภาพสำหรับ API, นักพัฒนาซอฟต์แวร์, ผลิตภัณฑ์ และแอปของนักพัฒนาซอฟต์แวร์ได้ย้ายไปแล้ว โดยก่อนหน้านี้จะแสดงที่ด้านล่างของหน้าหลักสำหรับเอนทิตีเหล่านี้ ตอนนี้คุณเข้าถึงแผนภูมิได้โดย เลือกแท็บข้อมูลวิเคราะห์ที่ด้านบนของแต่ละหน้า
• การเปิดตัวนี้รวมถึงการปรับปรุงที่สำคัญในแดชบอร์ดที่มีอยู่หรือแดชบอร์ดใหม่ต่อไปนี้
  • แดชบอร์ด Apigee (แก้ไข): มีแผนภูมิเมตริก 3 รายการ ได้แก่ การเข้าชมพร็อกซี การมีส่วนร่วมของนักพัฒนาแอป และแอปของนักพัฒนาแอป แผนภูมิแต่ละรายการมีมุมมอง "รายละเอียดเพิ่มเติม" ที่ช่วยให้คุณเจาะลึกเมตริกแต่ละรายการได้ ดูแดชบอร์ด Apigee
  • ประสิทธิภาพของพร็อกซี (ใหม่): แสดงรูปแบบการรับส่งข้อมูลของพร็อกซี API และเวลาในการประมวลผล แทนที่แดชบอร์ดประสิทธิภาพของพร็อกซี API ดูพร็อกซี API ประสิทธิภาพ
  • องค์ประกอบของการเข้าชม (แก้ไข): ปรับปรุงรูปลักษณ์ ความรู้สึก และเนื้อหาของแดชบอร์ดใหม่ทั้งหมด วัดสัดส่วนการมีส่วนร่วมของ API, แอป, นักพัฒนาซอฟต์แวร์ และผลิตภัณฑ์ยอดนิยมต่อโปรแกรม API โดยรวม ดูองค์ประกอบของการเข้าชม
  • การวิเคราะห์ข้อผิดพลาด (แก้ไขแล้ว): ปรับปรุงรูปลักษณ์และเนื้อหาใหม่ทั้งหมด แสดงอัตราข้อผิดพลาดสำหรับพร็อกซี API และเป้าหมาย ดูแดชบอร์ดการวิเคราะห์รหัสข้อผิดพลาด
• ระบบได้เปลี่ยนชื่อแดชบอร์ดที่มีอยู่ดังนี้
  • ประสิทธิภาพของปลายทางเปลี่ยนชื่อเป็นประสิทธิภาพ เป้าหมาย: แสดงรูปแบบการรับส่งข้อมูลและเมตริกประสิทธิภาพสำหรับเป้าหมายแบ็กเอนด์ของพร็อกซี API ดูเป้าหมาย ด้านประสิทธิภาพ
  • การมีส่วนร่วมของพาร์ทเนอร์เปลี่ยนชื่อเป็นการมีส่วนร่วมของนักพัฒนาแอป : แสดงให้เห็นว่านักพัฒนาแอปที่ลงทะเบียนรายใดสร้างการเข้าชม API มากที่สุด คุณสามารถดูได้ว่านักพัฒนาแอปคนใดสร้างการเข้าชม API และข้อผิดพลาดมากที่สุด สำหรับนักพัฒนาแอปแต่ละคน ดูการมีส่วนร่วมของนักพัฒนาแอป

บริการสำหรับนักพัฒนาแอป

ฟีเจอร์ใหม่และการเพิ่มประสิทธิภาพในบริการสำหรับนักพัฒนาซอฟต์แวร์ของ Edge มีดังนี้

การรองรับ Swagger 2.0 สำหรับ SmartDocs

SmartDocs รองรับการนำเข้าเอกสารข้อกำหนดของ Swagger 2.0 และยังคงรักษาความเข้ากันได้แบบย้อนกลับกับ Swagger 1.2 การรองรับออบเจ็กต์รูปแบบความปลอดภัยและสคีมาแบบรวมศูนย์จะพร้อมใช้งานในรุ่นถัดไป

การสร้างรายได้

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

การจัดการบริษัทและนักพัฒนาแอปแยกกัน

ตอนนี้เราจะจัดการบริษัทและนักพัฒนาแอปแยกกัน ซึ่งจะช่วยให้เพิ่ม บริษัทหลายแห่งให้กับนักพัฒนาแอป และเพิ่มนักพัฒนาแอปหลายรายให้กับบริษัทได้อย่างยืดหยุ่นมากขึ้น ตอนนี้ UI การจัดการมีหน้าต่างแยกต่างหากสำหรับ "บริษัท" และ "นักพัฒนาแอป" (เข้าถึงได้จากเมนู "เผยแพร่")

ดูจัดการบริษัทและ นักพัฒนาแอป

ในรายงานการสร้างรายได้ บริษัทจะยังคงเป็นตัวกรองหลัก แม้ว่าป้ายกำกับตัวกรองจะเปลี่ยนจาก "นักพัฒนาแอป" เป็น "บริษัท" แล้วก็ตาม

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

ข้อบกพร่องต่อไปนี้ได้รับการแก้ไขในรุ่นนี้

รหัสปัญหา	คำอธิบาย
OPDK-954	4.15.01 ไม่ได้อัปเกรดสคีมา Cassandra
MGMT-1986	ข้อผิดพลาดของ UI ขณะเพิ่มนักพัฒนาแอป
MGMT-1983	API รับรหัสการให้สิทธิ์ OAuth 2.0 แสดงสถานะไม่ถูกต้อง
MGMT-1962	ข้อผิดพลาดในการเข้าสู่ระบบ UI การจัดการด้วยรหัสผ่านที่รัดกุม การเข้าสู่ระบบ UI ด้วยอักขระพิเศษบางอย่าง เช่น เครื่องหมายเปอร์เซ็นต์ จะไม่ ล้มเหลวอีกต่อไป
MGMT-1894	หน้าแอปของนักพัฒนาแอปโหลดไม่เสร็จสำหรับคอลัมน์นักพัฒนาแอป
MGMT-1872	ดาวน์โหลดรายงานที่กำหนดเองไม่ได้
MGMT-1777	เพิ่มผู้ใช้ที่มีอีเมลซึ่งมี TLD เป็น .acn ไม่ได้
MGMT-1362	อีเมลลืมรหัสผ่านใช้ไม่ได้หากอีเมลมี '_' แก้ไขปัญหาการรีเซ็ตรหัสผ่านใน Private Cloud ด้วยอีเมลที่มี ขีดล่าง
CORERT-613	แฮนด์เชค SSL ไม่สำเร็จเนื่องจาก "unrecognized_name"
APIRT-1346	OAuth2.0 - ระบบจะแสดงค่าที่แฮชในการตอบกลับโทเค็นเพื่อการเข้าถึงเมื่อ hash.oauth.tokens.enabled เป็นจริง

นอกจากนี้ รุ่นนี้ยังมีการแก้ไขข้อบกพร่องจากรุ่นต่อไปนี้ด้วย

Edge Cloud	Edge สำหรับ Private Cloud
15.03.18 15.02.18 15.02.04 15.01.21 (การสร้างรายได้)	4.15.01.03 4.15.01.01 4.14.07.05 4.14.04.14 4.14.04.13 4.14.04.12

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

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

รหัสปัญหา	คำอธิบาย
ไม่มี	สคริปต์ Cassandra 2 รายการที่โปรแกรมติดตั้งใช้ในการติดตั้งหรืออัปเกรดการสร้างรายได้ ไม่ได้รวมอยู่ในการเปิดตัว หากต้องการหลีกเลี่ยงปัญหานี้ ให้เรียกใช้คำสั่งต่อไปนี้หลังจากการติดตั้งหรืออัปเกรด Cassandra เพื่อดำเนินการติดตั้ง/อัปเกรดการสร้างรายได้ให้เสร็จสมบูรณ์ apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318	บางครั้งการเรียก API ที่มีเพย์โหลดขนาดใหญ่ (หลายร้อย KB) อาจหยุดทำงาน หากต้องการแก้ไขปัญหานี้ ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในไฟล์ router.properties HTTPServer.streaming.buffer.limit=0 (การตั้งค่าเริ่มต้นคือ 10)