현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
다음 섹션의 설명대로 앱 개발자를 등록하고 관리합니다. 앱 등록은 앱 등록 및 API 키 관리의 설명대로 별도의 프로세스입니다.
소개
Edge는 API를 호출하는 주체를 전적으로 파악할 수 있는 많은 이점을 제공합니다. 예를 들어 API 보안, 트래픽 관리, 상당히 많은 분석 데이터는 호출자 파악에 따라 달라집니다. Edge는 누가 API를 호출하는지 어떻게 알 수 있을까요? 사용자 ID, API 키 또는 OAuth 토큰과 같은 각 API 호출에서 고유 정보를 읽어 파악합니다. 이러한 고유 정보는 API 프록시로 빌드하는 기능을 잠그거나 잠금 해제하여 API 액세스와 동작을 완전히 제어할 수 있게 해줍니다.
따라서 앱 개발자가 API를 사용하려면 등록해야 합니다. 추가되면 개발자는 자신의 앱을 등록하고, 사용할 API를 선택하고, API에 액세스하는 데 필요한 고유한 API 사용자 인증 정보(소비자 키 및 보안 비밀)를 수신합니다.
앱 개발자 등록 방법
다음 방법 중 하나를 사용하여 앱 개발자를 등록합니다.
- 유료 Edge 계정이 있는 경우 개발자는 개발자 포털을 통해 직접 등록할 수 있습니다. 자세한 내용은 개발자 포털 유형에 따라 다음 섹션 중 하나를 참조하세요.
- 통합 포털: 통합 포털에서 개발자 계정 만들기
- Drupal 9: 앱 개발자 계정 등록
- Drupal 7: 사용자 계정 추가 및 관리
- 관리자는 API를 사용하여 앱 개발자를 등록할 수 있습니다.
- 개발자 포털 관리자는 다음 섹션에 설명된 대로 포털에서 직접 개발자를 관리합니다.
- 통합 포털: 개발자 계정 관리를 통해 개발자 계정을 관리할 수 있습니다.
- Drupal 9: 앱 개발자가 Apigee Edge 모듈과 상호작용하는 방법
- Drupal 7: 사용자 계정 추가 및 관리
- 조직 관리자는 다음 섹션에 설명된 대로 Edge UI 또는 API를 사용하여 개발자를 관리합니다.
개발자 포털에서의 개발자 계정 관리를 위한 권장사항
Apigee에서는 개발자 포털에서 직접 개발자 계정을 관리하는 것이 좋습니다.
통합된 포털을 사용하는 경우 이 방법을 통해서만 통합 포털과 Edge의 개발자 계정이 동기화된 상태로 유지됩니다.
Drupal 기반 개발자 포털을 사용하는 경우 개발자 포털에서 직접 개발자 계정을 관리하면 다음과 같은 이점이 있습니다.
- 포털의 관리자 인터페이스를 통해 개발자를 추가하면 포털에 개발자 비밀번호를 설정하고 개발자에게 보낸 자동 이메일 메시지를 트리거할 수 있습니다.
Edge를 사용하여 개발자를 추가하거나 수정할 때 개발자에게 이메일이 전송되지 않으며 포털에서 개발자의 비밀번호를 설정할 수 없습니다. 따라서 개발자는 포털에 로그인하려면 포털에서 자신의 비밀번호를 재설정해야 합니다.
- 포털의 개발자 계정 변경사항은 자동으로 Edge로 전송됩니다.
Edge를 사용하여 Drupal 기반 개발자 계정을 관리하려면 포털과 Edge 간에 앱 개발자를 동기화해야 합니다.
개발자 페이지 살펴보기
Edge UI 및 기본 Edge UI를 사용하여 개발자 페이지에 액세스하고 탐색합니다.
에지
Edge UI를 사용하여 개발자 페이지에 액세스하려면 다음 안내를 따르세요.
- apigee.com/edge에 로그인합니다.
- 왼쪽 탐색 메뉴에서 Publish > Developers를 선택합니다.
개발자 페이지가 표시됩니다.
그림에 강조 표시된 것처럼 개발자 페이지에서 다음을 할 수 있습니다.
- 개발자 추가
- 다음을 비롯한 개발자 세부정보 보기 및 수정
- 게시 데이터 내보내기
- 개발자 삭제
- 개발자 목록 검색
Classic Edge (Private Cloud)
Classic Edge UI를 사용하여 개발자 페이지에 액세스하려면 다음 단계를 따르세요.
http://ms-ip:9000
에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.- 상단의 탐색 메뉴에서 게시 > 개발자를 선택합니다.
개발자 페이지가 표시됩니다.
- 개발자 목록 보기
- 개발자 추가
- 맞춤 속성을 포함한 개발자 세부정보를 확인 및 수정하고 개발자를 활성화하세요.
- 게시 데이터 내보내기
- 개발자 삭제
- 개발자 목록 검색
- 연결된 개발자 포털 보기 (Drupal 7만 해당)
개발자 추가
개발자를 추가하려면 다음 안내를 따르세요.
- 개발자 페이지에 액세스합니다.
- + Developer를 클릭합니다.
- 이름, 성, 이메일, 사용자 이름 등 개발자 세부정보를 입력합니다.
- 만들기를 클릭합니다.
개발자 세부정보 보기 및 수정
개발자 세부정보를 보고 수정합니다. 수익 창출이 사용 설정된 조직의 경우 수익 창출 속성 구성에 정의된 수익 창출 맞춤 속성을 수정할 수 있습니다.
개발자 세부정보를 보고 수정하려면 다음 안내를 따르세요.
- 개발자 페이지에 액세스합니다.
- 보고 수정하고 싶은 개발자의 행을 클릭하여 개발자 세부정보를 엽니다.
- 세부정보 섹션에 다음 정보가 표시됩니다. 필요에 따라 개발자 세부정보를 수정합니다.
세부정보 설명 세부정보 개발자 이름과 성, 사용자 이름, 이메일, 등록 상태와 기간, 개발자 ID.
개발자 세부정보를 수정하려면 다음 필드 중 하나를 클릭합니다.- 이름
- 성
- 이메일
- 사용자 이름
맞춤 속성 개발자에게 정의된 커스텀 속성입니다. 필요에 따라 커스텀 속성을 구성합니다. 자세한 내용은 다음을 참고하세요. 앱 개발자가 등록한 앱입니다. 앱 등록을 참조하세요. - 상태 필드에서 개발자를 활성화하거나 비활성화합니다.
자세한 내용은 개발자 활성화 및 비활성화를 참조하세요.
Apigee Edge for Public Cloud의 경우 Edge는 항목에 액세스한 후 최소 180초 동안 다음 항목을 캐시에 유지합니다.
- OAuth 액세스 토큰. 즉, 해지된 토큰은 캐시 한도가 만료될 때까지 최대 3분 동안 계속 성공할 수 있습니다.
- 키 관리 서비스(KMS) 항목(앱, 개발자, API 제품)
- OAuth 토큰 및 KMS 항목의 커스텀 속성
개발자 커스텀 속성 관리
수익 창출 속성 구성에 설명된 수익 창출 속성을 포함하여 각 개발자에 최대 18개의 맞춤 속성을 추가할 수 있습니다.
커스텀 속성을 관리하는 방법은 다음과 같습니다.
- 개발자 페이지에 액세스합니다.
- 커스텀 속성을 관리하려는 개발자의 행을 클릭하여 개발자 세부정보를 엽니다.
- 커스텀 속성 섹션에서 +를 클릭합니다.
- 속성 이름과 값을 입력합니다.
- 아이콘을 클릭합니다.
- 커스텀 속성을 삭제하려면 속성 위에 커서를 놓고 작업 메뉴에서 를 클릭합니다.
개발자 활성화 및 비활성화
앱 개발자가 포털에 직접 등록하면 기본적으로 앱 개발자 활성화 여부를 구성할 수 있습니다.
개발자가 비활성화된 상태이더라도 개발자는 개발자 포털에 로그인하여 앱을 만들 수 있습니다. 하지만 해당 API 키는 작동하지 않습니다. 개발자 앱이 개발자가 비활성화된 상태에서 유효하지 않더라도 API 키를 수행하므로 여전히 승인(또는 기타) 상태를 유지합니다.
개발자를 활성화하거나 비활성화하려면 다음 안내를 따르세요.
- 개발자 페이지에 액세스합니다.
- 활성화 또는 비활성화하려는 개발자의 행을 클릭하여 개발자 세부정보를 엽니다.
- 세부정보 섹션에서 Status 필드를 필요에 따라 Active 또는 Inactive로 설정합니다.
- 개발자가 여러 조직에 있으면 위 단계를 반복합니다.
게시 데이터 내보내기
다음 게시 데이터를 쉼표로 구분된 값(CSV) 파일로 내보냅니다.
- 개발자 세부정보
- 개발자, 애플리케이션, API 제품 세부정보
게시 데이터를 내보내려면 다음 안내를 따르세요.
- 개발자 페이지에 액세스합니다.
- Export CSV...를 클릭합니다.
- 드롭다운에서 개발자 또는 개발자, 앱, 제품을 선택합니다.
선택한 게시 데이터가 CSV 파일로 다운로드됩니다.
개발자 삭제
개발자를 삭제하려면 다음 안내를 따르세요.
- 개발자 페이지에 액세스합니다.
- 삭제할 개발자의 행으로 커서를 이동하여 작업 메뉴를 표시합니다.
- 아이콘을 클릭합니다.
- 삭제를 클릭하여 삭제를 확인합니다.
포털과 Edge 간 앱 개발자 동기화
Drupal 기반 개발자 포털을 사용하여 API를 게시하는 경우 Edge를 사용하는 앱 개발자를 대상으로 한 변경사항은 포털에 전파되지 않습니다. 포털 관리자로 포털에 로그인하고 포털을 Edge와 동기화해야 이러한 변경사항이 포털에 표시됩니다.
개발자 포털을 Edge에 정의된 앱 개발자와 동기화하려면 다음 섹션을 참고하세요.
- Drupal 9: Apigee Edge와 개발자 동기화
- Drupal 7: 포털과 Edge 간 앱 개발자 동기화
개발자를 회사에 그룹화
수익 창출에서 회사란 하나의 법인으로 관리되는 여러 개발자들의 집합체를 말합니다. 회사는 사업부, 제품 라인 또는 부서와 같이 조직에 적합한 모든 그룹이 될 수 있습니다. 여러 개발자를 하나의 기업 법인에 연결해야 할 때는 개발자를 회사로 그룹화하는 것이 유용합니다. 예를 들어 결제 목적으로 여러 회사를 설정해야 할 수 있습니다. 하지만 조직의 개발자는 회사와 연결될 필요가 없습니다. 개발자는 항상 이메일 요소로 고유하게 식별되는 단일 항목입니다. 개발자가 회사에 일하는 경우 개발자 페이지에 회사 이름이 표시됩니다.
수익 창출을 위해 회사 및 개발자를 관리하는 방법에 관한 자세한 내용은 회사 및 개발자 관리를 참조하세요.
수익 창출 속성 구성
UI를 사용하여 개발자를 수정하거나 API를 사용하여 개발자를 만들거나 수정할 때 다음 표에 정의된 수익 창출 속성을 구성할 수 있습니다. 먼저 조직 프로필을 수정할 때 조직의 수익 창출 속성을 구성합니다.
필드 이름 | 맞춤 속성 이름 | 설명 |
---|---|---|
주소 | MINT_DEVELOPER_ADDRESS |
주소 (입력란 1 및 2), 도시, 주, 우편번호, 국가 필드가 포함된 개발자의 주소 |
결제 프로필 | MINT_BILLING_PROFILE |
조직의 결제 주기입니다. 유효한 값으로 다음이 포함되어 있습니다.
|
결제 유형 | MINT_BILLING_TYPE |
결제에 사용되는 개발자 결제 모델 이 값은 다음 중 하나일 수 있습니다.
API를 사용한 선불 및 후불 결제 유형 구성을 참조하세요. |
카테고리 | MINT_DEVELOPER_CATEGORY |
개발자를 추가하려는 개발자 카테고리입니다. 개발자 카테고리는 유사한 특성을 가진 개발자나 회사를 그룹화한 것입니다. 자세한 내용은 개발자 카테고리 관리를 참고하세요. |
회사 ID | MINT_COMPANY_ID |
회사 ID(해당하는 경우) 자세한 내용은 개발자를 회사로 그룹화를 참조하세요. |
개발자 유형 | MINT_DEVELOPER_TYPE |
이 속성은 Apigee에서 사용하지 않습니다. 개발자 유형 유효한 값은 |
중개인 | MINT_IS_BROKER |
수익이 순수익을 기준으로 하는지 지정하는 플래그입니다. |
법적 이름 | MINT_DEVELOPER_LEGAL_NAME |
모든 보고서에 사용될 개발자의 법적 이름입니다. 참고: 이 속성은 개발자가 회사에 속해 있지 않으며 게시된 요금제를 구독하려는 경우 필수입니다. |
자체 결제 | MINT_HAS_SELF_BILLING |
자체 결제 인보이스의 사용 여부를 지정하는 플래그입니다. 사용 설정(true )하면 수익 창출에서 수익 배분 명세서 대신 자체 결제 인보이스를 생성합니다. 자체 결제 인보이스는 개발자에게 지불해야 할 금액을 자세히 설명하는 재무 문서입니다. 개발자를 대신하여 API 제공업체에 대한 인보이스 역할을 합니다. |
면세 승인 번호 | MINT_TAX_EXEMPT_AUTH_NO |
정부 면세 번호(해당하는 경우) |
세율 | MINT_APPROX_TAX_RATE |
개발자의 대략적인 세율 소수점 앞에는 3자, 소수점 뒤는 4자로 된 십진수를 지정합니다. |
API를 사용하여 개발자 관리
Developer API를 사용하여 개발자를 관리합니다.
API를 사용하여 개발자를 만들고 업데이트할 때 수익 창출 속성 구성에 설명된 수익 창출 속성을 필요에 따라 구성할 수 있습니다.