비밀 키 관리

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