ภาพรวม
Steamworks จะเปิดให้ใช้กระบวนการยืนยันอัตลักษณ์ของผู้ใช้ Steam และการยืนยันการเป็นเจ้าของของแอปพลิเคชันหลากหลายรูปแบบ เอกสารดังต่อไปนี้จะลงรายละเอียดอธิบายกระบวนการยืนยันตัวตนต่าง ๆ ที่ใช้ในสถานการณ์ดังต่อไปนี้:
- ระหว่างไคลเอนต์เกมและไคลเอนต์อื่น (P2P) หรือ เซิร์ฟเวอร์เกม ด้วยการใช้ ตั๋วเซสชัน
- ระหว่างไคลเอนต์เกมและเซิร์ฟเวอร์ส่วนแบ็กเอนด์ ด้วยการใช้:
- เมื่อผู้ใช้อยู่ในเว็บเบราว์เซอร์ ด้วยการใช้ OpenID and Steamworks Web API
การระบุตัวตนของผู้ใช้ใน Steam
ผู้ใช้ Steam ทุกคนนั้น จะสามารถถูกระบุตัวตนกันได้อย่างไม่ซ้ำกันด้วยหมายเลขไอดีแบบ 64 บิต ที่เรียกว่า
ไอดี Steam ใน Steamworks C++ API นั้น จะบรรจุ SteamID ของผู้ใช้เอาไว้ในออบเจ็กต์
CSteamID คุณสามารถเรียกรับ SteamID ของผู้ใช้ปัจจุบันได้ด้วยการเรียก
ISteamUser::GetSteamID แล้วจากนั้นเรียกรับไอดี ประเภท 64 บิตได้ด้วยการเรียก
CSteamID.ConvertToUint64() ลงไปบนค่าที่ได้รับคืนกลับมา
คุณจะสามารถใช้เมธอดการยืนยันตัวตนดังต่อไปนี้เพื่อยืนยันความถูกต้องของไอดี Steam ของผู้ใช้ได้
API ที่ได้รับการกล่าวถึงในเอกสารฉบับนี้
ตั๋วเซสชัน
ตั๋วเซสชันเป็นตั๋วที่ได้รับการลงนามที่สามารถนำไปใช้เพื่อตรวจสอบความถูกต้องของอัตลักษณ์ตัวตนของผู้ใช้ระหว่างไคลเอนต์เกมของผู้ใช้และไคลเอนต์เกมตัวอื่น ๆ ได้ (เช่น ในเซสชันผู้เล่นหลายคนแบบ peer-to-peer) หรือกับเซิร์ฟเวอร์เกมเฉพาะ (ด้วยการใช้ API
ISteamGameServer) นอกจากนี้ยังสามารถใช้ตั๋วเหล่านี้เพื่อตรวจสอบความถูกต้องของสถานะการเป็นเจ้าของของเกมปัจจุบันและเนื้อหาดาวน์โหลดเสริมที่เกี่ยวข้องได้ รวมทั้งยังสามารถใช้เพื่อตรวจดูว่าผู้ใช้ได้ถูกแบนโดย VAC หรือไม่ (กรุณาอ่าน
การแบนด้วยตัวป้องกันการโกงของ Valve (VAC) และเกมแบน)
และนอกจากนั้นยังสามารถใช้ตั๋วเซสชันเพื่อตรวจสอบความถูกต้องของอัตลักษณ์ของผู้ใช้ ระหว่างไคลเอนต์เกมและเซิร์ฟเวอร์ส่วนแบ็กเอนด์ที่ได้รับการดูแลความปลอดภัย ด้วยการใช้
Steamworks Web API Requires that the secure server can make HTTPS requests to
partner.steam-api.com.
ตั๋วแอปพลิเคชันที่ได้รับการเข้ารหัส
สามารถใช้ตั๋วแอปพลิเคชันที่ได้รับการเข้ารหัสเพื่อตรวจสอบความถูกต้องของอัตลักษณ์ของผู้ใช้ ระหว่างไคลเอนต์เกมและเซิร์ฟเวอร์ส่วนแบ็กเอนด์ที่ได้รับการดูแลความปลอดภัยได้ ตั๋วแอปพลิเคชันที่ได้รับการเข้ารหัสจะต่างจากตั๋วเซสชันตรงที่ การตรวจสอบความถูกต้องของตั๋วแอปพลิเคชันที่ได้รับการเข้ารหัสนั้น
จะ ไม่ต้องใช้เซิร์ฟเวอร์ที่ได้รับการดูแลความปลอดภัยที่สามารถดำเนินการร้องขอประเภท HTTPS ได้ โดยจะใช้ คลัง C++ และคีย์ Symmetric ส่วนตัวที่ใช้งานโดยเซิร์ฟเวอร์ที่ได้รับการดูแลความปลอดภัยมาตรวจสอบความถูกต้องของตั๋วแทน The Steamworks SDK includes 32-bit and 64-bit versions of this library for Windows and Linux under the
public/steam/lib directory.
Before using Encrypted Application Tickets, you must generate a private key for each title. You can do this by navigating to Edit Steamworks Settings for your application and selecting 'SDK Auth' from the 'Security' drop-down. This key will be associated with your title's AppID and any downloadable content for that title. In order to access this section of Steamworks, a user must have the "Manage Signing" permission for the relevant Application.
NOTE: These keys must be stored securely, and must not be distributed within your application in any way!
Steamworks Web API
Steam exposes an HTTP based Web API which can be used to access many Steamworks features. The API contains public methods that can be accessed from any application capable of making an HTTP request, such as game client or server. The API also contains protected methods that require authentication and are intended to be accessed from trusted back-end applications. More details on the Web API can be found
here.
เซิร์ฟเวอร์ P2P หรือเซิร์ฟเวอร์เกม
ตั๋วเซสชัน
การยืนยันตัวตนผู้ใช้
The following steps detail how to use Session Tickets to verify a user's identity between the user's game client (client A) and another client or game server (client B):
A few important notes about Session Tickets:
การยืนยันการเป็นเจ้าของ
When using Session Tickets, Steam will automatically verify ownership of the current AppID. If the user does not own the current AppID, then
m_eAuthSessionResponse field of the
ISteamUser::ValidateAuthTicketResponse_t will be set to
k_EAuthSessionResponseNoLicenseOrExpired. After receiving a user's Session Ticket and passing it to
ISteamUser::BeginAuthSession then,
ISteamUser::UserHasLicenseForApp can be used to determine if the user owns a specific piece of downloadable content.
เซิร์ฟเวอร์ส่วนแบ็กเอนด์
ตั๋วเซสชัน และ Steamworks Web API
การยืนยันตัวตนผู้ใช้
The following steps detail how to use Session Tickets to verify a user's identity between the user's game client and a secure server:
การยืนยันการเป็นเจ้าของ
Once a user's identity has been verified, a secure server can use the
ISteamUser/CheckAppOwnership Web API method to check if the user owns a particular AppID, or call
ISteamUser/GetPublisherAppOwnership to retrieve a list of all user owned AppIDs that are associated with the provided
Publisher Key.
ตั๋วแอปพลิเคชันที่ได้รับการเข้ารหัส
การยืนยันตัวตนผู้ใช้
The following steps detail how to use Encrypted Application Tickets to verify a user's identity between the user's game client and a secure server:
An example implementation can be found in the
แอปพลิเคชันตัวอย่างของ Steamworks API (SpaceWar) project in the SDK. Specifically
CSpaceWarClient::RetrieveEncryptedAppTicket and
CSpaceWarClient::OnRequestEncryptedAppTicket.
การยืนยันการเป็นเจ้าของ
Steam will only create Encrypted Application Tickets for users who own the AppID for which the ticket was created. After decrypting an Encrypted Application Ticket, the secure server can use
SteamEncryptedAppTicket::BIsTicketForApp to verify the AppID of the ticket matches the title's AppID. The server can also use
SteamEncryptedAppTicket::BUserOwnsAppInTicket to determine if the user owns a specific piece of
เนื้อหาดาวน์โหลด (DLC).
การยืนยันตัวตนทางเว็บเบราว์เซอร์ด้วย OpenID
Steam เป็นผู้ให้บริการ
OpenID ตามที่ได้บัญญัติไว้ในข้อกำหนดคุณลักษณะของ OpenID 2.0 Inside a web browser, a third-party website can use OpenID to obtain a user's SteamID which can be used as the login credentials for the 3rd party website, or linked to an existing account on that website.
When using OpenID, the user begins in a web browser at the third-party website. When the user wishes to login/link their account to that website, using OpenID, the site directs the user to a login form on the Steam Community website. Once the user has entered their Steam login credentials, the user's web browser is automatically redirected back to the 3rd party website with some additional OpenID specific data appended to the return URL. The site's OpenID library can then use this data to verify and obtain the user's SteamID.
Steam provides the following images which may be used by 3rd party sites when linking to the Steam sign in page:
การยืนยันตัวตนผู้ใช้
OpenID 2.0 ของ Steam อาจนำไปปรับใช้เพื่อเชื่อมโยงบัญชี Steam ของผู้ใช้เข้ากับบัญชีของตนที่เว็บไซต์ของผู้พัฒนาภายนอกได้
และสามารถดูรายชื่อไลบรารี OpenID โอเพนซอร์ซได้ที่
OpenID website To use OpenID to verify a user's identity:
- กำหนดค่าคลังของ OpenID ให้ใช้งาน URL ดังต่อไปนี้เป็น OP Endpoint URL ของ Steam:
https://steamcommunity.com/openid/
- หลังจากที่ผู้ใช้ได้รับการยืนยันตัวตนแล้ว Claimed ID ของผู้ใช้ก็จะบรรจุไปด้วยไอดี Steam ของผู้ใช้ Steam Claimed ID จะอยู่ในรูปแบบดังต่อไปนี้:
http://steamcommunity.com/openid/id/<steamid>
การยืนยันการเป็นเจ้าของ
Once a user's identity has been verified, a secure server can use the
ISteamUser/CheckAppOwnership Web API method to check if the user owns a particular AppID, or call
ISteamUser/GetPublisherAppOwnership to retrieve a list of all user owned AppIDs that are associated with the provided
Web API Publisher Key.
ตัวอย่าง
การเชื่อมบัญชีของผู้พัฒนาภายนอกเข้ากับบัญชี Steam
Third-party accounts can be linked to Steam accounts by associating a user's SteamID with the 3rd party account.
A user's SteamID can be securely retrieved either in-game or through a web browser and once the initial association has occurred, you can safely allow access to the 3rd party account by merely verifying a user's SteamID. This eliminates the need for Steam users to do any sort of secondary login to 3rd party account systems. Additionally, if new 3rd party accounts can be automatically created and linked when a new SteamID is encountered, the Steam user will never have to be aware that a secondary authentication is taking place at all. Instead, their single Steam account can grant access to all of their games, streamlining the user experience and removing potential barriers to installing and trying new games.
การเชื่อมโยงจากในเกม
Session Tickets can be used to verify a user's identity between a game client and a secure, backend server using the Steamworks Web API:
การเชื่อมโยงจากเว็บเบราว์เซอร์
Steam supports the OpenID 2.0 specification so that you can allow users to securly log into their Steam accounts from your website and retrieve their SteamID. For details on how to use OpenID with Steam go to
Using OpenIDการยืนยันการเป็นเจ้าของ
Once a user's identity has been verified, a secure server can use the
ISteamUser/CheckAppOwnership Web API method to check if the user owns a particular AppID, or call
ISteamUser/GetPublisherAppOwnership to retrieve a list of all user owned AppIDs that are associated with the provided
Web API Publisher Key.
การย้ายการใช้งานจากรหัสผลิตภัณฑ์ของผู้พัฒนาภายนอกมาสู่ระบบตรวจสอบการเป็นเจ้าของ Steam แบบเนทิฟ
Steam itself has a number of ways a title can authenticate a user with, removing the need for a third-party CD key. We've compiled a list of common use cases for CD Keys and how you might implement each case natively with Steam:
ฟอรัมสนทนาประเภทจำกัดการใช้งานส่วนบุคคล
You'll want to have users login directly with their Steam account using OpenID. OpenID will return the user's 64bit SteamID which can then be used with
ISteamUser/CheckAppOwnership to verify the user owns your appid. More details can be found above at
Linking 3rd party accounts to Steam accounts.
การปลดล็อคเกมที่ไม่มี DRM ที่ไม่ใช่ของ Steam
Use OpenID and
ISteamUser/CheckAppOwnership (
documented above) to unlock the content on your own site. Alternatively, you could upload the DRM-free build as optional, free DLC.
ซอฟต์แวร์ได้รับการจัดจำหน่ายอยู่บนเว็บไซต์ของฉันเองและจะต้องปลดล็อคด้วยรหัส
You'll want to have users login directly with their Steam account using OpenID. OpenID will return the user's 64bit SteamID which can then be used with
ISteamUser/CheckAppOwnership to verify the user owns your appid. More details can be found in
การเชื่อมบัญชีของผู้พัฒนาภายนอกเข้ากับบัญชี Steam above.
การมอบไอเท็มในเกมเป็นรางวัลให้แก่การลงทะเบียนรหัสผู้พัฒนาภายนอกของคุณ
If you are using the
Steam Inventory Service, make sure the item's itemdef is configured correctly as a promo item and call
ISteamInventory::AddPromoItem from the client.
If you have your own item backend, you can call
ISteamUser::GetAuthSessionTicket from the game client and then use
ISteamUserAuth/AuthenticateUserTicket with
ISteamUser/CheckAppOwnership to verify ownership.
More Information...รหัสจะเป็นตัวควบคุมว่าจะปลดล็อคซอฟต์แวร์เวอร์ชันใด
Each version of your game should have its own AppID. From the game client, call
ISteamUser::GetAuthSessionTicket and then use
ISteamUserAuth/AuthenticateUserTicket with
ISteamUser/CheckAppOwnership to verify ownership.
More Information...
