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

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

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

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

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

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

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

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

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

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

บริการ API

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

WebSockets

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

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

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

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

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

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

เมื่อแก้ข้อบกพร่องของพร็อกซี API ของ Node.js คุณสามารถเปิดใช้ฟีเจอร์บันทึก Node.js ในมุมมอง Trace ของเครื่องมือแก้ไขพร็อกซี 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 for Private Cloud Operations Guide

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

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

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

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

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

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

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

ดู 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 การจัดการ ตอนนี้มีตัวเลือกการกรองใหม่ สำหรับการค้นหาแล้ว

เครื่องมือ Trace แบบออฟไลน์

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

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

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

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

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

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

บริการ Analytics

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

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

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

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

ระบบจะส่งตัวแปรใหม่ต่อไปนี้ไปยัง Analytics ของ Edge ซึ่งจะแสดงในระยะ AX ของหน้าต่าง Trace ของพร็อกซี 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 มีดังนี้

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

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

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

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

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

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

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

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

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

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

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

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

ระบบคลาวด์ของ Edge	Edge for 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)