현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
이 섹션에서는 Drupal 7 포털 애셋을 통합 포털로 마이그레이션하는 작업을 계획하고 실행하는 방법을 안내합니다.
1단계: 통합 포털 만들기
Drupal 7 포털 애셋을 마이그레이션하기 전에 통합 포털을 만들어야 합니다.
통합 포털을 만들려면 다음 안내를 따르세요.
통합된 포털을 만들면 시작점으로 사용할 수 있는 시작 페이지 모음이 제공됩니다. 시작 페이지에는 텍스트와 이미지를 고유한 콘텐츠로 대체할 때 자체 포털 개발에 도움이 되는 데모 콘텐츠가 포함되어 있습니다. 자세한 내용은 샘플 포털 정보를 참고하세요.
2단계: 통합 포털 빌드
포털 빌드 단계에 설명된 대로 통합 포털을 빌드합니다.
최소한 다음 표에 나열된 단계를 수행해야 합니다.
| 단계 | 설명 |
|---|---|
| 포털 콘텐츠 개발 | 예를 들어 개념 및 시작 관련 정보가 포함되어 있습니다. 페이지를 생성한 다음 기존 Drupal 7 포털에서 직접 페이지 콘텐츠를 복사하여 붙여넣을 수 있습니다. |
| 탐색 설정 | 기존 구조와 일치하는 탐색 메뉴를 만듭니다. |
| 테마 맞춤설정 | 최소한 브랜딩 요구사항에 맞게 다음 구성요소를 맞춤설정하세요. |
| 커스텀 스크립트 추가 | 필요에 따라 포털에 맞춤 자바스크립트 코드를 추가합니다. |
| 이메일 구성 | SMTP 서버 및 이메일 알림 내용을 구성합니다. 참고: 현재 Apigee Hybrid 통합 포털에서는 이메일 알림 구성을 사용할 수 없습니다. |
| 기본 공개 상태 관리 | 특정 리소스의 기본 공개 상태를 관리합니다. |
| 콘텐츠 보안 정책 구성하기 | 원하는 경우 포털의 모든 페이지에 콘텐츠 보안 정책 (CSP)을 구성하여 교차 사이트 스크립팅 (XSS) 및 기타 코드 삽입 공격으로부터 보호하세요.
참고: 현재 Apigee Hybrid 통합 포털에서는 이 기능을 사용할 수 없습니다. |
3단계: ID 공급업체 구성
다음 표에 설명된 대로 인증 유형에 따라 통합 포털에서 ID 공급업체를 구성합니다.
| 인증 | 설명 |
|---|---|
| 기본 제공 ID 공급업체 (사용자 이름/비밀번호) | 통합 포털에서 기본 제공 ID 공급업체를 구성합니다. |
| SAML을 사용한 싱글 사인온 (SSO) | 통합 포털에서 SAML ID 공급업체 (베타)를 구성합니다.
참고
|
개발자가 포털에 로그인한 후 개발자 계정 관리에 설명된 대로 계정을 관리할 수 있습니다.
4단계: 잠재고객을 사용하여 리소스 액세스 제어
Drupal 7에서 역할을 사용하여 리소스 집합에 대한 액세스(예: API 문서 또는 API 제품의 API 키 생성)를 제어하는 경우 통합 포털에서 잠재고객을 사용하여 이와 동일한 기능을 실행할 수 있습니다.
특히 잠재고객을 사용하여 통합 포털에서 다음 리소스에 대한 액세스를 제어할 수 있습니다.
- 포털 페이지
- 게시된 API 제품
잠재고객을 추가하고 개별 사용자 및 개발자팀 할당을 관리하려면 잠재고객 관리를 참고하세요. 신규 사용자가 계정을 만들고 포털에 로그인하면 잠재고객 할당 관리에 설명된 대로 필요에 따라 하나 이상의 잠재고객에 할당해야 합니다.
이전을 간소화하기 위해 다음 팁을 고려할 수 있습니다.
- 대체할 Drupal 역할에 따라 잠재고객의 이름을 지정합니다.
- 개발자팀을 통해 잠재고객 멤버십을 관리합니다. 개발자는 앱에 대한 책임을 공유하고 팀 멤버십을 관리하기 위한 팀을 만듭니다.
5단계: API 게시
통합 포털에서 SmartDocs를 사용하여 API를 게시하고 API 참조 문서를 자동 생성하려면 API와 연결된 OpenAPI 사양에 액세스할 수 있어야 합니다.
OpenAPI 사양을 사용하여 Drupal 7에서 SmartDocs를 자동 생성했을 수도 있지만, 궁극적으로 콘텐츠는 원래 OpenAPI 사양과 연결되지 않은 내부 형식으로 저장됩니다. Apigee Edge를 사용하는 API팀은 일반적으로 Apigee Edge 사양 저장소에 OpenAPI 사양을 저장합니다.
그런 다음 포털에 API를 게시합니다. 다음 사항에 유의하세요.
- 사양 저장소, 로컬 디렉터리 또는 URL에서 문서 소스로 사용할 OpenAPI 사양을 지정합니다.
- 문서에 대한 공개 상태 설정 (공개, 인증 사용자 또는 선택한 대상)
- 필요한 경우 콜백 URL을 구성합니다.
- 원하는 경우 API 카탈로그의 디스플레이에 이미지를 추가합니다.
6단계: 개발자팀과 앱 책임 공유
개발자가 Drupal 7에서 회사 앱을 사용하여 앱에 대한 책임을 공유하는 경우 통합 포털의 개발자팀을 사용하여 동일한 기능을 실행할 수 있습니다.
개발자팀을 통해 앱에 대한 책임 공유 (베타)에 설명된 대로 개발자는 개발자팀을 만들어 앱에 대한 책임을 공유하고 팀 멤버십을 관리합니다.
개발자 커뮤니티에 개발자팀에 관해 알리고, 책임 분담을 위해 개발자팀을 통해 앱을 이전하고 새로운 API 키 사용으로 전환하도록 앱을 이전하도록 권장할 수 있습니다. 그런 다음 Edge API를 사용하여 모든 회사 앱 및 관련 아티팩트를 삭제할 수 있습니다.
또는 커뮤니티 도움말 회사 소유 앱을 개발자팀으로 이전에 설명된 대로 회사 앱을 개발자 팀 앱으로 이전할 수 있습니다.
7단계: 통합 포털 출시 준비
프로덕션에 통합 포털을 출시하기 전에 다음 표에 정의된 단계를 수행하는 것이 좋습니다.
| 단계 | 설명 |
| 도메인 맞춤설정 | 맞춤 도메인 이름을 제공하여 사이트를 맞춤설정하세요. 참고: 현재 Apigee Hybrid 통합 포털에서는 이 기능을 사용할 수 없습니다. |
| 애널리틱스 추적 구성 | Google 애널리틱스 또는 자체 커스텀 애널리틱스 추적 서비스를 사용하여 애널리틱스 추적을 구성합니다. |
| 커스텀 검색 페이지 만들기 | 커스텀 검색 페이지를 만들고 Google 맞춤검색 엔진을 삽입합니다. |