앱 개발자 등록

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

다음 섹션의 설명대로 앱 개발자를 등록하고 관리합니다. 앱 등록은 앱 등록 및 API 키 관리의 설명대로 별도의 프로세스입니다.

소개

Edge는 API를 호출하는 사용자를 파악하는 데 완전히 의존하는 많은 이점을 제공합니다. 예를 들어 API 보안, 트래픽 관리, 상당히 많은 분석 데이터는 호출자 파악에 따라 달라집니다. Edge는 API를 호출하는 사용자를 어떻게 파악할까요? 사용자 ID, API 키 또는 OAuth 토큰과 같은 각 API 호출에서 고유 정보를 읽어 파악합니다. 이러한 고유 정보는 API 프록시로 빌드하는 기능을 잠그거나 잠금 해제하여 API 액세스와 동작을 완전히 제어할 수 있게 해줍니다.

따라서 앱 개발자가 API를 사용하려면 등록해야 합니다. 추가되면 개발자는 자신의 앱을 등록하고, 사용할 API를 선택하고, API에 액세스하는 데 필요한 고유한 API 사용자 인증 정보(소비자 키 및 보안 비밀)를 수신합니다.

앱 개발자 등록 방법

다음 방법 중 하나를 사용하여 앱 개발자를 등록합니다.

• 유료 Edge 계정이 있으면 개발자는 개발자 포털을 통해 직접 등록할 수 있습니다. 자세한 내용은 개발자 포털 유형에 따라 다음 섹션 중 하나를 참조하세요.
  • 통합 포털: 통합 포털에서 개발자 계정 만들기
  • Drupal 10: 앱 개발자 계정 등록
  • Drupal 7: 사용자 계정 추가 및 관리
• 관리자는 API를 사용하여 앱 개발자를 등록할 수 있습니다.
• 개발자 포털 관리자는 다음 섹션의 설명대로 포털에서 직접 개발자를 관리합니다.
  • 통합 포털: 개발자 계정을 관리하여 개발자 계정을 관리합니다.
  • Drupal 10: 앱 개발자가 Apigee Edge 모듈과 상호작용하는 방식
  • Drupal 7: 사용자 계정 추가 및 관리
• 조직 관리자는 다음 섹션의 설명대로 Edge UI나 API를 사용하여 개발자를 관리합니다.

개발자 포털에서의 개발자 계정 관리를 위한 권장사항

Apigee는 개발자 포털에서 직접 개발자 계정을 관리하는 것을 권장합니다.

통합 포털을 사용하는 경우 이 방법은 통합 포털의 개발자 계정과 Edge가 동기화된 상태를 유지하는 유일한 방법입니다.

Drupal 기반 개발자 포털을 사용하는 경우 개발자 포털에서 직접 개발자 계정을 관리하면 다음과 같은 이점이 있습니다.

• 포털의 관리자 인터페이스를 통해 개발자를 추가하면 포털에 개발자 비밀번호를 설정하고 개발자에게 보낸 자동 이메일 메시지를 트리거할 수 있습니다.

  Edge를 사용하여 개발자를 추가하거나 수정할 때는 개발자에게 이메일이 전송되지 않으며 포털에서 개발자의 비밀번호를 설정할 수 없습니다. 따라서 개발자는 포털에 로그인하려면 포털에서 자신의 비밀번호를 재설정해야 합니다.

• 포털에서 개발자 계정에 적용된 변경사항은 Edge로 자동 전송됩니다.

Edge를 사용하여 Drupal 기반 개발자 계정을 관리하려면 포털과 Edge 간에 앱 개발자를 동기화해야 합니다.

개발자 페이지 살펴보기

Edge UI 및 기본 Edge UI를 사용하여 개발자 페이지에 액세스하고 살펴봅니다.

개발자 추가

개발자를 추가하려면 다음 안내를 따르세요.

1. 개발자 페이지에 액세스합니다.
2. + Developer를 클릭합니다.
3. 이름, 성, 이메일, 사용자 이름 등 개발자 세부정보를 입력합니다.
4. 만들기를 클릭합니다.

개발자 세부정보 보기 및 수정

개발자 세부정보를 보고 수정합니다. 수익 창출이 사용 설정된 조직의 경우 수익 창출 속성 구성에 정의된 수익 창출 맞춤 속성을 수정할 수 있습니다.

