Tablestore:アクセス資格情報の設定

環境変数

1. 環境変数を設定します。設定が完了したら、IDE、コマンドラインインターフェイス、その他のデスクトップアプリケーション、およびバックグラウンドサービスを含むコンパイルおよびランタイム環境を再起動またはリフレッシュして、最新のシステム環境変数が正常にロードされるようにします。

   Linux

   1. コマンドラインインターフェイスで次のコマンドを実行して、環境変数の設定を ~/.bashrc ファイルに追加します。

      echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
      echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc

   2. 次のコマンドを実行して、変更を有効にします。

      source ~/.bashrc

   3. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET

   macOS

   1. ターミナルで次のコマンドを実行して、デフォルトの Shell タイプを確認します。

      echo $SHELL

   2. デフォルトの Shell タイプに基づいて操作を実行します。

      Zsh

      1. 次のコマンドを実行して、環境変数の設定を ~/.zshrc ファイルに追加します。

         echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
         echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc

      2. 次のコマンドを実行して、変更を有効にします。

         source ~/.zshrc

      3. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

         echo $TABLESTORE_ACCESS_KEY_ID
         echo $TABLESTORE_ACCESS_KEY_SECRET

      Bash

      1. 次のコマンドを実行して、環境変数の設定を ~/.bash_profile ファイルに追加します。

         echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile
         echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile

      2. 次のコマンドを実行して、変更を有効にします。

         source ~/.bash_profile

      3. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

         echo $TABLESTORE_ACCESS_KEY_ID
         echo $TABLESTORE_ACCESS_KEY_SECRET

   Windows

   CMD

   1. CMD で次のコマンドを実行して、環境変数を設定します。

      setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
      setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

   2. CMD を再起動した後、次のコマンドを実行して環境変数が有効になったかどうかを確認します。

      echo %TABLESTORE_ACCESS_KEY_ID%
      echo %TABLESTORE_ACCESS_KEY_SECRET%

   PowerShell

   1. PowerShell で次のコマンドを実行します。

      [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
      [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

   2. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

      [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
      [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

2. 環境変数を使用して資格情報を渡します。

   Java

   import com.alicloud.openservices.tablestore.core.auth.CredentialsProviderFactory;
   import com.alicloud.openservices.tablestore.core.auth.EnvironmentVariableCredentialsProvider;
   
   public class AkDemoTest {
       public static void main(String[] args) throws Exception {
           {
               // 例 1: 環境変数からアクセス資格情報を取得します。
               EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
               // credentialsProvider を使用して後続の操作を実行します。
           }
           {
               // 例 2: 環境変数から AccessKey ID と AccessKey Secret を取得します。
               final String accessKeyId = System.getenv("TABLESTORE_ACCESS_KEY_ID");
               final String accessKeySecret = System.getenv("TABLESTORE_ACCESS_KEY_SECRET");
               // AccessKey ID と AccessKey Secret を使用して後続の操作を実行します。
           }
       }
   }

   Go

   accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
   accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")

   Python

   # -*- coding: utf-8 -*-
   import os
   
   access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
   access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")

   Node.js

   var accessKeyId = process.env.TABLESTORE_ACCESS_KEY_ID;
   var secretAccessKey = process.env.TABLESTORE_ACCESS_KEY_SECRET;

   C#

   // 環境変数からアクセス資格情報を取得します。
   var AccessKeyId = Environment.GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID");
   var AccessKeySecret = Environment.GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET");

   PHP

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

静的資格情報

コードで変数を指定することで、資格情報を参照できます。実行時環境では、変数は環境変数、構成ファイル、またはその他の外部データソースからの実際の資格情報の値によって渡されます。

次の手順では、設定ファイルを例として、一般的な Tablestore SDK で静的資格情報を使用する方法について説明します。

1. config.ini という名前の設定ファイルを作成します。

   [configName]
   TABLESTORE_ACCESS_KEY_ID = your_access_key_id
   TABLESTORE_ACCESS_KEY_SECRET = your_access_key_secret

2. 構成ファイルを使用して資格情報を渡します。

   Java

   import com.alicloud.openservices.tablestore.core.auth.CredentialsProvider;
   import com.alicloud.openservices.tablestore.core.auth.DefaultCredentialProvider;
   import java.io.FileInputStream;
   import java.util.Properties;
   
   public class AkDemoTest {
       public static void main(String[] args) throws Exception {
           Properties properties = new Properties();
           // config.ini ファイルのパスを指定します。実際のパスを使用してください。
           String configFilePath = "config.ini";
   
           // 設定ファイルを読み取ります。
           FileInputStream input = new FileInputStream(configFilePath);
           properties.load(input);
           input.close();
   
           // 設定ファイルから AccessKey ペアを取得します。
           String accessKeyId = properties.getProperty("TABLESTORE_ACCESS_KEY_ID");
           String accessKeySecret = properties.getProperty("TABLESTORE_ACCESS_KEY_SECRET");
   
           CredentialsProvider credentialsProvider = new DefaultCredentialProvider(accessKeyId, accessKeySecret);
   
           // 後続の操作には credentialsProvider を使用します。
       }
   }

   Go

   // 設定ファイルを読み取ります。実際のパスを使用してください。
   config, err := ini.Load("config.ini")
   if err != nil {
       fmt.Println("Failed to read the configuration file:", err)
   }
   
   // 設定ファイルから AccessKey ID と AccessKey Secret を取得します。
   access_key_id := config.Section("configName").Key("TABLESTORE_ACCESS_KEY_ID").String()
   access_key_secret := config.Section("configName").Key("TABLESTORE_ACCESS_KEY_SECRET").String()

   Python

   # -*- coding: utf-8 -*-
   import configparser
   
   # 設定ファイルを読み取ります
   config = configparser.ConfigParser()
   # config.ini がスクリプトと同じディレクトリにあると仮定します。実際のパスを使用してください。
   config.read('config.ini')
   
   # 設定ファイルから AccessKey ID と AccessKey Secret を取得します。
   access_key_id = config.get('configName', 'TABLESTORE_ACCESS_KEY_ID')
   access_key_secret = config.get('configName', 'TABLESTORE_ACCESS_KEY_SECRET')

   PHP

   try {
       // 設定ファイルを読み取ります。config.ini がスクリプトと同じディレクトリにあると仮定します。実際のパスを使用してください。
       $config = parse_ini_file('config.ini');
       // AccessKey ID と AccessKey Secret を取得します。
       $accessKeyId = $config['TABLESTORE_ACCESS_KEY_ID'];
       $accessKeySecret = $config['TABLESTORE_ACCESS_KEY_SECRET'];
   }catch (Exception $e) {
       printf($e->getMessage() . "\n");
       return;
   }

環境変数

1. 環境変数を設定します。設定が完了したら、IDE、コマンドラインインターフェイス、その他のデスクトップアプリケーション、およびバックグラウンドサービスを含むコンパイルおよびランタイム環境を再起動またはリフレッシュして、最新のシステム環境変数が正常にロードされるようにします。

   Linux

   1. コマンドラインインターフェイスで次のコマンドを実行して、環境変数の設定を ~/.bashrc ファイルに追加します。

      echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_STS_ACCESS_KEY_ID'" >> ~/.bashrc
      echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_STS_ACCESS_KEY_SECRET'" >> ~/.bashrc
      echo "export TABLESTORE_SESSION_TOKEN='YOUR_STS_TOKEN'" >> ~/.bashrc

   2. 次のコマンドを実行して、変更を有効にします。

      source ~/.bashrc

   3. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET
      echo $TABLESTORE_SESSION_TOKEN

   macOS

   1. ターミナルで次のコマンドを実行して、デフォルトの Shell タイプを確認します。

      echo $SHELL

   2. デフォルトの Shell タイプに基づいて操作を実行します。

      Zsh

      1. 次のコマンドを実行して、環境変数の設定を ~/.zshrc ファイルに追加します。

         echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_STS_ACCESS_KEY_ID'" >> ~/.zshrc
         echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_STS_ACCESS_KEY_SECRET'" >> ~/.zshrc
         echo "export TABLESTORE_SESSION_TOKEN='YOUR_STS_TOKEN'" >> ~/.zshrc

      2. 次のコマンドを実行して、変更を有効にします。

         source ~/.zshrc

      3. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

         echo $TABLESTORE_ACCESS_KEY_ID
         echo $TABLESTORE_ACCESS_KEY_SECRET
         echo $TABLESTORE_SESSION_TOKEN

      Bash

      1. 次のコマンドを実行して、環境変数の設定を ~/.bash_profile ファイルに追加します。

         echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_STS_ACCESS_KEY_ID'" >> ~/.bash_profile
         echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_STS_ACCESS_KEY_SECRET'" >> ~/.bash_profile
         echo "export TABLESTORE_SESSION_TOKEN='YOUR_STS_TOKEN'" >> ~/.bash_profile

      2. 次のコマンドを実行して、変更を有効にします。

         source ~/.bash_profile

      3. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

         echo $TABLESTORE_ACCESS_KEY_ID
         echo $TABLESTORE_ACCESS_KEY_SECRET
         echo $TABLESTORE_SESSION_TOKEN

   Windows

   CMD

   1. CMD で次のコマンドを実行して、環境変数を設定します。

      setx TABLESTORE_ACCESS_KEY_ID "YOUR_STS_ACCESS_KEY_ID"
      setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_STS_ACCESS_KEY_SECRET"
      setx TABLESTORE_SESSION_TOKEN "YOUR_STS_TOKEN"

   2. CMD を再起動した後、次のコマンドを実行して環境変数が有効になったかどうかを確認します。

      echo %TABLESTORE_ACCESS_KEY_ID%
      echo %TABLESTORE_ACCESS_KEY_SECRET%
      echo %TABLESTORE_SESSION_TOKEN%

   PowerShell

   1. PowerShell で次のコマンドを実行します。

      [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_STS_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
      [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_STS_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)
      [Environment]::SetEnvironmentVariable("TABLESTORE_SESSION_TOKEN", "YOUR_STS_TOKEN", [EnvironmentVariableTarget]::User)

   2. 次のコマンドを実行して、環境変数が有効になったかどうかを確認します。

      [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
      [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)
      [Environment]::GetEnvironmentVariable("TABLESTORE_SESSION_TOKEN", [EnvironmentVariableTarget]::User)

2. 環境変数を使用して資格情報を渡します。

   Java

   import com.alicloud.openservices.tablestore.core.auth.CredentialsProviderFactory;
   import com.alicloud.openservices.tablestore.core.auth.EnvironmentVariableCredentialsProvider;
   
   public class StsDemoTest {
       public static void main(String[] args) throws Exception {
           {
               // 例 1: 環境変数からアクセス資格情報を取得します。
               EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
               // 後続の操作には credentialsProvider を使用します。
           }
           {
               // 例 2: 環境変数から AccessKey ID、AccessKey Secret、およびセキュリティトークンを取得します。
               final String accessKeyId = System.getenv("TABLESTORE_ACCESS_KEY_ID");
               final String accessKeySecret = System.getenv("TABLESTORE_ACCESS_KEY_SECRET");
               final String securityToken = System.getenv("TABLESTORE_SESSION_TOKEN");
               // AccessKey ID、AccessKey Secret、およびセキュリティトークンを使用して後続の操作を実行します。
           }
       }
   }

   Go

   accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
   accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")
   securityToken := os.Getenv("TABLESTORE_SESSION_TOKEN")

   Python

   # -*- coding: utf-8 -*-
   import os
   
   access_key_id = os.getenv("TABLESTORE_ACCESS_KEY_ID")
   access_key_secret = os.getenv("TABLESTORE_ACCESS_KEY_SECRET")
   sts_token = os.getenv("TABLESTORE_SESSION_TOKEN")

   Node.js

   var accessKeyId = process.env.TABLESTORE_ACCESS_KEY_ID;
   var secretAccessKey = process.env.TABLESTORE_ACCESS_KEY_SECRET;
   var stsToken = process.env.TABLESTORE_SESSION_TOKEN;

   PHP

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

静的資格情報

コードで変数を指定することで、資格情報を参照できます。実行時環境では、変数は環境変数、構成ファイル、またはその他の外部データソースからの実際の資格情報の値によって渡されます。

次の手順では、設定ファイルを例として、一般的な Tablestore SDK で静的資格情報を使用する方法について説明します。

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. 構成ファイルを使用して資格情報を渡します。

   Java

   import com.alicloud.openservices.tablestore.core.auth.CredentialsProvider;
   import com.alicloud.openservices.tablestore.core.auth.DefaultCredentialProvider;
   import java.io.FileInputStream;
   import java.util.Properties;
   
   public class StsDemoTest {
       public static void main(String[] args) throws Exception {
           Properties properties = new Properties();
           // config.ini ファイルのパスを指定します。実際のパスを使用してください。
           String configFilePath = "config.ini";
   
           // 設定ファイルを読み取ります。
           FileInputStream input = new FileInputStream(configFilePath);
           properties.load(input);
           input.close();
   
           // 設定ファイルから AccessKey ペアとセキュリティトークンを取得します。
           String accessKeyId = properties.getProperty("TABLESTORE_ACCESS_KEY_ID");
           String accessKeySecret = properties.getProperty("TABLESTORE_ACCESS_KEY_SECRET");
           String securityToken = properties.getProperty("TABLESTORE_SESSION_TOKEN");
   
           CredentialsProvider credentialsProvider = new DefaultCredentialProvider(accessKeyId, accessKeySecret, securityToken);
           // 後続の操作には credentialsProvider を使用します。
       }
   }

   Go

   // 設定ファイルを読み取ります。実際のパスを使用してください。
   config, err := ini.Load("config.ini")
   if err != nil {
       fmt.Println("Failed to read the configuration file:", err)
   }
   
   // 設定ファイルから AccessKey ID と AccessKey Secret を取得します。
   access_key_id := config.Section("configName").Key("TABLESTORE_ACCESS_KEY_ID").String()
   access_key_secret := config.Section("configName").Key("TABLESTORE_ACCESS_KEY_SECRET").String()
   security_token := config.Section("configName").Key("TABLESTORE_SESSION_TOKEN").String()

   Python

   # -*- coding: utf-8 -*-
   import configparser
   
   # 設定ファイルを読み取ります
   config = configparser.ConfigParser()
   # config.ini がスクリプトと同じディレクトリにあると仮定します。実際のパスを使用してください。
   config.read('config.ini')
   
   # 設定ファイルから AccessKey ID と AccessKey Secret を取得します。
   access_key_id = config.get('configName', 'TABLESTORE_ACCESS_KEY_ID')
   access_key_secret = config.get('configName', 'TABLESTORE_ACCESS_KEY_SECRET')
   security_token = config.get('configName', 'TABLESTORE_SESSION_TOKEN')

   PHP

   try {
       // 設定ファイルを読み取ります。config.ini がスクリプトと同じディレクトリにあると仮定します。実際のパスを使用してください。
       $config = parse_ini_file('config.ini');
       // AccessKey ID、AccessKey Secret、およびセキュリティトークンを取得します。
       $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;
   }

Java での実装

1. Function Compute コンテキストの依存関係を追加します。

   <!-- https://mvnrepository.com/artifact/com.aliyun.fc.runtime/fc-java-core -->
   <dependency>
       <groupId>com.aliyun.fc.runtime</groupId>
       <artifactId>fc-java-core</artifactId>
       <version>1.4.1</version>
   </dependency>

2. Function Compute コンテキストの Credentials パラメーターを使用して資格情報プロバイダーを初期化します。

   package example;
   
   import com.alicloud.openservices.tablestore.core.auth.CredentialsProvider;
   import com.alicloud.openservices.tablestore.core.auth.DefaultCredentialProvider;
   import com.aliyun.fc.runtime.Context;
   import com.aliyun.fc.runtime.Credentials;
   import com.aliyun.fc.runtime.StreamRequestHandler;
   
   import java.io.IOException;
   import java.io.InputStream;
   import java.io.OutputStream;
   
   public class App implements StreamRequestHandler {
   
       @Override
       public void handleRequest(
               InputStream inputStream, OutputStream outputStream, Context context) throws IOException {
   
           // キー情報を取得します。関数を実行する前に、関数が属するサービスにロールが構成されており、そのロールに Tablestore にアクセスするための権限が付与されていることを確認してください。AliyunFCDefaultRole ロールを使用することをお勧めします。
           Credentials creds = context.getExecutionCredentials();
   
           // 取得した資格情報を使用して、資格情報プロバイダーインスタンスを作成します。
           CredentialsProvider credentialsProvider = new DefaultCredentialProvider(creds.getAccessKeyId(), creds.getAccessKeySecret(), creds.getSecurityToken());
   
           // 後続の操作を実行するために credentialsProvider を使用します。
   
           outputStream.write(new String("done").getBytes());
       }
   }

Python での実装

Function Compute のコンテキストで Credentials パラメーターを使用して、一時的なアクセス資格情報を取得します。

# -*- coding: utf-8 -*-

def handler(event, context):
    # キー情報を取得します。関数を実行する前に、関数が属するサービスにロールが設定されており、そのロールに Tablestore へのアクセス権限が付与されていることを確認してください。AliyunFCDefaultRole ロールを使用することを推奨します。
    creds = context.credentials

    access_key_id = creds.access_key_id
    access_key_secret = creds.access_key_secret
    security_token = creds.security_token

    # 後続の操作を実行します。

    return 'success'