사용자 지정 헤더 - AWS Amplify호스팅

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자 지정 헤더

사용자 지정 HTTP 헤더를 사용하면 모든 HTTP 응답에 대해 헤더를 지정할 수 있습니다. 응답 헤더는 디버깅, 보안 및 정보 제공을 목적으로 사용할 수 있습니다. 에서 헤더를 지정할 수 있습니다.AWS Management Console또는 앱 다운로드 및 편집customHttp.yml프로젝트의 루트 디렉터리에 파일을 저장합니다. 자세한 절차는 사용자 지정 헤더 설정 단원을 참조하십시오.

이전에는 앱에서 빌드 사양 (buildspec) 을 편집하여 앱에 대한 사용자 지정 HTTP 헤더가 지정되었습니다.AWS Management Console또는 다운로드 및 업데이트amplify.yml프로젝트의 루트 디렉터리에 파일을 저장합니다. 이 방법으로 지정된 사용자 정의 헤더는 buildspec 및amplify.yml파일. 지침은 사용자 지정 헤더 마이그레이션 단원을 참조하세요.

사용자 지정 헤더 YAML 형식

다음 YAML 형식을 사용하여 사용자 지정 헤더를 지정합니다.

customHeaders: - pattern: '*.json' headers: - key: 'custom-header-name-1' value: 'custom-header-value-1' - key: 'custom-header-name-2' value: 'custom-header-value-2' - pattern: '/path/*' headers: - key: 'custom-header-name-1' value: 'custom-header-value-2'

모노레포의 경우 다음 YAML 형식을 사용합니다.

applications: - appRoot: app1 customHeaders: - pattern: '**/*' headers: - key: 'custom-header-name-1' value: 'custom-header-value-1' - appRoot: app2 customHeaders: - pattern: '/path/*.json' headers: - key: 'custom-header-name-2' value: 'custom-header-value-2'

앱에 사용자 지정 헤더를 추가할 때 다음에 대한 고유한 값을 지정합니다.

패턴

패턴과 일치하는 모든 URL 파일 경로에 사용자 지정 헤더가 적용됩니다.

headers

파일 패턴과 일치하는 헤더를 정의합니다.

key

사용자 지정 헤더의 이름입니다.

value

사용자 지정 헤더의 값입니다.

HTTP 헤더에 대한 자세한 내용은 Mozilla의 목록 단원을 참조하십시오.HTTP 헤더.

사용자 지정 헤더 설정

에 대한 사용자 지정 HTTP 헤더를 지정하는 방법에는 두 가지가 있습니다.AWS Amplify앱. 에서 헤더를 지정할 수 있습니다.AWS Management Console또는 앱의 다운로드 및 편집으로 헤더를 지정할 수 있습니다.customHttp.yml프로젝트의 루트 디렉터리에 파일을 저장합니다.

앱에서 사용자 지정 헤더를 설정하려면AWS Management Console

  1. 에 로그인합니다.AWS Management Console를 열려면Amplify Console.

  2. 사용자 지정 헤더를 설정할 앱을 선택합니다.

  3. 탐색 창에서 [] 를 선택합니다.앱 앱 설정,사용자 지정 헤더.

  4. 에서사용자 지정 헤더 사양섹션, 선택Edit.

  5. 에서Edit창에서 다음을 사용하여 사용자 정의 헤더에 대한 정보를 입력합니다.사용자 지정 헤더 YAML 형식.

    1. pattern에 일치시킬 패턴을 입력합니다.

    2. key에서 사용자 지정 헤더의 이름을 입력합니다.

    3. value에서 사용자 지정 헤더의 값을 입력합니다.

  6. 저장(Save)을 선택합니다.

  7. 앱을 다시 배포하여 새 사용자 지정 헤더를 적용합니다.

    • CI/CD 앱의 경우 배포할 분기로 이동하여이 버전 재배포. Git 저장소에서 새 빌드를 수행할 수도 있습니다.

    • 수동 배포 앱의 경우 Amplify 콘솔에서 앱을 다시 배포합니다.

