การย้ายข้อมูลพอร์ทัล Drupal 7 ไปยังพอร์ทัลที่ผสานรวม

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

ส่วนนี้จะให้คำแนะนำเกี่ยวกับวิธีวางแผนและดำเนินการย้ายข้อมูลชิ้นงานพอร์ทัล Drupal 7 ไปยังพอร์ทัลที่ผสานรวม

ขั้นตอนที่ 1: สร้างพอร์ทัลที่ผสานรวม

ก่อนย้ายข้อมูลเนื้อหาพอร์ทัล Drupal 7 คุณต้องสร้างพอร์ทัลที่ผสานรวม

วิธีสร้างพอร์ทัลที่ผสานรวม

1. ตรวจสอบว่าคุณมีบทบาทพอร์ทัลที่เหมาะสมในการจัดการพอร์ทัลที่ผสานรวม
2. สร้างพอร์ทัลที่ผสานรวม

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

ขั้นตอนที่ 2: สร้างพอร์ทัลที่ผสานรวม

สร้างพอร์ทัลแบบผสานรวมตามที่อธิบายไว้ในขั้นตอนการสร้างพอร์ทัล

คุณจะต้องทำตามขั้นตอนในตารางต่อไปนี้เป็นอย่างน้อย

ขั้นตอน	คำอธิบาย
พัฒนาเนื้อหาของพอร์ทัล	เช่น ข้อมูลเชิงแนวคิดและการเริ่มต้น คุณอาจเลือกสร้างหน้าเว็บ จากนั้นคัดลอกและวางเนื้อหาของหน้าได้โดยตรงจากพอร์ทัล Drupal 7 ที่มีอยู่
ตั้งค่าการนำทาง	สร้างการนำทางที่จำเป็นให้ตรงกับโครงสร้างที่มีอยู่
ปรับแต่งธีม	โดยอย่างน้อยที่สุดก็ควรปรับแต่งคอมโพเนนต์ต่อไปนี้ให้ตรงกับข้อกำหนดการสร้างแบรนด์ โลโก้และไอคอน Fav ชุดสีและชุดแบบอักษรและรูปแบบ ภาพพื้นหลัง
เพิ่มสคริปต์ที่กำหนดเอง	เพิ่มโค้ด JavaScript ที่กำหนดเองลงในพอร์ทัลได้ตามต้องการ
กำหนดค่าอีเมล	กำหนดค่าเซิร์ฟเวอร์ SMTP และเนื้อหาของการแจ้งเตือนทางอีเมล หมายเหตุ: การกำหนดค่าการแจ้งเตือนทางอีเมลยังไม่พร้อมใช้งานสำหรับพอร์ทัลแบบผสมของ Apigee ในขณะนี้
จัดการระดับการเข้าถึงเริ่มต้น	จัดการระดับการเข้าถึงเริ่มต้นสำหรับทรัพยากรที่เฉพาะเจาะจง
กำหนดค่านโยบายความปลอดภัยของเนื้อหา	กำหนดค่านโยบายรักษาความปลอดภัยเนื้อหา (CSP) สำหรับทุกหน้าในพอร์ทัลเพื่อป้องกันการโจมตีแบบ Cross-site Scripting (XSS) และการโจมตีแบบแทรกโค้ดอื่นๆ หากต้องการ หมายเหตุ: ขณะนี้ฟีเจอร์นี้ยังไม่พร้อมใช้งานสำหรับพอร์ทัลแบบไฮบริดของ Apigee

ขั้นตอนที่ 3: กำหนดค่าผู้ให้บริการข้อมูลประจำตัว

กำหนดค่าผู้ให้บริการข้อมูลประจำตัวในพอร์ทัลที่ผสานรวมตามประเภทการตรวจสอบสิทธิ์ตามที่ระบุไว้ในตารางต่อไปนี้

การตรวจสอบสิทธิ์	คำอธิบาย
ผู้ให้บริการข้อมูลประจำตัวในตัว (ชื่อผู้ใช้/รหัสผ่าน)	กำหนดค่าผู้ให้บริการข้อมูลประจำตัวในตัวในพอร์ทัลที่ผสานรวม
การลงชื่อเพียงครั้งเดียว (SSO) โดยใช้ SAML	กำหนดค่าผู้ให้บริการข้อมูลประจำตัว SAML (เบต้า) ในพอร์ทัลที่ผสานรวม หมายเหตุ อ่านใช้โดเมนที่กำหนดเองกับผู้ให้บริการข้อมูลประจำตัว SAML เพื่อดูเคล็ดลับในการตั้งค่าโดเมนที่กำหนดเอง ระบบไม่รองรับการแมปบทบาท SAML กับ Drupal 7 สำหรับพอร์ทัลที่ผสานรวม แต่จะต้องควบคุมการเข้าถึงทรัพยากรโดยใช้กลุ่มเป้าหมายแทน ผู้ให้บริการข้อมูลประจำตัว SAML ยังไม่พร้อมใช้งานสำหรับพอร์ทัลที่ผสานรวม Apigee แบบไฮบริดในขณะนี้

หลังจากที่นักพัฒนาแอปลงชื่อเข้าใช้พอร์ทัลแล้ว คุณจะจัดการบัญชีของนักพัฒนาซอฟต์แวร์ได้ตามที่อธิบายไว้ในจัดการบัญชีนักพัฒนาแอป

