GitHub App installation token mới vẫn bắt đầu bằng ghs_, nhưng độ dài đã tăng từ 40 lên khoảng 520 ký tự. Nếu integration từng đóng đinh chiều dài vào regex, cột dữ liệu, proxy hoặc bộ che log, lỗi có thể chỉ xuất hiện khi token mới đi qua đúng lớp đó.
Rollout stateless đã hoàn tất từ ngày 02/10/2026. Mốc 30/11 không phải ngày token hết hạn; đó là lúc GitHub ngừng tôn trọng header tạm dùng để yêu cầu format mới. Trước deadline, việc đáng làm là đi theo đường đi của credential, kiểm từng điểm chạm và bỏ mọi giả định về nội dung bên trong token.
Mục lục [Hiển thị]
Điều gì đổi, điều gì vẫn giữ nguyên?
Theo GitHub Changelog ngày 02/10, token mới có dạng stateless ghs_APPID_JWT, vẫn giữ prefix ghs_ nhưng dài khoảng 520 ký tự thay vì 40. GitHub cũng nói rõ chiều dài có thể thay đổi theo dữ liệu được mang bên trong; vì vậy con số 520 nên được xem là kích thước cần hỗ trợ, không phải một contract để viết regex mới.
Thông báo format ban đầu còn nhấn mạnh phần JWT do issuer nội bộ của GitHub ký và client không nên tự xác minh hoặc phụ thuộc vào payload. Nói gọn: application nhận một opaque string, giữ an toàn, gửi lại đúng chỗ rồi quên chuyện “đọc ruột” nó.
| Thuộc tính | Trước rollout | Sau rollout |
|---|---|---|
| Prefix | ghs_ | Vẫn là ghs_ |
| Độ dài thường gặp | 40 ký tự | Khoảng 520 ký tự, có thể thay đổi |
| Permission và repository scope | Theo quyền installation | Không đổi |
| Thời hạn | Một giờ | Không đổi |
| REST endpoint tạo token | POST /app/installations/{id}/access_tokens | Không đổi |
Tài liệu tạo installation access token xác nhận response vẫn gồm thời điểm hết hạn, permission và repository được phép truy cập; token hết hạn sau một giờ. Thay đổi representation không tự mở rộng quyền và cũng không biến token thành credential sống lâu.
Đi theo đường đi của token để tìm chỗ vỡ
Một integration thường không chuyển thẳng token từ GitHub sang request kế tiếp. Chuỗi này có thể đi qua object trả về từ SDK, serializer, database hoặc secret store, environment variable, HTTP client, reverse proxy, middleware và cuối cùng là log. Chỉ cần một lớp giữ giả định cũ là request có thể thành 401, 431 hoặc tệ hơn: vẫn chạy nhưng làm lộ phần đuôi credential trong log.
Audit hiệu quả hơn nếu chia theo bốn lớp:
- Storage: tìm
VARCHAR(40),VARCHAR(255), inputmaxlength, schema validator và serializer có cắt chuỗi. - Validation: tìm regex exact-length, code parse JWT hoặc nhánh logic phân loại token bằng số ký tự.
- Transport: kiểm wrapper tự dựng, gateway, proxy, middleware và giới hạn header; đừng chỉ nhìn HTTP client chuẩn.
- Redaction: kiểm structured log, exception context, HTTP debug và masker chỉ nhận pattern legacy.
Đừng search mỗi chuỗi ghs_. Các giả định có thể nằm dưới tên chung như access_token, authorization, credential hoặc một field database dùng chung cho nhiều provider. Nếu CI có fixture regression, bài GitHub Actions lockfile: Pin dependency thế nào? là ví dụ gần về cách giữ input lặp lại được, còn bài GitHub Package Firewall bổ sung góc kiểm soát boundary trước khi dependency đi vào workflow.
Fixture synthetic kiểm được gì?
Fixture của bài chỉ tạo hai chuỗi giả trong bộ nhớ: một chuỗi dài 40 ký tự và một chuỗi dài 520 ký tự. Chúng không phải credential hợp lệ, không được gửi tới GitHub và không được ghi nguyên chuỗi vào report hoặc ảnh. Evidence chỉ giữ length, prefix đã che và 12 ký tự đầu của SHA-256 để đối chiếu round-trip.
const legacySynthetic = `ghs_${'A'.repeat(36)}`;
const statelessSynthetic = `ghs_${'B'.repeat(516)}`;
// Pattern cũ chỉ dùng làm control để chứng minh failure mode.
const legacyExactPattern = /^ghs_[A-Za-z0-9]{36}$/;
console.log(legacyExactPattern.test(legacySynthetic)); // true
console.log(legacyExactPattern.test(statelessSynthetic)); // false

