Outposts パートナー統合

パートナーバックエンド           管理者のブラウザ                 Devin
     │                                │                            │
     │ 1. code_verifier を生成し、     │                            │
     │    code_challenge を導出        │                            │
     │ 2. app.devin.ai/outposts/connect?…code_challenge へリダイレクト│
     │───────────────────────────────>                            │
     │                                │ 3. 管理者が「Connect」を確認│
     │                                │──────confirm connection──────>
     │                                │ 4. redirect callback_url?code=…  │
     │<───────────────────────────────                            │
     │ 5. POST /outposts/connection-token  (code + code_verifier) │
     │────────────────────────────────────────────────────────────>
     │ 6. { access_token, api_base_url, … }                       │
     │<────────────────────────────────────────────────────────────
     │ 7. access_token を使用してoutpost ワーカーを起動         │

import base64, hashlib, secrets

code_verifier = secrets.token_urlsafe(32)  # 43文字以上、予約されていない文字のみ使用
code_challenge = (
    base64.urlsafe_b64encode(hashlib.sha256(code_verifier.encode()).digest())
    .rstrip(b"=")
    .decode()
)

https://app.devin.ai/outposts/connect
  ?callback_url=https://partner.example.com/devin/outpost-callback
  &outpost_name=my-outpost
  &outpost_image=https://partner.example.com/logo.png
  &platform=linux
  &code_challenge=<code_challenge>

https://partner.example.com/devin/outpost-callback?code=<one-time code>

curl -X POST "https://api.devin.ai/outposts/connection-token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=authorization_code" \
  --data-urlencode "code=<one-time code>" \
  --data-urlencode "code_verifier=<code_verifier>"

{
  "outpost_id": "...",
  "account_id": "...",
  "outpost_name": "my-outpost",
  "service_user_id": "...",
  "api_base_url": "https://api.devin.ai",
  "access_token": "cog_...",
  "token_type": "bearer"
}

{
  "error": "invalid_grant",
  "error_description": "Invalid or expired connection code"
}