配置访问凭证

访问凭证选型

• 临时访问凭证：对于需要高安全性的场景，建议使用临时访问凭证。临时访问凭证可以限制访问的有效期，从而减少访问凭证泄露的风险。此外，临时访问凭证支持权限控制，可以有效地避免权限过大的问题。

• 长期访问凭证：出于安全性考虑，不建议您使用长期访问凭证。对于需要便利性的场景，长期访问凭证可以在较长时间内免除多次刷新的麻烦。

  重要

  • 建议每三个月更换一次长期访问凭证，以提高账号的安全性。

  • 当长期访问凭证泄露或者不再使用时，应该及时删除或者禁用相关的访问凭证，以免造成安全风险。

临时访问凭证

当您准备临时使用PHP SDK访问Tablestore服务时，您可以通过STS服务颁发一个STS临时访问凭证。临时访问凭证无需透露您的RAM用户密钥，使Tablestore的访问更加安全。

1. 创建RAM用户。具体操作，请参见创建RAM用户。

2. 为RAM用户授予 AliyunSTSAssumeRoleAccess权限。具体操作，请参见为RAM用户授权。

3. 创建RAM角色，并为RAM角色授予自定义权限策略。具体操作，请参见创建RAM角色和为RAM角色授予自定义权限策略。

4. 使用RAM用户扮演RAM角色获取STS临时访问凭证。具体操作，请参见获取STS临时访问凭证。

5. 配置STS临时访问凭证。

   环境变量

   1. 使用临时身份凭证设置环境变量。

      Mac OS X/Linux/Unix

      # 配置临时访问凭证 STS AccessKey ID
      export TABLESTORE_ACCESS_KEY_ID=your_sts_access_key_id
      # 配置临时访问凭证 STS AccessKey Secret
      export TABLESTORE_ACCESS_KEY_SECRET=your_sts_access_key_secret
      # 配置临时访问凭证 STS Token
      export TABLESTORE_SESSION_TOKEN=your_sts_token

      Windows

      以管理员身份运行命令提示符，执行以下命令。

      # 配置临时访问凭证 STS AccessKey ID
      setx TABLESTORE_ACCESS_KEY_ID your_sts_access_key_id /m
      # 配置临时访问凭证 STS AccessKey Secret
      setx TABLESTORE_ACCESS_KEY_SECRET your_sts_access_key_secret /m
      # 配置临时访问凭证 STS Token
      setx TABLESTORE_SESSION_TOKEN your_sts_token /m

      说明

      环境变量配置完成后，为确保新的设置被正确应用，您可能需要重启相关的开发工具（IDE等）或服务。

   2. 通过环境变量来传递凭证信息。

      $accessKeyId = getenv('TABLESTORE_ACCESS_KEY_ID');
      $accessKeySecret = getenv('TABLESTORE_ACCESS_KEY_SECRET');
      $securityToken = getenv('TABLESTORE_SESSION_TOKEN');

   静态凭证

   您可以在代码中使用变量来引用凭证，这些变量在运行时会被环境变量、配置文件或其他外部数据源中的实际凭证值填充。

   以下操作步骤以配置文件为例。

   1. 创建配置文件config.ini。

      [configName]
      TABLESTORE_ACCESS_KEY_ID = your_sts_access_key_id
      TABLESTORE_ACCESS_KEY_SECRET = your_sts_access_key_secret
      TABLESTORE_SESSION_TOKEN = your_sts_token

   2. 使用配置文件来传递凭证信息。

      try {
          // 读取配置文件，假设config.ini位于脚本同级目录下。
          $config = parse_ini_file('config.ini');
          // 获取AK、SK和TOKEN信息
          $accessKeyId = $config['TABLESTORE_ACCESS_KEY_ID'];
          $accessKeySecret = $config['TABLESTORE_ACCESS_KEY_SECRET'];
          $securityToken = $config['TABLESTORE_SESSION_TOKEN'];
      }catch (Exception $e) {
          printf($e->getMessage() . "\n");
          return;
      }

长期访问凭证

如果您的应用程序部署运行在安全、稳定且不易受外部攻击的环境中，需要长期使用PHP SDK访问您的Tablestore，您可以使用阿里云账号或RAM用户的AK（Access Key ID、Access Key Secret）的方式访问。如何获取AK，请参见使用RAM用户访问密钥访问表格存储。