Azure API Management에서 개발자 계정을 관리하는 그룹을 만들고 사용하는 방법
적용 대상: 개발자 | 기본 | 기본 v2 | 표준 | 표준 v2 | 프리미엄
API Management에서 그룹은 개발자에 대한 제품 표시 여부를 관리하는 데 사용됩니다. 제품이 먼저 그룹에 표시된 다음, 이러한 그룹의 개발자가 그룹과 연결된 제품을 보고 구독할 수 있습니다.
API Management에는 다음과 같은 변경할 수 없는 시스템 그룹이 있습니다.
관리자 - Azure 구독 관리자는 이 그룹의 구성원입니다. 관리자는 API Management 서비스 인스턴스를 관리하며 개발자가 사용하는 API, 작업 및 제품을 만듭니다. 이 그룹에 사용자를 추가할 수 없습니다.
참고 항목
API Management 인스턴스에서 개발자에게 보내는 알림에 사용되는 관리자 이메일 설정을 변경할 수 있습니다.
개발자 - 인증된 개발자 포털 사용자는 이 그룹에 속합니다. 개발자는 API를 사용하여 애플리케이션을 빌드하는 고객입니다. 개발자는 개발자 포털에 액세스할 수 있는 권한을 받으며 API의 작업을 호출하는 애플리케이션을 빌드합니다.
게스트 - API Management 인스턴스의 개발자 포털을 방문하는 인증되지 않은 개발자 포털 사용자(예: 잠재 고객)가 이 그룹에 속합니다. 예를 들어 API를 볼 수 있지만 호출할 수는 없는 기능과 같이 특정 읽기 전용 액세스 권한을 받을 수 있습니다.
이러한 시스템 그룹 외에도 관리자는 사용자 지정 그룹을 만들거나 관련 Microsoft Entra 테넌트에서 외부 그룹을 사용할 수 있습니다. 사용자 지정 및 외부 그룹은 시스템 그룹과 함께 사용되어 개발자에게 API 제품에 대한 표시 여부 및 액세스를 제공합니다. 예를 들어, 특정 파트너 조직과 관련된 개발자를 위한 하나의 사용자 지정 그룹을 만들고 관련 API만을 포함한 제품에서 API에 대한 액세스를 허용합니다. 사용자는 두 그룹 이상의 구성원이 될 수 있습니다.
이 가이드에서는 API Management 인스턴스의 관리자가 새 그룹을 추가하고 이 그룹과 새 제품 및 개발자를 연결하는 방법을 보여 줍니다.
Azure Portal에서 그룹 만들기 및 관리 외에도 API Management REST API 그룹 엔터티를 사용하여 그룹을 만들고 관리할 수 있습니다.
필수 조건
Azure API Management 인스턴스 만들기 문서의 작업을 완료합니다.
API Management 인스턴스로 이동
Azure Portal에서 API Management 서비스를 검색하여 선택합니다.
API Management 서비스 페이지에서 API Management 인스턴스를 선택합니다.
그룹 만들기
이 섹션에서는 API Management 계정에 새 그룹을 추가하는 방법을 보여 줍니다.
화면 왼쪽의 그룹 탭을 선택합니다.
+추가를 클릭합니다.
그룹의 고유한 이름 및 선택적 설명을 입력합니다.
만들기를 누릅니다.
그룹이 만들어지면 그룹 목록에 추가됩니다.그룹의 이름 또는 설명을 편집하려면 그룹 이름을 클릭하고 설정을 선택합니다.
그룹을 삭제하려면 그룹 이름을 클릭하고 삭제를 누릅니다.
그룹이 생성되었으므로, 제품 및 개발자와 연결할 수 있습니다.
그룹과 제품 연결
왼쪽의 제품 탭을 선택합니다.
원하는 제품의 이름을 클릭합니다.
액세스 제어>+ 그룹 추가를 누릅니다.
추가하려는 그룹을 선택합니다.
제품이 그룹과 연결되면 그룹의 개발자가 제품을 보고 구독할 수 있습니다.
참고 항목
Microsoft Entra 그룹을 추가하려면 Azure API Management에서 Microsoft Entra ID를 사용하여 개발자 계정을 권한 부여하는 방법을 참조하세요.
제품에서 그룹을 제거하려면 삭제를 클릭합니다.
그룹과 개발자 연결
이 섹션에서는 그룹과 구성원을 연결하는 방법을 보여 줍니다.
화면 왼쪽의 그룹 탭을 선택한 다음, 그룹을 선택합니다.
멤버>+ 추가를 선택합니다.
멤버를 선택합니다.
선택을 누릅니다.
개발자와 그룹 간의 연결을 추가한 후에는 사용자 탭에서 확인할 수 있습니다.
다음 단계
- 그룹에 개발자를 추가하면 개발자가 해당 그룹과 연결된 제품을 보고 구독할 수 있습니다. 자세한 내용은 Azure API Management에서 제품을 만들고 게시하는 방법을 참조하세요.
- 구성한 여러 사용자 및 그룹에게 개발자 포털 콘텐츠가 표시되는 방식을 제어할 수 있습니다. 개발자 포털의 표시 유형 및 액세스 제어에 대해 자세히 알아봅니다.
- API Management 인스턴스에서 개발자에게 보내는 알림에 사용되는 관리자 메일 설정을 관리하는 방법을 알아봅니다.