组织系统配置

组织系统配置包含获取组织的AccessKey,设置AES密钥,设置普通短链缩短后使用的域名。

  1. 单击页面右上角image,选择组织管理>组织系统配置image

  2. AccessKey:展示组织的AccessKey ID和AccessKey Secret,支持复制。

  3. AES密钥设置:输入16个字符的AES密钥,单击保存完成设置。

    密钥请向您方进行AES加密操作的开发人员获取,AES加密操作说明,请参见下面的AES加密函数

    在AIPL模型或人群推送到数据银行或人群进行营销发送时,若ID字段已被AES加密,将使用AES密钥进行解密。

  4. 短链域名设置:输入普通短链缩短后使用的域名,以http://或https://开头,例如:https://aliyundoc.com,单击保存完成设置。

    创建普通短链时,获得的短链格式例如:https://aliyundoc.com/example。

    说明
    • 该域名需要由您购买,并且请联系Quick Audience的技术人员,在技术人员的帮助下,进行该域名与Quick Audience的关联操作。

    • 若您在由旧域名切换到新域名,为保证使用旧域名和新域名的短链均能正常使用,请参见短链域名切换说明进行相关配置和测试。

AES加密函数

AES是一种常用的对称加密算法,使用同一个密钥进行加密、解密。

当ID字段储存在MaxCompute、ADB3.0、MySQL时,您可以使用以下AES加解密函数对ID进行AES加解密。

重要
  • Quick Audience仅支持16个字符长度的密钥,字符可为0~9、A~F(或a~f)。

  • 仅支持唯一密钥,请妥善保管该密钥。不支持变更密钥,否则可能导致部分数据无法解密。

  • 除MaxCompute、ADB3.0、MySQL外,其他类型数据库是否提供AES加解密函数,请参考相应数据库官方说明。

MaxCompute

进行AES加解密之前,需要下载AES加解密函数代码包,然后在MaxCompute命令行客户端中执行如下语句注册代码包中的自定义函数:

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';

AES加解密示例:

-- 加密“中国”,并转为base64,密钥为“xxxxxxxxxxxxxxxx”。
select qa_aes_encrypt('中国', 'xxxxxxxxxxxxxxxx');
-- 结果为“CjUlHjFp8lEUOfQ4k5eCpA==”。

-- 解密“CjUlHjFp8lEUOfQ4k5eCpA==”,“xxxxxxxxxxxxxxxx”为同一个密钥。
select qa_aes_decrypt('CjUlHjFp8lEUOfQ4k5eCpA==', 'xxxxxxxxxxxxxxxx');
-- 结果为“中国”。

ADB3.0

ADB3.0已提供AES加解密函数,您直接使用即可。

AES加解密示例:

-- 加密“中国”,并转为base64,密钥为“xxxxxxxxxxxxxxxx”。
select TO_BASE64(aes_encrypt(CAST('中国' AS VARBINARY), 'xxxxxxxxxxxxxxxx'))
-- 结果为“CjUlHjFp8lEUOfQ4k5eCpA==”。

-- 解密“CjUlHjFp8lEUOfQ4k5eCpA==”,“xxxxxxxxxxxxxxxx”为同一个密钥。
select aes_decrypt(FROM_BASE64('CjUlHjFp8lEUOfQ4k5eCpA=='), 'xxxxxxxxxxxxxxxx') 
-- 结果为“中国”。

MySQL

MySQL已提供AES加解密函数,您直接使用即可。

AES加解密示例:

-- 加密“中国”,并转为base64,密钥为“xxxxxxxxxxxxxxxx”。
select TO_BASE64(AES_ENCRYPT('中国', 'xxxxxxxxxxxxxxxx'));
-- 结果为“CjUlHjFp8lEUOfQ4k5eCpA==”。

-- 解密“CjUlHjFp8lEUOfQ4k5eCpA==”,“xxxxxxxxxxxxxxxx”为同一个密钥。
select AES_DECRYPT(FROM_BASE64('CjUlHjFp8lEUOfQ4k5eCpA=='), 'xxxxxxxxxxxxxxxx')
-- 结果为“中国”。

短链域名切换说明

若您在由旧域名切换到新域名,为保证使用旧域名和新域名的短链均能正常使用,不影响原有短链在有效期内的有效性,请按以下步骤操作:

  1. 切换前操作:

    • 检查新的短链域名信息:

      • 检查新域名的HTTPS证书是否就绪。

      • 检查新域名的DNS是否已配置指向原域名解析的IP。

      • 检查新域名是否已配置Nginx转发,需参考原域名进行配置,否则可能导致新域名无法访问。

    • 检查现有普通短链营销活动:检查是否有正在发送普通短链的营销活动,包括短信营销营自动化营销中的文本短信,如果有,则需要保证相应的短链域名在短链有效期内可以正常访问。

      (可选)如果有正在发送普通短链的营销活动,您可以创建一个只发送该短链的测试营销活动,用于在切换域名后,验证该短链是否还能正常发送和访问。

  2. 组织系统配置页面保存新域名。

    说明
    • 新域名保存后立即生效,后续创建的新短链将使用新域名。

    • 原有短链不受影响,在原域名可访问的条件下,原有短链可继续使用。

  3. 切换后检查:

    • 测试新短链:创建普通短链,将新短链复制到浏览器地址栏,测试能否正常转换为长链。

    • (可选)测试原短链:执行第1步中创建的只发送原短链的测试营销活动,验证原短链是否还能正常发送和访问,测试完成后删除该测试营销活动。