

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

# AWS SAM CLI 설치
<a name="install-sam-cli"></a>

의 지침에 따라 지원되는 운영 체제에 AWS Serverless Application Model 명령줄 인터페이스(AWS SAM CLI)의 최신 릴리스를 설치합니다[4단계: 설치 AWS CLI](prerequisites.md#prerequisites-install-cli).

야간 빌드를 업그레이드 AWS SAM CLI, 제거 또는 관리하는 방법을 포함하여 현재 설치된 버전의 관리에 대한 자세한 내용은 섹션을 참조하세요[AWS SAM CLI 버전 관리](manage-sam-cli-versions.md).

**AWS SAM CLI을 처음 설치하시나요?**  
진행하기 전에 이전 섹션의 모든 [사전 요구 사항](prerequisites.md)을 완료하십시오. 여기에는 다음이 포함됩니다.  
 AWS 계정에 가입합니다.
에 대한 보안 액세스 설정 AWS.
액세스 키 ID 및 보안 액세스 키 생성
설치 AWS CLI.
 AWS 자격 증명 구성.

**Topics**
+ [

## AWS SAMCLI의 설치
](#install-sam-cli-instructions)
+ [

## 설치 오류 문제 해결
](#sam-cli-troubleshoot-install)
+ [

## 다음 단계
](#install-sam-cli-next-steps)
+ [

# 선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인
](reference-sam-cli-install-verify.md)

## AWS SAMCLI의 설치
<a name="install-sam-cli-instructions"></a>

**참고**  
2023년 9월부터 AWS 는 더 이상 AWS SAM CLI ()에 대한 AWS 관리형 Homebrew 설치 프로그램을 유지 관리하지 않습니다`aws/tap/aws-sam-cli`. Homebrew를 사용하여를 설치하고 관리하는 경우 다음 옵션을 참조하세요 AWS SAM CLI.  
Homebrew을 계속 사용하려면 커뮤니티 관리 설치관리자 프로그램을 사용할 수 있습니다. 자세한 내용은 [AWS SAM로 CLI Homebrew 관리](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew)을 참조하십시오
이 페이지에 설명된 자사 설치 방법 중 하나를 사용하는 것이 좋습니다. 이러한 방법 중 하나를 사용하기 전에 [Homebrew에서 전환 ](manage-sam-cli-versions.md#manage-sam-cli-versions-switch)을 참조하세요.
자세한 내용은 [릴리스 버전: 1.121.0](https://github.com/aws/aws-sam-cli/releases)을 참조하세요.

 를 설치하려면 운영 체제의 지침을 AWS SAM CLI따릅니다.

### Linux
<a name="install-sam-cli-instructions-linux"></a>

------
#### [ x86\$164 - command line installer ]

1. 선택한 디렉터리에 [AWS SAM CLI .zip file](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip)을 복사합니다.

1. **(선택 사항)** 설치 전에 설치관리자 프로그램의 무결성을 확인할 수 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1. 선택한 디렉터리에 설치 파일의 압축을 풉니다. 다음은 `sam-installation` 하위 디렉토리의 사용을 보여주는 예입니다.
**참고**  
운영 체제에 기본 제공 **unzip** 명령이 없는 경우 이와 동등한 명령을 사용하세요.

   ```
   $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
   ```

1.  AWS SAMCLI를 실행하여 실행 `install` 파일을 설치합니다. 이 실행 파일은 이전 단계에서 사용된 디렉터리에 위치합니다. 다음은 `sam-installation` 하위 디렉토리의 사용을 보여주는 예입니다.

   ```
   $ sudo ./sam-installation/install
   ```

1. 설치를 확인합니다.

   ```
   $ sam --version
   ```

   설치에 성공했는지 확인하려면 출력에서 다음 괄호 안의 텍스트가 사용 가능한 최신 버전으로 대체되었는지 확인합니다.

   ```
    SAM CLI, <latest version>
   ```

------
#### [ arm64 - command line installer ]

1. 선택한 디렉터리에 [AWS SAM CLI .zip file](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip)을 복사합니다.

1. **(선택 사항)** 설치 전에 설치관리자 프로그램의 무결성을 확인할 수 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1. 선택한 디렉터리에 설치 파일의 압축을 풉니다. 다음은 `sam-installation` 하위 디렉토리의 사용을 보여주는 예입니다.
**참고**  
운영 체제에 기본 제공 **unzip** 명령이 없는 경우 이와 동등한 명령을 사용하세요.

   ```
   $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
   ```

1.  AWS SAMCLI를 실행하여 실행 `install` 파일을 설치합니다. 이 실행 파일은 이전 단계에서 사용된 디렉터리에 위치합니다. 다음은 `sam-installation` 하위 디렉토리의 사용을 보여주는 예입니다.

   ```
   $ sudo ./sam-installation/install
   ```

1. 설치를 확인합니다.

   ```
   $ sam --version
   ```

   설치에 성공했는지 확인하려면 다음과 같은 출력에서 괄호 안의 텍스트가 최신 SAM CLI 버전으로 대체되었는지 확인합니다.

   ```
    SAM CLI, <latest version>
   ```

------

### macOS
<a name="install-sam-cli-instructions-macos"></a>

#### 설치 단계
<a name="install-sam-cli-instructions-macos-steps"></a>

패키지 설치 관리자를 사용하여를 설치합니다 AWS SAM CLI. 또한 패키지 설치관리자 프로그램에서는 **GUI**와 **명령줄**의 두 가지 설치 방법 중에서 선택할 수 있습니다. **모든 사용자**를 위해 설치하거나 **현재 사용자**만을 위해 설치할 수 있습니다. 모든 사용자를 대상으로 설치하려면 수퍼유저 인증이 필요합니다.

**참고**  
AWS SAM CLI는 MacOS 13.x 이전 MacOS 버전을 지원하지 않습니다. 지원되는 MacOS 버전으로 업그레이드하거나를 사용하여 AWS SAM CLI를 설치합니다Homebrew.

------
#### [ GUI - All users ]

**패키지 설치관리자 프로그램을 다운로드하여 AWS SAM CLI를 설치하려면**
**참고**  
 이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 [AWS SAM CLI 제거](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall) 섹션을 참조하세요.

1.  선택한 디렉터리에 macOS `pkg`를 다운로드합니다.
   +  **Intel 프로세서를 실행하는 Mac의 경우 x86\$164 선택** – [ aws-sam-cli-macos-x86\$164.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) 
   +  **Apple Silicon을 실행하는 Mac의 경우 arm64 선택** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) 
**참고**  
설치 전에 설치관리자 프로그램의 무결성을 확인하는 옵션이 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1.  다운로드한 파일을 실행하고 화면에 나타난 지침에 따라 **소개**, **Read Me** 및 **라이선스** 단계를 계속 진행합니다.

1.  **대상 선택**에서 **이 컴퓨터의 모든 사용자를 위한 설치**를 선택합니다.

1.  **설치 유형**에서 AWS SAMCLI을 설치할 위치를 선택하고 **설치**를 누릅니다. 권장되는 기본 위치는 `/usr/local/aws-sam-cli`입니다.
**참고**  
 **sam** 명령으로 AWS SAMCLI를 간접 호출하기 위해 설치관리자 프로그램은 `/usr/local/bin/sam`와 `/usr/local/aws-sam-cli/sam` 또는 귀하가 선택한 설치 폴더 중 하나 간에 심링크를 자동으로 생성합니다.

1.  AWS SAMCLI가 설치하면 **설치 성공** 메시지가 표시됩니다. **닫기**를 누릅니다.

**성공적으로 설치되었는지 확인하려면**
+  다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

  ```
  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>
  ```

------
#### [ GUI - Current user ]

**AWS SAM CLI를 다운로드하여 설치하려면**
**참고**  
 이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 [AWS SAM CLI 제거](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall) 섹션을 참조하세요.

1.  선택한 디렉터리에 macOS `pkg`를 다운로드합니다.
   +  **Intel 프로세서를 실행하는 Mac의 경우 x86\$164 선택** – [ aws-sam-cli-macos-x86\$164.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) 
   +  **Apple Silicon을 실행하는 Mac의 경우 arm64 선택** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) 
**참고**  
설치 전에 설치관리자 프로그램의 무결성을 확인하는 옵션이 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1.  다운로드한 파일을 실행하고 화면에 나타난 지침에 따라 **소개**, **Read Me** 및 **라이선스** 단계를 계속 진행합니다.

1.  **대상 선택**에서 **나만을 위한 설치**를 선택합니다. 이 옵션이 표시되지 않으면 다음 단계를 진행합니다.

1.  **설치 유형**에서 다음을 수행합니다.

   1.  AWS SAMCLI를 설치할 위치를 선택합니다. 기본 위치는 `/usr/local/aws-sam-cli`입니다. 쓰기 권한이 있는 위치를 선택합니다. 설치 위치를 변경하려면 **로컬**을 선택하고 위치를 선택합니다. 완료되면 **계속**을 누르십시오.

   1.  이전 단계에서 **나를 위한 설치**를 선택하는 옵션이 표시되지 않은 경우 설치 **위치 변경** > **내게만 설치를 선택하고** **계속**을 누르십시오.

   1.  **설치를** 누릅니다.

1.  AWS SAMCLI가 설치하면 **설치 성공** 메시지가 표시됩니다. **닫기**를 누릅니다.

**심링크 생성**
+  **sam** 명령으로 AWS SAMCLI를 간접 호출하려면 AWS SAMCLI프로그램과 귀하의 `$PATH` 사이에 심링크를 수동으로 만들어야 합니다. 다음 명령을 수정하고 실행하여 심링크를 생성합니다.

  ```
  $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
  ```
  +  *sudo* – 사용자에게 `$PATH`에 대한 쓰기 권한이 있는 경우에는 **sudo**은 필요하지 않습니다. 그렇지 않으면 **sudo**이 필요합니다.
  +  *path-to* - AWS SAMCLI 프로그램을 설치한 위치의 경로. 예를 들어 `/Users/myUser/Desktop`입니다.
  +  *path-to-symlink-directory* – 귀하의 `$PATH` 환경 변수입니다. 기본 위치는 `/usr/local/bin`입니다.

**성공적으로 설치되었는지 확인하려면**
+  다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

  ```
  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>
  ```

------
#### [ Command line - All users ]

**AWS SAM CLI를 다운로드하여 설치하려면**
**참고**  
 이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 [AWS SAM CLI 제거](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall) 섹션을 참조하세요.

1.  선택한 디렉터리에 macOS `pkg`를 다운로드합니다.
   +  **Intel 프로세서를 실행하는 Mac의 경우 x86\$164 선택** – [ aws-sam-cli-macos-x86\$164.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) 
   +  **Apple Silicon을 실행하는 Mac의 경우 arm64 선택** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) 
**참고**  
설치 전에 설치관리자 프로그램의 무결성을 확인하는 옵션이 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1.  설치 스크립트를 변경하고 실행합니다.

   ```
   $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target /
   installer: Package name is AWS SAM CLI
   installer: Upgrading at base path /
   installer: The upgrade was successful.
   ```
**참고**  
 `/usr/local/bin/sam` `/usr/local/aws-sam-cli/sam` **sam**명령으로 AWS SAMCLI를 간접 호출하려면, 설치관리자 프로그램은 와 간에 심링크를 자동으로 생성합니다.

**성공적으로 설치되었는지 확인하려면**
+  다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

  ```
  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>
  ```

------
#### [ Command line - Current user ]

**AWS SAM CLI를 다운로드하여 설치하려면**
**참고**  
 이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 [AWS SAM CLI 제거](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall) 섹션을 참조하세요.

1.  선택한 디렉터리에 macOS `pkg`를 다운로드합니다.
   +  **Intel 프로세서를 실행하는 Mac의 경우 x86\$164 선택** – [ aws-sam-cli-macos-x86\$164.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) 
   +  **Apple Silicon을 실행하는 Mac의 경우 arm64 선택** – [ aws-sam-cli-macos-arm64.pkg](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg) 
**참고**  
설치 전에 설치관리자 프로그램의 무결성을 확인하는 옵션이 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1.  귀하에게 쓰기 권한이 있는 설치 디렉터리를 결정하십시오. 그런 다음 템플릿을 사용하여 `xml` 파일을 만들고 설치 디렉토리를 반영하도록 수정하십시오. 디렉토리는 이미 존재해야 합니다.

    예를 들어, *path-to-my-directory*를 `/Users/myUser/Desktop`로 바꾸면, `aws-sam-cli` 프로그램 폴더가 거기에 설치됩니다.

   ```
   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
     <array>
       <dict>
         <key>choiceAttribute</key>
         <string>customLocation</string>
         <key>attributeSetting</key>
         <string>path-to-my-directory</string>
         <key>choiceIdentifier</key>
         <string>default</string>
       </dict>
     </array>
   </plist>
   ```

1.  `xml`파일을 저장하고 다음을 실행하여 파일이 유효한지 확인합니다.

   ```
   $ installer -pkg path-to-pkg-installer \
   -target CurrentUserHomeDirectory \
   -showChoicesAfterApplyingChangesXML path-to-your-xml-file
   ```

    출력 결과는 AWS SAMCLI 프로그램에 적용할 기본 설정이 표시되어야 합니다.

1.  다음을 실행하여를 설치합니다 AWS SAM CLI.

   ```
   $ installer -pkg path-to-pkg-installer \
   -target CurrentUserHomeDirectory \
   -applyChoiceChangesXML path-to-your-xml-file
   
   # Example output
   installer: Package name is AWS SAM CLI
   installer: choices changes file 'path-to-your-xml-file' applied
   installer: Upgrading at base path base-path-of-xml-file
   installer: The upgrade was successful.
   ```

**심링크 생성**
+  **sam** 명령으로 AWS SAMCLI를 간접 호출하려면 AWS SAMCLI프로그램과 귀하의 `$PATH` 사이에 심링크를 수동으로 만들어야 합니다. 다음 명령을 수정하고 실행하여 심링크를 생성합니다.

  ```
  $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
  ```
  +  *sudo* – 사용자에게 `$PATH`에 대한 쓰기 권한이 있는 경우에는 **sudo**은 필요하지 않습니다. 그렇지 않으면 **sudo**이 필요합니다.
  +  *path-to* - AWS SAMCLI 프로그램을 설치한 위치의 경로. 예를 들어 `/Users/myUser/Desktop`입니다.
  +  *path-to-symlink-directory* – 귀하의 `$PATH` 환경 변수입니다. 기본 위치는 `/usr/local/bin`입니다.

**성공적으로 설치되었는지 확인하려면**
+  다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

  ```
  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>
  ```

------

### Windows
<a name="install-sam-cli-instructions-windows"></a>

Windows 설치관리자 프로그램 (MSI) 파일은 Windows 운영 체제의 패키지 설치 프로그램 파일입니다.

MSI 파일을 사용하여 AWS SAMCLI를 설치하려면 다음 단계를 따르십시오.

1.  AWS SAMCLI [64비트](https://github.com/aws/aws-sam-cli/releases/latest/download/AWS_SAM_CLI_64_PY3.msi)를 다운로드하십시오.

1. **(선택 사항)** 설치 전에 설치관리자 프로그램의 무결성을 확인할 수 있습니다. 지침은 [선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인](reference-sam-cli-install-verify.md) 섹션을 참조하세요.

1. 설치를 확인합니다.

   설치를 완료한 후 새 명령 프롬프트 또는 PowerShell 프롬프트를 열어 확인합니다. `sam`을 명령줄에서 간접 호출할 수 있어야 합니다.

   ```
   sam --version
   ```

   를 성공적으로 설치하면 다음과 같은 출력이 표시됩니다 AWS SAM CLI.

   ```
   SAM CLI, <latest version>
   ```

1. 긴 경로를 활성화합니다(Windows 10 이상만 해당).
**중요**  
는 AWS SAM CLI Windows 최대 경로 제한을 초과하는 파일 경로와 상호 작용할 수 있습니다. 이로 인해 `sam init`를 실행할 때 Windows 10 **MAX\$1PATH** 제한을 초과하여 오류가 발생할 수 있습니다. 이 문제를 해결하기 위해서는 새로운 긴 경로 동작을 구성해야 합니다.

   긴 경로를 활성화하려면 *Microsoft Windows 앱 개발 설명서*의 [Windows 10, 버전 1607 이상에서 긴 경로 사용 활성화](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later)를 참조하세요.

1. Git을 설치합니다.

   `sam init` 명령을 사용하여 샘플 애플리케이션을 다운로드하려면 Git도 설치해야 합니다. 자세한 내용은 [Git 설치](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)를 참조하세요

## 설치 오류 문제 해결
<a name="sam-cli-troubleshoot-install"></a>

### Linux
<a name="sam-cli-troubleshoot-install-linux"></a>

#### 도커 오류: “도커 데몬에 연결할 수 없습니다. docker 데몬이 이 호스트에서 실행되고 있습니까?”
<a name="serverless-sam-cli-install-linux-troubleshooting-docker-deamon"></a>

경우에 따라서는 `ec2-user`가 Docker 대몬에 액세스할 수 있는 권한을 제공하기 위해 인스턴스를 재부팅해야 할 수도 있습니다. 이 오류가 발생하면 인스턴스를 재부팅합니다.

#### 셸 오류: ‘명령을 찾을 수 없음’
<a name="serverless-sam-cli-install-linux-troubleshooting-sam-cli-not-found"></a>

이 오류가 발생하면 셸이 경로에서 AWS SAMCLI 실행 파일을 찾을 수 없는 것입니다. AWS SAMCLI 실행 파일을 설치한 디렉터리의 위치를 확인한 다음 디렉터리가 경로에 있는지 확인합니다.

#### AWS SAM CLI error: “/lib64/libc.so.6: version ‘GLIBC\$12.14’ not found (required by /usr/local/aws-sam-cli/dist/libz.so.1)”
<a name="serverless-sam-cli-install-linux-troubleshooting-sam-cli-missing-lib"></a>

이 오류가 표시되면 지원되지 않는 Linux 버전을 사용하고 있고 기본 제공 glibc 버전이 오래된 것입니다. 다음 중 하나를 사용하세요.
+ Linux 호스트를 CentOS, Fedora, Ubuntu 또는 Amazon Linux 2 최신 배포판의 64비트 버전으로 업그레이드합니다.
+ [AWS SAM CLI 설치](#install-sam-cli)에 대해서는 이 지침을 따릅니다.

### macOS
<a name="sam-cli-troubleshoot-install-macos"></a>

#### 설치 실패
<a name="sam-cli-troubleshoot-install-macos-install-failed"></a>

![\[설치 실패 메시지를 보여주는 AWS SAMCLI 설치 프로그램 이미지\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/images/sam-cli-troubleshoot-install-macos-install-failed.jpg)


 사용자용 AWS SAMCLI를 설치하고 쓰기 권한이 없는 설치 디렉터리를 선택한 경우 이 오류가 발생할 수 있습니다. 다음 중 하나를 사용하세요.

1.  쓰기 권한이 있는 다른 설치 디렉터리를 선택합니다.

1.  설치 프로그램을 삭제합니다. 그런 다음 다시 다운로드하고 실행합니다.

## 다음 단계
<a name="install-sam-cli-next-steps"></a>

 AWS SAMCLI에 대한 자세한 내용과 자체 서버리스 애플리케이션 구축을 시작하려면 다음을 참조하세요.
+ [자습서:를 사용하여 Hello World 애플리케이션 배포 AWS SAM](serverless-getting-started-hello-world.md)— 기본 서버리스 애플리케이션을 다운로드, 빌드 및 배포하기 위한 단계별 지침
+ [전체 AWS SAM 워크숍 ](https://catalog.workshops.aws/complete-aws-sam/en-US)-가 AWS SAM 제공하는 많은 주요 기능을 가르치도록 설계된 워크숍입니다.
+ [AWS SAM 예제 애플리케이션 및 패턴](https://serverlessland.com/patterns?framework=AWS+SAM) - 추가로 실험할 수 있는 커뮤니티 작성자의 샘플 애플리케이션 및 패턴입니다.

# 선택 사항: AWS SAM CLI 설치관리자 프로그램의 무결성 확인
<a name="reference-sam-cli-install-verify"></a>

패키지 설치 관리자를 사용하여 AWS Serverless Application Model 명령줄 인터페이스(AWS SAM CLI)를 설치할 때 설치 전에 무결성을 확인할 수 있습니다. (이 단계는 선택 사항이며, 권장 사항은 아닙니다.)

사용할 수 있는 두 가지 확인 옵션은 다음과 같습니다.
+ 패키지 설치관리자 프로그램 서명을 확인합니다.
+ 패키지 설치관리자 프로그램 해시 값을 확인합니다.

플랫폼에서 사용할 수 있는 경우 서명 파일 옵션을 확인하는 것이 좋습니다. 이 옵션은 키 값이 여기에 게시되고 GitHub 리포지토리와 별도로 관리되므로 추가 보안 레이어를 제공합니다.

**Topics**
+ [

## 설치관리자 서명 파일을 확인합니다.
](#reference-sam-cli-install-verify-signature)
+ [

## 해시 값을 확인합니다.
](#reference-sam-cli-install-verify-hash)

## 설치관리자 서명 파일을 확인합니다.
<a name="reference-sam-cli-install-verify-signature"></a>

### Linux
<a name="reference-sam-cli-install-verify-signature-linux"></a>

#### arm64 - 명령줄 설치관리자
<a name="reference-sam-cli-install-verify-signature-linux-arm64"></a>

AWS SAM 는 [GnuPG](https://www.gnupg.org/)를 사용하여 .zip 설치 프로그램에 서명합니다 AWS SAM CLI. 확인은 다음 단계들을 수행합니다.

1. 기본 공개 키를 사용하여 서명자 공개 키를 확인합니다.

1. 서명자 공개 키를 사용하여 AWS SAMCLI 패키지 설치관리자 프로그램을 확인합니다.

**서명자 공개 키의 무결성 확인**

1. 기본 공개 키를 복사하여 귀하의 로컬 기기에 `.txt` 파일로 저장합니다. 예를 들어 *`primary-public-key.txt`*입니다.

   ```
   -----BEGIN PGP PUBLIC KEY BLOCK-----
   Version: GnuPG v2.0.22 (GNU/Linux)
   
   mQINBGRuSzMBEADsqiwOy78w7F4+sshaMFRIwRGNRm94p5Qey2KMZBxekFtoryVD
   D9jEOnvupx4tvhfBHz5EcUHCEOdl4MTqdBy6vVAshozgxVb9RE8JpECn5lw7XC69
   4Y7Gy1TKKQMEWtDXElkGxIFdUWvWjSnPlzfnoXwQYGeE93CUS3h5dImP22Yk1Ct6
   eGGhlcbg1X4L8EpFMj7GvcsU8f7ziVI/PyC1Xwy39Q8/I67ip5eU5ddxO/xHqrbL
   YC7+8pJPbRMej2twT2LrcpWWYAbprMtRoa6WfE0/thoo3xhHpIMHdPfAA86ZNGIN
   kRLjGUg7jnPTRW4Oin3pCc8nT4Tfc1QERkHm641gTC/jUvpmQsM6h/FUVP2i5iE/
   JHpJcMuL2Mg6zDo3x+3gTCf+Wqz3rZzxB+wQT3yryZs6efcQy7nROiRxYBxCSXX0
   2cNYzsYLb/bYaW8yqWIHD5IqKhw269gp2E5Khs60zgS3CorMb5/xHgXjUCVgcu8a
   a8ncdf9fjl3WS5p0ohetPbO2ZjWv+MaqrZOmUIgKbA4RpWZ/fU97P5BW9ylwmIDB
   sWy0cMxg8MlvSdLytPieogaM0qMg3u5qXRGBr6Wmevkty0qgnmpGGc5zPiUbtOE8
   CnFFqyxBpj5IOnG0KZGVihvn+iRxrv6GO7WWO92+Dc6m94U0EEiBR7QiOwARAQAB
   tDRBV1MgU0FNIENMSSBQcmltYXJ5IDxhd3Mtc2FtLWNsaS1wcmltYXJ5QGFtYXpv
   bi5jb20+iQI/BBMBCQApBQJkbkszAhsvBQkHhM4ABwsJCAcDAgEGFQgCCQoLBBYC
   AwECHgECF4AACgkQQv1fenOtiFqTuhAAzi5+ju5UVOWqHKevOJSO08T4QB8HcqAE
   SVO3mY6/j29knkcL8ubZP/DbpV7QpHPI2PB5qSXsiDTP3IYPbeY78zHSDjljaIK3
   njJLMScFeGPyfPpwMsuY4nzrRIgAtXShPA8N/k4ZJcafnpNqKj7QnPxiC1KaIQWm
   pOtvb8msUF3/s0UTa5Ys/lNRhVC0eGg32ogXGdojZA2kHZWdm9udLo4CDrDcrQT7
   NtDcJASapXSQL63XfAS3snEc4e1941YxcjfYZ33rel8K9juyDZfi1slWR/L3AviI
   QFIaqSHzyOtP1oinUkoVwL8ThevKD3Ag9CZflZLzNCV7yqlF8RlhEZ4zcE/3s9El
   WzCFsozb5HfE1AZonmrDh3SyOEIBMcS6vG5dWnvJrAuSYv2rX38++K5Pr/MIAfOX
   DOI1rtA+XDsHNv9lSwSy0lt+iClawZANO9IXCiN1rOYcVQlwzDFwCNWDgkwdOqS0
   gOA2f8NF9lE5nBbeEuYquoOl1Vy8+ICbgOFs9LoWZlnVh7/RyY6ssowiU9vGUnHI
   L8f9jqRspIz/Fm3JD86ntZxLVGkeZUz62FqErdohYfkFIVcv7GONTEyrz5HLlnpv
   FJ0MR0HjrMrZrnOVZnwBKhpbLocTsH+3t5It4ReYEX0f1DIOL/KRwPvjMvBVkXY5
   hblRVDQoOWc=
   =d9oG
   -----END PGP PUBLIC KEY BLOCK-----
   ```

1. 주요 퍼블릭 키를 귀하의 키링으로 가져옵니다.

   ```
   $ gpg --import primary-public-key.txt
   							
   gpg: directory `/home/.../.gnupg' created
   gpg: new configuration file `/home/.../.gnupg/gpg.conf' created
   gpg: WARNING: options in `/home/.../.gnupg/gpg.conf' are not yet active during this run
   gpg: keyring `/home/.../.gnupg/secring.gpg' created
   gpg: keyring `/home/.../.gnupg/pubring.gpg' created
   gpg: /home/.../.gnupg/trustdb.gpg: trustdb created
   gpg: key 73AD885A: public key "AWS SAM CLI Primary <aws-sam-cli-primary@amazon.com>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1  (RSA: 1)
   ```

1. 서명자 공개 키를 복사하여 로컬 시스템에 `.txt` 파일로 저장합니다. 예를 들어 *`signer-public-key.txt`*입니다.

   ```
   -----BEGIN PGP PUBLIC KEY BLOCK-----
   Version: GnuPG v2.0.22 (GNU/Linux)
   
   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
   LtZnq+n4SfeNbZjD2FQWZR4CrA==
   =lHfs
   -----END PGP PUBLIC KEY BLOCK-----
   ```

1. 서명자 퍼블릭 키를 귀하의 키링으로 가져옵니다.

   ```
   $ gpg --import signer-public-key.txt
   							
   gpg: key 4094ABB1BEDFDAB4: public key "AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1  (RSA: 1)
   gpg: no ultimately trusted keys found
   ```

   출력 결과의 키 값을 기록해 두십시오. 예를 들어 *`4094ABB1BEDFDAB4`*입니다.

1. 키 값을 사용하여 서명자 공개 키 핑거프린트를 획득하고 확인합니다.

   ```
   $ gpg --fingerprint 4094ABB1BEDFDAB4
   							
   pub   rsa4096 2025-05-19 [SCEA] [expires: 2027-05-19]
         EF46 3E86 CA31 933B B688  CC1A 4094 ABB1 BEDF DAB4
   uid           [ unknown] AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>
   ```

   지문은 다음과 일치해야 합니다.

   ```
   EF46 3E86 CA31 933B B688  CC1A 4094 ABB1 BEDF DAB4
   ```

   지문 스트링이 일치하지 않으면 AWS SAM CLI 설치관리자를 사용하지 마십시오. *aws-sam-cli GitHub 리포지토리*에서 [문제를 생성](https://github.com/aws/aws-sam-cli/issues/new?assignees=&labels=stage%2Fneeds-triage&projects=&template=Bug_report.md&title=Bug%3A+TITLE)하여 AWS SAM 팀에 에스컬레이션합니다.

1. 서명자 공개 키의 서명을 확인하십시오.

   ```
   $ gpg --check-sigs 4094ABB1BEDFDAB4
   						  
   pub   rsa4096 2025-05-19 [SCEA] [expires: 2027-05-19]
         EF463E86CA31933BB688CC1A4094ABB1BEDFDAB4
   uid           [ unknown] AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>
   sig!3        4094ABB1BEDFDAB4 2025-05-19  [self-signature]
   sig!         42FD5F7A73AD885A 2025-05-19 AWS SAM CLI Primary <aws-sam-cli-primary@amazon.com>
   ```

   `1 signature not checked due to a missing key`이 확인되면 이전 단계를 반복하여 기본 및 서명자 공개 키를 키링으로 가져오세요.

   기본 공개 키와 서명자 공개 키 모두의 키 값이 표시되어 있어야 합니다.

서명자 공개 키의 무결성을 확인했으므로 이제 서명자 공개 키를 사용하여 AWS SAMCLI패키지 설치관리자 프로그램을 확인할 수 있습니다.

**AWS SAMCLI 패키지 설치관리자 프로그램의 무결성을 확인하려면**

1. ** AWS SAMCLI패키지 서명 파일 가져오기** - 다음 명령을 사용하여 AWS SAMCLI 패키지 설치관리자 프로그램의 서명 파일을 다운로드합니다.

   ```
   $ wget https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip.sig
   ```

1. **서명 파일을 확인** - 다운로드된 `.sig` 및 `.zip` 파일 모두를 `gpg` 명령의 파라미터로 전달합니다. 다음은 예제입니다.

   ```
   $ gpg --verify aws-sam-cli-linux-arm64.zip.sig aws-sam-cli-linux-arm64.zip
   ```

   출력은 다음과 비슷하게 보여야 합니다.

   ```
   gpg: Signature made Mon 19 May 2025 01:21:57 AM UTC using RSA key ID 4094ABB1BEDFDAB4
   gpg: Good signature from "AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>"
   gpg: WARNING: This key is not certified with a trusted signature!
   gpg:          There is no indication that the signature belongs to the owner.
   Primary key fingerprint: EF46 3E86 CA31 933B B688  CC1A 4094 ABB1 BEDF DAB4
   ```
   + `WARNING: This key is not certified with a trusted signature!` 메시지는 무시해도 됩니다. 이것은 귀하의 개인 PGP 키(보유하신 경우)와 AWS SAM CLI PGP 키 사이에 신뢰 체인이 없기 때문에 발생한 것입니다. 자세한 내용은 [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust)를 참조하세요.
   + 출력 결과에 `BAD signature` 문구가 포함된 경우 귀하가 절차를 올바르게 수행했는지 확인합니다. 이 응답을 계속 받는 경우 *aws-sam-cli GitHub 리포지토리*에서 [문제를 생성](https://github.com/aws/aws-sam-cli/issues/new?assignees=&labels=stage%2Fneeds-triage&projects=&template=Bug_report.md&title=Bug%3A+TITLE)하여 AWS SAM 팀에 에스컬레이션하고 다운로드한 파일을 사용하지 마세요.

   `Good signature from "AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>"` 메시지는 서명이 확인되었으며 귀하는 설치를 진행할 수 있다는 의미입니다.

#### x86\$164 - 명령줄 설치관리자
<a name="reference-sam-cli-install-verify-signature-linux-x8664"></a>

AWS SAM 는 [GnuPG](https://www.gnupg.org/)를 사용하여 .zip 설치 프로그램에 서명합니다 AWS SAM CLI. 확인은 다음 단계들을 수행합니다.

1. 기본 공개 키를 사용하여 서명자 공개 키를 확인합니다.

1. 서명자 공개 키를 사용하여 AWS SAMCLI 패키지 설치관리자 프로그램을 확인합니다.

**서명자 공개 키의 무결성 확인**

1. 기본 공개 키를 복사하여 귀하의 로컬 기기에 `.txt` 파일로 저장합니다. 예를 들어 *`primary-public-key.txt`*입니다.

   ```
   -----BEGIN PGP PUBLIC KEY BLOCK-----
   Version: GnuPG v2.0.22 (GNU/Linux)
   
   mQINBGRuSzMBEADsqiwOy78w7F4+sshaMFRIwRGNRm94p5Qey2KMZBxekFtoryVD
   D9jEOnvupx4tvhfBHz5EcUHCEOdl4MTqdBy6vVAshozgxVb9RE8JpECn5lw7XC69
   4Y7Gy1TKKQMEWtDXElkGxIFdUWvWjSnPlzfnoXwQYGeE93CUS3h5dImP22Yk1Ct6
   eGGhlcbg1X4L8EpFMj7GvcsU8f7ziVI/PyC1Xwy39Q8/I67ip5eU5ddxO/xHqrbL
   YC7+8pJPbRMej2twT2LrcpWWYAbprMtRoa6WfE0/thoo3xhHpIMHdPfAA86ZNGIN
   kRLjGUg7jnPTRW4Oin3pCc8nT4Tfc1QERkHm641gTC/jUvpmQsM6h/FUVP2i5iE/
   JHpJcMuL2Mg6zDo3x+3gTCf+Wqz3rZzxB+wQT3yryZs6efcQy7nROiRxYBxCSXX0
   2cNYzsYLb/bYaW8yqWIHD5IqKhw269gp2E5Khs60zgS3CorMb5/xHgXjUCVgcu8a
   a8ncdf9fjl3WS5p0ohetPbO2ZjWv+MaqrZOmUIgKbA4RpWZ/fU97P5BW9ylwmIDB
   sWy0cMxg8MlvSdLytPieogaM0qMg3u5qXRGBr6Wmevkty0qgnmpGGc5zPiUbtOE8
   CnFFqyxBpj5IOnG0KZGVihvn+iRxrv6GO7WWO92+Dc6m94U0EEiBR7QiOwARAQAB
   tDRBV1MgU0FNIENMSSBQcmltYXJ5IDxhd3Mtc2FtLWNsaS1wcmltYXJ5QGFtYXpv
   bi5jb20+iQI/BBMBCQApBQJkbkszAhsvBQkHhM4ABwsJCAcDAgEGFQgCCQoLBBYC
   AwECHgECF4AACgkQQv1fenOtiFqTuhAAzi5+ju5UVOWqHKevOJSO08T4QB8HcqAE
   SVO3mY6/j29knkcL8ubZP/DbpV7QpHPI2PB5qSXsiDTP3IYPbeY78zHSDjljaIK3
   njJLMScFeGPyfPpwMsuY4nzrRIgAtXShPA8N/k4ZJcafnpNqKj7QnPxiC1KaIQWm
   pOtvb8msUF3/s0UTa5Ys/lNRhVC0eGg32ogXGdojZA2kHZWdm9udLo4CDrDcrQT7
   NtDcJASapXSQL63XfAS3snEc4e1941YxcjfYZ33rel8K9juyDZfi1slWR/L3AviI
   QFIaqSHzyOtP1oinUkoVwL8ThevKD3Ag9CZflZLzNCV7yqlF8RlhEZ4zcE/3s9El
   WzCFsozb5HfE1AZonmrDh3SyOEIBMcS6vG5dWnvJrAuSYv2rX38++K5Pr/MIAfOX
   DOI1rtA+XDsHNv9lSwSy0lt+iClawZANO9IXCiN1rOYcVQlwzDFwCNWDgkwdOqS0
   gOA2f8NF9lE5nBbeEuYquoOl1Vy8+ICbgOFs9LoWZlnVh7/RyY6ssowiU9vGUnHI
   L8f9jqRspIz/Fm3JD86ntZxLVGkeZUz62FqErdohYfkFIVcv7GONTEyrz5HLlnpv
   FJ0MR0HjrMrZrnOVZnwBKhpbLocTsH+3t5It4ReYEX0f1DIOL/KRwPvjMvBVkXY5
   hblRVDQoOWc=
   =d9oG
   -----END PGP PUBLIC KEY BLOCK-----
   ```

1. 주요 퍼블릭 키를 귀하의 키링으로 가져옵니다.

   ```
   $ gpg --import primary-public-key.txt
   							
   gpg: directory `/home/.../.gnupg' created
   gpg: new configuration file `/home/.../.gnupg/gpg.conf' created
   gpg: WARNING: options in `/home/.../.gnupg/gpg.conf' are not yet active during this run
   gpg: keyring `/home/.../.gnupg/secring.gpg' created
   gpg: keyring `/home/.../.gnupg/pubring.gpg' created
   gpg: /home/.../.gnupg/trustdb.gpg: trustdb created
   gpg: key 73AD885A: public key "AWS SAM CLI Primary <aws-sam-cli-primary@amazon.com>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1  (RSA: 1)
   ```

1. 서명자 공개 키를 복사하여 로컬 시스템에 `.txt` 파일로 저장합니다. 예를 들어 *`signer-public-key.txt`*입니다.

   ```
   -----BEGIN PGP PUBLIC KEY BLOCK-----
   Version: GnuPG v2.0.22 (GNU/Linux)
   
   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
   LtZnq+n4SfeNbZjD2FQWZR4CrA==
   =lHfs
   -----END PGP PUBLIC KEY BLOCK-----
   ```

1. 서명자 퍼블릭 키를 귀하의 키링으로 가져옵니다.

   ```
   $ gpg --import signer-public-key.txt
   							
   gpg: key 4094ABB1BEDFDAB4: public key "AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>" imported
   gpg: Total number processed: 1
   gpg:               imported: 1  (RSA: 1)
   gpg: no ultimately trusted keys found
   ```

   출력 결과의 키 값을 기록해 두십시오. 예를 들어 *`4094ABB1BEDFDAB4`*입니다.

1. 키 값을 사용하여 서명자 공개 키 핑거프린트를 획득하고 확인합니다.

   ```
   $ gpg --fingerprint 4094ABB1BEDFDAB4
   						  
   pub   rsa4096 2025-05-19 [SCEA] [expires: 2027-05-19]
         EF46 3E86 CA31 933B B688  CC1A 4094 ABB1 BEDF DAB4
   uid           [ unknown] AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>
   ```

   지문은 다음과 일치해야 합니다.

   ```
   EF46 3E86 CA31 933B B688  CC1A 4094 ABB1 BEDF DAB4
   ```

   지문 스트링이 일치하지 않으면 AWS SAM CLI 설치관리자를 사용하지 마십시오. *aws-sam-cli GitHub 리포지토리*에서 [문제를 생성](https://github.com/aws/aws-sam-cli/issues/new?assignees=&labels=stage%2Fneeds-triage&projects=&template=Bug_report.md&title=Bug%3A+TITLE)하여 AWS SAM 팀에 에스컬레이션합니다.

1. 서명자 공개 키의 서명을 확인하십시오.

   ```
   $ gpg --check-sigs 4094ABB1BEDFDAB4
   							
   pub   rsa4096 2025-05-19 [SCEA] [expires: 2027-05-19]
         EF463E86CA31933BB688CC1A4094ABB1BEDFDAB4
   uid           [ unknown] AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>
   sig!3        4094ABB1BEDFDAB4 2025-05-19  [self-signature]
   sig!         42FD5F7A73AD885A 2025-05-19 AWS SAM CLI Primary <aws-sam-cli-primary@amazon.com>
   ```

   `1 signature not checked due to a missing key`이 확인되면 이전 단계를 반복하여 기본 및 서명자 공개 키를 키링으로 가져오세요.

   기본 공개 키와 서명자 공개 키 모두의 키 값이 표시되어 있어야 합니다.

서명자 공개 키의 무결성을 확인했으므로 이제 서명자 공개 키를 사용하여 AWS SAMCLI패키지 설치관리자 프로그램을 확인할 수 있습니다.

**AWS SAMCLI 패키지 설치관리자 프로그램의 무결성을 확인하려면**

1. ** AWS SAMCLI패키지 서명 파일 가져오기** - 다음 명령을 사용하여 AWS SAMCLI 패키지 설치관리자 프로그램의 서명 파일을 다운로드합니다.

   ```
   $ wget https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip.sig
   ```

1. **서명 파일을 확인** - 다운로드된 `.sig` 및 `.zip` 파일 모두를 `gpg` 명령의 파라미터로 전달합니다. 다음은 예제입니다.

   ```
   $ gpg --verify aws-sam-cli-linux-x86_64.zip.sig aws-sam-cli-linux-x86_64.zip
   ```

   출력은 다음과 비슷하게 보여야 합니다.

   ```
   gpg: Signature made Mon 19 May 2025 01:21:57 AM UTC using RSA key ID 4094ABB1BEDFDAB4
   gpg: Good signature from "AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>"
   gpg: WARNING: This key is not certified with a trusted signature!
   gpg:          There is no indication that the signature belongs to the owner.
   Primary key fingerprint: EF46 3E86 CA31 933B B688  CC1A 4094 ABB1 BEDF DAB4
   ```
   + `WARNING: This key is not certified with a trusted signature!` 메시지는 무시해도 됩니다. 이것은 귀하의 개인 PGP 키(보유하신 경우)와 AWS SAM CLI PGP 키 사이에 신뢰 체인이 없기 때문에 발생한 것입니다. 자세한 내용은 [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust)를 참조하세요.
   + 출력 결과에 `BAD signature` 문구가 포함된 경우 귀하가 절차를 올바르게 수행했는지 확인합니다. 이 응답을 계속 받는 경우 *aws-sam-cli GitHub 리포지토리*에서 [문제를 생성](https://github.com/aws/aws-sam-cli/issues/new?assignees=&labels=stage%2Fneeds-triage&projects=&template=Bug_report.md&title=Bug%3A+TITLE)하여 AWS SAM 팀에 에스컬레이션하고 다운로드한 파일을 사용하지 마세요.

   `Good signature from "AWS SAM CLI Team <aws-sam-cli-signer@amazon.com>"` 메시지는 서명이 확인되었으며 귀하는 설치를 진행할 수 있다는 의미입니다.

### macOS
<a name="reference-sam-cli-install-verify-signature-macos"></a>

#### GUI 및 명령줄 설치관리자 프로그램
<a name="reference-sam-cli-install-verify-signature-macos-installer"></a>

`pkgutil` 도구를 사용하거나 수동으로 AWS SAMCLI 패키지 설치관리자 서명 파일의 무결성을 확인할 수 있습니다.

**pkgutil을 사용하여 확인하려면**

1. 귀하의 로컬 기기에서 다운로드한 설치관리자 경로를 제공하여 다음 명령을 실행하십시오. 

   ```
   $ pkgutil --check-signature /path/to/aws-sam-cli-installer.pkg
   ```

   다음은 예제입니다.

   ```
   $ pkgutil --check-signature /Users/user/Downloads/aws-sam-cli-macos-arm64.pkg
   ```

1. 출력 결과에서 **Developer ID Installer: AMZN Mobile LLC**를 위해 **SHA256 fingerprint**을 찾습니다. 다음은 예제입니다.

   ```
   Package "aws-sam-cli-macos-arm64.pkg":
      Status: signed by a developer certificate issued by Apple for distribution
      Notarization: trusted by the Apple notary service
      Signed with a trusted timestamp on: 2026-01-28 07:39:16 +0000
      Certificate Chain:
       1. Developer ID Installer: AMZN Mobile LLC (94KV3E626L)
          Expires: 2030-09-26 00:18:06 +0000
          SHA256 Fingerprint:
              5C 45 BE 63 FD 52 10 07 2D 66 56 77 5C A9 FF 25 91 6D 3F 01 F7 0E
              9A 8A 05 F6 2D 62 B2 88 8D A9
          ------------------------------------------------------------------------
       2. Developer ID Certification Authority
          Expires: 2031-09-17 00:00:00 +0000
          SHA256 Fingerprint:
              F1 6C D3 C5 4C 7F 83 CE A4 BF 1A 3E 6A 08 19 C8 AA A8 E4 A1 52 8F
              D1 44 71 5F 35 06 43 D2 DF 3A
          ------------------------------------------------------------------------
       3. Apple Root CA
          Expires: 2035-02-09 21:40:36 +0000
          SHA256 Fingerprint:
              B0 B1 73 0E CB C7 FF 45 05 14 2C 49 F1 29 5E 6E DA 6B CA ED 7E 2C
              68 C5 BE 91 B5 A1 10 01 F0 24
   ```

1. **Developer ID Installer: AMZN Mobile LLC SHA256 fingerprint**은 다음 값과 일치해야 합니다.

   ```
   5C 45 BE 63 FD 52 10 07 2D 66 56 77 5C A9 FF 25 91 6D 3F 01 F7 0E 9A 8A 05 F6 2D 62 B2 88 8D A9
   ```

   지문 스트링이 일치하지 않으면 AWS SAM CLI 설치관리자를 사용하지 마십시오. *aws-sam-cli GitHub 리포지토리*에서 [문제를 생성](https://github.com/aws/aws-sam-cli/issues/new?assignees=&labels=stage%2Fneeds-triage&projects=&template=Bug_report.md&title=Bug%3A+TITLE)하여 AWS SAM 팀에 에스컬레이션합니다. 지문 스트링이 일치하면 패키지 설치관리자 프로그램을 사용하여 계속 진행할 수 있습니다.

**패키지 설치관리자 프로그램을 수동으로 확인하려면**
+ *Apple 지원 웹사이트*에서 [수동으로 다운로드한 Apple 소프트웨어 업데이트의 정품 여부를 확인하는 방법](https://support.apple.com/en-us/HT202369)을 참조하세요.

### Windows
<a name="reference-sam-cli-install-verify-signature-windows"></a>

설치 프로그램은 AWS SAM CLI Windows 운영 체제용 MSI 파일로 패키징됩니다.

**설치관리자 프로그램 무결성 확인**

1. 설치관리자 프로그램의을 마우스 오른쪽 버튼으로 클릭하고 **속성** 창을 엽니다.

1. **디지털 서명(Digital Signatures)** 탭을 선택합니다.

1. **서명 목록**에서 **Amazon Services Web Services, Inc.**를 선택한 후 **세부 정보**를 선택합니다.

1. **일반** 탭이 선택되어 있지 않으면 이 탭을 선택한 후 **인증서 보기(View Certificate)**를 선택합니다.

1. **세부 정보** 탭을 선택한 다음, 선택되어 있지 않은 경우 **표시** 드롭다운 목록에서 **모두(All)**를 선택합니다.

1. **지문(Thumbprint)** 필드가 보일 때까지 아래로 스크롤한 후 **지문(Thumbprint)**을 선택합니다. 그러면 아래 창에 전체 지문 값이 표시됩니다.

1. 지문 값을 다음 값과 일치시킵니다. 값이 일치하면 설치를 진행합니다. 그렇지 않은 경우 *aws-sam-cli GitHub 리포지토리*에서 [문제를 생성](https://github.com/aws/aws-sam-cli/issues/new?assignees=&labels=stage%2Fneeds-triage&projects=&template=Bug_report.md&title=Bug%3A+TITLE)하여 AWS SAM 팀에 에스컬레이션합니다.

   ```
   cd62479397f09d72a04c7399a254b0a91da53d6c
   ```

## 해시 값을 확인합니다.
<a name="reference-sam-cli-install-verify-hash"></a>

### Linux
<a name="reference-sam-cli-install-verify-hash-linux"></a>

#### x86\$164 - 명령줄 설치관리자
<a name="reference-sam-cli-install-verify-hash-linux-x8664"></a>

다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치관리자 파일의 무결성 및 신뢰성을 확인합니다.

```
$ sha256sum aws-sam-cli-linux-x86_64.zip
```

출력 결과는 다음과 같아야 합니다.

```
<64-character SHA256 hash value> aws-sam-cli-linux-x86_64.zip
```

64자의 SHA-256 해시 값을 GitHub에 관한 [AWS SAMCLI 릴리스 노트](https://github.com/aws/aws-sam-cli/releases/latest)에 있는 원하는 AWS SAMCLI 버전의 값과 비교합니다.

### macOS
<a name="reference-sam-cli-install-verify-hash-macos"></a>

#### GUI 및 명령줄 설치관리자 프로그램
<a name="reference-sam-cli-install-verify-hash-macos-installer"></a>

 다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치관리자의 무결성 및 신뢰성을 확인합니다.

```
$ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer

# Examples
$ shasum -a 256 ~/Downloads/aws-sam-cli-macos-arm64.pkg
$ shasum -a 256 ~/Downloads/aws-sam-cli-macos-x86_64.pkg
```

 귀하의 64자의 SHA-256 해시 값을 [AWS SAMCLI릴리스 노트](https://github.com/aws/aws-sam-cli/releases/latest) GitHub리포지토리의 해당 값과 비교합니다.