개발자 세부정보를 보고 수정하려면 다음 안내를 따르세요.

1. 개발자 페이지에 액세스합니다.
2. 보고 수정하고 싶은 개발자의 행을 클릭하여 개발자 세부정보를 엽니다.
3. 세부정보 섹션에 다음 정보가 표시됩니다. 필요에 따라 개발자 세부정보를 수정합니다.

   세부정보	설명
   세부정보	개발자 이름과 성, 사용자 이름, 이메일, 등록 상태와 기간, 개발자 ID. 개발자 세부정보를 수정하려면 다음 필드 중 하나를 클릭합니다. 이름 성 이메일 사용자 이름 콘텐츠를 수정하고 Enter 키를 눌러 변경사항을 확인합니다.
   맞춤 속성	개발자에게 정의된 맞춤 속성입니다. 필요에 따라 맞춤 속성을 구성합니다. 자세한 내용은 다음을 참고하세요. 개발자의 맞춤 속성 관리하기 수익 창출 속성 구성
   앱	개발자가 등록한 앱입니다. 앱 등록을 참고하세요.

4. 상태 필드에서 개발자를 활성화하거나 비활성화합니다.
   자세한 내용은 개발자 활성화 및 비활성화를 참고하세요.

퍼블릭 클라우드용 Apigee Edge를 사용하면 Edge는 항목이 액세스된 후 180초 이상 다음 항목을 캐시에 보관합니다.

• OAuth 액세스 토큰. 즉, 취소된 토큰은 캐시 한도가 만료될 때까지 최대 3 분 동안 계속 성공할 수 있습니다.
• 키 관리 서비스 (KMS) 항목 (앱, 개발자, API 제품)
• OAuth 토큰 및 KMS 항목의 맞춤 속성

개발자 맞춤 속성 관리

수익 창출 속성 구성에 설명된 수익 창출 속성을 비롯하여 각 개발자에게 최대 18개의 맞춤 속성을 추가합니다.

맞춤 속성을 관리하려면 다음 안내를 따르세요.

1. 개발자 페이지에 액세스합니다.
2. 커스텀 속성을 관리하려는 개발자의 행을 클릭하여 개발자 세부정보를 엽니다.
3. 커스텀 속성 섹션에서 +를 클릭합니다.
4. 속성 이름과 값을 입력합니다.
5. 를 클릭합니다.
6. 커스텀 속성을 삭제하려면 속성 위에 커서를 놓고 작업 메뉴에서 를 클릭합니다.

개발자 활성화 및 비활성화

앱 개발자가 포털에 직접 등록하면 기본적으로 앱 개발자 활성화 여부를 구성할 수 있습니다.

개발자가 비활성화된 상태이더라도 개발자는 개발자 포털에 로그인하여 앱을 만들 수 있습니다. 하지만 해당 API 키는 작동하지 않습니다. 개발자 앱이 개발자가 비활성화된 상태에서 유효하지 않더라도 API 키를 수행하므로 여전히 승인(또는 기타) 상태를 유지합니다.

개발자를 활성화하거나 비활성화하려면 다음 안내를 따르세요.

1. 개발자 페이지에 액세스합니다.
2. 활성화 또는 비활성화하려는 개발자의 행을 클릭하여 개발자 세부정보를 엽니다.
3. 세부정보 섹션에서 Status 필드를 필요에 따라 Active 또는 Inactive로 설정합니다.
4. 개발자가 여러 조직에 있으면 위 단계를 반복합니다.

게시 데이터 내보내기

다음 게시 데이터를 쉼표로 구분된 값(CSV) 파일로 내보냅니다.

• 개발자 세부정보
• 개발자, 애플리케이션, API 제품 세부정보

게시 데이터를 내보내려면 다음 안내를 따르세요.

1. 개발자 페이지에 액세스합니다.
2. Export CSV...를 클릭합니다.
3. 드롭다운에서 개발자 또는 개발자, 앱, 제품을 선택합니다.

선택한 게시 데이터가 CSV 파일로 다운로드됩니다.

개발자 삭제

개발자를 삭제하려면 다음 안내를 따르세요.

