Template 認証情報とは何ですか?
Template 認証情報は、Amazon S3 や Google Cloud Storage などのストレージプロバイダーへのアクセスに使用する認証情報で、Transloadit の Workspace に安全に保存されます。複数の Templates から同じ認証情報レコードを参照できます。
Template 認証情報の仕組み
Template 認証情報は、Workspace 側で管理する再利用可能なシークレットのレコードです。Robot は、外部ストレージサービスへの読み書きが必要なときに参照できます。インラインの Assembly Instructions と保存済みの Template のどちらでも参照できます。ワークフローには認証情報への間接参照を保存するため、Assembly Instructions やブラウザーのコードにプロバイダーのキーを埋め込まずに済みます。ただし、アクセスには引き続き外部プロバイダーの権限、有効期限ルール、リソースポリシーが適用されます。Transloadit の実行環境とストレージ操作を結び付けるため、依存関係の追跡、最小権限へのスコープ制限、計画的なローテーションが必要です。
要点
- 一つの認証情報レコードを複数の Template で共有できるため、ローテーションが容易になります。ただし、その削除、期限切れ、権限の喪失が、複数のワークフローにまたがる障害要因になります。
- 認証情報の取得に成功しても、操作の成功は保証されません。バケットポリシー、オブジェクトパス、リージョン、プロバイダー側のロール、許可された操作は、それぞれ独立してアクセスを拒否する要因になります。
- 認証情報の参照を使うと、送信する処理設定にプロバイダーのシークレットを埋め込まずに済みます。ただし、ログやエラーレポートにシークレットが含まれないよう、プロビジョニング、認証情報の取得、診断では引き続き機密情報のマスキングが必要です。また、Workspace にアクセスできる Collaborator の権限を適切に制限する必要があります。
Template 認証情報が重要になる場面
複数のワークフローで同じストレージアクセスが必要な場合は、Template 認証情報を再利用して、シークレット設定の重複を減らしてください。保存済みの Template とインラインの処理設定のどちらでも参照できます。一度の変更が依存するすべてのワークフローを中断させる可能性があるため、ローテーションや置き換えは慎重に行ってください。