integration workspace
API管理
認証連携している service、callback、主要 API 契約を一覧化し、外部サービス接続の現在地を管理します。
OAuth / SessionService Directory
DirectoryService IDs
30
登録済み service id の総数です。登録のみの service も含みます。
CallbackConfigured
21
callback URL まで設定済みで、接続フローに載せられる service 数です。
Header MenuBrowser Entry
1
header のグローバルメニューから直接開ける本番ブラウザ導線です。
Registered ServicesCurrent Runtime View
認証連携サービス一覧
`AUTH_SERVICE_INTEGRATION_GUIDE.md` と現在の runtime 設定を、運用画面向けに一覧化しています。
| service | 用途 | 環境 | callback | 導線 |
|---|---|---|---|---|
allocation-next web本番callback設定済み | 施設配分 施設配分サービスの本番 callback です。 | 本番 | https://allocation-next.pages.dev/auth/callback | 開く |
allocation-next-local webローカルローカル接続 | 施設配分 ローカル接続時の callback です。 | ローカル | http://127.0.0.1:5173/auth/callback | 開く |
doronko-camera-next web本番callback設定済み | 写真管理 header のグローバルメニューから開く本番サービスです。 | 本番 | https://camera.doronko.jp/auth/callback | 開く |
doronko-camera-next-web-staging webstagingcallback設定済み | 写真管理 staging 環境の web callback です。 | staging | https://camera-stg.doronko.jp/auth/callback | 開く |
doronko-camera-next-local webローカルローカル接続 | 写真管理 ローカル検証時の web callback です。 | ローカル | http://127.0.0.1:5174/auth/callback | 開く |
doronko-camera-next-mobile mobile本番callback設定済み | 写真管理 React Native 版の deep link callback です。 | 本番 | doronko://auth/callback | ブラウザ導線なし |
doronko-camera-next-mobile-local mobileローカルローカル接続 | 写真管理 ローカル開発でも deep link を利用します。 | ローカル | doronko://auth/callback | ブラウザ導線なし |
docont-editor web本番callback設定済み | ドキュメント編集 docont-editor 本番 callback です。公開ホスト名 (contract-editor.doronko.jp, gateway 経由) を登録済み。サブドメ DNS 反映 (VR-002) までログイン一巡は通りません。 | 本番 | https://contract-editor.doronko.jp/auth/callback | 開く |
docont-editor-local webローカルローカル接続 | ドキュメント編集 docont-editor ph1 ローカル接続時の callback です。 | ローカル | http://127.0.0.1:5173/auth/callback | 開く |
pay-rec-next web本番callback設定済み | 外部連携 pay-rec-next 本番 callback です。テスト期間中は workers.dev で公開し、会社サブドメインへの移行時に差し替えます。 | 本番 | https://pay-rec-next.nwejwri.workers.dev/auth/callback | 開く |
pay-rec-next-local webローカルローカル接続 | 外部連携 ローカル検証時の web callback です。 | ローカル | http://localhost:5175/auth/callback | 開く |
build-deck-local webローカルローカル接続 | 外部連携 ローカル検証時の web callback です。 | ローカル | http://127.0.0.1:4327/auth/callback | 開く |
fac-db web本番callback設定済み | 施設情報管理 fac-db 本番 callback です。サブドメ (fac-db.doronko.jp) DNS / 証明書反映後に旧 workers.dev callback から差し替え済み。旧 URL は rollback 用に git 履歴で保持。 | 本番 | https://fac-db.doronko.jp/auth/callback | 開く |
fac-db-local webローカルローカル接続 | 施設情報管理 fac-db ローカル接続時の callback です。 | ローカル | http://127.0.0.1:5177/auth/callback | 開く |
gradeditor-next web本番承認制 | gradeditor gradeditor-next 本番接続。viewer以上かつservice利用の承認が必要です。 | 本番 | https://gradeditor-next.nwejwri.workers.dev/auth/callback | 開く |
gradeditor-next-local webローカルローカル接続 | gradeditor gradeditor-next の隔離contract環境で使うloopback callbackです。 | ローカル | http://localhost:5176/auth/callback | 開く |
gradeditor-admin admin web本番callback未確定 | gradeditor Pages URL 確定後に callback を設定します。 | 本番 | 未設定 | ブラウザ導線なし |
gradeditor-admin-staging admin webstagingcallback未確定 | gradeditor staging URL 確定後に callback を設定します。 | staging | 未設定 | ブラウザ導線なし |
gradeditor-admin-local admin webローカルローカル接続 | gradeditor ローカル検証時の admin callback です。 | ローカル | http://127.0.0.1:5273/auth/callback | 開く |
gradeditor-editor editor web本番callback未確定 | gradeditor Pages URL 確定後に callback を設定します。 | 本番 | 未設定 | ブラウザ導線なし |
gradeditor-editor-staging editor webstagingcallback未確定 | gradeditor staging URL 確定後に callback を設定します。 | staging | 未設定 | ブラウザ導線なし |
gradeditor-editor-local editor webローカルローカル接続 | gradeditor ローカル検証時の editor callback です。 | ローカル | http://127.0.0.1:5274/auth/callback | 開く |
gradeditor-viewer viewer web本番callback未確定 | gradeditor Pages URL 確定後に callback を設定します。 | 本番 | 未設定 | ブラウザ導線なし |
gradeditor-viewer-staging viewer webstagingcallback未確定 | gradeditor staging URL 確定後に callback を設定します。 | staging | 未設定 | ブラウザ導線なし |
gradeditor-viewer-local viewer webローカルローカル接続 | gradeditor ローカル検証時の viewer callback です。 | ローカル | http://127.0.0.1:5275/auth/callback | 開く |
webauth-admin web本番internal | 管理画面 この管理画面自身の callback 設定です。 | 本番 | https://webauth.doronko.jp/auth/callback | 開く |
webauth-admin-local webローカルローカル接続 | 管理画面 ローカル Astro の callback です。 | ローカル | http://localhost:4321/auth/callback | 開く |
newjwri service登録のみcallback未設定 | 外部連携 service id は許可済みですが、callback はまだ未設定です。 | 登録のみ | 未設定 | ブラウザ導線なし |
support service登録のみcallback未設定 | 外部連携 service id は許可済みですが、callback はまだ未設定です。 | 登録のみ | 未設定 | ブラウザ導線なし |
cms service登録のみcallback未設定 | 外部連携 service id は許可済みですが、callback はまだ未設定です。 | 登録のみ | 未設定 | ブラウザ導線なし |
運用メモGuide Summary
このページの役割
外部サービス連携の現在地を、コードや env を見に行かず把握できるようにします。
header のグローバルメニューは、ここで定義した browser で開ける service だけを出します。
callback 未設定の service は接続準備中として扱い、ここで欠落を見つけられるようにしています。
詳細仕様は repo の `docs/AUTH_SERVICE_INTEGRATION_GUIDE.md` を正本にしつつ、この画面では運用に必要な要点を再配置します。
Required Env
必須環境変数
WEBAUTH 側で最低限そろえる env の一覧です。
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETGOOGLE_REDIRECT_URIGOOGLE_WORKSPACE_DOMAINALLOWED_CLIENT_SERVICESSERVICE_CALLBACK_URLSOAUTH_STATE_SECRET
Integration Request
連携前に必要な依頼
外部サービス実装を始める前に、WEBAUTH 運用側で先にそろえる項目です。
- 1ALLOWED_CLIENT_SERVICES に自サービスIDを追加する
- 2SERVICE_CALLBACK_URLS に callback URL を登録する
- 3Google Workspace の対象メールが許可ドメインに属していることを確認する
- 4本番とローカルは <service> / <service>-local を分けて登録する
- 5ローカル接続でも callback 先 URL を必ず登録する
Browser Flow
ブラウザログインの流れ
外部サービスが Google Workspace ログインを委譲するときの標準フローです。
- 1外部サービスのログインボタンから GET /auth/start?service={service} へ遷移する
- 2WEBAUTH が Google 認可画面へ 302 リダイレクトする
- 3Google 認証後に GET /auth/callback/google が実行される
- 4WEBAUTH が callback URL へ token 付きで 302 リダイレクトする
- 5外部サービス callback で access token / refresh token を保存する
API ContractNo Store
主要エンドポイント
外部サービス実装で最初に参照する API を抜粋しています。
| endpoint | 用途 | cache |
|---|---|---|
| GET /auth/start | OAuth 開始。service ごとに Google 認可画面へ接続します。 | no-store |
| POST /sessions/exchange | identityId と clientService から access token / refresh token を発行します。 | no-store |
| POST /sessions/verify | Opaque session の有効性確認に利用します。 | no-store |
| POST /sessions/revoke | 発行済み session を失効させます。 | no-store |
| GET /me | 本人情報と共通権限を確認します。施設スコープは含みません。 | no-store |
| GET /facility-access/effective-scope | service ごとの有効施設スコープを取得する正本 API です。 | no-store |