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

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

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

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

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

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

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

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

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

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

บริการ API

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

WebSockets

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

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

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

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

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

บันทึก 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 สําหรับระบบคลาวด์ส่วนตัว

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

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

ข้อความแสดงข้อผิดพลาดใน 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

บริการ Analytics

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

มีข้อมูล 6 เดือน

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

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

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

• apigee.edge.execution.is_target_error - ช่วยให้คุณระบุได้ว่าข้อผิดพลาดของ API เป็นข้อผิดพลาดฝั่งเป้าหมาย (ค่า "1") หรือข้อผิดพลาดที่ไม่ใช่ฝั่งเป้าหมายสำหรับการตอบกลับ HTTP ที่ไม่สําเร็จ (ค่า "0") ค่าจะเป็นค่าว่างสำหรับการตอบกลับ HTTP ที่สำเร็จ
• apigee.edge.execution.is_policy_error - ช่วยให้คุณระบุได้ว่านโยบายทำงานไม่สำเร็จ (ค่า "1") หรือไม่มีนโยบายใดทำงานไม่สำเร็จในการตอบกลับ HTTP ที่ไม่สำเร็จ (ค่า "0") ค่าจะเป็นค่าว่างสำหรับการตอบกลับ 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	Get an OAuth 2.0 authorization code API returns wrong status
MGMT-1962	ข้อผิดพลาดในการเข้าสู่ระบบ UI การจัดการด้วยรหัสผ่านที่รัดกุม การเข้าสู่ระบบ UI ด้วยสัญลักษณ์พิเศษบางรายการ เช่น เครื่องหมายเปอร์เซ็นต์ จะไม่ล้มเหลวอีกต่อไป
MGMT-1894	หน้าแอปของนักพัฒนาแอปไม่โหลดคอลัมน์นักพัฒนาแอปจนเสร็จสิ้น
MGMT-1872	ดาวน์โหลดรายงานที่กําหนดเองไม่ได้
MGMT-1777	เพิ่มผู้ใช้ที่มีอีเมลที่มี TLD เป็น .acn ไม่ได้
MGMT-1362	อีเมล "ลืมรหัสผ่าน" ไม่ทำงานหากอีเมลมี '_' แก้ไขปัญหาการรีเซ็ตรหัสผ่านในระบบคลาวด์ส่วนตัวที่มีอีเมลที่มีขีดล่าง
CORERT-613	SSL Handshake ไม่สำเร็จเนื่องจาก "unrecognized_name"
APIRT-1346	OAuth2.0 - ระบบจะแสดงผลค่าที่ผ่านการแฮชในการตอบกลับโทเค็นการเข้าถึงเมื่อ hash.oauth.tokens.enabled เป็นจริง

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

Edge Cloud	Edge สำหรับระบบคลาวด์ส่วนตัว
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)