Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
조직은 Apigee Edge의 최상위 컨테이너입니다. 여기에는 모든 API 프록시 및 관련 리소스가 포함됩니다. 이 주제의 나머지 부분에서는 조직에 대해 좀 더 깊게 다루며 몇 가지 유용한 점은 다음과 같습니다.
- 가상 호스트 정보에 설명된 대로 기본적으로 조직 이름은 API 프록시를 호출하는 데 사용되는 URL에 있습니다.
예를 들면 다음과 같습니다.
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- 조직 이름은 Edge 관리 UI의 URL에 있습니다. 예를 들어 다음 URL은
docs조직의 API 프록시를 표시합니다.
- 하나의 조직만 만들 수 있지만 다른 권한을 가진 사용자 또는 관리자로 다른 조직에 속할 수 있습니다. Edge 관리 UI에서 두 개 이상의 조직에 속해 있는 경우 조직 간 전환에 설명된 대로 다른 조직으로 전환할 수 있습니다.
- 조직 관리자 역할의 사용자로 관리 API를 호출하는 경우 조직은 대부분의 호출에서 경로의 필수 부분입니다. 예를 들어 다음 관리 API cURL 요청은 조직의 모든 API 프록시 목록을 반환합니다.
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
동영상: 조직에서 API 관리를 위한 멀티테넌시 아키텍처를 지원하는 방법을 알아보려면 짧은 동영상을 시청하세요.
조직 구성요소
Edge 계정을 만들면 Edge에서 자동으로 조직을 만듭니다. 조직을 만들면 조직에 사용자를 추가하고, API 프록시 및 API 제품을 만들고, 개발자와 앱을 등록할 수 있습니다.
다음 이미지는 Edge 조직 모델의 주요 구성요소를 보여줍니다. 이 모델은 API, API 제품, 앱, 앱 개발자가 모두 Edge 내에서 관련된 방식을 정의합니다.
이 모델에는 Apigee Edge의 모든 기능이 표시되지는 않습니다. 수익 창출을 사용하는 경우 모델에 추가 구성요소가 포함됩니다. 자세한 내용은 수익 창출 개요를 참고하세요. 수익 창출을 통해 회사 및 개발자를 관리하는 방법에 대한 자세한 내용은 회사 및 개발자 관리를 참고하세요.
조직 이름
조직의 이름은 다음과 같습니다.
- 평가 조직:
username-eval - 유료 조직: 초기 프로비저닝 시 사용자 정의
만든 뒤에 조직 이름은 변경할 수 없습니다.
조직 이름은 API 프록시의 URL과 Edge 관리 API에 요청할 때의 URL의 일부가 됩니다. 예를 들어 API 프록시에 액세스하는 데 사용되는 일반적인 URL의 형식은 다음과 같습니다.
http://org-name-env.apigee.net/v1/weather/forecastrss
각 항목의 의미는 다음과 같습니다.
- org-name는 조직 이름입니다.
- env는 API 프록시의 배포 환경으로, test 또는 prod입니다.
예:
http://myorg-test.apigee.net/v1/weather/forecastrss
조직 구성요소
다음 표에서는 조직 모델의 구성요소를 자세히 설명합니다.
| 구성요소 | 설명 |
|---|---|
|
조직 |
모든 Apigee 계정은 Apigee Edge의 하나 이상의 조직에 매핑됩니다. 조직에는 API 프록시, API 제품, API 패키지, 앱, 개발자를 비롯한 모든 구성요소의 표현이 포함됩니다. 계정 소유자는 단일 조직에 제한되지 않습니다. 일부 계정 소유자는 여러 앱 개발자 커뮤니티를 지원하는 여러 조직을 정의하거나 구성원일 수 있습니다. |
| 환경 | 조직의 API 프록시 런타임 실행 컨텍스트입니다. 환경에 대한 자세한 내용은 아래 섹션을 참조하세요. |
|
사용자 |
계정을 만드는 사람이 자동으로 관리자인 조직 내에서 사용자를 더 만들 수 있습니다. 사용자는 관리자, API 프록시, API 제품 생성자, 분석 및 기타 통계를 모니터링하는 사용자, 기타 사용자 등을 포함할 수 있는 조직의 API팀을 구성합니다. 사용자마다 다른 역할과 액세스 권한을 가질 수 있습니다. 예를 들어 조직 및 조직 구성요소를 수정하는 권한을 가진 사용자를 조직 관리자 및 작업 관리자로 정의합니다. API 프록시 및 API 제품을 만들 수 있는 권한이 있지만 다른 사용자를 수정할 수 있는 권한이 없는 다른 사용자를 정의합니다. 사용자는 여러 조직의 구성원일 수 있습니다. 예를 들어 회사는 Apigee Edge에 여러 조직을 정의하여 여러 개발자 커뮤니티를 지원할 수 있습니다. 내부적으로는 같은 사용자가 모든 API 프록시 및 API 제품을 빌드하므로 모든 조직의 구성원입니다. 사용자가 되기 위해 Apigee 계정(즉, Apigee 조직)을 만들 필요는 없습니다. 관리자는 사용자를 기존 조직에 추가할 수 있습니다. 모든 사용자는 다음 페이지에서 Apigee Edge에 로그인합니다.https://enterprise.apigee.com |
|
API 프록시 |
조직의 사용자는 API 프록시를 하나 이상 만듭니다. API 프록시는 공개적으로 사용 가능한 HTTP 엔드포인트의 백엔드 서비스에 대한 매핑을 정의합니다. 또한 API 프록시가 요청, 응답, 서비스 콜아웃에 대해 보안(예: OAuth)을 포함하고, 메시지 변환(예: XML에서 JSON으로)을 수행하고, 트래픽을 백엔드 서비스로 제한하고, 요청에 대한 다른 유용한 작업을 수행하도록 구성할 수 있습니다. Edge는 API 프록시 분석을 위해 데이터를 수집합니다. |
|
API 제품 |
조직의 사용자는 API 제품이 서비스 요금제와 결합된 API 프록시 번들인 하나 이상의 API 제품을 만듭니다. 이 서비스 요금제는 API 프록시에 대한 액세스 한도를 설정하고, 보안을 제공하고, 모니터링 및 분석을 허용하고, 추가 기능을 제공할 수 있습니다. Edge는 API 제품의 분석을 위한 데이터를 수집합니다. |
|
개발자 |
조직에는 조직에서 정의한 API(API 제품에 어셈블됨)를 사용하는 앱을 빌드하는 개발자 한 명 이상이 포함됩니다. 개발자는 API를 사용하지만, 조직에서 API를 만들거나 다른 작업을 수행할 수는 없습니다. 개발자는 회사 내부에 있을 수 있고, 파트너일 수 있고, API 액세스 권한에 대해 비용을 지불하는 외부 개발자일 수 있습니다. 개발자가 앱을 등록하고 API 키를 받은 후 API에 액세스하려면 개발자가 조직에 등록되어 있어야 합니다. 조직에서 개발자를 추가, 업데이트 또는 삭제하는 방법은 API 제공업체가 결정합니다. Edge 관리 UI를 통해 수동으로 추가하거나, 웹사이트를 통해 등록할 개발자 포털을 만들거나, Edge 관리 API를 사용하여 자체 등록 메커니즘을 정의할 수 있습니다. 개발자는 Edge에 계정을 보유할 필요가 없으며 대부분의 개발자는 Edge에 관해 알 필요가 없습니다. 개발자가 Edge에 계정을 보유한 경우 일반적으로 다른 조직의 사용자로 계정을 보유하거나 Edge API 서비스를 사용하기 위해 계정을 보유한 것입니다. |
|
앱 |
개발자가 API를 사용하는 하나 이상의 클라이언트 앱을 만듭니다. 개발자는 조직에 앱을 등록해야 합니다. Edge의 앱은 API에 대한 모든 요청을 전달할 API 키를 개발자에게 제공하는 실제 개발자 앱의 표현입니다. 모든 앱이 조직에 등록되었으므로 Edge를 사용하여 앱과 API 사용에 대한 분석 정보를 모니터링하고 수집할 수 있습니다. |
|
API 키/OAuth 토큰 |
API에 대해 정의한 승인 메커니즘에 따라 앱은 API에 대한 모든 요청과 함께 API 키를 전달합니다. 이 키가 유효하면 요청이 허용됩니다. Edge는 간단한 API 키, 2-legged OAuth, 3-legged OAuth 등 여러 유형의 인증을 지원합니다. API 제공업체는 개발자가 앱을 등록하는 방법을 정의해야 합니다. 이렇게 하려면 개발자에게 API에 액세스하는 데 필요한 키를 반환하는 앱을 등록하면 됩니다. 앱 등록 시점에 개발자는 단일 API 제품 또는 여러 API 제품에 액세스하도록 선택할 수 있습니다. 개발자의 실제 앱은 동일한 키를 사용하여 앱과 연결된 모든 API 제품에 액세스합니다 (Edge에서 개발자 앱의 등록된 표현). 언제든지 키를 취소하여 개발자의 앱이 더 이상 API에 액세스할 수 없도록 할 수 있습니다(개발자 앱의 등록된 표현은 조직에 여전히 존재함). 또는 개발자가 특정 시간 후에 키를 새로 고침하도록 키에 시간 한도를 정의할 수 있습니다. |
환경 정보
환경은 조직의 API 프록시에 대한 런타임 실행 컨텍스트입니다. 환경에 액세스하려면 API 프록시를 환경에 배포해야 합니다. API 프록시를 단일 환경 또는 여러 환경에 배포할 수 있습니다.
한 조직에 여러 환경이 포함될 수 있습니다. 예를 들어 조직의 dev, test, prod 환경을 정의할 수 있습니다.
조직은 일부 Apigee 기능의 범위를 제공합니다. 예를 들어 키-값 맵 (KVM) 데이터를 조직 수준에서 사용할 수 있습니다. 즉, 모든 환경에 배포된 API 프록시는 KVM에서 동일한 데이터를 가져옵니다. 캐싱과 같은 일부 기능은 조직 또는 조직 내 특정 환경으로 범위가 지정될 수 있습니다. Apigee 분석 데이터는 조직과 환경의 조합에 따라 분할됩니다.
아래에는 조직 내에서 관리하는 주요 항목(조직에서 전역적으로 정의되고 특정 환경에 정의된 항목)이 나와 있습니다.
