ปัญหาที่ทราบเกี่ยวกับ Apigee

เมื่อใช้ตัวแปรโฟลว์ cachehit หลังนโยบาย LookupCache เนื่องจากวิธีการส่งจุดแก้ไขข้อบกพร่องสำหรับลักษณะการทำงานแบบอะซิงโครนัส LookupPolicy จะเติมออบเจ็กต์ DebugInfo ก่อนเรียกใช้การเรียกกลับ ซึ่งทำให้เกิดข้อผิดพลาด

วิธีแก้ปัญหา: ทำขั้นตอนนี้ซ้ำ (ทำการโทรครั้งที่ 2) อีกครั้งทันทีหลังจากที่โทรครั้งแรก

การตั้งค่า PurgeChildEntries ในนโยบาย invalidateCache ควรลบค่าองค์ประกอบ KeyFragment ออกถาวรเท่านั้น แต่จะล้างแคชทั้งหมด

วิธีแก้ปัญหา: ใช้นโยบาย KeyValueMapEnforcements เพื่อทำซ้ำการกำหนดเวอร์ชันแคชและข้ามความจำเป็นในการทำให้แคชใช้งานไม่ได้

• Apigee Edge รองรับข้อมูลจำเพาะของ OpenAPI 3.0 เมื่อคุณสร้างข้อกำหนดเฉพาะโดยใช้เครื่องมือแก้ไขข้อกำหนดและเผยแพร่ API โดยใช้ SmartDocs ในพอร์ทัลของคุณ แม้ว่าบางส่วนของฟีเจอร์จะยังไม่ได้รับการสนับสนุน

  ตัวอย่างเช่น ระบบจะยังไม่รองรับฟีเจอร์จาก OpenAPI Specification 3.0 ดังต่อไปนี้

  • พร็อพเพอร์ตี้ allOf สำหรับการรวมและขยายสคีมา
  • การอ้างอิงระยะไกล

  หากมีการอ้างถึงฟีเจอร์ที่ไม่รองรับในข้อมูลจำเพาะของ OpenAPI ในบางกรณี เครื่องมือจะไม่สนใจฟีเจอร์ดังกล่าว แต่จะยังแสดงผลเอกสารอ้างอิง API อยู่ ในกรณีอื่นๆ ฟีเจอร์ที่ไม่รองรับจะทำให้เกิดข้อผิดพลาดที่ขัดขวางการแสดงผลเอกสารอ้างอิง API ได้สำเร็จ ไม่ว่าในกรณีใด คุณจะต้องแก้ไขข้อกําหนดของ OpenAPI เพื่อหลีกเลี่ยงการใช้ฟีเจอร์ที่ไม่รองรับจนกว่าจะรองรับในรุ่นต่อๆ ไป

  หมายเหตุ: เนื่องจากตัวแก้ไขข้อกำหนดมีข้อจำกัดน้อยกว่า SmartDocs เมื่อแสดงผลเอกสารอ้างอิง API คุณจึงอาจได้ผลลัพธ์ที่แตกต่างกันระหว่างเครื่องมือ

• เมื่อใช้ "ลองใช้ API นี้ในพอร์ทัล" ระบบจะตั้งค่าส่วนหัว Accept เป็น application/json ไม่ว่าชุดค่าสำหรับ consumes ในข้อกำหนดของ OpenAPI จะเป็นอย่างไรก็ตาม

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

• การค้นหาจะรวมอยู่ในพอร์ทัลที่ผสานรวมในรุ่นต่อๆ ไป

สำหรับ Edge for Private Cloud 4.53.00 การตั้งค่าคลัสเตอร์ใหม่ทำได้ผ่านขั้นตอนการติดตั้งใหม่เท่านั้น ไม่รองรับการอัปเกรดในสถานที่ หากคุณใช้ Edge for Private Cloud เวอร์ชันเก่าอยู่ คุณจะอัปเกรดเป็น Edge for Private Cloud 4.53.00 โดยตรงไม่ได้

แม้ว่าระบบจะไม่รองรับการอัปเกรดในตัว แต่คุณตั้งค่า 4.53.00 Edge ใหม่สำหรับคลัสเตอร์ Private Cloud ได้ และใช้ API การจัดการเพื่อส่งออกข้อมูลจากคลัสเตอร์เก่าและนำเข้าไปยังคลัสเตอร์ 4.53.00 ใหม่ได้