Trên Node.js 24.19.0, Windows x64, cả hai chuỗi round-trip nguyên vẹn qua SQLite TEXT, JSON và environment variable của fixture. Local HTTP server nhận đủ token dài 40 và 520 ký tự; tổng chiều dài header Authorization: Bearer … lần lượt là 47 và 527 byte.
Kết quả này là positive control của code local, không phải giấy chứng nhận cho Nginx, CDN, API gateway, secret store hay schema production. Mỗi hệ thống có giới hạn và wrapper riêng. Chỗ đáng lấy từ fixture là cách đo: so length và digest ở từng đầu mà không echo credential ra log.
Regex và log redaction là hai bẫy khác nhau
Regex exact-length có thể chặn token mới ngay từ đầu. Cách sửa đúng không phải đổi {36} thành một con số lớn hơn rồi tiếp tục coi format là contract. Nếu cần sanity check ở boundary, chỉ kiểm kiểu dữ liệu, chuỗi không rỗng và giới hạn tổng quát đủ an toàn cho hệ thống; authentication thực sự phải để GitHub quyết định.
Redaction còn nguy hiểm hơn vì lỗi không nhất thiết làm request fail. Trong fixture, pattern legacy che 36 ký tự sau prefix của chuỗi 520 nhưng để phần đuôi xuất hiện. Một dashboard nhìn thoáng qua vẫn thấy chữ [REDACTED], trong khi credential chưa được che hết. Đây là kiểu “trông có vẻ ổn” dễ tới công chuyện.

Cách chắc hơn là đăng ký đúng secret value vừa nhận để logger thay toàn bộ chuỗi, đồng thời giữ detector theo token type/prefix như một lớp phụ có boundary rõ ràng. Hãy test cả log JSON, exception, retry message, HTTP trace và alert gửi ra dịch vụ khác. GitHub App best practices khuyến nghị lưu token bằng cơ chế dành cho secret, giới hạn permission và repository, đồng thời có logging/monitoring phù hợp; logging không đồng nghĩa với ghi credential.
Storage và transport nên sửa theo contract nào?
Với storage, mục tiêu là không cắt chuỗi và không biến chiều dài hiện tại thành validation rule mới. Nếu buộc phải lưu installation token, dùng loại dữ liệu đủ rộng và mã hóa ở backend; nhiều integration có thể giữ token trong memory/cache đến khi hết hạn thay vì biến nó thành record sống lâu. Trước migration, kiểm cả column, ORM cast, form quản trị, message queue, cache và export job.
Với transport, hãy gửi token qua header chuẩn mà SDK hoặc HTTP client hỗ trợ. Dựng endpoint local chỉ trả length và digest là cách kiểm wrapper mà không phản chiếu secret. Sau đó chạy qua cùng proxy/gateway với production trong môi trường an toàn, quan sát mã 401, 431, header truncation và log. Một lần request thành công ở localhost không chứng minh chuỗi sẽ sống sót qua toàn bộ hạ tầng.
Nếu đang dùng X-GitHub-Stateless-S2S-Token để ép format mới, hãy coi đó là giàn giáo tạm. Changelog yêu cầu gỡ header khỏi production trước 30/11/2026; sau mốc này GitHub không còn tôn trọng nó và các app đủ điều kiện luôn nhận token stateless. Không nên biến header thành feature flag vĩnh viễn hoặc rollback về token 40 ký tự.
Checklist rollout trước ngày 30/11
- Inventory đường đi: ghi token được tạo ở đâu, đi qua service nào, lưu tạm ở đâu và những log nào có thể chạm vào nó.
- Chạy fixture synthetic: kiểm cả 40 và 520 ký tự; report chỉ giữ length, digest rút gọn và PASS/FAIL.
- Sửa schema và validation: bỏ exact-length, kiểm round-trip sau migration và giữ rollback cho schema/code chứ không rollback assumption.
- Kiểm redaction: dùng giá trị secret được cấp, test structured log, exception và HTTP debug; chạy secret scan trên artifact.
- Canary qua hạ tầng thật: theo dõi 401, 431, truncation và lỗi parser ở proxy/middleware, nhưng không tăng log level theo cách làm lộ header.
- Gỡ header tạm: chỉ làm sau khi hai format đi hết pipeline, rồi giữ regression test cho wrapper xung quanh SDK.
Permission và secret handling vẫn cần được review độc lập. Bài GitHub Actions chặn workflow đáng ngờ đi sâu hơn vào token permission, checkout và trust boundary của workflow; thay đổi độ dài token không làm các lớp đó tự an toàn hơn.
Ai cần hành động ngay?
Ưu tiên cao nhất là integration có schema hoặc regex tự viết, proxy/gateway tùy biến, wrapper tự serialize token và hệ thống log tự redact theo pattern legacy. Nếu dùng SDK chuẩn, vẫn nên audit phần bao quanh SDK: nơi token được cache, truyền qua process khác, đưa vào request và ghi lỗi.
Kết luận ngắn là đừng “nâng giới hạn lên 520 rồi xong”. Hãy coi token là opaque credential có chiều dài thay đổi, kiểm toàn bộ pipeline bằng chuỗi synthetic và giữ evidence không chứa secret. Làm vậy trước 30/11 sẽ giúp gỡ header tạm trong trạng thái chủ động, thay vì chờ một request 401 hoặc log leak mới bắt đầu lần đường.