Amazon S3サーバーサイドの暗号化
Amazon Web Services では、OpenTok のアーカイブを S3 ターゲットにアップロードする際に利用できるサーバーサイド暗号化機能を提供しています。
暗号化にはAmazon S3が管理するキーを使用します。詳しくは このAmazonウェブサービスのドキュメント. （OpenTokでは、Amazon S3が管理する暗号化キーのみの使用をサポートしており、KMSやお客様が提供するキーはサポートしていません。）
この機能を使用するには sse プロパティ "s3" OpenTok REST API を呼び出して、OpenTok アーカイブのアップロード先を設定する場合。
以下のURLにHTTP PUTリクエストを送信する：
https://api.opentok.com/v2/project/<apiKey>/archive/storage
交換 <apiKey> OpenTok APIキーを指定してください。
カスタム HTTP ヘッダーを使用して、REST API リクエストを認証します： X-OPENTOK-AUTH. これをJSON Webトークンに設定してください（詳細は OpenTok REST API ドキュメント):
X-OPENTOK-AUTH: <JSON_web_token>
POSTデータとしてJSONオブジェクトを含める：
{
"type": "s3",
"config": {
"bucket": "example.com.archive-bucket",
"endpoint": "https://s3.cloudianhyperstore.com",
"secretKey": "BvKwyshsmEATx5mngeloHwgKrYMbP+",
"accessKey": "AWFS7BAO536E6MXA",
"sse": "s3"
},
"fallback": "none",
}
セット bucket をアーカイブのアップロードに使用するAmazon S3バケットの名前に設定します。バケット名を secretKey そして accessKey プロパティを、そのバケットのAmazon S3のシークレットキーとアクセスキーに設定します。
を設定する。 endpoint プロパティは、Amazon以外のS3準拠のストレージ・プロバイダを使用する場合に使用します。
これはオプションです。プロトコル（httpまたはhttps）を含むエンドポイントのベースURLに設定します、
例えば "https://s3.cloudianhyperstore.com" または "https://storage.googleapis.com".デフォルトの
エンドポイントは "https://s3.amazonaws.com" (Amazon S3のエンドポイントURL）。
を設定する。 sse プロパティ "s3" をクリックして、Amazon S3のサーバー側暗号化を使用します。を設定する。 sse プロパティ "none" を使用してアーカイブを暗号化されていないS3バケットにアップロードします。
を設定する。 fallback プロパティ "none" アップロードに失敗した場合、アーカイブファイルがOpenTokクラウドに保存されないようにするため。このプロパティを "opentok" アップロードに失敗した場合でも、OpenTokダッシュボードでアーカイブを利用できるようにするため。
REST APIレスポンス
ステータスコード200のレスポンスは成功を示す。
ステータスコード400のレスポンスは、無効なJSONデータが含まれているか、アップロード先が指定されていないことを示します。
403ステータスコードが返された場合は、無効なOpenTok APIキーまたはAPIシークレットが指定されたことを示しています。
##例
次のコマンドラインの例は、アーカイブがAmazon S3バケットにアップロードされるときにVonageが使用するサーバー側の暗号化フラグを安全に設定します：
の値を設定する。 api_key OpenTok API キーに設定します。次の値を設定してください。 json_web_token をJSONウェブトークンに変換します。の値を設定します。 your-s3-bucket そして your-s3-access-key を、Amazon S3アカウントに適切にアクセスできる認証情報に変更します。