ขั้นตอนที่ 4: ควบคุมการเข้าถึงทรัพยากรโดยใช้กลุ่มเป้าหมาย

หากใช้บทบาทใน Drupal 7 เพื่อควบคุมการเข้าถึงชุดทรัพยากร เช่น เอกสารประกอบของ API หรือการสร้างคีย์ API สำหรับผลิตภัณฑ์ API คุณจะใช้ฟังก์ชันเดียวกันนี้ได้โดยใช้กลุ่มเป้าหมายในพอร์ทัลที่ผสานรวม

กล่าวอย่างเจาะจงก็คือ คุณควบคุมการเข้าถึงทรัพยากรต่อไปนี้ในพอร์ทัลที่ผสานรวมโดยใช้กลุ่มเป้าหมายได้

• หน้าในพอร์ทัลของคุณ
• ผลิตภัณฑ์ API ที่เผยแพร่

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

ลองทำตามเคล็ดลับต่อไปนี้เพื่อให้การย้ายข้อมูลง่ายขึ้น

• ตั้งชื่อกลุ่มเป้าหมายตามบทบาท Drupal ที่กลุ่มเป้าหมายเหล่านั้นจะแทนที่
• จัดการการเป็นสมาชิกของกลุ่มเป้าหมายโดยใช้ทีมนักพัฒนาซอฟต์แวร์ นักพัฒนาแอปสร้างทีมเพื่อแชร์ความรับผิดชอบต่อแอปและจัดการการเป็นสมาชิกทีม

ขั้นตอนที่ 5: เผยแพร่ API

หากต้องการเผยแพร่ API และสร้างเอกสารอ้างอิง API โดยอัตโนมัติโดยใช้ SmartGoogle ในพอร์ทัลที่ผสานรวม คุณต้องเข้าถึงข้อกำหนดของ OpenAPI ที่เชื่อมโยงกับ API ดังกล่าว

แม้ว่าคุณจะใช้ข้อมูลจำเพาะของ OpenAPI เพื่อสร้าง SmartDocument โดยอัตโนมัติใน Drupal 7 แต่เนื้อหาจะได้รับการจัดเก็บในรูปแบบภายในโดยไม่มีการเชื่อมโยงกับข้อกำหนด OpenAPI เดิม โดยทั่วไปแล้ว ทีม API ที่ใช้ Apigee Edge มักจะจัดเก็บข้อกำหนดของ OpenAPI ไว้ในพื้นที่เก็บข้อมูลของ Apigee Edge

จากนั้นเผยแพร่ API ไปยังพอร์ทัล เตรียมตัวให้พร้อม

• ระบุข้อมูลจำเพาะของ OpenAPI ที่จะใช้เป็นแหล่งที่มาของเอกสาร จากพื้นที่เก็บข้อมูลเฉพาะ ไดเรกทอรีภายใน หรือ URL
• ตั้งค่าการเปิดเผยสำหรับเอกสารประกอบ (สาธารณะ ผู้ใช้ที่มีสิทธิ์ตรวจสอบสิทธิ์ หรือกลุ่มเป้าหมายที่เลือก)
• กำหนดค่า URL เรียกกลับ หากจำเป็น
• เพิ่มรูปภาพไปยังจอแสดงผลในแคตตาล็อก API หากต้องการ

ขั้นตอนที่ 6: แชร์ความรับผิดชอบสำหรับแอปโดยใช้ทีมนักพัฒนาแอป

หากนักพัฒนาแอปใช้แอปของบริษัทใน Drupal 7 เพื่อรับผิดชอบต่อแอป นักพัฒนาแอปจะดำเนินการฟังก์ชันการทำงานเดียวกันนี้ได้โดยใช้ทีมนักพัฒนาแอปในพอร์ทัลที่ผสานรวม

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

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

หรือย้ายข้อมูลแอปของบริษัทไปยังแอปทีมนักพัฒนาแอป ตามที่อธิบายไว้ในบทความของชุมชนต่อไปนี้ การย้ายข้อมูลแอปของบริษัทไปยังทีมนักพัฒนาซอฟต์แวร์

ขั้นตอนที่ 7: เตรียมเปิดตัวพอร์ทัลแบบผสานรวม

ก่อนเปิดตัวพอร์ทัลผสานรวมเพื่อใช้งานจริง ลองพิจารณาทำตามขั้นตอนที่ระบุไว้ในตารางต่อไปนี้

Step	คำอธิบาย
ปรับแต่งโดเมน	ระบุชื่อโดเมนที่คุณกำหนดเองเพื่อปรับเปลี่ยนเว็บไซต์ในแบบของคุณ หมายเหตุ: ขณะนี้ฟีเจอร์นี้ยังไม่พร้อมใช้งานสำหรับพอร์ทัลแบบไฮบริดของ Apigee
กำหนดค่าการติดตาม Analytics	กำหนดค่าการติดตามการวิเคราะห์โดยใช้ Google Analytics หรือบริการติดตามการวิเคราะห์ที่กำหนดเองของคุณ
สร้างหน้าการค้นหาที่กำหนดเอง	สร้างหน้าการค้นหาที่กำหนดเองและฝังเครื่องมือค้นหาที่กำหนดเองของ Google