Using the Chinese Data Center

Skip to end of metadata
Go to start of metadata

 

Description

Gigya maintains a primary Chinese data center physically located inside China, to assist customers in complying with Chinese data localization laws. The hardware and infrastructure of this Chinese data center are completely independent of any other Gigya data centers, enabling the complete isolation of Chinese citizen user data.

There are certain questions that may arise when using the Chinese data center. This document answers some of the most common of these questions.

FAQ

Who Should Use The Chinese Data Center?

Any organization that deals directly or purposefully with citizens of China, or operates a website with a Chinese TLD (i.e., .cn). 

 

Can I Configure A Site In My Existing Gigya Console To Point To The Chinese Data Center?

For security reasons, the Chinese data center will require sites to be configured only under a dedicated Chinese Console account, unlike our other data centers.

Administrators must log in via the URL of the Chinese data center to configure any sites and view user data stored within the Chinese data center.

 

How Do I Access The Chinese Data Center?

Gigya's Chinese data center is a premium service offering. To enable the Chinese data center for your account, please contact your Account Manager, or fill out a case in the Customer Portal.

Once you've been approved to use the Chinese data center, you will only be able to access and configure your sites hosted in the data center by logging into the Chinese Data Center Console. This will require a username and password different from your current console credentials, and can only be accessed via the specific URL https://console.gigya-api.cn.

 

How Do I Make Web SDK Calls Using The Chinese Data Center?

You must use an API Key generated from within the Chinese data center's Console at https://console.gigya-api.cn/Site/partners/Dashboard.aspx. When delivering content to users whose data is to be kept in the Chinese data center, you must load all pages using the gigya.js Web SDK with this API key, and reference the cn1 data center (example below). Once the correct version of the Gigya Web SDK is loaded, you make all requests just like using any other Gigya data center.

<!-- Using http -->
<script src="http://cdn.cn1.gigya-api.cn/js/gigya.js?apiKey=<Your_API_Key>"></script>
 
<!-- Using https -->
<script src="https://cdns.cn1.gigya-api.cn/js/gigya.js?apiKey=<Your_API_Key>"></script>

 

How Do I Make REST API Calls Using The Chinese Data Center?

When making any REST API calls, you must use the Request URI for the cn1 data center and include the API key and secret of your site in the Chinese Data Center Dashboard (as well as any other required parameters). Aside from ensuring that the URI of all requests contain the correct data center designation, everything else functions identically to all other Gigya REST requests.

Example Request URL

https://<namespace>.cn1.gigya-api.cn/<namespace>.REST_API
https://accounts.cn1.gigya-api.cn/accounts.getAccountInfo

Using Gigya's server-side SDKs

If you use one of our SDKs to make REST calls, use the setAPIDomain method of the SDK to set the data center to cn1.

For example, if you're using our PHP SDK:

/* Set up parameters, such as API key, secret key, etc. */
...
$request = new GSRequest($apiKey, $secret, $method);
 
/* Make sure this request uses the Chinese data center */
$request->setAPIDomain("cn1.gigya-api.cn");
... 

 

Can I view User Data And Reports For Users Stored In The Chinese Data Center From My US, EU, or AU Gigya Dashboard?

Gigya's Chinese data center is a completely independent data center physically located in China using its own hardware and infrastructure. The only way to view user data stored within the Chinese data center is by logging into the cn1 Gigya Console at https://console.gigya-api.cn/Site/partners/Dashboard.aspx.

 

Can I Export User Data Outside of China?

You can pull data out of China into any other data center, but Chinese law requires that you meet certain conditions. For example, see this article.

 

Will My Existing Social Network Apps Work With The Chinese Data Center?

Your existing apps will work with the Chinese data center providing that:

  • Your social network is not blocked by the Great Firewall of China,

  • You add the cn1 data center's OAuth URL (or the alias you configured as a CName ) to your existing apps settings at the social network, for example:

    https://socialize.cn1.gigya-api.cn/GS/GSLogin.aspx
  • And that you use the existing app's Application key and secret when configuring the app within the Provider Configurations page of the Chinese data center's Gigya Dashboard.


     

Alternatively, you may create separate apps for use with the Chinese data center.

 

Do I Need to Notify the Chinese Government When I Start to Store Data Within China

Yes, your Account Manager can assist you in filing the proper paperwork to notify the Chinese Government.

 

Can Gigya Assist Me In Migrating Existing User Data to the Chinese Data Center

Yes, Gigya can assist you in migrating any existing user data that needs to be stored in the Chinese data center. Your Account Manager can discuss this service with you when setting up your Chinese Console account.

 

Are all of Gigya's Engagement Add-Ons Supported When Using the Chinese Data Center? 

No. Due to Chinese legal restrictions, the Comments and Ratings&Reviews add-ons are not supported. 

 

Is CAPTCHA Supported When Using the Chinese Data Center?

No. CAPTCHA is not supported in China.

 

Will My Site's Performance Be Affected? 

The data center should work fast within China, but any traffic to the cn domain from outside of China will be slow.

 

Can I Access Gigya Academy From My CN Console? 

Currently, no. However, we do plan to provide access to Gigya Academy in the future. 

  

 

 

 

  • No labels