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 for 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 ในการติดตาม

เมื่อแก้ไขข้อบกพร่องของพร็อกซี 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

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

การเปิดตัวนี้มีปัญหาที่ทราบดังต่อไปนี้

รหัสปัญหา คำอธิบาย
ไม่มี

สคริปต์ 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)
ก่อนหน้า
4.15.04.01
ถัดไป
4.15.01.08