ปัญหานี้ส่งผลกระทบต่อผู้ใช้ที่พยายามติดตั้ง SSO หรือ UI ใหม่ใน RHEL 8 ที่เปิดใช้ FIPS ใน Edge for Private Cloud 4.53.00

คอมโพเนนต์ที่ได้รับผลกระทบ: SSO และ UI ใหม่

ปัญหา: หากคุณติดตั้ง SSO หรือ UI ใหม่ในระบบปฏิบัติการ RHEL 8 ที่เปิดใช้ FIPS การติดตั้งจะดำเนินการไม่สำเร็จ

วิธีแก้ปัญหา: เราขอแนะนำให้ใช้ UI แบบคลาสสิกซึ่งมีฟีเจอร์ครบถ้วนและตรงตามความต้องการด้านฟังก์ชันการทำงานของ UI

ปัญหานี้ส่งผลกระทบต่อผู้ที่ใช้ MINT หรือเปิดใช้ MINT ในการติดตั้ง Edge สำหรับ Private Cloud เท่านั้น

คอมโพเนนต์ที่ได้รับผลกระทบ: edge-message-processor

ปัญหา: หากเปิดใช้การสร้างรายได้และกำลังติดตั้ง 4.52.01 เป็นการติดตั้งใหม่หรืออัปเกรดจากเวอร์ชัน Private Cloud ก่อนหน้า คุณอาจพบปัญหาเกี่ยวกับโปรแกรมประมวลผลข้อความ จำนวนชุดข้อความที่เปิดอยู่จะค่อยๆ เพิ่มขึ้นจนทำให้ทรัพยากรหมด พบข้อยกเว้นต่อไปนี้ใน system.log ของ edge-message-processor

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

เมื่อเร็วๆ นี้มีการค้นพบช่องโหว่การปฏิเสธการให้บริการ (DoS) ในการใช้งานโปรโตคอล HTTP/2 หลายครั้ง (CVE-2023-44487) ซึ่งรวมถึงใน Apigee Edge สําหรับระบบคลาวด์ส่วนตัว ช่องโหว่นี้อาจทําให้ฟังก์ชันการจัดการ Apigee API เกิดการโจมตีแบบ DoS โปรดดูรายละเอียดเพิ่มเติมที่กระดานข่าวสารด้านความปลอดภัยของ Apigee GCP-2023-032

คอมโพเนนต์เราเตอร์และเซิร์ฟเวอร์การจัดการ Edge for Private Cloud เปิดเผยต่ออินเทอร์เน็ตและอาจมีช่องโหว่ แม้ว่าจะมีการเปิดใช้ HTTP/2 ในพอร์ตการจัดการของคอมโพเนนต์อื่นๆ สำหรับ Edge โดยเฉพาะของ Edge สำหรับ Private Cloud แต่ไม่มีคอมโพเนนต์ใดที่เปิดเผยต่ออินเทอร์เน็ต สำหรับคอมโพเนนต์ที่ไม่ใช่ Edge เช่น Cassandra, Zookeeper และอื่นๆ จะไม่มีการเปิดใช้ HTTP/2 เราขอแนะนําให้คุณทําตามขั้นตอนต่อไปนี้เพื่อจัดการช่องโหว่ของ Edge for Private Cloud

• ขั้นตอนสำหรับ Edge for Private Cloud เวอร์ชัน 4.51.00.11 ขึ้นไป
• ขั้นตอนสำหรับ Edge สำหรับ Private Cloud เวอร์ชันเก่ากว่า 4.51.00.11

ทําตามขั้นตอนต่อไปนี้หากคุณใช้ Edge Private Cloud เวอร์ชัน 4.51.00.11 ขึ้นไป

1. อัปเดตเซิร์ฟเวอร์การจัดการ

   1. ในโหนดเซิร์ฟเวอร์การจัดการแต่ละโหนด ให้เปิด /opt/apigee/customer/application/management-server.properties
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์เซิร์ฟเวอร์การจัดการโดยทำดังนี้

      apigee-service edge-management-server restart

2. อัปเดตโปรแกรมประมวลผลข้อความ

   1. ในโหนดโปรแกรมประมวลผลข้อความแต่ละโหนด ให้เปิด /opt/apigee/customer/application/message-processor.properties
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-message-processor restart

3. อัปเดตเราเตอร์โดยทำดังนี้

   1. เปิด /opt/apigee/customer/application/router.properties บนโหนดเราเตอร์แต่ละโหนด
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-router restart

