[논문 리뷰] Source Data for the Focus Area Maturity Model for API Management

Max Mathijssen, Michiel Overeem외 1명|arXiv (Cornell University)|2020. 07. 21.

Software Engineering Research참고 문헌 3인용 수 5

한 줄 요약

이 논문은 체계적인 문헌 리뷰, 전문가 인터뷰 및 사례 연구를 통해 개발된 6개의 중점 분야에서 81개의 실천 항목과 20개의 역량을 포함하는 구조화된 프레임워크인 API 관리 중점 분야 성숙도 모델(API-m-FAMM)을 제시한다. 이 모델을 통해 조직은 수준 1에서 10까지의 성숙도를 평가하고 향상시키며 기준을 설정할 수 있으며, 명확성과 구현 가능성을 위해 실천 항목이 표준화되어 있다.

ABSTRACT

We define API Management as an activity that enables organizations to design, publish and deploy their APIs for (external) developers to consume. API Management capabilities such as controlling API lifecycles, access and authentication to APIs, monitoring, throttling and analyzing API usage, as well as providing security and documentation. These capabilities are often implemented through an integrated platform. This data set describes the API Management Focus Area Maturity Model (API-m-FAMM). In a structured manner, this model aims to support organizations that expose their API(s) to third-party developers in their API management activities. Through a thorough Systematic Literature Review (SLR), 114 practices and 39 capabilities were collected. Subsequently, these practices and capabilities were categorized into 6 focus areas. Next, the practices and capabilities were analyzed and verified through inter-rater agreement and four validation sessions with all involved researchers. Then, the collection of practices and capabilities was verified by using information gathered from supplemental literature, online blog posts, websites, commercial API management platform documentation and third-party tooling. As a result, the initial body of practices and capabilities was narrowed down to 87 practices and 23 capabilities. These practices are described by a practice code, name, description, conditions for implementation, the role responsible for the practice, and the associated literature in which the practice was originally identified. Capabilities and focus areas are described by a code, description and, optionally, the associated literature in which it was originally identified. Using the API-m-FAMM, organizations may evaluate, improve upon and assess the degree of maturity their business processes regarding the topic of API management have.

연구 동기 및 목표

• 조직의 API 관리 성숙도를 평가하고 향상시키기 위한 종합적이고 경험 기반의 성숙도 모델을 개발하기 위해.
• 제3자 API 노출 및 관리와 관련된 실행 가능하고 구현 가능한 실천 항목과 역량을 식별하고 검증하기 위해.
• 표준화되고 증거 기반인 프레임워크를 통해 실무자와 연구자들이 API 관리 성숙도를 평가하고 기준을 설정할 수 있도록 지원하기 위해.
• 전문가 검증, 사례 연구 및 체계적인 피드백 루프를 통한 반복적 개선을 통해 모델의 타당성과 실용적 관련성을 확보하기 위해.

제안 방법

• 학술 및 그레이 리서치 문헌에서 기초적인 실천 항목과 역량을 식별하기 위해 체계적인 문헌 리뷰(SLR)를 수행하였다.
• 실무자 관련성과 사용 용이성에 기반해 초안 실천 항목과 역량을 검증하고 보완하기 위해 11건의 반구조화된 전문가 인터뷰를 실시하였다.
• 연구자와 실무자 간의 반복적 토론 세션을 통해 실천 항목의 분류, 기술 및 성숙도 수준 할당에 합의를 이끌어냈다.
• Google Drawings를 활용한 카드 정렬 기법을 적용하여 중점 분야와 성숙도 수준 간에 모델 구성 요소를 체계적으로 정리하고 재구성하였다.
• 실제 적용 가능성과 구현 격차를 테스트하기 위해 상용 소프트웨어 제품 5종에 대한 사례 연구를 수행하였다.
• 최종 모델(v1.0)을 개선하기 위해 모호한 실천 항목을 제거하고, 명확성을 높이기 위해 기술 내용을 업데이트하였으며, 일관된 문법적 구조(예: 동사-명사 형식)에 맞추어 용어를 통일하였다.

실험 결과

연구 질문

• RQ1 외부 개발자에게 API를 노출하는 조직에서 효과적인 API 관리를 정의하는 핵심 실천 항목과 역량은 무엇인가?
• RQ2 SLR, 전문가 인터뷰 및 사례 연구를 포함한 혼합 방법 연구를 통해 API 관리 성숙도 모델을 체계적으로 개발하고 검증할 수 있는 방법은 무엇인가?
• RQ3 전문가 실무자들이 API 관리 실천 항목의 관련성과 성숙도 수준 할당에 대해 어느 정도 일치하는가?
• RQ4 실제 구현 과제와의 일치성과 실용적 사용 가능성을 확보하기 위해 모델을 어떻게 반복적으로 개선할 수 있는가?

주요 결과

• 최종 API-m-FAMM는 6개의 중점 분야에 분류된 81개의 검증된 실천 항목과 20개의 역량을 포함하며, 각 실천 항목은 수준 1에서 10까지의 성숙도 수준이 할당되어 있다.
• 전문가 피드백을 통해 '민감한 데이터 노출 방지' 실천 항목이 '전송 계층 암호화 구현'과 같은 기존 실천 항목과 중복되어 제거되었다.
• '요청 빈도 제한 수행' 실천 항목은 오류 빈도 제한까지 포함하도록 개선되어, 실제 운영 환경에서 관찰된 구현 패턴을 반영하였다.
• '자원 사용량 모니터링'의 기술 내용은 지표가 아닌 비정량적 근사치까지 포함하도록 확장되어 명확성과 실용적 적용 가능성이 향상되었다.
• '예측적 스케일링 구현' 실천 항목의 기술 내용은 수동 구현을 제외하도록 수정되어 산업 기대 수준인 자동화를 반영하였다.
• 최종 모델는 6종의 소프트웨어 제품에 대한 사례 연구를 통해 검증되었으며, 실용적 관련성이 확인되었고, 기술 및 범위에 대한 실행 가능한 개선 사항이 도출되었다.