사용자 정의 HTTP.yml 파일을 사용하여 사용자 정의 헤더를 설정하려면

  1. 에 로그인합니다.AWS Management Console를 열려면Amplify Console.

  2. 사용자 지정 헤더를 설정할 앱을 선택합니다.

  3. 탐색 창에서 [] 를 선택합니다.앱 앱 설정,사용자 지정 헤더.

  4. 에서사용자 지정 헤더 사양섹션, 선택다운로드.

  5. 다운로드한 파일 열기customHttp.yml선택한 코드 편집기에서 파일을 입력하고 다음을 사용하여 사용자 정의 헤더에 대한 정보를 입력합니다.사용자 지정 헤더 YAML 형식.

    1. pattern에 일치시킬 패턴을 입력합니다.

    2. key에서 사용자 지정 헤더의 이름을 입력합니다.

    3. value에서 사용자 지정 헤더의 값을 입력합니다.

  6. 편집한 항목 저장customHttp.yml프로젝트의 루트 디렉터리에 파일입니다. 모노레포로 작업하는 경우customHttp.yml저장소의 루트에 있는 파일.

  7. 앱을 다시 배포하여 새 사용자 지정 헤더를 적용합니다.

    • CI/CD 앱의 경우 Git 저장소에서 새로운 빌드를 포함하는 새 빌드를 수행합니다.customHttp.yml파일.

    • 수동 배포 앱의 경우 Amplify 콘솔에서 앱을 다시 배포하고 새 앱을 포함시킵니다.customHttp.yml업로드한 아티팩트가 포함된 파일입니다.

참고

에 설정된 사용자 지정 헤더customHttp.yml파일을 사용하여 앱의 루트 디렉터리에 배포하면사용자 지정 헤더의 단원AWS Management Console.

사용자 지정 헤더 마이그레이션

이전에는 앱에서 buildspec을 편집하여 앱에 대한 사용자 지정 HTTP 헤더가 지정되었습니다.AWS Management Console또는 다운로드 및 업데이트amplify.yml파일을 만들고 프로젝트의 루트 디렉토리에 저장합니다. buildspec에서 사용자 정의 헤더를 마이그레이션하는 것이 좋습니다.amplify.yml파일.

에서 사용자 지정 헤더를 지정합니다.사용자 지정 헤더의 단원AWS Management Console또는 다운로드 및 편집하여customHttp.yml파일.

Amplify 콘솔에 저장된 사용자 지정 헤더를 마이그레이션하려면

  1. 에 로그인합니다.AWS Management Console를 열려면Amplify Console.

  2. 사용자 지정 헤더 마이그레이션을 수행할 앱을 선택합니다.

  3. 탐색 창에서 [] 를 선택합니다.앱 앱 설정,빌드 설정. 에서앱 빌드 사양섹션에서 앱의 빌드 사양을 검토할 수 있습니다.

  4. 선택다운로드현재 빌드 스펙의 복사본을 저장합니다. 설정을 복구해야 하는 경우 나중에 이 복사본을 참조할 수 있습니다.

  5. 다운로드가 완료되면 를 선택합니다.Edit.

  6. 나중에 9단계에서 사용하므로 파일의 사용자 지정 헤더 정보를 기록해 둡니다. 에서Edit창에서 파일에서 사용자 정의 헤더를 삭제하고Save.

  7. 탐색 창에서 [] 를 선택합니다.앱 앱 설정,사용자 지정 헤더.

  8. 에서사용자 지정 헤더 사양섹션, 선택Edit.

  9. 에서Edit창에서 6단계에서 삭제한 사용자 지정 헤더에 대한 정보를 입력합니다.

  10. 저장(Save)을 선택합니다.

  11. 새 사용자 지정 헤더를 적용할 브랜치를 다시 배포합니다.

