기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 게이트웨이 활성화 키 받기
게이트웨이 활성화 키를 받으려면 게이트웨이 가상 머신(VM)으로 웹 요청을 보내야 합니다. VM은 활성화 키를 포함한 리디렉션을 반환하며, 이 키는 `ActivateGateway` API 작업의 파라미터 중 하나로 전달되어 게이트웨이 구성을 지정합니다. 자세한 내용은 *Storage Gateway API 참조*에서 [ActivateGateway](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ActivateGateway.html)를 참조하세요.
**참고**
게이트웨이 활성화 키는 사용하지 않으면 30분 후에 만료됩니다.
게이트웨이 VM에 대한 요청에는 활성화가 발생하는 AWS 리전이 포함됩니다. 응답에 리디렉션으로 반환되는 URL에는 `activationkey`라는 쿼리 문자열 파라미터가 포함되어 있습니다. 이 쿼리 문자열 파라미터는 정품 인증 키입니다. 쿼리 문자열의 형식은 다음과 같습니다. `http://gateway_ip_address/?activationRegion=activation_region`. 이 쿼리의 출력은 활성화 리전과 활성화 키를 모두 반환합니다.
이 URL에는 VPC 엔드포인트 유형을 사용하여 연결하는 게이트웨이의 VPC 엔드포인트 ID인 `vpcEndpoint`도 포함되어 있습니다.
**참고**
The AWS Storage Gateway 하드웨어 어플라이언스, VM 이미지 템플릿 및 Amazon EC2 Amazon Machine Image(AMI)는이 페이지에 설명된 웹 요청을 수신하고 응답하는 데 필요한 HTTP 서비스로 미리 구성되어 있습니다. 게이트웨이에 추가 서비스를 설치할 필요는 없으며 권장하지도 않습니다.
**Topics**
+ [Linux(curl)](#get-activation-key-linux-curl)
+ [Linux(bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [로컬 콘솔 사용](#using-local-console)
## Linux(curl)
다음 예에서는 Linux(curl)를 사용하여 활성화 키를 받는 방법을 보여줍니다.
**참고**
강조 표시된 변수를 게이트웨이의 실제 값으로 바꿉니다. 가능한 값은 다음과 같습니다.
*gateway\$1ip\$1address* - 게이트웨이의 IPv4 주소입니다(예: `172.31.29.201`).
*gateway\$1type* - 활성화하려는 게이트웨이의 유형입니다(예: `STORED`, `CACHED`, `VTL`, `FILE_S3`, `FILE_FSX_SMB`).
*region\$1code* - 게이트웨이를 활성화할 리전입니다.AWS 일반 참조 안내서에서 [리전 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)를 참조하세요.** 이 파라미터가 지정되지 않았거나 제공된 값의 철자가 잘못되었거나 유효한 리전과 일치하지 않는 경우 명령은 기본적으로 `us-east-1` 리전으로 설정됩니다.
*vpc\$1endpoint* - 게이트웨이의 VPC 엔드포인트 이름입니다(예: `vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com`).
**퍼블릭 엔드포인트**
퍼블릭 엔드포인트에 대한 활성화 키를 가져오려면 다음 명령 중 하나를 사용합니다.
**표준 엔드포인트**
표준 엔드포인트의 활성화 키를 받으려면:
```
curl "http://gateway_ip_address/?activationRegion=region_code&no_redirect"
```
**듀얼 스택 엔드포인트**
듀얼 스택 엔드포인트의 활성화 키를 받으려면:
IPv4
```
curl "http://gateway_ip_address/?activationRegion&endpointType=DUALSTACK&ipVersion=ipv4&no_redirect"
```
IPv6
```
curl "http://gateway_ip_address/?activationRegion&endpointType=DUALSTACK&ipVersion=ipv6&no_redirect"
```
**FIPS 엔드포인트**
FIPS 엔드포인트의 활성화 키를 받으려면:
IPv4
```
curl "http://gateway_ip_address/?activationRegion&endpointType=FIPS_DUALSTACK&ipVersion=ipv4&no_redirect"
```
IPv6
```
curl "http://gateway_ip_address/?activationRegion&endpointType=FIPS_DUALSTACK&ipVersion=ipv6&no_redirect"
```
**VPC 엔드포인트**
VPC 엔드포인트의 활성화 키를 받으려면:
```
curl "http://gateway_ip_address/?activationRegion=region_code&vpcEndpoint=vpc_endpoint&no_redirect"
```
## Linux(bash/zsh)
다음 예제는 Linux(bash/zsh)를 사용하여 HTTP 응답을 가져오고, HTTP 헤더를 구문 분석하고, 활성화 키를 받는 방법을 보여줍니다.
```
function get-activation-key() {
local ip_address=$1
local activation_region=$2
if [[ -z "$ip_address" || -z "$activation_region" || -z "$gateway_type" ]]; then
echo "Usage: get-activation-key ip_address activation_region gateway_type"
return 1
fi
if redirect_url=$(curl -f -s -S -w '%{redirect_url}' "http://$ip_address/?activationRegion=$activation_region&gatewayType=$gateway_type"); then
activation_key_param=$(echo "$redirect_url" | grep -oE 'activationKey=[A-Z0-9-]+')
echo "$activation_key_param" | cut -f2 -d=
else
return 1
fi
}
```
## Microsoft Windows PowerShell
다음 예제는 Microsoft Windows PowerShell을 사용하여 HTTP 응답을 가져오고, HTTP 헤더를 구문 분석하고, 활성화 키를 받는 방법을 보여줍니다.
```
function Get-ActivationKey {
[CmdletBinding()]
Param(
[parameter(Mandatory=$true)][string]$IpAddress,
[parameter(Mandatory=$true)][string]$ActivationRegion,
[parameter(Mandatory=$true)][string]$GatewayType
)
PROCESS {
$request = Invoke-WebRequest -UseBasicParsing -Uri "http://$IpAddress/?activationRegion=$ActivationRegion&gatewayType=$GatewayType" -MaximumRedirection 0 -ErrorAction SilentlyContinue
if ($request) {
$activationKeyParam = $request.Headers.Location | Select-String -Pattern "activationKey=([A-Z0-9-]+)"
$activationKeyParam.Matches.Value.Split("=")[1]
}
}
}
```
## 로컬 콘솔 사용
다음 예에서는 로컬 콘솔을 사용하여 활성화 키를 생성하고 표시하는 방법을 보여줍니다.
**Amazon Linux 2(AL2) 기반 게이트웨이**
AL2 기반 게이트웨이의 표준 또는 FIPS 엔드포인트를 선택할 수 있습니다.
**참고**
FIPS 엔드포인트를 전혀 사용할 수 없습니다 AWS 리전. 자세한 내용은 [서비스별 FIPS 엔드포인트](https://aws.amazon.com/compliance/fips/)를 참조하세요.
**로컬 콘솔에서 AL2 기반 게이트웨이 활성화 키를 가져오려면**
1. 로컬 콘솔에 *admin*으로 로그인합니다.
1. **AWS 어플라이언스 활성화 - 구성** 기본 메뉴에서 `0`을 선택하여 **정품 인증 키 가져오기**를 선택합니다.
1. 게이트웨이 제품군 옵션으로 **Storage Gateway**를 선택합니다.
1. 게이트웨이를 활성화하려는 AWS 리전을 입력합니다.
1. 네트워크 유형으로 퍼블릭의 경우 `1` 또는 VPC의 경우 `2`를 입력합니다.
1. 엔드포인트 유형으로 표준의 경우 `1`, FIPS(Federal Information Processing Standard)의 경우 `2`를 입력합니다.
**Amazon Linux 2023(AL2023) 기반 게이트웨이**
AL2023 기반 게이트웨이의 경우 다음 엔드포인트를 사용할 수 있습니다.
+ 표준 엔드포인트(IPv4만 지원)
+ FIPS 엔드포인트(IPv4만 지원)
+ 듀얼 스택 엔드포인트(IPv4 및 IPv6 지원)
+ 듀얼 스택 FIPS 엔드포인트(IPv4 및 IPv6 지원)
자세한 내용은 [엔드포인트 유형](Requirements.md#endpoint-types-fgw) 단원을 참조하십시오.
**로컬 콘솔에서 AL2023 기반 게이트웨이 활성화 키를 가져오려면**
1. 로컬 콘솔에 로그인합니다. Amazon EC2 인스턴스에 연결하는 경우, *admin*으로 로그인합니다.
1. **AWS 어플라이언스 활성화 - 구성** 기본 메뉴에서 `0`을 선택하여 **정품 인증 키 가져오기**를 선택합니다.
1. 게이트웨이 제품군 옵션으로 **Storage Gateway**를 선택합니다.
1. 게이트웨이를 활성화하려는 AWS 리전을 입력합니다.
1. 네트워크 유형으로 퍼블릭의 경우 `1`, VPC 엔드포인트의 경우 `2`를 입력합니다.
1. **엔드포인트 유형 선택**, **FIPS 활성화?**에 `Y`를 입력하여 FIPS를 활성화하거나 `N`을 입력하여 비 FIPS 엔드포인트를 사용합니다.
1. 엔드포인트 유형에 표준 엔드포인트의 경우 `1` 또는 듀얼 스택 엔드포인트의 경우 `2`를 입력합니다.
1. 듀얼 스택 엔드포인트의 경우 **IP 버전 선택 또는 종료:**에 IPv4의 경우 `1` 또는 IPv6의 경우 `2`를 입력합니다.