Oversigt

Steamworks har flere metoder til at bekræfte en Steam-brugers identitet og bekræfte ejerskab af en applikation. Det følgende dokument beskriver hver af disse godkendelsesmetoder, som bruges i de følgende scenarier:

• Mellem en spilklient og andre klienter (P2P) eller spilservere, der bruger Sessionsbilletter
  
• Mellem en spilklient og backend-sever, som bruger:
  
  • Sessionsbilletter og Steamworks-web-API'en
    
  • Bibliotek med krypterede applikationsbilletter
    
• Når en bruger er i en webbrowser, som bruger OpenID og Steamworks-web-API

Identificering af en bruger indenfor Steam

Hver Steam-bruger kan identificeres entydigt ud fra et 64-bit numerisk ID, kendt som brugerens Steam-ID. En brugers Steam-ID er i Steamworks C++-API'er indeholdt i et CSteamID-objekt. Du kan hente den nuværende brugers Steam-ID ved at kalde ISteamUser::GetSteamID og derefter hende 64-bit-ID'et ved at kalde CSteamID.ConvertToUint64() på den returnerede værdi.

De følgende godkendelsesmetoder kan bruges til sikkert at bekræfte en brugers Steam-ID.

API'er beskrevet i dette dokument

Sessionsbilletter

