Access FAQ
Overview
This page covers the Access service's frequently asked questions (FAQ) by customers at our Customer Support Portal.
How do I configure the platform to send player email notifications using my own sender address ?
Example, I want to use no-reply@myawesomestudio.com.
- AGS Shared Cloud
- AGS Private Cloud
Please follow the step in Configure the Email Sender.
- Contact your AccelByte Technical Producer or reach out to support@accelbyte.net for customer support.
- Our Operations team will help to set up the SendGrid configuration and provide a list of CNAME records that you'll need to add to your domain's DNS settings.
- After you've registered the CNAME records, our Operations team will assist with verifying the configuration.
Why are some players not receiving emails?
Some internet service providers (ISPs) will block an email due to the sender, signed-by, and mailed-by not being synchronized.
What should we do?
- AGS Shared Cloud
- AGS Private Cloud
Make sure you have Configure the Email Sender in the Admin Portal and confirmed that it has been successfully verified.
Make sure you have correctly added the CNAME records provided by our Operations team to your domain's DNS settings.
What if players still aren't receiving emails?
Please contact support@accelbyte.net for customer support.
There may be additional factors related to external email providers (i.e. SendGrid), some examples:
-
SendGrid is able to send the email to the recipient, but there is a significant delay before it gets processed.
This is usually happen for Gmail server, this was caused by the receiving mail server is limiting or deferring incoming emails from the IP addresses SendGrid is using to send our emails. One possible reason because a sudden change in email volume, so from an IP address it can take time for the IP to warm up. If it's urgent, Our operation team need to setup another dedicated IP address on SendGrid configuration.
-
SendGrid email delivery is blocked by the mail server.
Mail servers usually block IP addresses with a poor reputation, example, due to send emails to invalid addresses. Our Operations team will try to check and request the IP address to be de-listed by sending a support request to the email provider.
What is the Oculus user id stored in AGS?
There are two types of user ids in Oculus:
- app scoped id: unique ID per application, different for the same application on different devices, can be avoided by app grouping, in the same app grouping, new users will have the same app scoped id, for games that want to share user data between devices, please put the apps in the same app group.
- organization scoped id: unique per organization, allows different apps within the same organization to identify the user.
For AGS account link, we use organization scoped id so that we can identify the same Oculus account regardless of the apps within this organization.
We also utilize the app scoped id for some features like IAP.
You can get the app scoped id by an AGS user id with this endpoint.
You can get the AGS user account by the app scoped id with this endpoint.
What's the best way to get an authorization (apiKey) to test endpoints in the API Explorer?
The authorization (apiKey) is also known as access token in AGS. There are two types of access token in AGS:
- user token: access token granted to a user. Its permission level depends on its assigned user role.
- client token: access token granted to a Confidential IAM Client type by client credentials. Its permission level depends on the permissions assigned to it. Mostly this is used for server-to-server (S2S) calls to admin endpoints in AGS.
To generate either a user token or a client token, refer to the guide in Get authorized in OpenAPI.
Some API endpoints are protected by Permissions, you can find the required permission of the endpoint from Required permission in the API Explorer.
If you get the insufficient permissions error, you need to grant permissions to the user's role or grant permissions to your IAM client.
But do NOT grant any permission to a public IAM client, it's not safe.