IHOR.DEVБАЗА_ЗНАНЬ
МЕНЮ

~/blog / Безпека / oauth-authentication-in-chrome-extensions.md

// посібник · 3 хв читання

Автентифікація OAuth у розширеннях Chrome

Проєктуйте OAuth розширення за public-client code-flow, PKCE, перевіреним redirect, мінімальними scopes, явною дією й lifecycle токенів.

Коротка відповідь

Розширення є 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 різні.

Поясніть 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.

Первинні джерела

Пов’язані посібники та приклади

Ігор Харчишин

Незалежний full-stack інженер продуктів, який пише посібники з реалізації розширень браузера та сучасних вебпродуктів на основі першоджерел.

Потрібно реалізувати це у вашому продукті?

Інструменти браузера з чіткою метою, обґрунтованими дозволами та підтримуваною архітектурою Manifest V3.