개발자 프록시에 대한 기술 참조

이 섹션에는 개발자 프록시 플러그 인 및 구성 옵션에 대한 기술 참조가 포함되어 있습니다.

보고 및 분석에 사용해야 하는 플러그 인은 무엇인가요?

다음 표를 사용하여 앱의 API 트래픽에 대해 알아보려는 것과 일치하는 플러그 인을 선택합니다. 보고서를 생성하는 플러그인에는 보고서를 파일에 저장하려면 JsonReporter, MarkdownReporter 또는 PlainTextReporter와 같은 리포터가 필요합니다. 생성기 플러그인은 출력 파일에 직접 씁니다. 개발자 프록시는 기록을 중지한 후 현재 작업 디렉터리에 출력 파일을 만듭니다.

목표 플러그인 + 리포터 출력 파일
내 앱에서 호출하는 URL을 목록화하세요 UrlDiscoveryPlugin + JsonReporter UrlDiscoveryPlugin_JsonReporter.json
요청 및 그 결과 수 계산 ExecutionSummaryPlugin + MarkdownReporter 또는 JsonReporter ExecutionSummaryPlugin_MarkdownReporter.md 또는 ExecutionSummaryPlugin_JsonReporter.json
전체 요청 및 응답 캡처 HarGeneratorPlugin devproxy-yyyyMMddHHmmss.har
재실행 가능한 요청 만들기 HttpFileGeneratorPlugin requests_yyyyMMddHHmmss.http
트래픽에서 API 사양 만들기 OpenApiSpecGeneratorPlugin 또는 TypeSpecGeneratorPlugin host-port-yyyyMMddHHmmss.json (또는 .yaml) API 호스트당 또는 name-yyyyMMddHHmmss.tsp API 호스트당
트래픽에서 mock 만들기 MockGeneratorPlugin mocks-yyyyMMddHHmmss.json
내 앱에 필요한 최소 권한 찾기 MinimalPermissionsPlugin + MarkdownReporter 또는 JsonReporter MinimalPermissionsPlugin_MarkdownReporter.md 또는 MinimalPermissionsPlugin_JsonReporter.json

Note

같은 이름의 보고서 파일이 이미 있는 경우 보고 도구는 파일 이름에 타임스탬프를 추가합니다. 예를 들면 다음과 같습니다 UrlDiscoveryPlugin_JsonReporter_yyyyMMddHHmmss.json. Microsoft Graph API의 경우 GraphMinimalPermissionsPlugin을 사용하여 최소 권한을 찾습니다.

플러그 인

모든 API에서 작동하는 플러그 인 목록입니다.

이름 설명
AuthPlugin API 키 또는 OAuth2를 사용하여 인증 및 권한 부여를 시뮬레이션합니다.
DevToolsPlugin Chrome DevTools에서 개발자 프록시 메시지와 가로채는 요청 및 응답에 대한 정보를 노출합니다. HTTP 및 STDIO를 모두 지원합니다.
CachingGuidancePlugin 개발자 프록시가 지정된 기간 내에 동일한 요청을 가로챌 때 경고를 표시합니다.
CrudApiPlugin 메모리 내 데이터 저장소를 사용하여 CRUD API를 시뮬레이션합니다.
ExecutionSummaryPlugin 프록시를 통과하는 요청의 요약 보고서를 생성합니다.
GenericRandomErrorPlugin 모의 오류가 포함된 파일에서 임의로 선택한 오류가 있는 요청에 실패합니다.
HarGeneratorPlugin 가로챈 요청 및 응답에서 HTTP 아카이브 (HAR) 파일을 생성합니다.
HttpFileGeneratorPlugin 가로챈 요청 및 응답에서 HTTP 파일을 생성합니다.
언어 모델 실패 플러그인(LanguageModelFailurePlugin) 다양한 언어 모델 오류 시나리오를 시뮬레이션하여 언어 모델 종속 애플리케이션의 복원력을 테스트합니다.
LanguageModelRateLimitingPlugin 구성 가능한 시간 내에 프롬프트 및 완료 토큰 사용을 추적하여 언어 모델 API에 대한 토큰 기반 속도 제한을 시뮬레이션합니다.
LatencyPlugin 구성된 범위에서 난수(밀리초)로 응답을 지연합니다. HTTP 및 STDIO를 모두 지원합니다.
MinimalCsomPermissionsPlugin 기록된 SharePoint Client-Side 개체 모델(CSOM) API 요청을 호출하는 데 필요한 최소 권한을 검색합니다.
MinimalPermissionsPlugin 기록된 API 요청을 호출하는 데 필요한 최소 권한을 반환합니다. 지정된 로컬 폴더의 API 정보를 사용합니다.
MinimalPermissionsGuidancePlugin API로 전송된 JWT 토큰에 사용된 사용 권한을 프록시가 기록한 요청에 필요한 최소 범위와 비교하고 차이를 표시합니다.
MockGeneratorPlugin 인터셉트된 요청을 기반으로 개발 프록시 모형을 생성합니다.
MockRequestPlugin 개발자 프록시를 사용하여 웹 요청을 실행할 수 있습니다.
MockResponsePlugin 응답을 시뮬레이션합니다.
MockStdioResponsePlugin MCP 서버와 같은 STDIO 기반 애플리케이션에 대한 응답을 시뮬레이션합니다.
ODataPagingGuidancePlugin 프록시가 이전에 가로채진 응답 중 하나에서 반환되지 않은 URL을 사용하여 OData 페이징 요청을 가로챌 때 경고를 표시합니다.
OpenAIMockResponse플러그인 로컬 언어 모델을 사용하여 Azure OpenAI 및 OpenAI의 응답을 시뮬레이션합니다.
OpenAITelemetryPlugin OpenAI 호환 API 요청에 대한 원격 분석 데이터를 생성합니다.
OpenAIUsageDebuggingPlugin 디버깅 및 분석을 위해 OpenAI API 사용 메트릭을 CSV 파일에 기록합니다.
OpenApiSpecGenerator플러그인 가로챈 요청 및 응답에서 OpenAPI 사양을 생성합니다.
RateLimitingPlugin 속도 제한 동작을 시뮬레이션합니다.
RetryAfterPlugin Retry-After 요청을 제한한 후 API에서 보낸 헤더를 시뮬레이션합니다.
RewritePlugin 요청을 다시 작성합니다.
TypeSpecGenerator플러그인 인터셉트한 요청 및 응답에서 TypeSpec 파일을 생성합니다.
UrlDiscoveryPlugin 프록시가 가로채는 URL 목록을 만듭니다.