amplify.yml에서 사용자 정의 헤더를 사용자 정의 HTTP.yml로 마이그레이션하려면

  1. 로 이동합니다.amplify.yml앱의 루트 디렉터리에 현재 배포된 파일입니다.

  2. Openamplify.yml를 원하는 코드 편집기에서 선택합니다.

  3. 나중에 8단계에서 사용하므로 파일의 사용자 지정 헤더 정보를 기록해 둡니다. 파일에서 사용자 지정 헤더를 삭제합니다. 파일을 저장하고 닫습니다.

  4. 에 로그인합니다.AWS Management Console를 열려면Amplify Console.

  5. 사용자 지정 헤더를 설정할 앱을 선택합니다.

  6. 탐색 창에서 [] 를 선택합니다.앱 앱 설정,사용자 지정 헤더.

  7. 에서사용자 지정 헤더 사양섹션, 선택다운로드.

  8. 다운로드한 파일 열기customHttp.yml선택한 코드 편집기에서 파일을 입력하고 삭제한 사용자 지정 헤더에 대한 정보를 입력합니다.amplify.yml단계 3입니다.

  9. 편집한 항목 저장customHttp.yml프로젝트의 루트 디렉터리에 파일입니다. monorepo로 작업하는 경우 파일을 저장소의 루트에 저장하십시오.

  10. 앱을 다시 배포하여 새 사용자 지정 헤더를 적용합니다.

    • CI/CD 앱의 경우 Git 저장소에서 새로운 빌드를 포함하는 새 빌드를 수행합니다.customHttp.yml파일.

    • 수동 배포 앱의 경우 Amplify 콘솔에서 앱을 다시 배포하고 새 앱을 포함시킵니다.customHttp.yml업로드한 아티팩트가 있는 파일입니다.

참고

에 설정된 사용자 지정 헤더customHttp.yml파일을 사용하여 앱의 루트 디렉터리에 배포하면사용자 지정 헤더의 단원AWS Management Console.

모노레포 사용자 지정 헤더

monorepo에서 앱에 대한 사용자 지정 헤더를 지정하는 경우 다음 설정 요구 사항에 유의하십시오.

  • 모노레포에 대한 특정 YAML 형식이 있습니다. 올바른 구문은 단원을 참조하십시오.사용자 지정 헤더 YAML 형식.

  • 다음을 사용하여 monorepo에서 응용 프로그램에 대한 사용자 정의 헤더를 지정할 수 있습니다.사용자 지정 헤더의 단원AWS Management Console. 새 사용자 지정 헤더를 적용하려면 응용 프로그램을 다시 배포해야 합니다.

  • 콘솔을 사용하는 대신 monorepo에서 앱에 대한 사용자 지정 헤더를 지정할 수 있습니다.customHttp.yml파일. 저장해야 합니다.customHttp.ymlrepo의 루트에 파일을 넣은 다음 응용 프로그램을 다시 배포하여 새 사용자 지정 헤더를 적용합니다. 에 지정된 사용자 정의 헤더customHttp.yml파일을 사용하여 지정된 모든 사용자 지정 헤더를 재정의합니다.사용자 지정 헤더의 단원AWS Management Console.

보안 헤더 예

사용자 지정 보안 헤더는 HTTPS 실행, XSS 공격 예방 및 클릭재킹으로부터 브라우저 보호를 활성화합니다. 다음 YAML 구문을 사용하여 앱에 사용자 지정 보안 헤더를 적용합니다.

customHeaders: - pattern: '**' headers: - key: 'Strict-Transport-Security' value: 'max-age=31536000; includeSubDomains' - key: 'X-Frame-Options' value: 'SAMEORIGIN' - key: 'X-XSS-Protection' value: '1; mode=block' - key: 'X-Content-Type-Options' value: 'nosniff' - key: 'Content-Security-Policy' value: "default-src 'self'"