Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
개발자 서비스 포털은 Apigee Edge의 클라이언트 역할을 합니다. 즉, 포털은 독립형 시스템으로 작동하지 않습니다. 대신 포털에서 사용하는 대부분의 정보는 실제로 Edge에 저장됩니다. 필요한 경우 포털은 HTTP 또는 HTTPS 요청을 보내 Edge에서 정보를 검색하거나 Edge로 정보를 전송합니다.
Edge는 포털에 요청을 수행하지 않으며 포털의 요청에만 응답합니다. 따라서 포털과 Edge 간의 모든 상호작용은 포털에서 시작됩니다.
포털과 Edge 간의 연결 구성
포털이 Edge와 통신하는 데 필요한 정보는 세 가지입니다(아래 참고).
- Edge 엔드포인트 URL
클라우드 기반 버전의 Edge의 기본 엔드포인트는 https://api.enterprise.apigee.com/v1입니다.
프라이빗 클라우드 설치의 경우 URL은 http://EdgePrivateCloudIp:8080/v1 또는 https://EdgePrivateCloudIp:TLSport/v1 형식입니다.
여기서 EdgePrivateCloudIp는 Edge 관리 서버의 IP 주소이고 TLSport는 Edge 관리 API의 TLS/SSL 포트입니다. 예를 들면 8443입니다. - Apigee 조직 이름
Edge의 조직 이름입니다. Edge에서 계정을 만들 때 조직을 설정합니다. -
개발자 관리자의 사용자 이름 및 비밀번호
포털에서 Edge로의 호출은 인증되며 개발자 관리자 권한이 있는 사용자가 필요합니다. 개발자 포털이 프로비저닝되면 개발자 관리자 역할이 조직에 추가됩니다.devadmin+{org_name}@apigee.com라는 단일 사용자를 포함하는 이 역할은 개발자 포털을 Edge 조직에 연결하기 위한 목적으로만 사용됩니다. 포털은 Edge 개발자 앱, API 제품 등을 표시하므로 인증이 필요한 관리 API를 호출하여 Edge 조직과 동기화 상태를 유지해야 합니다. devadmin '사용자'에게 필요한 권한이 있습니다.
연결 정보를 보려면 다음 단계를 따르세요.
- Drupal 관리 메뉴에서 구성 > 개발자 포털 > 애플리케이션 설정을 선택합니다.
구성 변경 방법:
구성을 변경하는 방법은 포털 설치 및 포털 버전에 따라 다릅니다.
- 포털 버전 15.01.06 이상을 클라우드 기반으로 설치한 경우: 연결 정보를 변경하려면 Apigee Edge 지원팀에 요청해야 합니다. 예를 들어 조직 이름을 변경하려는 경우
- 버전 15.01.06 이전의 온프레미스 설치 및 클라우드 기반 포털: 아래 설명에 따라 연결 정보를 변경합니다.
- Drupal 관리 메뉴에서 구성 > 개발자 포털 설정을 선택합니다.
- Management API 조직에 조직 이름을 입력합니다.
- Management API Endpoint URL에 Edge 엔드포인트의 URL을 입력합니다.
- 엔드포인트 인증 사용자 및 인증된 사용자의 비밀번호에 조직 관리자 사용자 인증 정보를 입력합니다.
- 연결 테스트를 선택하여 연결이 성공했는지 확인합니다.
- Save Configuration을 선택합니다.
포털에서 Edge에 액세스할 수 있도록 하기
포털에서 사용하는 대부분의 정보는 Edge에 저장되므로 포털이 Edge에 액세스할 수 있는지 확인해야 합니다. 포털은 HTTP 및 HTTPS를 통해 REST 요청을 실행하여 Edge와의 통신을 시작합니다. 예를 들어 개발자가 포털에 새 앱을 등록하면 포털은 앱에 대한 정보를 Edge로 전송하도록 Edge에 요청합니다.
Edge와 포털은 모두 클라우드 또는 온프레미스에 배포할 수 있으며 배포 유형을 혼합할 수 있습니다. 예를 들어 두 모델을 모두 클라우드에 배포하거나, 모두 온프레미스에 배포하거나, 하나는 클라우드에, 하나는 온프레미스에 배포할 수 있습니다.
- 포털과 Edge가 모두 Apigee에 의해 클라우드에 배포된 경우 포털에서 Edge로 요청하는 데 문제가 없습니다.
- 포털을 온프레미스에 배포하는 경우 Edge가 클라우드에 배포되었는지 온프레미스에 배포되었는지와 관계없이 포털에서 Edge에 요청할 수 있어야 합니다.
- 온프레미스에 Edge를 배포하는 경우 포털에 Edge에 대한 액세스 권한이 있는지 확인해야 합니다. 즉, 포털이 클라우드에 배포되었는지 온프레미스에 배포되었는지와 관계없이 에지 서버가 포털의 요청을 수락해야 합니다.
동영상: 개발자 포털이 Apigee Edge와 통신하는 방법과 연결이 작동하는지 확인하는 방법을 알아보려면 짧은 동영상을 시청하세요.
포털에서 앱 및 API 키 관리
개발자가 포털에서 앱 등록 프로세스를 완료하면 포털에서 앱 이름 및 앱과 연결된 API 제품을 포함하여 앱에 대한 정보를 Edge로 전송합니다.
Edge가 앱을 성공적으로 등록하면 Edge는 포털에 단일 API 키를 반환합니다. 그런 다음 개발자는 이 API 키를 사용하여 앱과 연결된 API 제품에 액세스합니다.
앱 및 API 키에 대한 정보는 실제로 포털에 저장되지 않습니다. 대신 모든 정보가 Edge에 저장됩니다. 따라서 개발자가 포털을 사용하여 앱에 대한 정보를 볼 때마다 포털은 Edge에 해당 정보에 액세스하도록 요청합니다. 개발자가 앱을 수정할 때마다 포털은 이러한 수정사항을 Edge로 자동 전송합니다.
예를 들어 개발자가 포털에 로그인하고 '내 앱' 페이지로 이동합니다. 내 앱 페이지를 채우기 위해 포털은 Edge에 요청하여 개발자의 앱 및 API 키에 관한 정보를 가져옵니다. 그러면 포털의 개발자 '내 앱' 페이지에 다음 정보가 표시됩니다.
그런 다음 개발자가 앱을 추가, 삭제 또는 수정하면 포털에서 Edge에 수정사항을 전송합니다.
앱 및 API 키에 대한 모든 정보가 Edge에 저장되므로 Edge 관리자는 Edge UI를 사용하여 정보를 조작할 수 있습니다. 예를 들어 관리자는 다음 작업을 수행할 수 있습니다.
- 개발자 앱 추가, 삭제, 수정
- 앱의 API 키 취소 또는 승인
아래는 Edge UI에서 관리자에게 표시되는 동일한 앱인 '내 날씨 앱'입니다.
포털에서 개발자 관리
개발자가 새 포털 사용자로 등록하면 Edge와 포털에 개발자가 생성됩니다. 따라서 앱 및 API 키와 달리 개발자에 대한 정보는 실제로 Edge와 포털 모두에 저장됩니다.
Edge에 저장되는 개발자 정보에는 다음이 포함됩니다.
- 이름
- 성
- 이메일 주소
- 포털에서 전송된 추가 정보(선택사항)
포털은 Edge와 동일한 정보를 저장하지만 다음과 같은 추가 정보도 저장합니다.
- 포털 비밀번호
- 포털 계정 상태: 활성 또는 차단됨
- 포털 역할: 인증된 사용자, 관리자, 기타
- 역할 기반 권한: 개발자가 포털에서 수행할 수 있는 작업을 결정합니다.
개발자가 포털에 로그인하면 포털에서 개발자를 인증하고 역할 기반 권한을 적용합니다.
포털은 개발자에 관한 모든 정보를 저장하므로 포털을 Edge가 아닌 개발자 정보의 레코드 시스템으로 간주하세요. 개발자가 포털에서 정보를 수정하면 포털에 저장되고 해당하는 경우 Edge로 전송됩니다. 예를 들어 개발자가 이름을 변경하면 이 정보가 Edge로 전송됩니다. 하지만 개발자가 비밀번호를 변경하면 이 정보는 포털에 로컬로만 저장됩니다.
자세한 내용은 사용자 계정 추가 및 관리를 참고하세요.
포털과 Edge 간의 앱 개발자 동기화
Edge는 포털과의 통신을 시작하지 않습니다. Edge 관리자가 Edge UI에서 개발자에 관한 정보를 조작하는 경우 해당 정보가 포털에 푸시되는 시점이 보장되지 않습니다. 따라서 Edge가 아닌 포털의 관리 기능을 사용하여 개발자를 생성, 수정, 삭제하세요.
포털 관리자는 포털과 Edge 간에 동기화를 강제하여 Edge에서 포털로 정보를 다운로드할 수 있습니다. 하지만 Edge가 아닌 포털에서만 개발자를 수정하는 경우 이 동기화를 실행할 필요가 없습니다. 또한 Edge에서는 개발자를 만들 때 비밀번호를 설정할 수 없으므로 Edge에서 만든 모든 개발자의 포털 비밀번호는 임의의 값으로 설정됩니다. 따라서 개발자는 포털에 로그인하기 전에 비밀번호 복구 프로세스를 거쳐야 합니다.
Edge에서 포털을 앱 개발자와 동기화하려면 다음 단계를 따르세요.
:- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 관리 메뉴에서 사용자를 선택합니다.
- 페이지 상단에서 Dev Portal Developer Sync 버튼을 선택하여 Edge의 앱 개발자와 동기화합니다.