Azure API 센터 플러그 인

Azure API 센터에서 작동하는 플러그 인 목록입니다.

이름 설명
ApiCenterMinimalPermissionsPlugin 앱이 최소 사용 권한을 사용하여 API를 호출하는지 확인합니다. 지정된 Azure API Center 인스턴스의 API 정보를 사용합니다.
ApiCenterOnboardingPlugin 앱에 사용되는 API가 지정된 Azure API 센터 인스턴스에 등록되어 있는지 확인합니다.
ApiCenterProductionVersionPlugin 앱에서 사용되는 API가 지정된 Azure API 센터 인스턴스에 등록된 API의 프로덕션 버전인지 확인합니다.

Microsoft Entra 플러그 인

Microsoft Entra API와 함께 작동하는 플러그 인 목록입니다.

이름 설명
EntraMockResponsePlugin Microsoft Entra에 대한 모의 응답입니다.

Microsoft Graph 플러그 인

Microsoft Graph API에서 작동하는 플러그 인 목록입니다.

이름 설명
GraphBetaSupportGuidancePlugin 프록시가 Microsoft Graph 베타 엔드포인트에 대한 요청을 검색할 때 경고를 표시합니다.
GraphClientRequestIdGuidancePlugin Microsoft Graph API에 대한 요청에 client-request-id 헤더가 포함되어 있지 않은 경우 팁을 표시합니다.
GraphConnectorGuidancePlugin Microsoft Graph 커넥터 작업에 대한 상황별 지침을 보여 줍니다.
GraphMinimalPermissionsPlugin 프록시가 기록한 Microsoft Graph 요청에 필요한 최소 권한 목록을 반환합니다.
GraphMinimalPermissionsGuidancePlugin Microsoft Graph에 전송된 JWT 토큰에 사용된 사용 권한을 프록시가 기록한 요청에 필요한 최소 범위와 비교하고 차이를 표시합니다.
GraphMockResponsePlugin Microsoft Graph API에 대한 모의 응답입니다.
GraphRandomErrorPlugin 임의 오류로 인해 Microsoft Graph에 대한 요청이 실패합니다.
GraphSdkGuidancePlugin 프록시가 Microsoft Graph SDK에서 발급하지 않은 Microsoft Graph에 대한 요청을 가로채는 경우 팁을 표시합니다.
GraphSelectGuidancePlugin 프록시가 쿼리 문자열 매개 변수를 포함하지 $select 않는 Microsoft Graph API에 대한 요청을 가로챌 때 경고를 표시합니다.
ODSPSearchGuidancePlugin 개발자 프록시가 OneDrive 및 SharePoint 검색 API에 대한 요청을 검색할 때 경고를 표시합니다.

기자

다양한 형식의 보고서를 생성하는 기자 목록입니다.

이름 설명
JsonReporter JSON 형식으로 보고서를 생성합니다.
MarkdownReporter Markdown 형식으로 보고서를 생성합니다.
PlainTextReporter 일반 텍스트 형식으로 보고서를 생성합니다.

구성

개발 프록시 구성 옵션에 대한 참조입니다.

이름 설명
devproxyrc 개발 프록시에 대한 구성 파일입니다.
프록시 API 프로그래밍 방식으로 개발 프록시와 상호 작용하기 위한 API입니다.
프록시 설정 프록시 설정에 대한 구성 옵션입니다.