HarGeneratorPlugin

가로채는 요청 및 응답에서 HAR(HTTP 보관) 파일을 생성합니다.

구성 예제

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/rc.schema.json",
  "plugins": [
    {
      "name": "HarGeneratorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "harGeneratorPlugin"
    }
  ],
  "harGeneratorPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/hargeneratorplugin.schema.json",
    "includeSensitiveInformation": false,
    "includeResponse": true
  }
}

구성 속성

재산 Description Default
includeSensitiveInformation 생성된 HAR 파일에 중요한 정보(권한 부여 헤더, 쿠키 등)를 포함할지 여부를 결정합니다. 로 false설정하면 중요한 헤더, 쿠키 및 중요한 쿼리 매개 변수의 값이 값으로 수정됩니다. REDACTED false
includeResponse 생성된 HAR 파일에 응답 본문 콘텐츠를 포함할지 여부를 결정합니다. false

명령줄 옵션

None

비고

HAR(HTTP 보관) 형식은 HTTP 트랜잭션을 로깅하기 위한 JSON 기반 형식입니다. 다양한 도구가 이를 광범위하게 지원하고 이를 사용하여 다음을 수행합니다.

  • 네트워크 트래픽 및 성능 분석
  • API 상호 작용 디버그
  • HTTP 세션 데이터 공유
  • 브라우저 개발자 도구 및 기타 분석 도구로 가져오기

설정includeSensitiveInformation되면 false 플러그 인은 다음 중요한 헤더를 자동으로 수정합니다.

  • authorization
  • cookie
  • from
  • proxy-authenticate
  • proxy-authorization
  • set-cookie
  • www-authenticate
  • x-api-key
  • x-auth-token
  • x-csrf-token
  • x-forwarded-for
  • x-real-ip
  • x-session-token
  • x-xsrf-token

또한 플러그 인은 쿠키 이름을 유지하면서 모든 요청 및 응답 쿠키(request.cookies 및 response.cookies)의 값을 로 REDACTED바꿉니다.

또한 플러그 인은 요청 URL() 및 쿼리 문자열request.queryString()에서 다음과 같은 중요한 쿼리 매개 변수(request.url대/소문자를 구분하지 않는)의 값을 수정합니다. 다른 쿼리 매개 변수는 원래 값을 유지합니다.

  • access_token
  • api_key
  • api-key
  • apikey
  • auth
  • client_secret
  • code
  • id_token
  • key
  • password
  • refresh_token
  • secret
  • sig
  • signature
  • token
  • x-amz-credential
  • x-amz-security-token
  • x-amz-signature
  • x-goog-credential
  • x-goog-signature

예를 들어 요청 URL https://api.contoso.com/users?access_token=abc123&page=2 은 .로 https://api.contoso.com/users?access_token=REDACTED&page=2기록됩니다.

생성된 HAR 파일에는 다음이 포함됩니다.

  • HTTP 요청 세부 정보(메서드, URL, 헤더, 쿼리 매개 변수, 쿠키)
  • HTTP 응답 세부 정보(상태, 헤더, 쿠키)
  • 요청 및 응답 본문 데이터(해당하는 경우)
  • 콘텐츠 형식 및 크기
  • HTTP 버전 정보

플러그 인은 녹음이 중지된 후 현재 디렉터리에 이름이 지정된 devproxy-{timestamp}.har HAR 파일을 만듭니다.

또한, 다음을 참조하세요.

  • 에 마지막으로 업데이트됨