Question 1

GitHubのGatekeeper接続が、接続からちょうど8時間後に「Bad credentials」で失敗する場合、どうすれば修正できますか？

Accepted Answer

これは、GitHubが8時間後に期限切れになるアクセストークンを発行し、リフレッシュトークンを提供するようになったため、新しいGitHub OAuthアプリに影響します。古いバージョンの`gatekeeper-github`はアクセストークンのみを保存し、`refresh_token`を破棄していたため、期限切れ後に呼び出しが失敗していました。

即時の回避策:
1. GitHubで、**Settings → Developer settings → OAuth Apps → 対象のアプリを選択 → Optional features**に移動します。
2. **expiring user tokens**をオプトアウトします。
3. 影響を受ける各ユーザーに、GitHubアカウントを一度**Disconnect**してから**Connect**してもらいます。オプトアウト前に発行されたトークンは引き続き期限切れになります。

恒久的な修正: issue #641の修正を含むリリースに`gatekeeper-github`をアップグレードしてください。この修正では、`refresh_token`とトークンの有効期限を永続化し、`grant_type=refresh_token`を指定した`POST https://github.com/login/oauth/access_token`を使用して期限切れ前にリフレッシュを行い、GitHubがローテーションしたトークンペアをアトミックに保存し、同時実行されるリフレッシュを直列化し、GitHubが`bad_refresh_token`を返した場合に再接続を促します。`expires_in`を持たないOAuthアプリは、従来どおり期限切れのない動作を維持します。

Question 2

Windows で workshop-frontend build や pnpm lint を実行した際に発生する「Failed to find executable rm」エラーを修正するにはどうすればよいですか？

Accepted Answer

Vite+ の `clean:dist` タスクは POSIX 専用の `rm` バイナリを直接呼び出すため、Windows ではそれを見つけることができません。`packages/workshop-frontend/vite.config.ts` で、`command: 'rm -rf dist'` を Node.js 組み込みのファイルシステム削除機能に置き換えてください:

```js
'clean:dist': {
  command: `node -e "require('node:fs').rmSync('dist', { recursive: true, force: true })"`,
  cache: false,
}
```

または、`fs.rmSync(..., { recursive: true, force: true })` を使用する PR #373 (`c0ccaa1`) を含むリビジョンに更新してください。その後、`pnpm exec vp run -F @gadgets/workshop-frontend --no-cache build` または `pnpm lint` を再実行してください。

Question 3

期待されるパスに '/' が使用され、実際のパスに '\' が使用されることが原因で Windows 上で発生する、バンドルされた blueprint テストの失敗を修正するにはどうすればよいですか？

Accepted Answer

実装は正しい。テストが POSIX のパス区切り文字をハードコードしている。Windows では、Node の `readlinkSync()` と `path.relative()` はバックスラッシュ区切りのパスを返す。`scripts/build-bundled-blueprints.test.ts` を修正し、アサーションをプラットフォームに対応させる。シンボリックリンクのターゲットを `path.normalize("../NOTES.md")` と比較し、エラーメッセージの正規表現をどちらの区切り文字にもマッチするように変更する。たとえば `/ignored by Git: example[\/]files[\/]dist[\/]client\.js/` や `/ignored by Git: example[\/]blueprint\.json/` のようにする。その後、`pnpm --filter @gadgets/scripts test` を実行する。これは PR #653 の修正であり、Windows 11 と Ubuntu/WSL 上の Node 24.18.0 で検証済みである。一時的な回避策として、WSL 上でテストを実行する。別件の `gatekeeper-google` の失敗は無関係であり、`core.symlinks=false` の場合に Git for Windows がシンボリックリンクを通常ファイルとしてチェックアウトすることが原因である。

Question 4

リフレッシュトークンが正常に動作しているにもかかわらず、なぜ Confluence ゲートキーパーは1時間後に「Credentials expired」と表示するのですか？

Accepted Answer

Confluence ゲートキーパーは、有効期間の短い Atlassian アクセストークンの 1 時間の有効期限を、認証情報全体の有効期限として記録します。その時間が経過すると、getAccessToken() がローテーションするリフレッシュトークンを透過的に利用できるにもかかわらず、UI はアカウントを期限切れとして表示します。これを修正するには、packages/gatekeeper-confluence/src/confluence.ts を編集し、callback.complete()、callback.reconnectComplete()、callback.credentialsRestored() から expiresAt/new Date(grant.expiresAt) 引数を削除してください。通常のリフレッシュパスと、リフレッシュが実際に失敗した場合にのみ送信される明示的な credentialsExpired() シグナルに依存させます。パッチが適用されるまでは、既存の Confluence バインディングを使用するとリフレッシュがトリガーされ、期限切れ状態が一時的に解除されます。再接続でも解消できますが、1 時間後にメッセージが再び表示されます。

Question 5

15.0より古いセルフホストのGitLabに接続する際に、「GitLab OAuth token response was incomplete」エラーを修正するにはどうすればよいですか？

Accepted Answer

これは、GitLab 13.3 など、15.0 より前のセルフホスト版 GitLab で発生します。有効期限のない OAuth トークンは `expires_in` を省略するためです。GitLab gatekeeper は、このフィールドを必須として扱ってはいけません。

`expires_in` がオプションになるようトークン交換の処理を修正してください。省略されている場合は `expiresAt` を空/undefined のままにします。credentials kit はこれを、リフレッシュが不要なトークンとして扱います。

```js
if (typeof tokenResponse.expires_in === "number") {
  credentials.expiresAt = new Date(
    Date.now() + tokenResponse.expires_in * 1000
  ).toISOString();
} else {
  credentials.expiresAt = undefined; // GitLab < 15.0: token does not expire
}
```

必須とすべきなのは `access_token` のみです。Cloudflare OS をリビルドして再デプロイし、必要に応じて失敗した GitLab 接続を削除してから、OAuth 経由で再接続してください。あるいは、GitLab を 15.0 以降にアップグレードするか、上記の修正を含むリリースを使用してください。

cloudflare-os

概要

README プレビュー

FAQ (5)

同类型项目

vscode

FreeDomain

stable-diffusion-webui

paperclip