This type defines the Microservice main entry point for the Auth feature. More...
Inheritance diagram for Beamable.Server.Api.IMicroserviceAuthApi:
Collaboration diagram for Beamable.Server.Api.IMicroserviceAuthApi:
Public Member Functions | |
| Promise< User > | GetUser (long userId) |
 Public Member Functions inherited from Beamable.Common.Api.Auth.IAuthApi | |
| Promise< User > | GetUser () |
| Get the main User for the current instance. More... | |
| Promise< User > | GetUser (TokenResponse token) |
| Get a specific User by passing in a TokenResponse structure. The User this method returns will be the one that has the token given. In order to get a TokenResponse, you can use the CreateUser, Login, LoginThirdParty, or LoginRefreshToken methods. More... | |
| Promise< bool > | IsEmailAvailable (string email) |
| Check if a given email address is available to be associated with a User. Each email address is only assignable to one User, so if one player registers an email, that email cannot be registered by any other players. More... | |
| Promise< bool > | IsThirdPartyAvailable (AuthThirdParty thirdParty, string token) |
| Check if a given AuthThirdParty's token is available to be associated with a User. Each third party issues a unique access token per player that will be stored on the Beamable servers. However, if the access token from the third party has already been associated with a User, then it cannot be associated with any other players. More... | |
| Promise< TokenResponse > | CreateUser () |
| Create a new User on the Beamable server, and return that player's TokenResponse. To log into the new account, use the token response structure. More... | |
| Promise< TokenResponse > | LoginRefreshToken (string refreshToken) |
| Use a refresh token string to retrieve a TokenResponse. The resulting token response can be used to change the current User. More... | |
| Promise< TokenResponse > | Login (string username, string password, bool mergeGamerTagToAccount=true, bool customerScoped=false) |
| Use email and password credentials to retrieve a TokenResponse. The resulting token response can be used to change the current User A login will only work after the email and password have been registered by using the RegisterDBCredentials method. More... | |
| Promise< TokenResponse > | LoginThirdParty (AuthThirdParty thirdParty, string thirdPartyToken, bool includeAuthHeader=true) |
| Use a token issued by a third party to retrieve a TokenResponse. The resulting token response can be used to change the current User. You should get the thirdPartyToken directly from the third party itself. A login will only work after the third party has been registered by using the RegisterThirdPartyCredentials method. More... | |
| Promise< User > | RegisterDBCredentials (string email, string password) |
| A User can associate an email and password credential to their account. Once the player registers the credential, they can use the email and password to retrieve a TokenResponse for the account by using the Login method. This method will associate the email and password with the current User. More... | |
| Promise< User > | RegisterThirdPartyCredentials (AuthThirdParty thirdParty, string accessToken) |
| A User can associate a third party credential to their account. The available third party apps can be explored by looking at the AuthThirdParty enum. Once the player registers the credential, they can request a token from the third party and then submit that token to the LoginThirdParty method to retrieve a TokenResponse. This method will associate the third party token with the current User. More... | |
| Promise< EmptyResponse > | IssueEmailUpdate (string newEmail) |
| It is possible that a player may forget the email address they registered with their account when using the RegisterDBCredentials method. In that event, you can update the User.email address using this method. More... | |
| Promise< EmptyResponse > | ConfirmEmailUpdate (string code, string password) |
| It is possible that a player may forget the email address they registered with their account when using the RegisterDBCredentials method. In that even, you can update the User.email address with the IssueEmailUpdate method. A unique code will be sent to the player's new email address. That code needs to be given to this method to complete the email transfer. More... | |
| Promise< EmptyResponse > | IssuePasswordUpdate (string email) |
| If the player forgets the password they registered with their email during the RegisterDBCredentials method, you can use this method to issue them a password update email. This method will send the player an email containing a unique code. That code needs to be given to the ConfirmPasswordUpdate method to complete the password update. More... | |
| Promise< EmptyResponse > | ConfirmPasswordUpdate (string code, string newPassword) |
| If the player forgets the password they registered with their email during the RegisterDBCredentials method, you can use the IssuePasswordUpdate method to send the player a one time password reset code. That code needs to be given to this method, as well as a new password, to complete the password update process. More... | |
| Promise< CustomerRegistrationResponse > | RegisterCustomer (string email, string password, string projectName, string customerName, string alias) |
| This method should not be used by Developers, and will soon be marked as obsolete. More... | |
| Promise< User > | RemoveThirdPartyAssociation (AuthThirdParty thirdParty, string token) |
| If a User has associated third party credentials to their account by using the RegisterThirdPartyCredentials method, you can remove the credentials with this method. In order to remove a third party association, you need to retrieve the third party's auth token for the player one last time, so that Beamable can verify that the remove operation is secure and authorized by the actual player. More... | |
Additional Inherited Members | |
| Properties inherited from Beamable.Common.Api.IHasBeamableRequester | |
| IBeamableRequester | Requester [get] |
| Access the IBeamableRequester | |
Detailed Description
This type defines the Microservice main entry point for the Auth feature.
Related Links
- See the Identity feature documentation
- See Beamable.Server.IBeamableServices script reference
The documentation for this interface was generated from the following file:
- com.beamable.server/SharedRuntime/Api/IMicroserviceAuthApi.cs