Sessionsbilletter er signerede billetter, som kan bruges til at verificere en brugers identitet mellem brugerens spilklient og et vilkårligt antal af andre spilklienter (såsom i en peer-to-peer multiplayer-session) eller en lytte-/dedikeret spilserver (ved hjælp af ISteamGameServer API'en). Disse billetter kan også bruges til at bekræfte ejerskab af det aktuelle spil og relateret indhold, som kan downloades, og afgøre, om brugeren er blevet VAC-udelukket (se VAC (Valve Anti-Cheat) og spiludelukkelser).
Sessionsbilletter kan også bruges til at bekræfte en brugers identitet mellem en spilklient og en sikker backend-server ved at bruge Steamworks-web-API'en. Kræver, at den sikre server kan lave HTTPS-anmodninger til partner.steam-api.com.

Krypterede applikationsbilletter

Krypterede applikationsbilletter kan bruges til at bekræfte en brugers identitet mellem en spilklient og en sikker backend-server. I modsætning til sessionsbilletter kræver bekræftelse af krypterede applikationsbilletter ikke, at den sikre server kan lave HTTPS-anmodninger. I stedet bruges et C++-bibliotek og en privat, symmetrisk nøgle af den sikre server til at bekræfte billetten. Steamworks-SDK'en inkluderer 32-bit og 64-bit versioner af dette bibliotek for Windows og Linux under public/steam/lib-mappen.
Før du bruger krypterede applikationsbilletter, skal du generere en privat nøgle til hver titel. Du kan gøre dette ved at navigere til "Rediger Steamworks-indstillinger" for din applikation og vælge "SDK Auth" fra rullemenuen "Sikkerhed". Denne nøgle vil være tilknyttet dit titels app-ID og alt indhold, som kan downloades, til den pågældende titel.

Bemærk: Disse nøgler skal opbevares forsvarligt og må ikke distribueres i din applikation på nogen måde!

Steamworks-web-API

Steam har en HTTP-baseret web-API, som kan bruges til at få adgang til mange Steamworks-funktioner. API'en indeholder offentlige metoder, som kan tilgås fra enhver applikation, som er i stand til at lave en HTTP-anmodning, såsom spilklient eller server. API'en indeholder også beskyttede metoder, som kræver godkendelse og er beregnet til at blive tilgået fra betroede backend-applikationer. Flere detaljer om web-APi'en kan findes her.

P2P eller spilservere

Sessionsbilletter

Brugergodkendelse

De følgende trin beskriver, hvordan du bruger sessionsbilletter til at bekræfte en brugers identitet mellem brugerens spilklient (klient A) og en anden klient eller spilserver (klient B):

• Klient A skal hente en sessionsbillet ved at kalde ISteamUser::GetAuthSessionTicket.
  
• Klient A skal sende sin sessionsbillet til klient B.
  
• Klient B skal sende klient A's billet til ISteamUser::BeginAuthSession, som vil udføre en hurtig gyldighedskontrol. Hvis billetten er gyldig, vil ISteamUser::BeginAuthSession videresende billetten til Steam-backenden for at bekræfte, at billetten ikke er blevet genbrugt, og er udstedt af kontoens ejer af klient A. Resultatet af denne bekræftelse vil blive returneret i et ISteamUser::ValidateAuthTicketResponse_t-tilbagekald.
  
• Når multiplayer-sessionen afsluttes:
  
  • Klient A skal sende handlet, som først blev returneret fra ISteamUser::GetAuthSessionTicket, til ISteamUser::CancelAuthTicket.
    
  • Klient B skal sende Steam-ID'et tilhørende klient A til ISteamUser::EndAuthSession.
    

Et par vigtige noter vedrørende sessionsbilletter:

• Sessionsbilletter må kun bruges én gang. ISteamUser::GetAuthSessionTicket skal kaldes for hver klient i multiplayer-sessionen, som anmoder om en billet.
  
• Når det bruges til at godkende spillere inden for en peer-to-peer multiplayer-session, bør hver spilklient bekræfte identiteten af alle andre spilklienter i multiplayer sessionen.
  
• Når processen er færdig med en sessionsbillet, skal ISteamUser::CancelAuthTicket kaldes for alle handles, som returneres af ISteamUser::GetAuthSessionTicket.
  
• Når klient A kalder ISteamUser::CancelAuthTicket, vil klient B modtage et ISteamUser::ValidateAuthTicketResponse_t-tilbagekald, som viser, at klient A's billet ikke længere er gyldig.
  
• Hvis klient A's kald til ISteamUser::CancelAuthTicket behandles før klient B's kald til ISteamUser::EndAuthSession, kan klient B modtage et ISteamUser::ValidateAuthTicketResponse_t-tilbagekald, som siger, at billetten blev annulleret, når klient A forlader et spil med klient B. Fordi der er enighed om, at klient A forlader spillet, kan dette tilbagekald ignoreres.
  
• Netværksforudsætninger kan forhindre Steam-backenden i at give et tilbagekald til den, der kalder ISteamUser::BeginAuthSession i en uendelig tidsperiode. Kalderen af ISteamUser::BeginAuthSession (klient B) bør ikke antage, at han kender klient A's sande identitet, før at dette tilbagekald er blevet modtaget, men bør tillade, at multiplayer-sessionen fortsætter.
  
• Hvis den, som kalder ISteamUser::BeginAuthSession, modtager et ISteamUser::ValidateAuthTicketResponse_t-tilbagekald, som siger, at billetten for klient A er ugyldig, skal kalderen nægte at fortsætte multiplayer-sessionen med klient A. Hvis de andre peers i spillet ikke også nægter at spille med klient A, bør kalderen forlade multiplayer-sessionen.
  
• ISteamGameServer har de samme sessionsbilletmetoder til at udføre godkendelse mellem en spilklient og en spilserver.

Bekræftelse af ejerskab

Når der bruges sessionsbilletter, vil Steam automatisk bekræfte ejerskab af det nuværende app-ID. Hvis brugeren ikke ejer det nuværende app-ID, vil m_eAuthSessionResponse-feltet tilhørende ISteamUser::ValidateAuthTicketResponse_t blive sat til k_EAuthSessionResponseNoLicenseOrExpired. Efter at have modtaget en brugers sessionsbillet og sendt den videre til ISteamUser::BeginAuthSession, ISteamUser::UserHasLicenseForApp bruges til at afgøre, om brugeren ejer det specifikke stykke indhold, som kan downloades.

Backend-server

Sessionsbilletter og Steamworks-web-API

Brugergodkendelse

De følgende trin beskriver, hvordan du bruger sessionsbilletter til at bekræfte en brugers identitet mellem brugerens spilklient og en sikker server:

• Klienten skal hente en sessionsbillet ved at kalde ISteamUser::GetAuthSessionTicket.
  
• For at være sikker på, at billetten er gyldig, skal klienten vente på ISteamUser::GetAuthSessionTicketResponse_t-tilbagekaldet.
  
• Klienten skal sende dens sessionsbillet til den sikre server.
  
• Den sikre server skal lave en HTTPS-anmodning til partner.steam-api.com og kalde webmetoden ISteamUserAuth/AuthenticateUserTicket og give brugerens sessionsbillet som en hex-kodet UTF-8-streng. Bemærk, at denne metode tillader enten en Steam-web-API-nøgle eller en web-API-udgivernøgle, som er tilknyttet app-ID'et for den givne billet, der skal sendes. En senere opdatering af denne API kan give flere oplysninger til kalderen, hvis der er angivet en web-API-udgivernøgle.
  
• Hvis brugerens billet er gyldig, vil ISteamUserAuth/AuthenticateUserTicket returnere brugerens 64-bit Steam-ID.

Bekræftelse af ejerskab

Når en brugers identitet er blevet bekræftet, kan en sikker server bruge web-API-metoden ISteamUser/CheckAppOwnership til at tjekke, om brugeren ejer et bestemt app-ID eller kalde ISteamUser/GetPublisherAppOwnership for at hente en liste over alle brugerejede app-ID'er, som er tilknyttet den givne udgivernøgle.

Krypterede applikationsbilletter

Brugergodkendelse

De følgende trin beskriver, hvordan du skal bruge krypterede applikationsbilletter til at bekræfte en brugers identitet mellem brugerens spilklient og en sikker server:

• Klienten skal kalde ISteamUser::RequestEncryptedAppTicket og vente på ISteamUser::EncryptedAppTicketResponse_t-kaldsresultatet.
  
• Klienten skal derefter kalde ISteamUser::GetEncryptedAppTicket for at hente brugerens krypterede billet og sende billetten til den sikre server.
  
• Ved at bruge biblioteket med krypterede applikationsbilletter skal den sikre server:
  
  • Kalde SteamEncryptedAppTicket::BDecryptTicket for at dekryptere brugerens billet
    
  • Kalde SteamEncryptedAppTicket::BIsTicketForApp for at bekræfte, at billetten er til den forventede applikation
    
  • Kalde SteamEncryptedAppTicket::GetTicketIssueTime for at bekræfte, at billetten ikke er udløbet (udløbstidspunkt er defineret af applikationen)
    
  • Kalde SteamEncryptedAppTicket::GetTicketSteamID for at hente brugerens Steam-ID
    

Et eksempel på implementering kan findes i projektet Steamworks-API-eksempel på applikation (SpaceWar) i SDK'en. Specifikt i CSpaceWarClient::RetrieveEncryptedAppTicket og CSpaceWarClient::OnRequestEncryptedAppTicket.

Bekræftelse af ejerskab

Steam vil kun skabe krypterede applikationsbilletter for brugere, som ejer app-ID'et, hvortil billetten var oprettet. Efter at have dekrypteret en applikationsbillet kan den sikre server bruge SteamEncryptedAppTicket::BIsTicketForApp til at bekræfte, at app-ID'et matcher titlens app-ID. Serveren kan også bruge SteamEncryptedAppTicket::BUserOwnsAppInTicket til at afgøre, om brugeren ejer et specifikt stykke Indhold, der kan downloades (DLC).

Webbrowserbaseret bekræftelse med OpenID

Steam er en OpenID-udbyder som beskrevet i OpenID 2.0-specifikationen. Inde i en webbrowser kan en tredjepartshjemmeside bruge OpenID til at hente en brugers Steam-ID, som kan bruges som loginoplysningerne til tredjepartshjemmesiden eller tilknyttes til en eksisterende konto på hjemmesiden.

Når OpenId bruges, starter brugeren i en webbrowser på tredjepartshjemmesiden. Når brugeren ønsker at logge ind/tilknytte sin konto til den pågældende hjemmeside ved brug af OpenID, dirigerer siden brugeren til en loginformular på Steam-fællesskabets hjemmeside. Når brugeren har indtastet sine Steam-loginoplysninger, bliver brugerens webbrowser automatisk omdirigeret tilbage til tredjepartshjemmesiden med nogle yderligere OpenID-specifikke data tilføjet til returwebadressen. Sidens OpenID-bibliotek kan derefter bruge disse data til at bekræfte og indhente brugerens Steam-ID.

Steam leverer de følgende billeder, som kan bruges af tredjepartssider, når der linkes til Steams loginside:

Brugergodkendelse

Steam's OpenID 2.0-implementering kan bruges til at tilknytte en brugers Steam-konto til deres konto på tredjepartens hjemmeside.

En liste over open source OpenID-biblioteker kan findes på OpenID-hjemmesiden. For at bruge OpenID til at bekræfte en brugers identitet:

• Konfigurer dit OpenID-bibliotek for at bruge den følgende URL som Steam's OP Endpoint URL: https://steamcommunity.com/openid/
  
• Efter en bruger er blevet bekræftet, vil brugerens tildelte ID indeholde brugerens Steam-ID. Steam's tildelte ID-format er:http://steamcommunity.com/openid/id/<steamid>.

Bekræftelse af ejerskab

Når en brugers identitet er blevet bekræftet, kan en sikker server bruge web-API-metoden ISteamUser/CheckAppOwnership til at tjekke, om brugeren ejer et bestemt app-ID, eller kalde ISteamUser/GetPublisherAppOwnership for at hente en liste over alle brugerejede app-ID'er, som er tilknyttet den givne web-API-udgivernøgle.

Eksempler

Tilknytning af tredjepartskonti til Steam-konti

Tredjepartskonti kan også linkes til Steam-konti ved at at tilknytte en brugers Steam-ID til tredjepartskontoen.

En brugers Steam-ID kan hentes sikkert enten i spil eller via en webbrowser, og når den oprindelige tilknytning er på plads, kan du tillade sikker adgang til tredjepartskontoen ved blot at verificere en brugers Steam-ID. Dette eliminerer behovet for, at Steam-brugere skal foretage et sekundært login til tredjeparters kontosystemer. Derudover, hvis nye tredjepartskonti kan oprettes automatisk og linkes, når et nyt Steam-ID opdages, vil Steam-brugeren aldrig skulle tænke over, at en sekundær godkendelse overhovedet finder sted. I stedet kan brugerens ene Steam-konto give adgang til alle brugerens spil, strømline brugeroplevelsen og fjerne potentielle barrierer til at installere og prøve nye spil.

Tilknytning inde fra spil

Sessionsbilletter kan bruges til at bekræfte en brugers identitet mellem en spilklient og en sikker backend-server ved at bruge Steamworks-web-API'en:

• Klienten skal hente en sessionsbillet ved at kalde ISteamUser::GetAuthSessionTicket.
  
• For at være sikker på, at billetten er gyldig, skal klienten vente på ISteamUser::GetAuthSessionTicketResponse_t-tilbagekaldet.
  
• Klienten skal sende dens sessionsbillet til den sikre server.
  
• Den sikre server skal lave en HTTPS-anmodning til api.steampowered.com og kalde webmetoden ISteamUserAuth/AuthenticateUserTicket og give brugerens sessionsbillet som en hex-kodet UTF-8-streng. Bemærk, at denne metode kræver en web-API-udgivernøgle, som er tilknyttet app-ID'et for den givne billet.
  
• Hvis brugerens billet er gyldig, vil ISteamUserAuth/AuthenticateUserTicket returnere brugerens 64-bit Steam-ID.

Tilknytning fra en webbrowser

Steam understøtter OpenID 2.0-specifikationen, så du kan lade brugere logge sikkert ind på deres Steam-konti fra din hjemmeside og hente deres Steam-ID. Gå til Sådan bruges OpenID for at læse mere om, hvordan man bruger OpenID med Steam.

Bekræftelse af ejerskab

Når en brugers identitet er blevet bekræftet, kan en sikker server bruge web-API-metoden ISteamUser/CheckAppOwnership til at tjekke, om brugeren ejer et bestemt app-ID, eller kalde ISteamUser/GetPublisherAppOwnership for at hente en liste over alle brugerejede app-ID'er, som er tilknyttet den givne web-API-udgivernøgle.

Overførsel fra tredjeparts-CD-nøgler til indbygget Steam-ejerskabstjek

Steam selv har flere måder, som en titel kan bekræfte en bruger med, som fjerner behovet for en tredjeparts-CD-nøgle. Vi har samlet en liste over almindelige anvendelsesscenarier for CD-nøgler, samt hvordan du kan indbygge hvert scenarie i Steam:

Adgang til private forummer

Brugere skal logge ind direkte med deres Steam-konto ved hjælp af OpenID. OpenID returnerer brugerens 64-bit Steam-ID, som derefter kan bruges med ISteamUser/CheckAppOwnership for at bekræfte, at brugeren ejer dit app-ID. Flere oplysninger kan findes ovenfor i Tilknytning af tredjepartskonti til Steam-konti.

Sådan låses der op for et ikke-Steam-spil, som er bygget uden DRM

Brug OpenID og ISteamUser/CheckAppOwnership (dokumenteret ovenfor) for at låse op for indholdet på din egen side. Alternativt kan du uploade buildet uden DRM som valgfrit, gratis DLC.

Softwaren sælges på min egen hjemmeside og låses op med en nøgle

Du skal have brugerens login direkte sammen med brugerens Steam-konto, som bruger OpenID. OpenID returnerer brugerens 64-bit Steam-ID, som derefter kan bruges med ISteamUser/CheckAppOwnership for at bekræfte, at brugeren ejer dit app-ID. Flere oplysninger kan findes i Tilknytning af tredjepartskonti til Steam-konti ovenfor.

Drop af genstande i spil til registrering af din tredjepartsnøgle

Hvis du bruger Steam-inventartjenesten, skal du sikre dig, at itemdef er konfigureret korrekt som en promo-genstand, og kalde ISteamInventory::AddPromoItem fra klienten.
Hvis du har din egen backend, kan du kalde ISteamUser::GetAuthSessionTicket fra spilklienten og derefter bruge ISteamUserAuth/AuthenticateUserTicket med ISteamUser/CheckAppOwnership for at bekræfte ejerskab. Flere oplysninger...

Nøglen kontrollerer, hvilken version af softvaren der bliver låst op for

Hver version af dit spil bør have sit eget app-ID. Fra spilklienten skal du kalde ISteamUser::GetAuthSessionTicket og derefter bruge ISteamUserAuth/AuthenticateUserTicket med ISteamUser/CheckAppOwnership til at bekræfte ejerskab. Flere oplysninger...