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

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

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

ชื่อผลิตภัณฑ์เดิม "Apigee Edge ภายในองค์กร" หรือ "OPDK" ได้เปลี่ยนชื่อเป็น "Apigee Edge สำหรับ Private Cloud" แล้ว

หากมีคำถาม โปรดไปที่ฝ่ายสนับสนุนลูกค้าของ Apigee

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

ฟีเจอร์ใหม่และการเพิ่มประสิทธิภาพ

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

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

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

บริการ API

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

WebSockets

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

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

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

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

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

บันทึก Node.js ในการติดตาม

เมื่อแก้ไขข้อบกพร่องของพร็อกซี Node.js API คุณจะเปิดใช้ฟีเจอร์การบันทึก Node.js ในมุมมองการติดตามของเครื่องมือแก้ไขพร็อกซี API ได้ หากต้องการเปิดใช้ฟีเจอร์ ให้ตั้งค่า apigee.feature.disableNodeJSLogs="false" ในไฟล์ apigee-base.conf หรือ apigee-onvenue.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

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

คุณสามารถจำกัดการเป็นสมาชิกในบทบาทอ่านอย่างเดียวของ sysadmin หรือ sysadmin สำหรับผู้ใช้ในโดเมนอีเมลที่ระบุ หากต้องการเปิดใช้ฟีเจอร์นี้ ให้เพิ่มโดเมนที่อนุญาตลงในไฟล์ 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, ผลิตภัณฑ์, นักพัฒนาซอฟต์แวร์ และหน้าแอปใน UI การจัดการ ตัวเลือกการกรองใหม่จะพร้อมใช้งานสำหรับการค้นหา

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

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

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

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

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

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

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

บริการการวิเคราะห์

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

ข้อมูลที่ใช้ได้ 6 เดือน

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

เพิ่มตัวแปรลงใน Analytics แล้ว

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

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

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

การสนับสนุน Swouch 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 - ค่าที่แฮชจะส่งคืนในการตอบกลับโทเค็นเพื่อการเข้าถึงเมื่อแฮช.oauth.tokens.enabled เป็นจริง

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

ขอบเมฆ	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 {โฮสต์} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt apigee4/share/apache-cassandra/bin/cassandra-cli -h {โฮสต์} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318	การเรียก API ที่มีเพย์โหลดขนาดใหญ่ (100 KB) อาจทำให้ค้างในบางครั้ง หากต้องการแก้ปัญหานี้ ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในไฟล์ Router.properties HTTPServer.streaming.buffer.limit=0 (การตั้งค่าเริ่มต้นคือ 10)