Drupal 기반 포털과 Edge 간의 통신

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

개발자 서비스 포털은 Apigee Edge의 클라이언트 역할을 합니다. 즉, 포털이 독립형 시스템으로 작동하지 않습니다. 대신 포털에서 사용하는 정보의 대부분이 실제로 Edge에 저장됩니다. 필요한 경우 포털에서 HTTP 또는 HTTPS 요청을 수행하여 Edge에서 정보를 검색하거나 Edge로 정보를 전송합니다.

Edge는 포털에 요청하지 않고 포털에서 생성된 요청에만 응답합니다. 따라서 포털과 Edge 간의 모든 상호작용은 포털에서 시작됩니다.

포털과 Edge 간의 연결 구성

아래에 설명된 대로 포털이 Edge와 통신하는 데 필요한 세 가지 정보가 있습니다.

  • 에지의 URL 엔드포인트

    Edge 클라우드 기반 버전의 기본 엔드포인트는 https://api.enterprise.apigee.com/v1입니다.

    Private Cloud 설치의 경우 URL은 http://EdgePrivateCloudIp:8080/v1 또는 https://EdgePrivateCloudIp:TLSport/v1 형식입니다.

    여기서 EdgePrivateCloudIp는 에지 관리 서버 서버의 IP 주소이고 TLSport는 Edge 관리 API의 TLS/SSL 포트입니다. 예: 8443
  • Apigee 조직 이름

    Edge에 있는 조직의 이름입니다. Edge에서 계정을 만들 때 조직을 설정합니다.
  • 개발자 관리자의 사용자 이름 및 비밀번호

    포털에서 Edge로 보내는 호출은 인증되며 개발자 관리자 권한이 있는 사용자가 필요합니다. 개발자 포털이 프로비저닝되면 개발자 관리자 역할이 조직에 추가됩니다. devadmin+{org_name}@apigee.com라는 단일 사용자를 포함하는 이 역할은 개발자 포털을 Edge 조직에 연결하기 위한 목적으로만 사용됩니다. 포털에는 Edge 개발자 앱, API 제품 등이 표시되므로 인증이 필요한 관리 API 호출을 통해 Edge 조직과 동기화된 상태를 유지해야 합니다. devadmin '사용자'에게 필요한 권한이 있습니다.

연결 정보를 보려면 다음 안내를 따르세요.

  1. Drupal 관리 메뉴에서 Configuration > Dev Portal > Application Settings를 선택합니다.

구성을 변경하려면 다음 안내를 따르세요.

구성을 변경하는 방법은 포털 설치 및 포털 버전에 따라 다릅니다.

  • 포털 버전 15.01.06 이상의 클라우드 기반 설치: 연결 정보를 변경하려면 Apigee Edge 지원에 요청해야 합니다. 예를 들어 조직의 이름을 변경할 수 있습니다.
  • 버전 15.01.06 이전의 온프레미스 설치 및 클라우드 기반 포털: 아래에 설명된 대로 연결 정보를 변경합니다.
  1. Drupal 관리 메뉴에서 Configuration > Dev Portal Settings를 선택합니다.
  2. Management API 조직에 조직 이름을 입력합니다.
  3. Management API 엔드포인트 URL에 Edge 엔드포인트의 URL을 입력합니다.
  4. 엔드포인트 인증된 사용자인증된 사용자의 비밀번호에 조직 관리자의 사용자 인증 정보를 입력합니다.
  5. 연결 테스트를 선택하여 성공적으로 연결되었는지 확인합니다.
  6. Save Configuration을 선택합니다.

포털에서 Edge에 대한 액세스 보장

포털에서 사용하는 정보의 대부분이 Edge에 저장되므로 포털에서 Edge에 액세스할 수 있는지 확인해야 합니다. 포털은 HTTP 및 HTTPS를 통해 REST 요청을 실행하여 Edge와 통신을 시작합니다. 예를 들어 개발자가 포털에 새 앱을 등록하면 포털은 Edge에 앱에 대한 정보를 Edge로 전송하도록 요청합니다.

Edge와 포털은 모두 클라우드나 온프렘에 배포할 수 있으며, 배포 유형을 혼합할 수 있습니다. 예를 들어 둘 다 클라우드(온프렘)에 배포할 수도 있고, 클라우드에 하나, 온프렘에 하나씩 배포할 수도 있습니다.

  • Apigee에서 포털과 Edge를 모두 클라우드에 배포한 경우 포털에서 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 관리 메뉴에서 People(사용자)을 선택합니다.
  • 페이지 상단의 개발자 포털 개발자 동기화 버튼을 선택하여 Edge의 앱 개발자와 동기화합니다.