คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info
ส่วนนี้จะให้คําแนะนําเกี่ยวกับวิธีวางแผนและดําเนินการย้ายข้อมูลเนื้อหาของพอร์ทัล Drupal 7 ไปยังพอร์ทัลแบบรวม
ขั้นตอนที่ 1: สร้างพอร์ทัลแบบรวม
คุณต้องสร้างพอร์ทัลแบบรวมก่อนจึงจะย้ายข้อมูลชิ้นงานพอร์ทัล Drupal 7 ได้
วิธีสร้างพอร์ทัลแบบรวม
- ตรวจสอบว่าคุณมีบทบาทในพอร์ทัลที่เหมาะสมเพื่อจัดการพอร์ทัลที่ผสานรวม
- สร้างพอร์ทัลแบบรวม
เมื่อสร้างพอร์ทัลแบบรวมแล้ว ระบบจะจัดเตรียมชุดหน้าเริ่มต้นไว้ให้คุณใช้เป็นจุดเริ่มต้น หน้าเริ่มต้นมีเนื้อหาสาธิตเพื่อช่วยสร้างแรงบันดาลใจในการพัฒนาพอร์ทัลของคุณเองเมื่อคุณแทนที่ข้อความและรูปภาพด้วยเนื้อหาที่เป็นเอกลักษณ์ ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับพอร์ทัลตัวอย่าง
ขั้นตอนที่ 2: สร้างพอร์ทัลแบบรวม
สร้างพอร์ทัลแบบรวมตามที่อธิบายไว้ในขั้นตอนการสร้างพอร์ทัล
ขั้นต่ำ คุณจะต้องทําตามขั้นตอนที่ระบุไว้ในตารางต่อไปนี้
ขั้นตอน | คำอธิบาย |
---|---|
พัฒนาเนื้อหาพอร์ทัล | เช่น ข้อมูลแนวคิดและการเริ่มต้นใช้งาน คุณอาจเลือกสร้างหน้าเว็บ แล้วคัดลอกและวางเนื้อหาหน้าเว็บจากพอร์ทัล Drupal 7 ที่มีอยู่โดยตรง |
ตั้งค่าการนําทาง | สร้างการนําทางที่จําเป็นเพื่อให้ตรงกับโครงสร้างที่มีอยู่ |
ปรับแต่งธีม | อย่างน้อยที่สุด ให้ปรับแต่งคอมโพเนนต์ต่อไปนี้ให้ตรงกับข้อกำหนดการสร้างแบรนด์ |
เพิ่มสคริปต์ที่กําหนดเอง | เพิ่มโค้ด JavaScript ที่กําหนดเองลงในพอร์ทัลตามต้องการ |
กำหนดค่าอีเมล | กำหนดค่าเซิร์ฟเวอร์ SMTP และเนื้อหาของการแจ้งเตือนทางอีเมล หมายเหตุ: ขณะนี้การกําหนดค่าการแจ้งเตือนทางอีเมลยังไม่พร้อมใช้งานในพอร์ทัลแบบผสานรวมแบบผสมของ Apigee |
จัดการระดับการเข้าถึงเริ่มต้น | จัดการระดับการเข้าถึงเริ่มต้นสำหรับทรัพยากรที่เฉพาะเจาะจง |
กำหนดค่านโยบายความปลอดภัยของเนื้อหา | กำหนดค่านโยบายรักษาความปลอดภัยเนื้อหา (CSP) สำหรับทุกหน้าในพอร์ทัลเพื่อป้องกันการโจมตีด้วยสคริปต์ข้ามเว็บไซต์ (XSS) และการโจมตีด้วยการแทรกโค้ดอื่นๆ หากต้องการ
หมายเหตุ: ฟีเจอร์นี้ยังไม่พร้อมให้บริการในพอร์ทัลแบบผสานรวมแบบไฮบริดของ Apigee ในขณะนี้ |
ขั้นตอนที่ 3: กำหนดค่าผู้ให้บริการข้อมูลประจำตัว
กำหนดค่าผู้ให้บริการข้อมูลประจำตัวในพอร์ทัลที่ผสานรวมตามประเภทการตรวจสอบสิทธิ์ตามที่ระบุไว้ในตารางต่อไปนี้
การตรวจสอบสิทธิ์ | คำอธิบาย |
---|---|
ผู้ให้บริการข้อมูลประจำตัวในตัว (ชื่อผู้ใช้/รหัสผ่าน) | กำหนดค่าผู้ให้บริการข้อมูลประจำตัวในตัวในพอร์ทัลที่ผสานรวม |
การลงชื่อเพียงครั้งเดียว (SSO) โดยใช้ SAML | กําหนดค่าผู้ให้บริการข้อมูลประจําตัว SAML (เบต้า) ในพอร์ทัลที่ผสานรวม
หมายเหตุ
|
หลังจากนักพัฒนาแอปลงชื่อเข้าใช้พอร์ทัลแล้ว คุณจะจัดการบัญชีของนักพัฒนาแอปได้ ตามที่อธิบายไว้ในจัดการบัญชีนักพัฒนาแอป
ขั้นตอนที่ 4: ควบคุมการเข้าถึงทรัพยากรโดยใช้กลุ่มเป้าหมาย
หากคุณใช้บทบาทใน Drupal 7 เพื่อควบคุมการเข้าถึงชุดทรัพยากร เช่น เอกสารประกอบ API หรือการสร้างคีย์ API สำหรับผลิตภัณฑ์ API คุณจะใช้ฟังก์ชันการทำงานเดียวกันนี้โดยใช้กลุ่มเป้าหมายในพอร์ทัลที่ผสานรวมได้
กล่าวโดยละเอียดคือ คุณควบคุมการเข้าถึงทรัพยากรต่อไปนี้ในพอร์ทัลที่ผสานรวมได้โดยใช้กลุ่มเป้าหมาย
- หน้าในพอร์ทัล
- ผลิตภัณฑ์ API ที่เผยแพร่แล้ว
หากต้องการเพิ่มกลุ่มเป้าหมายและจัดการการมอบหมายให้กับผู้ใช้แต่ละรายและทีมนักพัฒนาซอฟต์แวร์ โปรดดูจัดการกลุ่มเป้าหมาย เมื่อผู้ใช้ใหม่สร้างบัญชีและลงชื่อเข้าใช้พอร์ทัล คุณจะต้องมอบหมายผู้ใช้รายนั้นให้กับกลุ่มเป้าหมายอย่างน้อย 1 กลุ่มตามที่จำเป็น ตามที่อธิบายไว้ในจัดการการมอบหมายให้กับกลุ่มเป้าหมาย
คุณอาจลองใช้เคล็ดลับต่อไปนี้เพื่อให้การย้ายข้อมูลง่ายขึ้น
- ตั้งชื่อกลุ่มเป้าหมายตามบทบาท Drupal ที่กลุ่มเป้าหมายจะแทนที่
- จัดการการเป็นสมาชิกกลุ่มเป้าหมายโดยใช้ทีมนักพัฒนาแอป นักพัฒนาแอปสร้างทีมเพื่อแชร์ความรับผิดชอบสำหรับแอปและจัดการการเป็นสมาชิกในทีม
ขั้นตอนที่ 5: เผยแพร่ API
หากต้องการเผยแพร่ API และสร้างเอกสารอ้างอิง API โดยอัตโนมัติโดยใช้ SmartDocs ในพอร์ทัลแบบรวม คุณต้องมีสิทธิ์เข้าถึงข้อมูลจำเพาะของ OpenAPI ที่เชื่อมโยงกับ API
แม้ว่าคุณอาจใช้ข้อกำหนด OpenAPI เพื่อสร้าง SmartDocs ใน Drupal 7 โดยอัตโนมัติ แต่ระบบจะจัดเก็บเนื้อหาโดยใช้รูปแบบภายในโดยไม่มีการเชื่อมโยงกับข้อกำหนด OpenAPI เดิม โดยทั่วไปแล้ว ทีม API ที่ใช้ Apigee Edge จะจัดเก็บข้อมูลจำเพาะของ OpenAPI ในที่เก็บข้อมูลจำเพาะของ Apigee Edge
จากนั้นเผยแพร่ API ไปยังพอร์ทัล โปรดเตรียมตัวให้พร้อมสำหรับสิ่งต่อไปนี้
- ระบุข้อมูลจำเพาะของ OpenAPI ที่จะใช้เป็นแหล่งที่มาของเอกสารประกอบจากที่เก็บข้อมูลจำเพาะ ไดเรกทอรีในเครื่อง หรือ URL
- ตั้งค่าระดับการเข้าถึงสำหรับเอกสารประกอบ (สาธารณะ ผู้ใช้การตรวจสอบสิทธิ์ หรือกลุ่มเป้าหมายที่เลือก)
- กำหนดค่า URL เรียกกลับ (หากจำเป็น)
- เพิ่มรูปภาพลงในการแสดงในแคตตาล็อก API หากต้องการ
ขั้นตอนที่ 6: แชร์ความรับผิดชอบสำหรับแอปโดยใช้ทีมนักพัฒนาแอป
หากนักพัฒนาแอปใช้แอปของบริษัทใน Drupal 7 เพื่อแชร์ความรับผิดชอบสำหรับแอป นักพัฒนาแอปจะสามารถใช้ฟังก์ชันการทำงานเดียวกันนี้โดยใช้ทีมนักพัฒนาแอปในพอร์ทัลที่ผสานรวม
นักพัฒนาแอปจะสร้างทีมนักพัฒนาแอปเพื่อแชร์ความรับผิดชอบสำหรับแอปและจัดการการเป็นสมาชิกในทีม ตามที่อธิบายไว้ในแชร์ความรับผิดชอบสำหรับแอปโดยใช้ทีมนักพัฒนาแอป (เบต้า)
คุณอาจต้องแจ้งให้ชุมชนนักพัฒนาแอปทราบเกี่ยวกับทีมนักพัฒนาแอปและกระตุ้นให้นักพัฒนาแอปย้ายข้อมูลแอปของตนเพื่อใช้ทีมนักพัฒนาแอปเพื่อแบ่งความรับผิดชอบและเปลี่ยนไปใช้คีย์ API ใหม่ จากนั้นคุณสามารถนําแอปของบริษัทและรายการต่างๆ ที่เกี่ยวข้องทั้งหมดออกได้โดยใช้ Edge API
หรือจะย้ายข้อมูลแอปของบริษัทไปยังแอปของทีมนักพัฒนาแอปก็ได้ ตามที่อธิบายไว้ในบทความชุมชนเรื่องการย้ายข้อมูลแอปของบริษัทไปยังทีมนักพัฒนาแอป
ขั้นตอนที่ 7: เตรียมเปิดตัวพอร์ทัลแบบรวม
ก่อนเปิดตัวพอร์ทัลที่ผสานรวมกับเวอร์ชันที่ใช้งานจริง ให้พิจารณาทำตามขั้นตอนที่ระบุไว้ในตารางต่อไปนี้
Step | คำอธิบาย |
ปรับแต่งโดเมน | ระบุชื่อโดเมนที่กำหนดเองของคุณเพื่อปรับเปลี่ยนเว็บไซต์ในแบบของคุณ หมายเหตุ: ฟีเจอร์นี้ยังไม่พร้อมให้บริการในพอร์ทัลแบบผสานรวมแบบไฮบริดของ Apigee ในขณะนี้ |
กําหนดค่าการติดตามข้อมูลวิเคราะห์ | กำหนดค่าการติดตามข้อมูลวิเคราะห์โดยใช้ Google Analytics หรือบริการติดตามข้อมูลวิเคราะห์ที่กําหนดเอง |
สร้างหน้าการค้นหาที่กำหนดเอง | สร้างหน้าการค้นหาที่กำหนดเองและฝังเครื่องมือค้นหาที่กำหนดเองของ Google |