> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 비밀 키 관리

> Game Manager에서 PlayFab 개발자 비밀 키를 생성, 순환, 비활성화 및 만료시켜 Admin 및 Server API 호출을 보호하고 임시 타이틀 액세스를 허용합니다.

PlayFab 개발자 비밀 키를 사용하면 타이틀에서 PlayFab Admin 및 Server API 호출을 할 수 있습니다. 개발자 키라고도 하는 비밀 키는 PlayFab 타이틀과 강하게 결합됩니다.

**Game Manager**의 **Secret Keys** 페이지를 사용하여 키를 생성, 삭제, 비활성화하고 만료되도록 설정할 수 있습니다. 이를 통해 타이틀의 비밀 키를 순환할 수 있습니다(과거에는 하기 어려웠던 작업). 또한 타이틀에 대한 임시 액세스를 허용할 수도 있습니다.

<Note>
  고객에게 보내는 클라이언트 빌드에 개발자 비밀 키를 절대 포함하지 마세요. 그렇게 하면 타이틀이 남용에 노출됩니다.
</Note>

타이틀의 비밀 키를 관리하려면:

1. **Game Manager**에 로그인합니다.
2. 타이틀을 선택합니다.
3. 오른쪽 상단 모서리에서 톱니바퀴 아이콘을 선택합니다.
4. **Title settings**를 선택한 다음, **Secret Keys** 탭을 선택합니다.

**Secret Keys** 페이지는 키를 **Delete**하고, 각 키의 **Status**, **Name**, **Value** 및 만료 시간(있는 경우)을 확인할 수 있는 옵션을 제공합니다. 이 테이블에서는 사용 가능한 키를 감사할 수 있습니다.

대시보드를 통해 기존 키의 이름을 바꾸거나, 활성화, 비활성화 또는 만료 시간을 설정할 수 있습니다. 키에 대한 옵션을 보려면 키를 선택합니다. 각 타이틀은 기본 키로 시작합니다.

키를 순환하려면:

1. **New Secret Key**를 선택합니다.
2. 키의 **Name**과 선택적인 만료 날짜를 입력합니다.
3. 새 키를 사용하도록 코드를 업데이트합니다.
4. 이전 키를 비활성화합니다. 이전 키를 선택한 다음, **Edit Secret Key** 페이지에서 **Disable** 확인란을 선택합니다.
5. **SAVE SECRET KEY**를 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-edit-secret-key.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=315ad34a88e817754d4aae20163f5bcb" alt="Game Manager - Settings - Edit Secret Key" width="1366" height="892" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-edit-secret-key.png" />

<Info>
  이전 키가 손상된 경우, 타이틀을 안전한 상태로 되돌리기 위해 키를 순환합니다.
</Info>

이 흐름은 다운타임이 없으며, 이전 키를 삭제할 때까지 각 단계를 안전하게 롤백할 수 있습니다. 첫 번째 단계에서 문제가 있는 경우, 새 키를 삭제할 수 있습니다. 아직 아무도 사용하고 있지 않을 것입니다.

두 번째 단계에서는 두 키가 모두 활성화되어 있으므로, 코드를 안전하게 롤포워드하거나 롤백할 수 있습니다.

세 번째 단계에서는 여전히 이 키에 의존하고 있는 부분을 수정하는 동안 키를 다시 활성화할 수 있습니다.

프로세스가 완료되어도 이전 키를 삭제할 필요는 없습니다. 이 키를 삭제하면 복구할 수 없습니다. 삭제는 영구적이며 되돌릴 수 없습니다.

키를 Expire로 설정하는 것은 누군가에게 타이틀에 대한 임시 액세스를 부여해야 할 때 유용합니다.

예를 들어, 게임 작업을 하는 계약자가 있는 경우, 그들이 필요할 것으로 예상되는 기간 동안만 액세스할 수 있는 키를 부여할 수 있습니다. 원래 예상 만료 날짜 이후에도 액세스가 필요한 경우, 만료 날짜를 재설정하여 비밀 키의 수명을 연장할 수 있습니다.

## IP 허용 목록

타이틀 비밀 키의 IP 허용 목록은 타이틀 비밀 키가 신뢰하는 IP 외부에서 사용될 수 없도록 보장하는 보안 기능입니다. 각 비밀 키는 사용이 허용된 IPv4 또는 IPv6 주소(또는 CIDR 범위)의 자체 목록을 가질 수 있습니다.

타이틀 비밀 키에 대해 IP 허용 목록이 구성되면, 해당 키로 이루어진 특권 호출(Server 및 Admin API)은 목록의 항목과 일치하는 소스 IP에서만 수락됩니다. 키 자체가 유효하더라도 다른 IP의 호출은 거부됩니다. 허용 목록 편집을 포함하여 키의 모든 변경 사항은 기존 PlayStream secret key changed 이벤트에 캡처됩니다.

**지원되는 형식:**

* IPv4 및 IPv6 주소가 모두 지원됩니다(예: `203.0.113.7` 또는 `2001:db8::1`).
* CIDR 범위는 두 계열 모두 지원됩니다(예: `203.0.113.0/24` 또는 `2001:db8::/32`).

**타이틀 비밀 키에 대한 IP 허용 목록 구성 방법:**

1. **Game Manager**에서 **Title Settings** > **Secret Keys**로 이동합니다.
2. 비밀 키를 편집하거나 생성합니다.
3. **Enable IP allowlist**를 토글합니다.
4. 출구(egress) IP 또는 CIDR 범위를 한 줄에 하나씩 추가합니다(예: `203.0.113.7` 또는 `2001:db8::/32`).
5. **Save**를 선택합니다.

<Info>
  저장하기 전에 목록을 다시 확인하세요. 잘못된 항목은 목록에 없는 모든 IP를 차단하며, 이로 인해 서비스가 Server 및 Admin API에서 잠길 수 있습니다.
</Info>


## Related topics

- [연습: PowerShell/API를 사용하여 빌드 배포](/ko/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-api-powershell.md)
- [PowerShell/API를 사용하여 빌드 배포](/ko/services/playfab/multiplayer/servers/deploy-using-powershell-api.md)
- [Winter Starfall PlayFab 데모 게임 개요](/ko/services/playfab/demo-game/overview.md)
- [Postman용 PlayFab REST API 컬렉션 빠른 시작](/ko/services/playfab/sdks/postman/postman-quickstart.md)
- [통계 빠른 시작](/ko/services/playfab/player-progression/statistics/quickstart-statistics.md)
