Organization System Configuration - Quick Audience - Alibaba Cloud Documentation Center

The organization system configuration includes obtaining the AccessKey of the organization, setting the AES key, and setting the domain used after the general short chain is shortened.

In the upper-right corner of the page, click Organizations and choose Organization System Configuration.
AccessKey: displays the AccessKey ID and AccessKey secret of the organization. You can copy them.
AES Key Settings: Enter a 16-character AES key and click Save.
You can obtain the key from the developer who performs the AES encryption operation. For more information about the AES encryption operation, see AES Encryption Function.
When an AIPL model or crowd is pushed to a data bank or crowd for marketing sending, if the ID field has been encrypted by AES, the AES key will be used for decryption.
Short-chain Domain Settings: Enter a shortened domain that starts with http:// or https://, for example, https://aliyundoc.com. Click Save.
Note
- You must purchase the domain. Contact the technical support personnel of Quick Audience to associate the domain with Quick Audience with the help of the technical support personnel.
- If you switch the domain from the old domain to the new domain, you can use the short chain of the new domain. For more information, see Short Chain Domain Switching Guide.

AES encryption function

AES is a commonly used symmetric encryption algorithm that uses the same key for encryption and decryption.

If the ID field is stored in MaxCompute, ADB3.0, or MySQL, you can use the following AES encryption and decryption functions to perform AES encryption and decryption on the ID.

Important

Quick Audience supports only 16 characters in length keys, which can be 0 to 9, A to F (or a to f).
Only a unique key is supported. Keep this key safe. You cannot change the key. Otherwise, some data may fail to be decrypted.
For more information about whether databases other than MaxCompute, Analyte Database 3.0, and MySQL provide the AES encryption and decryption function, see the official database description.

MaxCompute

Before performing AES encryption and decryption, you must download the AES Encryption and Decryption Function Code Package. Then, run the following command on the MaxCompute CLI to register the custom function in the code package:

add jar crypt-1.0-SNAPSHOT.jar as crypt.jar;
create function qa_aes_encrypt as 'com.aliyun.quicka.crypt.AESEncrypt' using 'crypt.jar';
create function qa_aes_decrypt as 'com.aliyun.quicka.crypt.AESDecrypt' using 'crypt.jar';

Example of AES encryption and decryption:

-- Encrypt "China" and convert it to Base64. The key is "xxxxxxxxxxxxxxxx". 
select qa_aes_encrypt ('China', xxxxxxxxxxxxxxxx);
-- The result is CjUlHjFp8lEUOfQ4k5eCpA==. 

-- Decrypt "CjUlHjFp8lEUOfQ4k5eCpA==", "xxxxxxxxxxxxxxxx" is the same key. 
select qa_aes_decrypt('CjUlHjFp8lEUOfQ4k5eCpA==', 'xxxxxxxxxxxxxxxx');
-- The result is "China".

ADB3.0

ADB3.0 provides the AES encryption and decryption functions. You can use these functions directly.

Example of AES encryption and decryption:

-- Encrypt "China" and convert it to Base64. The key is "xxxxxxxxxxxxxxxx". 
select TO_BASE64(aes_encrypt(CAST ('China' AS VARBINARY), xxxxxxxxxxxxxxxx))
-- The result is CjUlHjFp8lEUOfQ4k5eCpA==. 

-- Decrypt "CjUlHjFp8lEUOfQ4k5eCpA==", "xxxxxxxxxxxxxxxx" is the same key. 
select aes_decrypt(FROM_BASE64('CjUlHjFp8lEUOfQ4k5eCpA=='), 'xxxxxxxxxxxxxxxx') 
-- The result is "China".

MySQL

MySQL provides the AES encryption and decryption functions. You can use these functions directly.

Example of AES encryption and decryption:

-- Encrypt "China" and convert it to Base64. The key is "xxxxxxxxxxxxxxxx". 
select TO_BASE64(AES_ENCRYPT ('China', 'China')); xxxxxxxxxxxxxxxx
-- The result is CjUlHjFp8lEUOfQ4k5eCpA==. 

-- Decrypt "CjUlHjFp8lEUOfQ4k5eCpA==", "xxxxxxxxxxxxxxxx" is the same key. 
select AES_DECRYPT(FROM_BASE64('CjUlHjFp8lEUOfQ4k5eCpA=='), 'xxxxxxxxxxxxxxxx')
-- The result is "China".

Short chain domain switching

If you switch from the old domain to the new domain, to ensure that the short chain of the old domain and the new domain can be used normally without affecting the validity of the original short chain within the validity period, follow these steps:

Pre-switchover operations:
- Check the new short chain domain information:
  - Check whether the HTTPS certificate of the new domain is ready.
  - Check whether the DNS of the new domain has been configured to point to the IP address resolved from the original domain.
  - Check whether the new domain has been configured with Nginx forwarding. You must refer to the original domain for configuration. Otherwise, the new domain may be inaccessible.
- Check existing short chain marketing activities: Check whether there are marketing activities that are sending , including text messages in SMS Marketing and Automatic Marketing. If yes, make sure that the corresponding short chain domain can be accessed within the validity period of the short chain.
  (Optional) If you have a marketing campaign that is sending a regular short chain, you can create a marketing campaign that only sends the regular short chain. This campaign is used to verify whether the regular short chain can be sent and accessed after the domain is switched.
On the Organization System Configuration page, save the new domain.
Note
- The new domain takes effect immediately after it is saved. New short chains created later will use the new domain.
- The original short chain is not affected. If the original domain is accessible, the original short chain can continue to be used.
Check after switching:
- Test the new short chain: copy the new short chain to the address bar of your browser to test whether the new short chain can be converted to a long chain.
- (Optional) Test the original short chain: Execute the test marketing activity created in Step 1 to only send the original short chain. Verify whether the original short chain can still be sent and accessed. After the test is complete, delete the test marketing activity.