> ## 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. # Services C API 개요 - PFAuthenticationTypes.h > Services C API 개요 - PFAuthenticationTypes.h ## 구조체 | 구조체 | 설명 | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [PFAuthenticationAuthenticateCustomIdRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationauthenticatecustomidrequest) | PFAuthenticationAuthenticateCustomIdRequest 데이터 모델입니다. game\_server 엔터티 토큰을 만들거나 반환합니다. 호출자는 타이틀 엔터티여야 합니다. | | [PFAuthenticationAuthenticateCustomIdResult](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationauthenticatecustomidresult) | PFAuthenticationAuthenticateCustomIdResult 데이터 모델입니다. | | [PFAuthenticationDeleteRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationdeleterequest) | PFAuthenticationDeleteRequest 데이터 모델입니다. game\_server 엔터티를 삭제합니다. 호출자는 자신을 삭제하려는 game\_server 엔터티일 수 있습니다. 또는 이 타이틀에 대한 game\_server 엔터티를 삭제하려는 타이틀 엔터티일 수 있습니다. | | [PFAuthenticationEntityTokenResponse](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationentitytokenresponse) | PFAuthenticationEntityTokenResponse 데이터 모델입니다. | | [PFAuthenticationGetEntityRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationgetentityrequest) | PFAuthenticationGetEntityRequest 데이터 모델입니다. 이 API는 X-SecretKey, X-Authentication 또는 X-EntityToken 헤더로 호출해야 합니다. 선택적인 EntityKey를 포함하여 결과 EntityToken을 특정 엔터티로 설정하려고 시도할 수 있지만, 해당 엔터티는 캐릭터의 master\_player\_account와 같이 호출자와 관계가 있어야 합니다. X-EntityToken을 보내면 계정은 새로 로그인한 것으로 표시되고 새 토큰이 발급됩니다. X-Authentication 또는 X-EntityToken을 사용하는 경우, 헤더는 여전히 유효해야 하며 만료되거나 취소되어서는 안 됩니다. | | [PFAuthenticationLoginResult](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginresult) | PFAuthenticationLoginResult 데이터 모델입니다. | | [PFAuthenticationLoginWithAppleRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithapplerequest) | PFAuthenticationLoginWithAppleRequest 데이터 모델입니다. | | [PFAuthenticationLoginWithCustomIDRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithcustomidrequest) | PFAuthenticationLoginWithCustomIDRequest 데이터 모델입니다. 개발자는 고객이 이미 다른 고객이 사용 중인 ID를 생성할 가능성이 매우 낮도록 하는 것이 강력히 권장됩니다. 사용자가 Custom ID로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Custom ID에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 Custom ID에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. | | [PFAuthenticationLoginWithFacebookRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithfacebookrequest) | PFAuthenticationLoginWithFacebookRequest 데이터 모델입니다. Facebook 로그인은 Facebook 사용자 액세스 토큰을 사용하여 수행됩니다. 토큰에 대한 자세한 내용은 Facebook 개발자 문서([https://developers.facebook.com/docs/facebook-login/access-tokens/](https://developers.facebook.com/docs/facebook-login/access-tokens/))에서 확인할 수 있습니다. 예를 들어, Unity에서는 토큰이 Facebook SDK ScriptableObject FB의 AccessToken으로 제공됩니다. 사용자가 Facebook 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 제공된 계정의 Facebook ID에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 Facebook 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. Facebook은 애플리케이션당 고유한 사용자 ID를 제공하므로 PlayFab Title ID 간에 동일한 Facebook 애플리케이션을 재사용해서는 안 되며, 이렇게 하면 PlayFab 계정 정보의 사용자에 대한 Facebook ID에 문제가 발생할 수 있습니다. 새 PlayFab Title ID에서 애플리케이션을 재사용해야 하는 경우, 먼저 모든 계정을 Facebook에서 연결 해제하거나 첫 번째 Title ID의 모든 사용자를 삭제하십시오. 참고: 사용자가 AccessToken 대신 AuthenticationToken으로 인증된 경우, GetFriendsList API는 빈 목록을 반환합니다. | | [PFAuthenticationLoginWithGameCenterRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithgamecenterrequest) | PFAuthenticationLoginWithGameCenterRequest 데이터 모델입니다. Game Center 플레이어 식별자([https://developer.apple.com/library/ios/documentation/Accounts/Reference/ACAccountClassRef/index.html#](https://developer.apple.com/library/ios/documentation/Accounts/Reference/ACAccountClassRef/index.html#) // apple\_ref/occ/instp/ACAccount/identifier)는 로컬 장치에 저장되는 생성된 문자열입니다. 장치 식별자와 마찬가지로, 플레이어의 Game Center 식별자를 최종 사용자에게 노출하지 않도록 주의해야 합니다. 그렇지 않으면 사용자의 계정이 손상될 수 있습니다. 사용자가 Game Center로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Game Center 식별자에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 Game Center 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. 잘못된 iOS Game Center 플레이어 식별자가 사용된 경우, 이를 나타내는 오류가 반환됩니다. | | [PFAuthenticationLoginWithGoogleAccountRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithgoogleaccountrequest) | PFAuthenticationLoginWithGoogleAccountRequest 데이터 모델입니다. Google 로그인은 장치에서 Android용 Google 로그인 API를 사용하여 Google OAuth 2.0 자격 증명을 획득하고 이를 이 API에 전달함으로써 수행됩니다. 사용자가 Google 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Google 계정에 연결됩니다. 그렇지 않고 Google 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. Android 애플리케이션에서 Google 계정 자격 증명을 얻는 현재(권장) 방법은 GoogleSignInAccount.getServerAuthCode()를 호출하고 인증 코드를 이 API의 ServerAuthCode 매개 변수로 보내는 것입니다. 이 작업을 수행하기 전에 Google API Console에서 OAuth 2.0 웹 애플리케이션 클라이언트 ID를 생성하고 PlayFab Game Manager Google Add-on에서 타이틀에 대한 클라이언트 ID 및 비밀을 구성해야 합니다. 이 방법은 사용자에게 추가 Google 계정 권한을 요구하지 않으므로 최대한 원활한 사용자 환경을 제공합니다. 서버 인증 코드 획득에 대한 자세한 내용은 [https://developers.google.com/identity/sign-in/android/offline-access](https://developers.google.com/identity/sign-in/android/offline-access)를 참조하세요. 이전(사용되지 않음) 방법은 클라이언트에서 GetAccessToken()을 호출하여 OAuth 액세스 토큰을 얻고 이를 AccessToken 매개 변수로 이 API에 전달하는 것이었습니다. Google OAuth 2.0 액세스 토큰을 사용합니다. 이 변경에 대한 자세한 내용은 Google 개발자 문서([https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html](https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html))에서 확인할 수 있습니다. | | [PFAuthenticationLoginWithGooglePlayGamesServicesRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithgoogleplaygamesservicesrequest) | PFAuthenticationLoginWithGooglePlayGamesServicesRequest 데이터 모델입니다. Google Play Games 로그인은 장치에서 Android용 Google Play Games 로그인 API를 사용하여 Google OAuth 2.0 자격 증명을 획득하고 이를 이 API에 전달함으로써 수행됩니다. 사용자가 Google Play Games 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Google Play Games 계정에 연결됩니다. 그렇지 않고 Google Play Games 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. Android 애플리케이션에서 Google Play Games 계정 자격 증명을 얻는 현재(권장) 방법은 GamesSignInClient.requestServerSideAccess()를 호출하고 인증 코드를 이 API의 ServerAuthCode 매개 변수로 보내는 것입니다. 이 작업을 수행하기 전에 Google API Console에서 OAuth 2.0 웹 애플리케이션 클라이언트 ID를 생성하고 PlayFab Game Manager Google Add-on에서 타이틀에 대한 클라이언트 ID 및 비밀을 구성해야 합니다. 이 방법은 사용자에게 추가 Google 계정 권한을 요구하지 않으므로 최대한 원활한 사용자 환경을 제공합니다. 서버 인증 코드 획득에 대한 자세한 내용은 [https://developers.google.com/games/services/android/signin](https://developers.google.com/games/services/android/signin)을 참조하세요. | | [PFAuthenticationLoginWithNintendoServiceAccountRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithnintendoserviceaccountrequest) | PFAuthenticationLoginWithNintendoServiceAccountRequest 데이터 모델입니다. | | [PFAuthenticationLoginWithOpenIdConnectRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithopenidconnectrequest) | PFAuthenticationLoginWithOpenIdConnectRequest 데이터 모델입니다. | | [PFAuthenticationLoginWithPSNRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithpsnrequest) | PFAuthenticationLoginWithPSNRequest 데이터 모델입니다. 사용자가 PlayStation :tm: Network 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 PlayStation :tm: Network 계정에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 PlayStation :tm: Network 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. | | [PFAuthenticationLoginWithServerCustomIdRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithservercustomidrequest) | PFAuthenticationLoginWithServerCustomIdRequest 데이터 모델입니다. | | [PFAuthenticationLoginWithSteamIdRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithsteamidrequest) | PFAuthenticationLoginWithSteamIdRequest 데이터 모델입니다. 사용자가 Steam ID로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 Steam 계정에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 Steam 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. Steam Client 앱에 로그인하지 않은 Steam 사용자는 Steam 사용자 이름만 동기화되며, 통화 및 국가와 같은 기타 데이터는 Client가 열린 상태에서 로그인할 때까지 사용할 수 없습니다. | | [PFAuthenticationLoginWithSteamRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithsteamrequest) | PFAuthenticationLoginWithSteamRequest 데이터 모델입니다. Steam 로그인은 Steam Session Ticket을 통해 수행됩니다. Ticket에 대한 자세한 내용은 Steamworks SDK의 [https://partner.steamgames.com/documentation/auth](https://partner.steamgames.com/documentation/auth)에서 확인할 수 있습니다. 참고: Steam 인증이 작동하려면 PlayFab Game Manager에서 타이틀이 Steam Application ID 및 Web API Key로 구성되어 있어야 합니다(Add-ons Marketplace의 Steam에서). App ID와 연결된 그룹의 Permissions 페이지에서 Steamworks 사이트를 통해 Web API Key를 얻을 수 있습니다. 사용자가 Steam 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 제공된 계정의 Steam ID에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 Steam 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. | | [PFAuthenticationLoginWithXboxIdRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithxboxidrequest) | PFAuthenticationLoginWithXboxIdRequest 데이터 모델입니다. 사용자가 XBOX ID로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 XBOX Live 계정에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 XBOX Live 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. | | [PFAuthenticationLoginWithXboxRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithxboxrequest) | PFAuthenticationLoginWithXboxRequest 데이터 모델입니다. 사용자가 XBOX Live 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 XBOX Live 계정에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 XBOX Live 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. | | [PFAuthenticationLoginWithXUserRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithxuserrequest) | PFAuthenticationLoginWithXUserRequest 데이터 모델입니다. 사용자가 XBOX Live 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 XBOX Live 계정에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 XBOX Live 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. PFAuthenticationLoginWithXUserAsync의 요청 객체입니다. | | [PFAuthenticationServerLoginWithXboxRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationserverloginwithxboxrequest) | PFAuthenticationServerLoginWithXboxRequest 데이터 모델입니다. 사용자가 XBOX Live 계정으로 처음 로그인하고 CreateAccount가 true로 설정된 경우, 새 PlayFab 계정이 생성되어 XBOX Live 계정에 연결됩니다. 이 경우 PlayFab 계정에는 이메일이나 사용자 이름이 연결되지 않습니다. 그렇지 않고 XBOX Live 계정에 연결된 PlayFab 계정이 없으면, 이를 나타내는 오류가 반환되어 타이틀이 사용자에게 PlayFab 계정 생성 과정을 안내할 수 있도록 합니다. | | [PFAuthenticationUserSettings](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationusersettings) | PFAuthenticationUserSettings 데이터 모델입니다. | | [PFAuthenticationValidateEntityTokenRequest](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationvalidateentitytokenrequest) | PFAuthenticationValidateEntityTokenRequest 데이터 모델입니다. 지정된 엔터티 토큰이 만료되거나 취소되지 않았는지 검증하고 소유자의 세부 정보를 반환합니다. | | [PFAuthenticationValidateEntityTokenResponse](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationvalidateentitytokenresponse) | PFAuthenticationValidateEntityTokenResponse 데이터 모델입니다. | ## 상태 변경 | 상태 변경 | 설명 | | ----- | -- | ## 열거형 | 열거형 | 설명 | | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | | [PFAuthenticationIdentifiedDeviceType](/services/playfab/api-references/c/pfauthenticationtypes/enums/pfauthenticationidentifieddevicetype) | IdentifiedDeviceType 열거형입니다. | ## Related topics - [Services C API 개요 - PFAuthentication.h](/ko/services/playfab/api-references/c/pfauthentication/pfauthentication_members.md) - [PFAuthenticationLoginWithNintendoServiceAccountRequest](/ko/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithnintendoserviceaccountrequest.md) - [PFAuthenticationLoginWithGooglePlayGamesServicesRequest](/ko/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationloginwithgoogleplaygamesservicesrequest.md) - [PFAuthenticationIdentifiedDeviceType](/ko/services/playfab/api-references/c/pfauthenticationtypes/enums/pfauthenticationidentifieddevicetype.md) - [PFAuthenticationDeleteRequest](/ko/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationdeleterequest.md)