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