Sudo モード認証

POST

/dashboard/sudo/verify

• Staging
• Production (planned)

センシティブな操作を行うための再認証を実施し、Sudo トークンを取得する。

• パスワードユーザー: password フィールドが必須
• MFA 有効ユーザー: totpCode フィールドが必須
• OAuth ユーザー (パスワードなし): emailCode フィールドが必須 取得したトークンは X-Sudo-Token ヘッダーでセンシティブなエンドポイントに渡す。 ブルートフォース保護: 5回失敗で15分間ロック (sudo-attempts:{userId} KV キー)。

Authorizations

• bearerAuth

Request Body ^required

object

password

パスワードユーザーの場合に必須

string

totpCode

MFA 有効時に必須 (6桁)

string

/^\d{6}$/

emailCode

OAuth ユーザー (パスワードなし) の場合に必須 (6桁)

string

/^\d{6}$/

Responses

200

Sudo トークン発行成功

object

sudoToken

Sudo セッショントークン (KV TTL 15分)

string

expiresAt

トークン有効期限 (ISO 8601)

string format: date-time

400

バリデーションエラー

object

error

object

code

string

Example

VALIDATION_ERROR

message

string

Example

Invalid request body

status

integer

Example

400

upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string

Example

https://app.manako.dev/billing

401

認証情報が不正

object

error

object

code

string

Example

VALIDATION_ERROR

message

string

Example

Invalid request body

status

integer

Example

400

upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string

Example

https://app.manako.dev/billing

429

試行回数超過 (SUDO_LOCKED) - 15分間ロック

object

error

object

code

string

Example

VALIDATION_ERROR

message

string

Example

Invalid request body

status

integer

Example

400

upgradeUrl

URL to upgrade plan (only present for plan limit errors)

string

Example

https://app.manako.dev/billing