비밀 키 관리

PlayFab 개발자 비밀 키를 사용하면 타이틀에서 PlayFab Admin 및 Server API 호출을 할 수 있습니다. 개발자 키라고도 하는 비밀 키는 PlayFab 타이틀과 연결됩니다. Game Manager의 Secret Keys 페이지를 사용하여 키를 생성, 삭제, 비활성화하고 만료되도록 설정할 수 있습니다. 이를 통해 타이틀의 비밀 키를 순환할 수 있습니다(과거에는 하기 어려웠던 작업). 또한 타이틀에 대한 임시 액세스를 허용할 수도 있습니다. 타이틀의 비밀 키를 관리하려면:

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를 선택합니다.

이 흐름은 다운타임이 없으며, 이전 키를 삭제할 때까지 각 단계를 안전하게 롤백할 수 있습니다. 첫 번째 단계에서 문제가 있는 경우, 새 키를 삭제할 수 있습니다. 아직 아무도 사용하고 있지 않을 것입니다. 두 번째 단계에서는 두 키가 모두 활성화되어 있으므로, 코드를 안전하게 롤포워드하거나 롤백할 수 있습니다. 세 번째 단계에서는 여전히 이 키에 의존하고 있는 부분을 수정하는 동안 키를 다시 활성화할 수 있습니다. 프로세스가 완료되어도 이전 키를 삭제할 필요는 없습니다. 이 키를 삭제하면 복구할 수 없습니다. 삭제는 영구적이며 되돌릴 수 없습니다. 키를 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를 선택합니다.

​

API 허용 목록

API 허용 목록은 타이틀 비밀 키를 특정 PlayFab API 집합으로 제한합니다. 허용 목록에 없는 API에 대한 요청은 HTTP 403(NotAuthorized)을 반환합니다. API 허용 목록 편집을 포함하여 키의 모든 변경 사항은 기존 PlayStream secret key changed 이벤트에 캡처됩니다. API 허용 목록이 없는 비밀 키는 제한 없이 유지됩니다. 기존 비밀 키는 API 허용 목록을 활성화하고 구성할 때까지 영향을 받지 않습니다. API 허용 목록을 구성하려면:

1. Game Manager에서 Title Settings > Secret Keys로 이동합니다.
2. 비밀 키를 편집하거나 생성합니다.
3. Enable API allowlist를 켭니다.
4. Search APIs를 사용하여 /Server/GetUserData와 같은 필요한 각 API를 찾아 선택합니다.
5. Save를 선택한 다음, 변경 사항을 확인합니다.

API 허용 목록 변경 사항은 즉시 적용되지 않습니다. 기존 비밀 키 캐시가 만료되면서 적용됩니다. 키에 대한 모든 액세스를 취소하려면 API 허용 목록 변경에 의존하지 말고 키를 비활성화하세요. API 제한을 제거하려면:

1. 비밀 키를 편집합니다.
2. Enable API allowlist를 끕니다.
3. Save를 선택한 다음, 변경 사항을 확인합니다.

그러면 비밀 키는 현재 및 향후 API에 대해 제한 없이 사용할 수 있습니다.