Object Storage Service:アクセス認証情報の構成 (Android SDK)

前提条件

OSS Android SDK がインストールされていること。 Android SDK のインストール

方法 1：AccessKey ペアの使用

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ペア (AccessKey ID と AccessKey シークレット) を使用して、認証情報プロバイダーを初期化します。この方法は、頻繁な認証情報のローテーションなしで長期的な OSS アクセスを必要とする、安全で安定した環境に適しています。手動によるキー管理はセキュリティリスクをもたらし、メンテナンスの複雑さを増大させます。AccessKey ペアを取得するには、「CreateAccessKey - Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ペアの作成」を呼び出してください。

サンプルコード

String ak = "<ALIBABA_CLOUD_ACCESS_KEY_ID>";
String sk = "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>";

OSSCredentialProvider credentialProvider = new OSSPlainTextAKSKCredentialProvider(ak, sk);

方法 2： STS トークンの使用

STS からの一時的な認証情報を使用して、認証情報プロバイダーを初期化します。これは、きめ細かいリアルタイムの権限制御を伴う一時的な OSS アクセスを必要とするアプリケーションに適しています。認証情報には、AccessKey ID、AccessKey シークレット、および STS トークンが含まれます。手動によるトークン管理はセキュリティリスクをもたらし、メンテナンスの複雑さを増大させます。STS トークンを取得するには、「AssumeRole - RAM ロールの一時的な ID 認証情報の取得」を呼び出してください。

次の例は、STS トークンを手動または自動で更新する方法を示しています。

String ak = "<ALIBABA_CLOUD_ACCESS_KEY_ID>";
String sk = "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>";
String token = "<ALIBABA_CLOUD_SECURITY_TOKEN>";

OSSCredentialProvider credentialProvider = new OSSStsTokenCredentialProvider(ak, sk, token);

OSSCredentialProvider credentialProvider = new OSSFederationCredentialProvider() {
    @Override
    public OSSFederationToken getFederationToken() {

        /* AccessKey ID、AccessKey シークレット、STS トークン、および有効期限を取得します。
         * 次の例は、アプリケーションサーバーから認証情報を取得する方法を示しています：
         * URL stsUrl = new URL("<server_url>");
         * HttpURLConnection conn = (HttpURLConnection) stsUrl.openConnection();
         * InputStream input = conn.getInputStream();
         * String jsonText = IOUtils.readStreamAsString(input, OSSConstants.DEFAULT_CHARSET_NAME);
         * JSONObject jsonObjs = new JSONObject(jsonText);
         * String ak = jsonObjs.getString("AccessKeyId");
         * String sk = jsonObjs.getString("AccessKeySecret");
         * String token = jsonObjs.getString("SecurityToken");
         * String expiration = jsonObjs.getString("Expiration");
         */
        String ak = "<ALIBABA_CLOUD_ACCESS_KEY_ID>";
        String sk = "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>";
        String token = "<ALIBABA_CLOUD_SECURITY_TOKEN>";
        String expiration = "<ALIBABA_CLOUD_EXPIRATION>";

        // AccessKey ID、AccessKey シークレット、STS トークン、および有効期限から OSSFederationToken オブジェクトを構築します。
        OSSFederationToken federationToken = new OSSFederationToken(ak, sk, token, expiration);
        return federationToken;
    }
};

方法 3： CredentialsURI の使用

アプリケーションが柔軟な認証情報管理とキーレスアクセスのために外部システムから認証情報を取得する必要がある場合は、CredentialsURI を使用して認証情報プロバイダーを初期化します。内部実装では STS トークンを使用します。Credentials ツールは、指定された URI を使用して STS トークンを取得し、クライアントを初期化します。これにより、AccessKey ペアまたは STS トークンを直接提供する必要がなくなります。

1. URI は、次のプロトコルに準拠したレスポンスを返す必要があります：

   • レスポンスステータスコード： 200

   • レスポンスボディ構造：

     {
       "StatusCode":200,
       "AccessKeyId":"AccessKeyId",
       "AccessKeySecret":"AccessKeySecret",
       "Expiration":"2015-11-03T09:52:59Z",
       "SecurityToken":"SecurityToken"
     }                    

2. URI 認証情報をアクセス認証情報として構成します。

   String authServerUrl = "<remote_url>";
   OSSAuthCredentialsProvider credentialProvider = new OSSAuthCredentialsProvider(authServerUrl);
   /* データが暗号化されている場合は、次のコードを使用して復号できます。
    * credentialProvider.setDecoder(new OSSAuthCredentialsProvider.AuthDecoder() {
    *     @Override
    *     public String decode(String data) {
    *         String result = null;
    *         // データを復号します。
    *         // result = ...
    *         return result;
    *     }
    * });
    */