Transloadit はエンタープライズ対応
どのセキュリティ質問票でも、問われる内容はほぼ同じです。誰がサインインできるのか、どう外すのか。漏えいしたキーで何ができるのか。書面で何を約束するのか。Transloadit はいま、それぞれに明確に答えられるようになったため、審査を次のベンダーへ進められます。
Workspace 向けシングルサインオン
Enterprise の Workspace メンバーは、SAML 2.0 を通じて Console にサインインできるようになりました。チームメンバーの認証は ID プロバイダーが行いますが、アクセスを最終的に決めるのは、引き続き Transloadit Workspace のメンバーシップ、招待、シート上限です。
SSO は早期アクセス段階のため、まず当社側で有効化します。営業チームにメールでご連絡ください。Workspace で有効化し、設定もサポートします。その後、Workspace オーナーは Console で 設定、続いて シングルサインオン(SAML) を開きます。そこから、サービスプロバイダーの entity ID、ACS URL、metadata URL を ID プロバイダーへコピーし、ID プロバイダーの entity ID、SSO URL、X.509 証明書、email 属性を Transloadit に貼り戻します。パスワードでサインインするオーナーは、新しい昇格セッションが必要になったときにパスワードの確認が必要です。ID プロバイダーは assertion に署名し、安定した一時的ではない NameID を送信しなければなりません。
その後、チームメンバーは ログインページで SSO で続行 を選び、Workspace slug を入力します。セキュリティレビューでよく確認される点を挙げます。
- プロビジョニング。Console で ジャストインタイムのユーザープロビジョニングを許可 を有効にすると、Transloadit アカウントをまだ持たない人でも、保留中の招待を含むプランのシート数の範囲内で、初回サインイン時に User ロールで参加できます。すでにアカウントを持っていてもメンバーでない場合は、このオプションが有効でも招待が必要です。SSO 招待経由で参加する新規メンバーにも User ロールが付与され、既存メンバーは現在のロールを維持します。プロビジョニングを無効にすると、サインインできるのは既存メンバーと招待済みの人だけです。
- オフボーディング。ID プロバイダー側で誰かを無効化すると、新しい SSO サインインはブロックされますが、既存セッションや別のサインイン方法までは止まりません。Workspace のメンバーシップは別途削除する必要があります。その Workspace へのアクセスは、その人の次のリクエスト時に終了します。また、secret をその人が作成した、閲覧した、またはその他の方法でアクセスできた Auth Key は、すべてローテーションまたは削除してください。
- 適用範囲。SSO はパスワードサインインを置き換えるのではなく並存し、ログインは Transloadit 側から開始します(SP-initiated)。すでにパスワードを持つメンバーは、そのまま利用できます。
第 2 要素としてのパスキー
Console の二要素認証は、これまでメールで送られる 6 桁コードを意味していました。現在は代わりにパスキーを使えます。Face ID、Touch ID、またはハードウェアセキュリティキーです。パスキーは作成されたサイトでしか機能しないため、見た目が似たログインページではフィッシングできません。
Console で ユーザー設定、ログインのセキュリティ、二要素認証 の順に開き、パスキー を選んで、ブラウザーの指示に従ってください。パスワードで認証済みのセッションでは、メールコードに戻すこともできます。パスキーが適用されるのは、パスワードでサインインするアカウントです。Google、GitHub、SAML でのサインインは、代わりに各 ID プロバイダーの認証と MFA に依存します。
現在、Console で登録できるパスキーは 1 つです。置き換えるには、パスワードで認証済みのセッションでメールコードに切り替え、その後 パスキー を選んで新しいものを登録します。ブラウザーがパスキーをサポートしていない場合は、メールコードを使ってください。
SHA-384 によるリクエスト署名
署名認証は、そのリクエストが secret を保持している相手から来たことを証明します。通常の API リクエスト向けの新しい Auth Key は、デフォルトで HMAC-SHA384 を使用します。各キーには個別のアルゴリズム設定があります。新しい API リクエスト署名には、SHA-1 ではなく SHA-384 を使用してください。一方、Smart CDN の URL 署名は SHA-256 を使用します。Smart CDN を有効にしたキーで受け付けるのは、SHA-256 制限またはキーごとの制限なしのみで、通常キーの SHA-384 デフォルトは継承しません。キーにアルゴリズム制限が設定されると、別のアルゴリズムで署名された API リクエストは拒否されます。制限のないキーは、API リクエストに対して SHA-1、SHA-256、SHA-384 を受け付けます。完全な署名仕様は認証ドキュメントに記載しています。
Smart CDN 署名には別のキーを使ってください。互換性のある制限を明示的に選ばずに、既存の SHA-384 制限付きキーで Smart CDN を有効にすると、その制限はクリアされ、API リクエストで再び SHA-1、SHA-256、SHA-384 を受け付けるようになります。既存のキーで Smart CDN を有効にする場合は、SHA-256 制限を選んでください。これらの API リクエスト設定は Assembly Notification の署名には影響しません。
当社の Node SDK はデフォルトで SHA-384 で署名します。SHA-256 に制限されたキーを使う場合は、signatureAlgorithm: 'sha256' オプションを設定してください。自前で SHA-384 によりリクエストへ署名する場合は、16 進ダイジェストの先頭に
sha384: を付けます。以下は、Node 組み込みの
crypto と fetch だけを使う、通常の
SHA-384 API キー向けの小さなヘルパーです。
// sign.mjs
import { createHmac } from 'node:crypto'
export async function postApi2(path, fields, key, secret) {
if (!key || !secret) throw new Error('Set your server-side Transloadit credentials')
const expires = new Date(Date.now() + 10 * 60 * 1000).toISOString()
const params = JSON.stringify({ ...fields, auth: { key, expires } })
const hmac = createHmac('sha384', secret).update(params).digest('hex')
const body = new URLSearchParams({ params, signature: `sha384:${hmac}` })
const res = await fetch(`https://api2.transloadit.com${path}`, { method: 'POST', body })
if (!res.ok) throw new Error(`Transloadit request failed (HTTP ${res.status})`)
return res.json()
}
このスクリプトでは、そのヘルパーを使って画像を取り込み、リサイズする Assembly を作成します。
// assembly.mjs
import { postApi2 } from './sign.mjs'
const { TRANSLOADIT_KEY, TRANSLOADIT_SECRET } = process.env
const steps = {
imported: { robot: '/http/import', url: 'https://demos.transloadit.com/inputs/chameleon.jpg' },
thumb: { use: 'imported', robot: '/image/resize', width: 200, height: 200 },
}
const assembly = await postApi2('/assemblies', { steps }, TRANSLOADIT_KEY, TRANSLOADIT_SECRET)
console.log(assembly.ok ?? assembly.error, assembly.assembly_id ?? assembly.message)
サポート対象の Node.js リリースと、assemblies:write スコープを持つ Auth Key を使って、サーバー上で実行してください。
$ export TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY
$ node assembly.mjs
ASSEMBLY_EXECUTING 1aa00d5b547b…
最初のレスポンスが意味するのは、処理が開始したということだけであり、サムネイルの準備完了ではありません。完了または失敗するまで Assembly Status を追跡してください。このサンプル画像では、正常に完了すると 200×133 のサムネイルが生成されます。
スコープ付き Auth Key
何でもできるキーは、漏えい時のリスクになります。新しい Auth Key には、いまや少なくとも 1 つのスコープが必要です。Assembly、Template、Template の認証情報、Auth Key、請求、キュー、Smart CDN 署名には、用途別のスコープを優先してください。従来の
read と write のスコープも引き続き利用できますが、広範なアクセス権を与えます。アプリケーションや環境ごとに、その用途に必要な権限だけを持つキーを分けて発行し、ほかに影響させずに個別に失効できるようにしてください。
Console で 認証情報 に移動し、新しい Auth Key をクリックします。プライベート画像配信(Smart CDN 署名) プリセットで作成されるキーは、Smart CDN URL の署名はできますが、スタンドアロンの Assembly を作成したり Storage を管理したりはできません。スコープを自分で選ぶ場合はカスタム を選択します。API でも、Auth Key の作成と利用可能なスコープの一覧取得によって同じことができます。
各呼び出しでスコープを確認しています。以下の例で使うキーは Assembly を作成できますが、新しいキーは作成できません。
// create-key.mjs
import { postApi2 } from './sign.mjs'
const { TRANSLOADIT_KEY, TRANSLOADIT_SECRET } = process.env
const fields = { scope: 'assemblies:write', description: 'my-app staging' }
postApi2('/auth_keys', fields, TRANSLOADIT_KEY, TRANSLOADIT_SECRET)
.then((res) => console.log(res.ok))
.catch((error) => {
console.error(error.message)
process.exitCode = 1
})
$ node create-key.mjs
Transloadit request failed (HTTP 403)
API が INSUFFICIENT_AUTH_SCOPE を返すのは、この操作に auth_keys:write が必要なためです。ヘルパーはレスポンス本文を出力せず、HTTP ステータスだけを報告します。そのスコープを持つキーであれば、代わりに AUTH_KEY_CREATED が返ります。auth_keys:write は管理者権限として扱ってください。より広いスコープを持つキーを作成できるため、専用かつ厳重に保護されたキーだけに限定すべきです。作成成功時のレスポンスには、新しいキーの
secret も含まれますが、この例では意図的に出力していません。キー作成を組み込む場合は、安全に保管してください。作成時に can_show_auth_secret を設定すると、後で 1 回だけ再表示でき、無制限に取得できるわけではありません。キー作成権限付きでこの例を実行した場合は、その後 Console でテストキーを削除してください。
各種書類
セキュリティページには、調達部門が求める情報をまとめています。
- SOC 2 Type II。保証報告書は、NDA のもとで要望に応じて提供します。
- ISO 27001。Transloadit は ISO/IEC 27001 認証を取得しています。
- SLA。当社の サービスレベル契約 (English) は公開されています。ここでは Annual Uptime Percentage と Annual Queue Percentage のコミットメントを定義し、契約で定める適格条件と請求要件を満たした場合にサービスクレジットを付与します。
財務チーム向けには、Billing Admin ロールによって、Workspace の完全な管理者権限がなくても、プラン変更、請求と利用状況の確認、請求先メールアドレスと支払い方法の更新ができます。
はじめに
パスキーと Auth Key は Console で設定できます。SAML シングルサインオンは Enterprise Workspace 向けに早期アクセスとして提供中です。プランについては 料金ページを参照してください。SSO の有効化、SOC 2 Type II 報告書の請求、またはセキュリティ質問票の確認を一緒に進める場合は、営業チームにメールでご連絡ください。