4. อัปเดต QPID

   1. เปิด /opt/apigee/customer/application/qpid-server.properties ในโหนด QPID แต่ละโหนด
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-qpid-server restart

5. อัปเดต Postgres:

   1. ในโหนด Postgres แต่ละโหนด ให้เปิด /opt/apigee/customer/application/postgres-server.properties
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความ โดยทำดังนี้

      apigee-service edge-postgres-server restart

ทําตามขั้นตอนต่อไปนี้หากคุณใช้ Edge for Private Cloud เวอร์ชันเก่ากว่า 4.51.00.11

1. อัปเดตเซิร์ฟเวอร์การจัดการ

   1. ในแต่ละโหนดเซิร์ฟเวอร์การจัดการ ให้เปิด /opt/apigee/customer/application/management-server.properties
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์เซิร์ฟเวอร์การจัดการโดยทำดังนี้

      apigee-service edge-management-server restart

2. อัปเดตโปรแกรมประมวลผลข้อความ

   1. ในโหนดโปรแกรมประมวลผลข้อความแต่ละโหนด ให้เปิด /opt/apigee/customer/application/message-processor.properties
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความ โดยทำดังนี้

      apigee-service edge-message-processor restart

3. อัปเดตเราเตอร์โดยทำดังนี้

   1. เปิด /opt/apigee/customer/application/router.properties ในโหนดเราเตอร์แต่ละโหนด
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-router restart

4. อัปเดต QPID:

   1. เปิด /opt/apigee/customer/application/qpid-server.properties ในโหนด QPID แต่ละโหนด
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-qpid-server restart

5. อัปเดต Postgres:

   1. ในโหนด Postgres แต่ละโหนด ให้เปิด /opt/apigee/customer/application/postgres-server.properties
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-postgres-server restart

Apigee-postgresql พบปัญหาในการอัปเกรดจาก Edge สำหรับ Private Cloud เวอร์ชัน 4.50 หรือ 4.51 เป็นเวอร์ชัน 4.52 ปัญหาส่วนใหญ่เกิดขึ้นเมื่อจำนวนตารางมากกว่า 500

คุณสามารถตรวจสอบจํานวนตารางทั้งหมดใน Postgres ได้โดยเรียกใช้การค้นหา SQL ด้านล่าง

select count(*) from information_schema.tables

วิธีแก้ปัญหา: เมื่อ อัปเดต Apigee Edge 4.50.00 หรือ 4.51.00 เป็น 4.52.00 โปรดตรวจสอบว่าได้ดำเนินการ ขั้นตอนเบื้องต้นก่อนอัปเกรด Apigee-postgresql

apigee-mirror ไม่ทำงานใน Red Hat Enterprise Linux (RHEL) 8.0

วิธีแก้ปัญหา: วิธีแก้ไขปัญหาเบื้องต้นคือให้ติดตั้ง apigee-mirror ในเซิร์ฟเวอร์ที่ใช้ RHEL เวอร์ชันต่ำกว่าหรือระบบปฏิบัติการอื่นที่รองรับสำหรับ Apigee จากนั้นคุณจะใช้มิเรอร์เพื่อเพิ่มแพ็กเกจได้แม้ว่าจะติดตั้ง Apigee ในเซิร์ฟเวอร์ RHEL 8.0 ก็ตาม

149245401: การตั้งค่าพูลการเชื่อมต่อ LDAP สําหรับ JNDI ที่กําหนดค่าผ่านทรัพยากร LDAP จะไม่แสดง และค่าเริ่มต้นของ JNDI จะทําให้การเชื่อมต่อเป็นแบบใช้ครั้งเดียวทุกครั้ง ด้วยเหตุนี้ ระบบจึงเปิดและปิดการเชื่อมต่อทุกครั้งเพื่อการใช้งานครั้งเดียว ซึ่งจะสร้างการเชื่อมต่อกับเซิร์ฟเวอร์ LDAP เป็นจำนวนมากต่อชั่วโมง

วิธีแก้ปัญหา

หากต้องการเปลี่ยนพร็อพเพอร์ตี้พูลการเชื่อมต่อ LDAP ให้ทําตามขั้นตอนต่อไปนี้เพื่อตั้งค่าการเปลี่ยนแปลงแบบรวมในนโยบาย LDAP ทั้งหมด