1. 개발자 페이지에 액세스합니다.
2. 삭제할 개발자의 행으로 커서를 이동하여 작업 메뉴를 표시합니다.
3. 를 클릭합니다.
4. 삭제 를 클릭하여 삭제를 확인합니다.

포털과 Edge 간의 앱 개발자 동기화

Drupal 기반 개발자 포털을 사용하여 API를 게시하는 경우 Edge를 사용한 앱 개발자의 변경사항이 포털에 전파되지 않습니다. 포털 관리자로 포털에 로그인하고 포털을 Edge와 동기화해야 포털에 변경사항이 표시됩니다.

개발자 포털을 Edge에서 정의한 앱 개발자와 동기화하려면 다음 섹션을 참조하세요.

• Drupal 10: Apigee Edge와 개발자 동기화
• Drupal 7: 포털과 Edge 간의 앱 개발자 동기화

개발자를 회사에 그룹화

수익 창출을 사용하면 회사는 단일 법인으로 관리되는 개발자 모음입니다. 회사는 비즈니스 단위, 제품 라인 또는 부서와 같이 조직에 적합한 그룹화일 수 있습니다. 개발자를 회사에 그룹화하는 것은 단일 법인에 여러 개발자를 연결해야 하는 경우에 유용합니다. 예를 들어 청구 목적으로 여러 회사를 설정해야 할 수 있습니다. 하지만 조직의 개발자는 회사와 연결될 필요가 없습니다. 개발자는 항상 단일 법인이며, 이메일 요소로 고유하게 식별됩니다. 개발자가 회사에 속해 있으면 개발자 페이지에 회사 이름이 표시됩니다.

수익 창출을 위한 회사 및 개발자 관리에 대한 자세한 내용은 회사 및 개발자 관리를 참고하세요.

수익 창출 속성 구성

UI를 사용하여 개발자를 수정하거나 API를 사용하여 개발자를 만들거나 수정할 때 다음 표에 정의된 수익 창출 속성을 구성할 수 있습니다. 처음에는 조직 프로필을 수정할 때 조직의 수익 창출 속성을 구성합니다.

필드 이름	맞춤 속성 이름	설명
주소	MINT_DEVELOPER_ADDRESS	주소 (1행 및 2행), 시, 도, 우편번호, 국가 필드를 비롯한 개발자의 주소입니다.
결제 프로필	MINT_BILLING_PROFILE	조직의 결제 주기입니다. 유효한 값으로 다음이 포함되어 있습니다. PRORATED: 결제는 API 제품이 달력 월에 사용된 일수를 기준으로 합니다. CALENDAR_MONTH: 결제는 월 단위로 이루어집니다.
결제 유형	MINT_BILLING_TYPE	결제에 사용되는 개발자 결제 모델입니다. 이 값은 다음 중 하나일 수 있습니다. 선불: 개발자가 API 제품 사용 요금을 미리 지불합니다. API 제품을 사용하면 개발자의 잔액에서 금액이 차감됩니다. 개발자는 API 제품을 구매할 수 있는 충분한 선불 잔액을 유지해야 합니다. POSTPAID: 개발자는 API 제품 사용 요금을 월 단위로 결제합니다 (인보이스를 통해). 개발자는 인보이스에 포함된 요금제에서 설정한 결제 약관에 따라 API 제품 사용 요금을 지불합니다. BOTH: 두 결제 유형을 모두 지원합니다. 기본값은 선불입니다. API를 사용하여 선불 및 후불 결제 유형 구성을 참고하세요.
카테고리	MINT_DEVELOPER_CATEGORY	개발자를 추가하려는 개발자 카테고리입니다. 개발자 카테고리는 유사한 특성을 가진 개발자 또는 회사의 그룹입니다. 자세한 내용은 개발자 카테고리 관리를 참고하세요.
회사 ID	MINT_COMPANY_ID	해당하는 경우 회사 ID입니다. 자세한 내용은 Grouping developers into companies를 참고하세요.
개발자 유형	MINT_DEVELOPER_TYPE	이 속성은 Apigee에서 사용되지 않습니다. 개발자 유형입니다. 유효한 값으로 TRUSTED 또는 UNTRUSTED가 포함되어 있습니다.
브로커인가요?	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를 사용하여 개발자를 만들고 업데이트할 때 필요에 따라 수익 창출 속성 구성에 설명된 수익 창출 속성을 구성할 수 있습니다.