Коротка відповідь
Розширення є public OAuth-client: secret пакета читається й не доводить confidential-client. Використовуйте provider code-flow із PKCE, minimal scopes, точним redirect і дією користувача. Chrome identity дає browser-handling; provider визначає протокол.
OAuth надає доступ, не автоматичну login-identity. Для входу потрібен підтримуваний identity-протокол і валідація. Локальний інструмент без account не має отримати OAuth зі стартера.
Практичні кроки реалізації
Виберіть документований потік
Для Google оцініть getAuthToken і manifest. Для іншого provider — launchWebAuthFlow і redirect відповідного ID. Dev і store IDs різні; перевірте release-реєстрацію. Interactive лише після зрозумілої дії, не при кожному popup.
Пов’яжіть транзакцію
Створіть випадкові state і PKCE-verifier кожній спробі. Надішліть S256, збережіть лише pending-строк. Перевірте state й точний redirect origin/path до exchange. Приберіть stale й duplicate; не логуйте code, verifier, tokens чи callback.
Трактуйте tokens як capabilities
Токени короткі, мінімальні й недоступні scripts. Refresh відповідає public-client-policy із rotation чи reauthorization. Розрізняйте expiry/revocation і network, уникайте refresh-loop. Очищення Chrome-cache й provider-revoke різні.
Покажіть consent і account-change
Поясніть service, scopes і функцію. Дайте disconnect та deletion account-data. Кеш прив’язуйте account, щоб не показати старий після switch. Новий flow потребує privacy й store-review.
Приклад реалізації
Helper створює verifier і challenge умовного flow, не exchange чи verify. Verifier приватний pending, endpoint отримує challenge.
function base64url(bytes) {
return btoa(String.fromCharCode(...bytes))
.replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
}
async function createPkce() {
const verifier = base64url(crypto.getRandomValues(new Uint8Array(32)));
const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(verifier));
return { verifier, challenge: base64url(new Uint8Array(digest)), method: "S256" };
}
Повний flow має перевірений SDK чи layer під CSP і remote-code. Helper лише PKCE; state, redirect, errors, timeout і account лишаються потрібними.
Компроміси та альтернативи
Backend-flow тримає server-credentials і дає вузьку session, додаючи infrastructure. Direct public-client залежить від provider і browser. Обирайте за ресурсом і revocation, не для приховування bundled-secret.
Поширені помилки
- Client-secret у пакеті.
- Будь-який callback із code.
- Відсутні state чи PKCE.
- Tokens scripts.
- Cache-remove як revoke.
Контрольний список перед випуском
- Provider підтримує public-client.
- Redirect та ID правильні.
- State, PKCE, expiry і duplicates оброблено.
- Interactive після user-action.
- Tokens trusted без logs.
- Disconnect і privacy перевірено.
Поширені запитання
Чи client ID секретний?
Ні. Він визначає client. Confidential-secret є іншим credential, не секретним у пакеті.
Чи silent завжди усуває prompt?
Ні. Consent, account, expiry і policy можуть потребувати дії. Дайте reconnect, не повторюйте unsolicited-flow.
Висновок
OAuth — повна transaction і lifecycle. Перевірте provider, redirects, PKCE/state й дайте reconnect/disconnect. Пакет не confidential-client.
Первинні джерела
Пов’язані посібники та приклади
Потрібно реалізувати це у вашому продукті?
Інструменти браузера з чіткою метою, обґрунтованими дозволами та підтримуваною архітектурою Manifest V3.