Epic Games has filed an antitrust complaint against Apple in the European Union, broadening its legal battle against the tech giant by attempting to appeal to the EU's differing interpretation of.
This guide will walk you through the process of creating your first EAS application and setting up your game to use Epic Account Services.
Applications within Epic Account Services are defined with their own configuration, life cycle, and associated data. The simplest way to understand an application is to view it as an entity on behalf of which a developer or a piece of software asks the user for permission to access their data.
0. Prerequisites
Before you can begin setting up an Epic Account Services application, be sure that you fulfill these prerequisites:
Iron Harvest is a real-time strategy game (RTS) set in the alternate reality of 1920+, just after the end of the Great War. The Game lets you control giant dieselpunk mechs, combining epic singleplayer and coop campaigns as well as skirmishes with intense action on the battlefield for multiplayer fans, Iron Harvest is the classic real-time strategy games fans have been waiting for. Epic Games Christmas 2020 FREE Games: The Correct List! Forget about the earlier fake list of FREE games from Epic Games this Christmas, which includes Horizon Zero Dawn. Here is the confirmed list of FREE games that Epic Games will give away for just 24 hours, every day from 17 December until 31 December 2020! Simple searches use one or more words. Separate the words with spaces (cat dog) to search cat,dog or both. Separate the words with plus signs (cat +dog) to search for.
Signup for the Developer Portal at https://dev.epicgames.com/portal and enable multi-factor authentication on the account.
Create your own organization or join an existing one. Minimally you will need an Epic Account or an Admin role to proceed.
Create or pick a product to use Epic Account Services with.
Download the latest version of EOS SDK.
Check the EOS Quick Start for more details.
1. Accessing Epic Account Services
To access Epic Account Services, navigate to the corresponding section under a product configuration. You can do this from the Organization dashboard:
Click to enlarge image.
Alternatively, you can click the Epic Account Services tile on the Product dashboard, or the link within the Product navigation panel:
Click to enlarge image.
You will need to review and accept a Service Addendum for Epic Account Services to proceed to the EAS dashboard. You can always review all accepted agreements under the Licenses tab of the Organization section in the Developer Portal.
2. Accepting the License Agreement
Acceptable use of Epic Account Services is defined in the Service Addendum for Epic Account Services. Before you can use the services, you will need to review and accept this addendum. You might also want to review the Epic Games Privacy Policy document to understand how Epic Games collects, uses and shares user data.
Your organization can be set up with an Individual or a Company entity type. If an organization is set up with a Company entity type, then each license agreement version needs to be accepted just once per organization. Otherwise, each individual member with access to the EAS dashboard would need to accept agreements individually.
Note that when you use Epic Account Services, you and Epic Games switch roles in the data handling process. With Standard EOS services, you're licensing Epic Games as a service provider to process the data of your players on your behalf. With Epic Account Services, Epic Games manages the user data and authentication flows and exposes this data and functionality on users' behalf, with their consent. From your end, you agree to use the data for specifically permitted uses only, as defined in the Service Addendum for Epic Account Services.
Click to enlarge image.
After accepting the agreement, the EAS dashboard will display and you can start the setup process for your application.
3. Setting Up an EAS Application
From the Epic Account Services dashboard, you can proceed creating your first application. The Developer Portal will show a placeholder for a future application, but none of the configuration details.
Click to enlarge image.
Application configuration consists of three major sections:
Brand Settings: Name, logo, privacy policy URL, and support URL.
Permissions: The access permissions that the application asks users for.
Linked Clients: Association of the application with client credentials used by the SDK during the authentication flow.
Click Configure to proceed with each of these.
Application Brand Settings
The first section for configuring your application is Application Brand Settings.
Click to enlarge image.
On the left you can see a preview of the consent dialog that will be shown to Epic users requesting their permission to share information with that application. The preview is available in a mobile and a web version.
Initially, a red warning banner will appear at the top of the preview for the consent dialog. This warning indicates that the application brand settings have not been reviewed against potential toxicity or an attempt to spoof the brand. Additionally, the consent dialog for an unverified application is prefaced with another warning dialog. The purpose of the double warning is to fully ensure that the user understands all the implications of proceeding with an unverified application.
All applications are created unverified, and with audience restrictions in place. Only members of the same development organization will be able to use their Epic Games accounts to authenticate against this unverified application. All other users will see an audience restriction error message. The purpose of these audience restrictions is to protect Epic users while allowing developers to iterate on integration while they prepare the application for the brand review.
Epic Account Services is available in a Preview mode, and is a subject to temporary limitations. Specifically, the Application Brand Review process is currently under construction and is coming soon. Stay tuned!
To remove these restrictions, the details in the fields on the right must be filled out and submitted for Application Brand Review. These include:
Application Name: A friendly name for your application that will display to users. This is set to the product name by default.
Privacy Policy URL: A URL where users can find your application's privacy policy.
Application Logo: A 128 x 128 opaque PNG or JPG that will represent your application on the consent dialog.
As you update these fields, the preview will immediately update to reflect your changes. Sims 4 with all dlc price.
Click to enlarge image.
Once application is created and brand settings are saved, go to the next tab.
Application Permissions
The Permissions tab is where you define the level of access the application will request from the user.
Click to enlarge image.
Epic Account Services ships with support for three basic permissions:
Basic Profile: Allows read access to user display name, language preferences and linked account display names.
Online Presence: Allows the application to set the online presence of the current user and receive online presence updates from their friends.
Friends: Allows read access to the friends list for the current user's account.
Basic Profile is always required for Epic Account Services and can not be deactivated as you cannot get access to any user data without it. Online Presence and Friends may be enabled or disabled per the needs of your application. Toggle on the permissions you want to enable for your application, then click Save to save your changes. The consent dialog preview will update to reflect the permissions you add or remove.
Click to enlarge image.
Epic Games Setup Controller
Application Clients
Finally, the Clients tab enables you to configure a list of clients associated with this application. A client is any piece of software or website that can access the application's data within the Epic Account Services backend. All clients associated with an application are listed in its Product Settings, and all of them share the user's consent once it is given.
Click to enlarge image.
If you already have clients set up for your application, you can select them from the Select Clients dropdown. Otherwise, click Create New Client to open your Product Settings page and configure a new client. For more information, refer to the Client Credentials page for more information on adding new clients.
Once you have added a client to this list, click the Save button to save your changes.
Click to enlarge image.
At this point you have completed the EAS Application Configuration. From here you are ready to integrate EAS into a product and use it to access user data. Following a review of the application brand settings you submitted, audience restrictions will be lifted, and the application can be made visible to users outside of your organization.
Click to enlarge image.
4. Authenticating Epic Games Users With EOS SDK
Use of Epic Account requires no special setup in the EOS SDK. However, you must use a login type that is appropriate for your target platform, and you must remember to include the scopes you want the user to consent to in the login call. For example, to login via the account portal on a PC, your login call may appear as follows:
This will open a default system web browser that prompts the user to login and review the access application requests. Refer to Authorization and Consent Management for more information regarding the user experience on login.
For more detailed information about API usage and preferred login types per platform, see Auth Interface.
5. Authenticating Epic Games Users on a Web Site
We support OpenID Connect Core 1.0, for authenticating users on websites and web applications, using the authorization code flow. Before you begin, you will need to configure an Application and Client credentials.
User Authorization
To initiate the flow, your application will need to redirect the user to the authorization page where they will be asked to login to their Epic Games account. The authorization URL is:
To request additional permissions, modify the scope parameter in the authorization request. This should contain a space-delimited list of the required permissions. For example:
The redirect URI in the authorization request will need to be configured for the Client in the Dev Portal.
After the user logs in, they will be asked to approve the requested permissions. After, they will be redirected back to your application with a code parameter. The code will be used when requesting an access token.
Epic Games Setup
Epic also supports an optional state parameter that can be used to maintain state between the request and the callback. This is used to prevent cross-site request forgery attacks.
The following is an example redirect after the user is authenticated:
Requesting an Access Token
To request an access token, the client will make a request to the token endpoint, including the client credentials and authorization code. The Epic token endpoint is https://api.epicgames.dev/epic/oauth/v1/token.
The client credentials will be passed in the Authorization header using basic authorization.
In the request, you will also need to specify the authorization_code grant type and include the code and redirect URI from the authorization flow.
The following snippet shows a sample request (using password grant type):
The response contains the following fields:
Response | Description | ||
|---|---|---|---|
| Epic Games Setup Wizard Update The access token should always be passed as is in the Authorization header to Epic services. For example: Endpoints
|