1. สร้างไฟล์พร็อพเพอร์ตี้การกําหนดค่า หากยังไม่มี

   /opt/apigee/customer/application/message-processor.properties

2. เพิ่มข้อมูลต่อไปนี้ลงในไฟล์ (แทนที่ค่าของพร็อพเพอร์ตี้ Java Naming and Directory Interface (JNDI) ตามข้อกำหนดในการกําหนดค่าทรัพยากร LDAP)

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. ตรวจสอบว่าไฟล์ /opt/apigee/customer/application/message-processor.properties เป็นของ apigee:apigee
4. รีสตาร์ทโปรแกรมประมวลผลข้อความแต่ละตัว

หากต้องการยืนยันว่าพร็อพเพอร์ตี้ JNDI ของพูลการเชื่อมต่อมีผล ให้ใช้ tcpdump เพื่อสังเกตลักษณะการทํางานของพูลการเชื่อมต่อ LDAP เมื่อเวลาผ่านไป

139051927: เวลาในการตอบสนองการประมวลผลพร็อกซีสูงที่พบในตัวประมวลผลข้อความกำลังส่งผลต่อ พร็อกซี API ทั้งหมด อาการแสดง ได้แก่ เวลาในการประมวลผลที่ล่าช้า 200-300 มิลลิวินาทีกว่าเวลาในการตอบกลับ API ปกติ และอาจเกิดขึ้นแบบสุ่มแม้ว่า TPS จะต่ำก็ตาม กรณีนี้อาจเกิดขึ้นเมื่อเซิร์ฟเวอร์เป้าหมายที่โปรแกรมประมวลผลข้อความเชื่อมต่อมีมากกว่า 50 เซิร์ฟเวอร์

สาเหตุที่แท้จริง: โปรแกรมประมวลผลข้อความจะเก็บแคชที่แมป URL ของเซิร์ฟเวอร์เป้าหมายกับออบเจ็กต์ HTTPClient สำหรับการเชื่อมต่อขาออกไปยังเซิร์ฟเวอร์เป้าหมาย โดยค่าเริ่มต้นการตั้งค่านี้จะมีค่าเป็น 50 ซึ่งอาจต่ำเกินไปสําหรับการใช้งานส่วนใหญ่ เมื่อการทําให้การเผยแพร่มีองค์กร/สภาพแวดล้อมหลายรายการในการตั้งค่า และเซิร์ฟเวอร์เป้าหมายจํานวนมากเกิน 50 รายการ ระบบจะนํา URL ของเซิร์ฟเวอร์เป้าหมายออกจากแคชอยู่เรื่อยๆ ซึ่งทําให้เกิดความล่าช้า

การตรวจสอบ: หากต้องการตรวจสอบว่าการลบ URL ของเซิร์ฟเวอร์เป้าหมายเป็นสาเหตุของปัญหาเวลาในการตอบสนองหรือไม่ ให้ค้นหาคีย์เวิร์ด "onEvict" หรือ "Eviction" ใน system.logs ของ Message Processor การมี URL ในบันทึกแสดงให้เห็นว่า URL ของเซิร์ฟเวอร์เป้าหมายจะถูกนําออกจากแคช HTTPClient เนื่องจากแคชมีขนาดเล็กเกินไป

วิธีแก้ปัญหา: สำหรับ Edge for Private Cloud เวอร์ชัน 19.01 และ 19.06 คุณสามารถแก้ไขและกำหนดค่าแคช HTTPClient /opt/apigee/customer/application/message-processor.properties ได้โดยทำดังนี้

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

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

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

หมายเหตุ: Edge for Private Cloud เวอร์ชัน 50.00 มีการตั้งค่าเริ่มต้นเป็น 500

157933959: การแทรกและอัปเดตพร้อมกันในแมปค่าคีย์ (KVM) เดียวกันที่กำหนดขอบเขตที่ระดับองค์กรหรือสภาพแวดล้อมจะทำให้ข้อมูลไม่สอดคล้องกันและการอัปเดตสูญหาย

หมายเหตุ: ข้อจำกัดนี้มีผลกับ Edge สำหรับ Private Cloud เท่านั้น Edge สำหรับระบบคลาวด์สาธารณะและระบบไฮบริดไม่มีข้อจำกัดนี้

หากต้องการแก้ปัญหาเบื้องต้นใน Edge สำหรับ Private Cloud ให้สร้าง KVM ที่ขอบเขต apiproxy