이 섹션에는 개발자 프록시 플러그 인 및 구성 옵션에 대한 기술 참조가 포함되어 있습니다.
보고 및 분석에 사용해야 하는 플러그 인은 무엇인가요?
다음 표를 사용하여 앱의 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입니다. |
| 프록시 설정 | 프록시 설정에 대한 구성 옵션입니다. |
Dev Proxy