Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
새 앱을 등록하려면 개발자가 '내 앱' 페이지에서 '새 앱 추가' 버튼을 선택합니다.
그러면 포털에 기본 앱 등록 양식이 표시됩니다.
기본적으로 개발자는 앱 이름, 콜백 URL, 앱에 추가할 API 제품 목록만 지정하면 됩니다.
API 제공업체는 앱 등록 프로세스를 완전히 제어할 수 있습니다. 예를 들어 다음을 구성할 수 있습니다.
- 포털에서 사용할 수 있는 API 제품 목록
- 기본 API 제품이 있는지 여부
- 콜백 URL이 필요한지 여부
- API 제품에 대한 API 키의 수동 또는 자동 승인 여부
- 앱을 등록하기 위해 앱 추가 페이지에 다른 정보가 필요한지 여부
이 주제에서는 포털의 앱 등록 프로세스를 구성하는 방법을 설명합니다. 하지만 이 주제에서는 API 제품을 만드는 방법을 설명하지 않습니다. 자세한 내용은 다음을 참고하세요.
개발자에게 할당된 역할에 따라 개발자가 앱을 만들거나 삭제하거나 수정할 수 없도록 포털을 구성할 수 있습니다. 예를 들어 개발자가 등록할 때 모든 개발자를 위해 단일 기본 앱을 만들도록 포털을 구성할 수 있습니다. 그런 다음 수수료 구조 또는 개발자의 기타 특성을 기준으로 일부 개발자만 새 앱을 추가하도록 허용할 수 있습니다. 역할과 권한을 사용하여 앱을 만들고, 삭제하고, 수정할 수 있는 개발자를 관리합니다. 자세한 내용은 사용자 계정 추가 및 관리하기를 참고하세요.
포털에서 사용할 수 있는 API 제품 지정
개발자가 포털에 액세스할 때 사용할 수 있는 API 제품을 지정하는 방법에는 두 가지가 있습니다.
API 제품을 만들 때 액세스 수준 지정
API 제품을 만들 때 아래와 같이 제품의 액세스 수준 옵션을 지정합니다.
액세스 수준이 Drupal 7 개발자 포털에서 API 제품의 사용 가능 여부에 미치는 영향에 관한 자세한 내용은 액세스 수준을 참고하세요.
역할에 따라 API 제품에 대한 액세스 제한
API 제품 역할 액세스 Drupal 모듈을 사용 설정하면 각 API 제품에 액세스할 수 있는 역할을 지정할 수 있습니다.
개발자 역할을 기반으로 API 제품에 대한 액세스를 제한하려면 다음 단계를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- 개발자 포털 역할 및 사용자 할당을 검토합니다.
- Drupal 관리 메뉴에서 사용자 > 권한 > 역할을 선택하고 필요에 따라 개발자 역할 및 권한을 추가하거나 수정합니다.
- Drupal 관리 메뉴에서 사용자를 선택하고 필요에 따라 사용자 및 역할 할당을 수정합니다.
- Drupal 관리 메뉴에서 구성 > 개발자 포털 > API 제품 역할 액세스를 선택합니다.
- 각 API 제품에 액세스할 수 있는 역할을 선택합니다.
- Save configuration(구성 저장)을 클릭합니다.
개발자가 API 제품을 앱에 연결하는 방식 구성
새 앱을 등록하려면 개발자가 '내 앱' 페이지에서 '새 앱 추가' 버튼을 선택하여 앱 추가 양식을 엽니다.
포털을 구성하는 방식에 따라 개발자는 앱 등록 시 앱에 연결할 API 제품을 하나 이상 선택할 수 있습니다. 또는 모든 앱에 할당되는 기본 제품을 지정할 수 있습니다.
포털에서 앱을 등록할 때 API 제품 선택을 제어하는 데 사용할 수 있는 구성 옵션은 다음과 같습니다.
- 앱을 API 제품과 연결하지 마세요.
- 모든 앱을 하나 이상의 기본 API 제품 (아래에서 구성)과 연결합니다. 개발자는 앱에 다른 API 제품을 추가할 수 없습니다.
- 단일 API 제품을 선택하도록 허용하지만 필수사항은 아닙니다.
- 단일 API 제품을 선택해야 합니다.
- 여러 API 제품을 선택할 수 있지만 필수는 아닙니다.
- 여러 API 제품을 선택할 수 있도록 허용하고 하나 이상을 요구합니다.
개발자가 API 제품을 선택하는 데 사용하는 양식에 표시되는 HTML 요소도 제어할 수 있습니다. 옵션은 다음과 같습니다.
- 드롭다운 목록
- 체크박스 또는 라디오 버튼 체크박스는 개발자가 여러 API 제품을 선택할 수 있는 경우 표시되고 라디오 버튼은 개발자가 단일 API 제품만 선택할 수 있는 경우 표시됩니다.
API 제품 선택 옵션을 설정하려면 다음 단계를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 관리 메뉴에서 구성 > 개발자 포털 설정 > 애플리케이션 설정을 선택합니다.
- 애플리케이션 설정 페이지에서 API 제품 설정 영역을 펼칩니다.
- API 제품 처리에서 API 제품 선택을 제어하는 옵션을 선택합니다.
- '모든 앱을 하나 이상의 기본 API 제품(아래에서 구성됨)과 연결' 옵션을 지정하는 경우 기본 API 제품에서 기본 제품을 설정합니다.
- API 제품 위젯에서 개발자가 API 제품을 선택하는 데 사용하는 HTML 요소를 선택합니다.
- 구성을 저장합니다.
콜백 URL 처리 구성
API 제품의 API 프록시가 '3-legged OAuth' (승인 코드 부여 유형)를 사용하는 경우 개발자는 앱을 등록할 때 콜백 URL을 지정해야 합니다. 콜백 URL은 보통 클라이언트 앱을 대신하여 승인 코드를 수신하도록 지정된 앱의 URL을 지정합니다. 또한 이 URL 문자열은 유효성 검사에 사용됩니다. 클라이언트는 승인 코드 및 액세스 토큰을 요청할 때 이 URL을 Apigee Edge에 보내고 redirect_uri 매개변수가 등록된 매개변수와 일치해야 합니다. 자세한 내용은 승인 코드 부여 유형 구현을 참고하세요.
API 제품 선택의 콜백 URL을 제어하려면 다음 단계를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 관리 메뉴에서 구성 > 개발자 포털 설정 > 애플리케이션 속성을 선택합니다.
- 애플리케이션 설정 페이지에서 콜백 URL 설정 영역을 펼칩니다.
- 콜백 URL 처리에서 다음 옵션 중 하나를 선택합니다.
- 모든 개발자 앱에는 콜백 URL이 필요합니다.
- 콜백 URL은 모든 개발자 앱에 선택사항입니다.
- 콜백 URL은 필요하지 않으며 표시되지도 않습니다.
- 구성을 저장합니다.
앱 사용 분석 표시
포털은 앱 사용에 관한 분석 정보를 표시할 수 있습니다. 분석 표시가 사용 설정된 경우 앱 개발자는 각 앱의 '내 앱' 페이지에서 분석을 확인할 수 있습니다. 예를 들어 개발자는 앱에 다음과 같은 분석을 표시할 수 있습니다.
- 처리량
- 최대 응답 시간
- 최소 응답 시간
- 메시지 수
- 오류 수
포털에서 분석을 사용 설정하려면 다음 단계를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 관리 메뉴에서 구성 > 개발자 포털 > 애플리케이션 설정을 선택합니다.
- 애플리케이션 설정 페이지에서 앱 성능 설정 영역을 펼칩니다.
- 개발자 앱 분석 탭 표시 체크박스를 선택합니다.
- 애널리틱스 데이터를 쿼리할 환경에서 테스트 또는 프로덕션을 선택합니다. 공개적으로 제공되는 포털의 경우 일반적으로 프로덕션을 선택합니다.
- 구성을 저장합니다.
포털에 앱의 애널리틱스를 표시하려면 다음 단계를 따르세요.
- '내 앱' 페이지에서 앱 이름을 선택합니다.
- 앱의 애널리틱스 링크를 선택합니다.
- 표시할 분석 유형과 기간을 선택합니다.
- 선택한 정보가 표시됩니다.
API 제품의 API 키를 수동으로 승인 또는 취소
개발자가 앱에 API 제품을 추가한 후 앱을 등록하면 포털은 개발자에게 해당 앱의 API 키를 다시 반환합니다. 그러면 개발자는 이 API 키를 사용하여 앱과 연결된 API 제품에 번들로 제공된 API 프록시에 액세스합니다.
API 제품을 만들 때 각 API 제품의 키 승인 프로세스를 제어합니다.
승인 절차는 다음과 같습니다.
- 자동 - 개발자가 앱을 등록하면 포털에서 API 제품의 승인된 API 키를 반환합니다. 나중에 자동으로 승인된 키를 취소할 수 있습니다.
- 수동 - 개발자가 앱을 등록하면 포털에서 API 키를 반환하지만 수동 키 승인을 사용하는 API 제품에는 키가 활성화되지 않습니다. 개발자가 API 제품에 액세스하는 데 API 키를 사용할 수 있으려면 관리자가 Edge 관리 UI 또는 API에서 API 키를 수동으로 승인해야 합니다. 나중에 수동으로 승인된 키를 취소할 수 있습니다.
자세한 내용은 API 제품 만들기를 참고하세요.
포털에서 개발자가 앱에 여러 API 제품을 추가할 수 있는 경우 개발자가 일부 제품은 자동 키 승인으로 추가하고 일부 제품은 수동으로 추가할 수 있습니다. 개발자는 수동 승인이 필요한 제품의 최종 승인을 기다리는 동안 자동으로 승인된 모든 API 제품에 반환된 API 키를 즉시 사용할 수 있습니다.
앱의 API 제품 목록과 API 제품의 키 승인 상태를 보려면 개발자가 '내 앱' 페이지에서 앱 이름을 선택한 다음 '제품' 링크를 선택합니다.
이 예에서 Premium Weather API 제품은 수동 승인을 사용하고 있으며 관리자가 키를 승인할 때까지 기다리고 있습니다. 무료 API 제품은 자동 승인을 사용하며 액세스 키의 사용이 승인되었습니다.
키를 수동으로 승인하거나 취소하려면 다음 안내를 따르세요.
- 조직에 대한 관리 권한이 있는 사용자로 Edge 관리 UI에 로그인합니다.
- 오른쪽 상단의 드롭다운 상자에서 API 플랫폼을 선택합니다.
- 게시 > 개발자 앱을 선택하여 개발자 앱 목록을 엽니다.
- 대기 중 버튼을 선택하여 대기 중인 키 요청이 있는 앱 목록을 확인합니다.
- 승인하려는 앱 이름을 선택합니다.
- 앱 세부정보 페이지에서 오른쪽 상단의 수정 버튼을 선택합니다.
- 앱의 API 제품 목록에 있는 작업에서 다음을 수행합니다.
-
키를 승인하려면 수동 승인이 필요한 각 API 제품에 대해 승인 버튼을 선택합니다.
-
승인된 키를 취소하려면 액세스를 취소할 API 제품의 작업에서 취소 버튼을 선택합니다.
-
키를 승인하려면 수동 승인이 필요한 각 API 제품에 대해 승인 버튼을 선택합니다.
- 앱을 저장합니다. 이제 API 키가 승인됩니다.
API 제품 및 앱 캐싱 제어
API 제품 및 개발자 앱에 대한 정보는 포털에서 Apigee Edge에 원격으로 저장됩니다. 즉, 포털을 거치지 않고도 Edge UI 또는 API에서 API 제품 및 앱을 변경할 수 있습니다. 예를 들어 백엔드 관리자가 새 API 제품을 추가하면 포털은 즉시 해당 정보로 업데이트되지 않습니다.
포털이 Edge 백엔드와 동기화되도록 하려면 포털 캐시 업데이트를 수동으로 트리거하거나, 포털의 크론 작업이 실행될 때 캐시를 자동으로 업데이트하거나, 둘 다를 실행할 수 있습니다. 예를 들어 5분 또는 10분마다 자주 실행되도록 크론 작업을 구성하는 경우 API 제품 및 개발자 앱 캐시를 그렇게 자주 업데이트하는 오버헤드는 원치 않을 수 있습니다. 이 경우 캐시 업데이트를 수동으로 트리거할 수 있습니다. 하지만 크론 작업이 1시간 또는 2시간마다 실행되는 경우 캐시를 업데이트하는 데 걸리는 시간은 큰 영향을 미치지 않을 수 있습니다.
기본적으로 포털은 cron이 실행될 때마다 API 제품 및 개발자 앱 캐시를 다시 빌드하도록 구성됩니다.
cron이 실행될 때마다 API 제품 및 개발자 앱 캐시를 다시 빌드할지 여부를 지정하려면 다음 안내를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 메뉴에서 구성 > 개발자 포털 설정 > 애플리케이션 설정을 선택합니다.
- cron이 실행될 때마다 API 제품 및 개발자 앱 캐시 재빌드를 선택 또는 선택 해제합니다.
- 설정을 저장합니다.
캐시를 수동으로 업데이트하려면 다음 단계를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 메뉴에서 홈 아이콘 > 모든 캐시 플러시를 선택합니다.
앱을 등록하는 데 사용되는 양식 필드 맞춤설정
개발자가 앱을 등록하면 포털에 기본 양식이 표시됩니다.
API 제공업체는 개발자에게 고객 ID, 앱의 대상 플랫폼 또는 기타 정보와 같은 추가 정보를 제공하라는 메시지를 표시하도록 이 양식을 수정할 수 있습니다. 포털을 사용하면 이 양식에 새 필드를 추가할 수 있습니다. 이러한 필드는 다음과 같습니다.
- 필수 또는 선택사항
- 텍스트 상자, 라디오 버튼, 체크박스 등의 다양한 HTML 요소로 표시됨
- 콜백 URL 필드와 제품 필드 사이의 양식 어디에나 표시되도록 설정할 수 있습니다.
개발자 포털에서 사용할 수 있는 앱 등록 양식을 맞춤설정하는 방법을 알아보려면 이 동영상을 시청하세요.
예를 들어 다음 양식에는 고객 ID의 필수 입력란과 대상 플랫폼의 선택 입력란이 표시됩니다.
양식에 새 필드를 추가하면 개발자가 양식을 제출할 때 필드 값이 다른 모든 필드와 함께 Edge에 자동으로 업로드됩니다. 즉, Edge에서 이러한 필드를 보거나 수정하거나 Edge 관리 API를 사용하여 스크립트에서 이러한 필드에 액세스할 수 있습니다.
예를 들어 Edge 관리 UI에서 게시 > 개발자 앱으로 이동한 다음 앱 이름을 선택하여 새 양식 필드를 확인합니다. 새 필드 값은 페이지의 맞춤 속성 영역에 필드의 내부 이름에 해당하는 이름으로 표시됩니다.
필드 값은 개발자의 '내 앱' 페이지에 있는 앱의 세부정보 영역에도 표시됩니다.
개발자는 '내 앱' 페이지에서 앱의 수정 링크를 선택하여 값을 수정할 수도 있습니다.
아래 절차에서는 관리자 인터페이스를 사용하여 앱 생성 양식을 구성하는 방법을 설명합니다. Drupal 개발자는 맞춤 후크를 사용하여 '내 앱' 페이지 수정 등 추가 맞춤설정을 실행할 수 있습니다. 코드를 통해 동작을 변경하는 방법을 자세히 알아보려면 /profiles/apigee/modules/custom/devconnect/devconnect_developer_apps/devconnect_developer_apps.api.php 파일의 앱 API 예시를 참고하세요.
앱 등록 양식에 필드를 추가하는 방법은 다음과 같습니다.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- DevConnect 앱 속성 관리 모듈이 사용 설정되어 있는지 확인합니다.
- Drupal 관리 메뉴에서 구성 > Dev Portal 설정 > Dev Portal 앱 속성을 선택합니다.
- 페이지 상단에서 Dev Portal 앱 속성 추가 버튼을 선택합니다.
- 필드를 구성합니다. 예를 들어 위에 표시된 고객 ID 필드의 경우 다음 설정을 사용합니다.
- 내부 이름 = cust_id입니다. 필드 값을 저장하는 데 사용되는 변수의 이름입니다.
- 공개 이름 = 고객 ID
- Description = 고객 ID를 입력합니다.
- 이 속성 필요의 체크박스를 선택합니다.
- 이 속성 표시 체크박스를 선택합니다.
- 위젯 = 텍스트 상자
- 저장을 선택하여 Dev Portal 앱 속성 페이지로 돌아갑니다.
- 변경사항 저장을 선택합니다.
- Drupal 메뉴에서 홈 아이콘 > 모든 캐시 플러시를 선택합니다.
새 필드가 양식에 표시되려면 브라우저 캐시를 지워야 할 수도 있습니다.
개발자가 앱의 플랫폼을 지정할 수 있는 선택적 필드를 추가하려면 필드 속성을 다음과 같이 설정하세요.
- 내부 이름 = intended_platforms
- 공개 이름 = 플랫폼
- 설명 = 앱의 플랫폼을 하나 이상 지정합니다.
- '이 속성 필요' 체크박스를 선택 해제합니다.
- 이 속성 표시 체크박스를 선택합니다.
- 위젯 = 체크박스 목록
- 저장을 선택하여 Dev Portal 앱 속성 페이지로 돌아갑니다.
양식의 속성을 재정렬하려면 다음 단계를 따르세요.
- 관리자 또는 콘텐츠 제작 권한이 있는 사용자로 포털에 로그인합니다.
- Drupal 관리 메뉴에서 구성 > Dev Portal 설정 > Dev Portal 앱 속성을 선택합니다.
- 이름 열에서 더하기 기호(+)를 선택하고 속성을 양식에 표시할 위치로 드래그합니다.
- 변경사항을 저장합니다.