diff --git a/_data/locales/default/ach.json b/_data/locales/default/ach.json new file mode 100644 index 000000000..65b1077d4 --- /dev/null +++ b/_data/locales/default/ach.json @@ -0,0 +1,12 @@ +{ + "clickHere": "crwdns342:0crwdne342:0", + "viewInLang": "crwdns344:0crwdne344:0", + "unlocalized": "crwdns346:0crwdne346:0", + "translate": "crwdns348:0crwdne348:0", + "translate-long": "crwdns350:0crwdne350:0", + "edit": "crwdns352:0crwdne352:0", + "warning": "crwdns354:0crwdne354:0", + "outdated-warn-1": "crwdns356:0crwdne356:0", + "outdated-warn-2": "crwdns358:0crwdne358:0", + "outdated-warn-3": "crwdns360:0crwdne360:0" +} diff --git a/_data/locales/default/ar.json b/_data/locales/default/ar.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/ar.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/bg.json b/_data/locales/default/bg.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/bg.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/ca.json b/_data/locales/default/ca.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/ca.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/cs.json b/_data/locales/default/cs.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/cs.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/da.json b/_data/locales/default/da.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/da.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/de.json b/_data/locales/default/de.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/de.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/el.json b/_data/locales/default/el.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/el.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/es.json b/_data/locales/default/es.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/es.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/fa.json b/_data/locales/default/fa.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/fa.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/fi.json b/_data/locales/default/fi.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/fi.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/fr.json b/_data/locales/default/fr.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/fr.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/he.json b/_data/locales/default/he.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/he.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/hu.json b/_data/locales/default/hu.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/hu.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/id.json b/_data/locales/default/id.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/id.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/it.json b/_data/locales/default/it.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/it.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/ja.json b/_data/locales/default/ja.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/ja.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/ko.json b/_data/locales/default/ko.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/ko.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/nl.json b/_data/locales/default/nl.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/nl.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/no.json b/_data/locales/default/no.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/no.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/pl.json b/_data/locales/default/pl.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/pl.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/pt.json b/_data/locales/default/pt.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/pt.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/pt_BR.json b/_data/locales/default/pt_BR.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/pt_BR.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/ro.json b/_data/locales/default/ro.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/ro.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/ru.json b/_data/locales/default/ru.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/ru.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/si.json b/_data/locales/default/si.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/si.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/sr.json b/_data/locales/default/sr.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/sr.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/sv.json b/_data/locales/default/sv.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/sv.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/tr.json b/_data/locales/default/tr.json new file mode 100644 index 000000000..451313d55 --- /dev/null +++ b/_data/locales/default/tr.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Buraya tıklayın", + "viewInLang": "to view this page in English.", + "unlocalized": "Yerelleştirilmemiş", + "translate": "Translate", + "translate-long": "Bu sayfayı çevir", + "edit": "Düzenle", + "warning": "Uyarı", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/uk.json b/_data/locales/default/uk.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/uk.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/vi.json b/_data/locales/default/vi.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/vi.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/zh_CN.json b/_data/locales/default/zh_CN.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/zh_CN.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/default/zh_TW.json b/_data/locales/default/zh_TW.json new file mode 100644 index 000000000..5f143e2f9 --- /dev/null +++ b/_data/locales/default/zh_TW.json @@ -0,0 +1,12 @@ +{ + "clickHere": "Click here", + "viewInLang": "to view this page in English.", + "unlocalized": "Unlocalized", + "translate": "Translate", + "translate-long": "Translate this page", + "edit": "Edit", + "warning": "Warning", + "outdated-warn-1": "The translations for this page are outdated. The", + "outdated-warn-2": "English version of this page", + "outdated-warn-3": "has more up-to-date information." +} diff --git a/_data/locales/sidebar/ach.yml b/_data/locales/sidebar/ach.yml new file mode 100644 index 000000000..f16d565d2 --- /dev/null +++ b/_data/locales/sidebar/ach.yml @@ -0,0 +1,32 @@ +--- +sections: + - + title: crwdns362:0crwdne362:0 + docs: + - + title: crwdns366:0crwdne366:0 + stub: crwdns368:0crwdne368:0 + - + title: crwdns370:0crwdne370:0 + stub: crwdns372:0crwdne372:0 + - + title: crwdns374:0crwdne374:0 + stub: crwdns376:0crwdne376:0 + - + title: crwdns378:0crwdne378:0 + docs: + - + title: crwdns382:0crwdne382:0 + stub: crwdns384:0crwdne384:0 + - + title: crwdns386:0crwdne386:0 + stub: crwdns388:0crwdne388:0 + - + title: crwdns390:0crwdne390:0 + stub: crwdns392:0crwdne392:0 + - + title: crwdns394:0crwdne394:0 + stub: crwdns396:0crwdne396:0 + - + title: crwdns398:0crwdne398:0 + stub: crwdns400:0crwdne400:0 diff --git a/_data/locales/sidebar/ar.yml b/_data/locales/sidebar/ar.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/ar.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/bg.yml b/_data/locales/sidebar/bg.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/bg.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/ca.yml b/_data/locales/sidebar/ca.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/ca.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/cs.yml b/_data/locales/sidebar/cs.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/cs.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/da.yml b/_data/locales/sidebar/da.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/da.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/de.yml b/_data/locales/sidebar/de.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/de.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/el.yml b/_data/locales/sidebar/el.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/el.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/es.yml b/_data/locales/sidebar/es.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/es.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/fa.yml b/_data/locales/sidebar/fa.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/fa.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/fi.yml b/_data/locales/sidebar/fi.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/fi.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/fr.yml b/_data/locales/sidebar/fr.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/fr.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/he.yml b/_data/locales/sidebar/he.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/he.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/hu.yml b/_data/locales/sidebar/hu.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/hu.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/id.yml b/_data/locales/sidebar/id.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/id.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/it.yml b/_data/locales/sidebar/it.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/it.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/ja.yml b/_data/locales/sidebar/ja.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/ja.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/ko.yml b/_data/locales/sidebar/ko.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/ko.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/nl.yml b/_data/locales/sidebar/nl.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/nl.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/no.yml b/_data/locales/sidebar/no.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/no.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/pl.yml b/_data/locales/sidebar/pl.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/pl.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/pt.yml b/_data/locales/sidebar/pt.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/pt.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/pt_BR.yml b/_data/locales/sidebar/pt_BR.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/pt_BR.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/ro.yml b/_data/locales/sidebar/ro.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/ro.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/ru.yml b/_data/locales/sidebar/ru.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/ru.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/si.yml b/_data/locales/sidebar/si.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/si.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/sr.yml b/_data/locales/sidebar/sr.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/sr.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/sv.yml b/_data/locales/sidebar/sv.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/sv.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/tr.yml b/_data/locales/sidebar/tr.yml new file mode 100644 index 000000000..c81605a31 --- /dev/null +++ b/_data/locales/sidebar/tr.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Genel Görünüm + docs: + - + title: Kimlik Doğrulayıcı Uzantısı nedir? + stub: genel görünüm + - + title: Hızlı Başlangıç + docs: + - + title: İlk Hesabınızı Ekleyin + stub: hızlı başlangıç + - + title: Export and Import Backups + stub: export-and-import + - + title: Tarayıcı Sayfaları + docs: + - + title: Chrome + stub: chrome-sorunları + - + title: Firefox + stub: firefox-sorunları + - + title: Edge + stub: edge-sorunları + - + title: Ek bilgi + docs: + - + title: Kayıp Kodlar + stub: kayıp-kodlar + - + title: Hesap Türleri + stub: hesap-türleri + - + title: Hata Ayıklama Bilgilerini Alma + stub: hata ayıklama-bilgisi + - + title: Standart Yedekleme Formatı + stub: otp-yedeklemesi + - + title: Politika Yapılandırması + stub: politika-yapılandırması diff --git a/_data/locales/sidebar/uk.yml b/_data/locales/sidebar/uk.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/uk.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/vi.yml b/_data/locales/sidebar/vi.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/vi.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/zh_CN.yml b/_data/locales/sidebar/zh_CN.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/zh_CN.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/_data/locales/sidebar/zh_TW.yml b/_data/locales/sidebar/zh_TW.yml new file mode 100644 index 000000000..f14d55f61 --- /dev/null +++ b/_data/locales/sidebar/zh_TW.yml @@ -0,0 +1,47 @@ +--- +sections: + - + title: Overview + docs: + - + title: What is Authenticator Extension? + stub: overview + - + title: Quickstarts + docs: + - + title: Add Your First Account + stub: quickstart + - + title: Export and Import Backups + stub: export-and-import + - + title: Browser Pages + docs: + - + title: Chrome + stub: chrome-issues + - + title: Firefox + stub: firefox-issues + - + title: Edge + stub: edge-issues + - + title: Additional Info + docs: + - + title: Lost Codes + stub: lost-codes + - + title: Account Types + stub: account-types + - + title: Getting Debugging Information + stub: debug-info + - + title: Standard Backup Format + stub: otp-backup + - + title: Policy Configuration + stub: policy-config diff --git a/docs/ach/account-types.md b/docs/ach/account-types.md new file mode 100644 index 000000000..a0448b174 --- /dev/null +++ b/docs/ach/account-types.md @@ -0,0 +1,13 @@ +--- +title: crwdns402:0crwdne402:0 +stub: crwdns404:0crwdne404:0 +lang: crwdns406:0crwdne406:0 +ver: crwdns408:0crwdne408:0 +--- + +| crwdns410:0crwdne410:0 | crwdns412:0crwdne412:0 | +| ---------------------- | ---------------------------------------- | +| crwdns414:0crwdne414:0 | crwdns416:0crwdne416:0 | +| crwdns418:0crwdne418:0 | crwdns420:0crwdne420:0 | +| crwdns422:0crwdne422:0 | crwdns424:0crwdne424:0 | +| crwdns426:0crwdne426:0 | crwdns428:0%27scrwdnd428:0%27crwdne428:0 | crwdns430:0{: .table .table-striped}crwdne430:0 \ No newline at end of file diff --git a/docs/ach/chrome-issues.md b/docs/ach/chrome-issues.md new file mode 100644 index 000000000..271e06eb9 --- /dev/null +++ b/docs/ach/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: crwdns432:0crwdne432:0 +stub: crwdns434:0crwdne434:0 +lang: crwdns436:0crwdne436:0 +ver: crwdns438:0crwdne438:0 +--- + +crwdns440:0crwdne440:0 + +#### crwdns442:0crwdne442:0 crwdns444:0crwdne444:0 + +crwdns446:0crwdne446:0 + +- crwdns448:0crwdne448:0 crwdns450:0crwdne450:0 +- crwdns452:0crwdne452:0 crwdns454:0crwdne454:0 +- crwdns456:0crwdne456:0 crwdns458:0crwdne458:0 \ No newline at end of file diff --git a/docs/ach/debug-info.md b/docs/ach/debug-info.md new file mode 100644 index 000000000..c61d162eb --- /dev/null +++ b/docs/ach/debug-info.md @@ -0,0 +1,54 @@ +--- +title: crwdns460:0crwdne460:0 +stub: crwdns462:0crwdne462:0 +lang: crwdns464:0crwdne464:0 +ver: crwdns466:0crwdne466:0 +--- + +crwdns468:0crwdne468:0 + +- [crwdns472:0crwdne472:0](crwdns470:0crwdne470:0) +- [crwdns476:0crwdne476:0](crwdns474:0crwdne474:0) + +* * * + +## crwdns478:0crwdne478:0 + +1. crwdns480:0crwdne480:0 +2. crwdns482:0crwdne482:0 + +![crwdns486:0crwdne486:0](crwdns484:0crwdne484:0) + +3. crwdns488:0crwdne488:0 + +![crwdns492:0crwdne492:0](crwdns490:0crwdne490:0) + +4. crwdns494:0crwdne494:0 + +![crwdns498:0crwdne498:0](crwdns496:0crwdne496:0) + +* * * + +## crwdns500:0crwdne500:0 + +1. crwdns502:0crwdne502:0 +2. crwdns504:0crwdne504:0 + +![crwdns508:0crwdne508:0](crwdns506:0crwdne506:0) + +3. crwdns510:0crwdne510:0 + +![crwdns514:0crwdne514:0](crwdns512:0crwdne512:0) + +4. crwdns516:0crwdne516:0 + +![crwdns520:0crwdne520:0](crwdns518:0crwdne518:0) + +5. crwdns522:0crwdne522:0 + +![crwdns526:0crwdne526:0](crwdns524:0crwdne524:0) + +6. crwdns528:0crwdne528:0 +7. crwdns530:0crwdne530:0 + +![crwdns534:0crwdne534:0](crwdns532:0crwdne532:0) \ No newline at end of file diff --git a/docs/ach/edge-backup.md b/docs/ach/edge-backup.md new file mode 100644 index 000000000..072fbeba1 --- /dev/null +++ b/docs/ach/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: crwdns536:0crwdne536:0 +stub: crwdns538:0crwdne538:0 +lang: crwdns540:0crwdne540:0 +ver: crwdns542:0crwdne542:0 +--- + +1. crwdns544:0crwdne544:0 + +![crwdns548:0crwdne548:0](crwdns546:0crwdne546:0) + +2. crwdns550:0crwdne550:0 +3. crwdns552:0crwdne552:0 + +```javascript +crwdns554:0crwdne554:0 +``` + +![crwdns558:0crwdne558:0](crwdns556:0crwdne556:0) + +4. crwdns560:0crwdne560:0 + +![crwdns564:0crwdne564:0](crwdns562:0crwdne562:0) + +5. crwdns566:0crwdne566:0 + +![crwdns570:0crwdne570:0](crwdns568:0crwdne568:0) \ No newline at end of file diff --git a/docs/ach/edge-issues.md b/docs/ach/edge-issues.md new file mode 100644 index 000000000..ffed3c642 --- /dev/null +++ b/docs/ach/edge-issues.md @@ -0,0 +1,23 @@ +--- +title: crwdns572:0crwdne572:0 +stub: crwdns574:0crwdne574:0 +lang: crwdns576:0crwdne576:0 +ver: crwdns578:0crwdne578:0 +--- + +crwdns580:0crwdne580:0 + +#### crwdns582:0crwdne582:0 crwdns584:0crwdne584:0 + +crwdns586:0crwdne586:0 + +### crwdns588:0crwdne588:0 + +- crwdns590:0crwdne590:0 crwdns592:0crwdne592:0 crwdns594:0crwdne594:0 +- crwdns596:0crwdne596:0 crwdns598:0crwdne598:0 + +### crwdns600:0crwdne600:0 + +- crwdns602:0crwdne602:0 crwdns604:0crwdne604:0 +- crwdns606:0crwdne606:0 crwdns608:0crwdne608:0 +- crwdns610:0crwdne610:0 crwdns612:0crwdne612:0 \ No newline at end of file diff --git a/docs/ach/firefox-issues.md b/docs/ach/firefox-issues.md new file mode 100644 index 000000000..35edfe2b3 --- /dev/null +++ b/docs/ach/firefox-issues.md @@ -0,0 +1,18 @@ +--- +title: crwdns662:0crwdne662:0 +stub: crwdns884:0crwdne884:0 +lang: crwdns886:0crwdne886:0 +ver: crwdns888:0crwdne888:0 +--- + +crwdns670:0{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %}crwdne670:0 + +### crwdns672:0crwdne672:0 + +- crwdns674:0crwdne674:0 crwdns676:0crwdne676:0 + +### crwdns678:0crwdne678:0 + +- crwdns680:0crwdne680:0 crwdns682:0crwdne682:0 +- crwdns684:0crwdne684:0 crwdns686:0crwdne686:0 +- crwdns688:0crwdne688:0 crwdns690:0crwdne690:0 \ No newline at end of file diff --git a/docs/ach/index.md b/docs/ach/index.md new file mode 100644 index 000000000..9275d72d0 --- /dev/null +++ b/docs/ach/index.md @@ -0,0 +1,7 @@ +--- +title: crwdns692:0crwdne692:0 +stub: crwdns694:0crwdne694:0 +lang: crwdns696:0crwdne696:0 +layout: crwdns698:0crwdne698:0 +--- + diff --git a/docs/ach/lost-codes.md b/docs/ach/lost-codes.md new file mode 100644 index 000000000..6432af25c --- /dev/null +++ b/docs/ach/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: crwdns700:0crwdne700:0 +stub: crwdns702:0crwdne702:0 +lang: crwdns704:0crwdne704:0 +ver: crwdns706:0crwdne706:0 +--- + +crwdns708:0crwdne708:0 crwdns710:0crwdne710:0 + +- crwdns712:0crwdne712:0 crwdns714:0crwdne714:0 +- crwdns716:0crwdne716:0 crwdns718:0crwdne718:0 + +crwdns720:0crwdne720:0 + +### crwdns722:0crwdne722:0 + +- [crwdns726:0crwdne726:0](crwdns724:0crwdne724:0) +- [crwdns730:0crwdne730:0](crwdns728:0crwdne728:0) +- [crwdns734:0crwdne734:0](crwdns732:0crwdne732:0) \ No newline at end of file diff --git a/docs/ach/manual-update.md b/docs/ach/manual-update.md new file mode 100644 index 000000000..b99bb52ee --- /dev/null +++ b/docs/ach/manual-update.md @@ -0,0 +1,26 @@ +--- +title: crwdns736:0crwdne736:0 +stub: crwdns738:0crwdne738:0 +lang: crwdns740:0crwdne740:0 +ver: crwdns742:0crwdne742:0 +--- + +## crwdns744:0crwdne744:0 + +1. crwdns746:0crwdne746:0 + +2. crwdns748:0crwdne748:0 + +3. crwdns750:0crwdne750:0 + +![crwdns754:0crwdne754:0](crwdns752:0crwdne752:0) + +## crwdns756:0crwdne756:0 + +1. crwdns758:0crwdne758:0 + +2. crwdns760:0crwdne760:0 + +3. crwdns762:0crwdne762:0 + +![crwdns766:0crwdne766:0](crwdns764:0crwdne764:0) \ No newline at end of file diff --git a/docs/ach/opera-install.md b/docs/ach/opera-install.md new file mode 100644 index 000000000..c8405202f --- /dev/null +++ b/docs/ach/opera-install.md @@ -0,0 +1,10 @@ +--- +title: crwdns768:0crwdne768:0 +stub: crwdns770:0crwdne770:0 +lang: crwdns772:0crwdne772:0 +ver: crwdns774:0crwdne774:0 +--- + +crwdns776:0crwdne776:0 + +crwdns778:0crwdne778:0 crwdns780:0crwdne780:0 crwdns782:0crwdne782:0 \ No newline at end of file diff --git a/docs/ach/otp-backup-developer.md b/docs/ach/otp-backup-developer.md new file mode 100644 index 000000000..23f4e36b8 --- /dev/null +++ b/docs/ach/otp-backup-developer.md @@ -0,0 +1,18 @@ +--- +title: crwdns784:0crwdne784:0 +stub: crwdns786:0crwdne786:0 +lang: crwdns788:0crwdne788:0 +ver: crwdns790:0crwdne790:0 +--- + +crwdns792:0crwdne792:0 crwdns794:0crwdne794:0 crwdns796:0crwdne796:0 + + crwdns798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdnd798:0%20crwdne798:0 + + +crwdns800:0crwdne800:0 + +- crwdns802:0%3crwdne802:0 +- crwdns804:0crwdne804:0 + +crwdns806:0crwdne806:0 \ No newline at end of file diff --git a/docs/ach/otp-backup.md b/docs/ach/otp-backup.md new file mode 100644 index 000000000..9efd2f0da --- /dev/null +++ b/docs/ach/otp-backup.md @@ -0,0 +1,19 @@ +--- +title: crwdns808:0crwdne808:0 +stub: crwdns810:0crwdne810:0 +lang: crwdns812:0crwdne812:0 +ver: crwdns814:0crwdne814:0 +--- + +crwdns816:0crwdne816:0 crwdns818:0crwdne818:0 + +| crwdns820:0crwdne820:0 | crwdns822:0crwdne822:0 | crwdns824:0crwdne824:0 | +| ------------------------------------------------ | ---------------------- | ---------------------- | +| [crwdns828:0crwdne828:0](crwdns826:0crwdne826:0) | crwdns894:0crwdne894:0 | crwdns832:0crwdne832:0 | +| [crwdns898:0crwdne898:0](crwdns896:0crwdne896:0) | crwdns900:0crwdne900:0 | | crwdns834:0{: .table .table-striped}crwdne834:0 + +crwdns836:0crwdne836:0 + +- [crwdns840:0crwdne840:0](crwdns838:0crwdne838:0) + +[crwdns844:0crwdne844:0](crwdns842:0crwdne842:0) \ No newline at end of file diff --git a/docs/ach/policy-config.md b/docs/ach/policy-config.md new file mode 100644 index 000000000..b5d2149e1 --- /dev/null +++ b/docs/ach/policy-config.md @@ -0,0 +1,34 @@ +--- +title: crwdns846:0crwdne846:0 +stub: crwdns848:0crwdne848:0 +lang: crwdns850:0crwdne850:0 +ver: crwdns852:0crwdne852:0 +--- + +crwdns854:0crwdne854:0 crwdns856:0crwdne856:0 crwdns858:0crwdne858:0 crwdns860:0crwdne860:0 + +#### crwdns862:0crwdne862:0 + +crwdns864:0crwdne864:0 + +crwdns866:0crwdne866:0 + +## crwdns868:0crwdne868:0 + +crwdns870:0crwdne870:0 + +crwdns872:0crwdne872:0 + +```jsonc +crwdns874:0crwdne874:0 +``` + +## crwdns876:0crwdne876:0 + +crwdns878:0crwdne878:0 + +crwdns880:0crwdne880:0 + +```jsonc +crwdns882:0crwdne882:0 +``` \ No newline at end of file diff --git a/docs/ar/account-types.md b/docs/ar/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/ar/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/ar/chrome-issues.md b/docs/ar/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/ar/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ar/debug-info.md b/docs/ar/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/ar/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/ar/edge-backup.md b/docs/ar/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/ar/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/ar/edge-install.md b/docs/ar/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/ar/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/ar/edge-issues.md b/docs/ar/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/ar/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ar/edge-privacy.md b/docs/ar/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/ar/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/ar/export-and-import.md b/docs/ar/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/ar/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/ar/firefox-issues.md b/docs/ar/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/ar/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ar/index.md b/docs/ar/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/ar/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/ar/lost-codes.md b/docs/ar/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/ar/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/ar/manual-update.md b/docs/ar/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/ar/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/ar/onedrive-perms.md b/docs/ar/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/ar/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/ar/opera-install.md b/docs/ar/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/ar/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/ar/otp-backup-developer.md b/docs/ar/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/ar/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/ar/otp-backup.md b/docs/ar/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/ar/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/ar/overview.md b/docs/ar/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/ar/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/ar/policy-config.md b/docs/ar/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/ar/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/ar/quickstart.md b/docs/ar/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/ar/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/bg/account-types.md b/docs/bg/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/bg/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/bg/chrome-issues.md b/docs/bg/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/bg/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/bg/debug-info.md b/docs/bg/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/bg/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/bg/edge-backup.md b/docs/bg/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/bg/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/bg/edge-install.md b/docs/bg/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/bg/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/bg/edge-issues.md b/docs/bg/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/bg/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/bg/edge-privacy.md b/docs/bg/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/bg/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/bg/export-and-import.md b/docs/bg/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/bg/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/bg/firefox-issues.md b/docs/bg/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/bg/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/bg/index.md b/docs/bg/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/bg/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/bg/lost-codes.md b/docs/bg/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/bg/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/bg/manual-update.md b/docs/bg/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/bg/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/bg/onedrive-perms.md b/docs/bg/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/bg/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/bg/opera-install.md b/docs/bg/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/bg/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/bg/otp-backup-developer.md b/docs/bg/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/bg/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/bg/otp-backup.md b/docs/bg/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/bg/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/bg/overview.md b/docs/bg/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/bg/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/bg/policy-config.md b/docs/bg/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/bg/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/bg/quickstart.md b/docs/bg/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/bg/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/ca/account-types.md b/docs/ca/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/ca/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/ca/chrome-issues.md b/docs/ca/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/ca/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ca/debug-info.md b/docs/ca/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/ca/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/ca/edge-backup.md b/docs/ca/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/ca/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/ca/edge-install.md b/docs/ca/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/ca/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/ca/edge-issues.md b/docs/ca/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/ca/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ca/edge-privacy.md b/docs/ca/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/ca/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/ca/export-and-import.md b/docs/ca/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/ca/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/ca/firefox-issues.md b/docs/ca/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/ca/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ca/index.md b/docs/ca/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/ca/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/ca/lost-codes.md b/docs/ca/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/ca/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/ca/manual-update.md b/docs/ca/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/ca/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/ca/onedrive-perms.md b/docs/ca/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/ca/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/ca/opera-install.md b/docs/ca/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/ca/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/ca/otp-backup-developer.md b/docs/ca/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/ca/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/ca/otp-backup.md b/docs/ca/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/ca/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/ca/overview.md b/docs/ca/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/ca/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/ca/policy-config.md b/docs/ca/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/ca/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/ca/quickstart.md b/docs/ca/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/ca/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/cs/account-types.md b/docs/cs/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/cs/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/cs/chrome-issues.md b/docs/cs/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/cs/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/cs/debug-info.md b/docs/cs/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/cs/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/cs/edge-backup.md b/docs/cs/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/cs/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/cs/edge-install.md b/docs/cs/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/cs/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/cs/edge-issues.md b/docs/cs/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/cs/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/cs/edge-privacy.md b/docs/cs/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/cs/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/cs/export-and-import.md b/docs/cs/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/cs/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/cs/firefox-issues.md b/docs/cs/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/cs/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/cs/index.md b/docs/cs/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/cs/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/cs/lost-codes.md b/docs/cs/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/cs/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/cs/manual-update.md b/docs/cs/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/cs/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/cs/onedrive-perms.md b/docs/cs/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/cs/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/cs/opera-install.md b/docs/cs/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/cs/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/cs/otp-backup-developer.md b/docs/cs/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/cs/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/cs/otp-backup.md b/docs/cs/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/cs/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/cs/overview.md b/docs/cs/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/cs/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/cs/policy-config.md b/docs/cs/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/cs/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/cs/quickstart.md b/docs/cs/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/cs/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/da/account-types.md b/docs/da/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/da/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/da/chrome-issues.md b/docs/da/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/da/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/da/debug-info.md b/docs/da/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/da/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/da/edge-backup.md b/docs/da/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/da/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/da/edge-install.md b/docs/da/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/da/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/da/edge-issues.md b/docs/da/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/da/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/da/edge-privacy.md b/docs/da/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/da/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/da/export-and-import.md b/docs/da/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/da/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/da/firefox-issues.md b/docs/da/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/da/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/da/index.md b/docs/da/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/da/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/da/lost-codes.md b/docs/da/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/da/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/da/manual-update.md b/docs/da/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/da/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/da/onedrive-perms.md b/docs/da/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/da/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/da/opera-install.md b/docs/da/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/da/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/da/otp-backup-developer.md b/docs/da/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/da/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/da/otp-backup.md b/docs/da/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/da/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/da/overview.md b/docs/da/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/da/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/da/policy-config.md b/docs/da/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/da/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/da/quickstart.md b/docs/da/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/da/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/de/account-types.md b/docs/de/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/de/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/de/chrome-issues.md b/docs/de/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/de/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/de/debug-info.md b/docs/de/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/de/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/de/edge-backup.md b/docs/de/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/de/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/de/edge-install.md b/docs/de/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/de/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/de/edge-issues.md b/docs/de/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/de/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/de/edge-privacy.md b/docs/de/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/de/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/de/export-and-import.md b/docs/de/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/de/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/de/firefox-issues.md b/docs/de/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/de/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/de/index.md b/docs/de/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/de/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/de/lost-codes.md b/docs/de/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/de/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/de/manual-update.md b/docs/de/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/de/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/de/onedrive-perms.md b/docs/de/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/de/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/de/opera-install.md b/docs/de/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/de/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/de/otp-backup-developer.md b/docs/de/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/de/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/de/otp-backup.md b/docs/de/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/de/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/de/overview.md b/docs/de/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/de/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/de/policy-config.md b/docs/de/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/de/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/de/quickstart.md b/docs/de/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/de/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/el/account-types.md b/docs/el/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/el/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/el/chrome-issues.md b/docs/el/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/el/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/el/debug-info.md b/docs/el/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/el/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/el/edge-backup.md b/docs/el/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/el/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/el/edge-install.md b/docs/el/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/el/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/el/edge-issues.md b/docs/el/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/el/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/el/edge-privacy.md b/docs/el/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/el/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/el/export-and-import.md b/docs/el/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/el/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/el/firefox-issues.md b/docs/el/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/el/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/el/index.md b/docs/el/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/el/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/el/lost-codes.md b/docs/el/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/el/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/el/manual-update.md b/docs/el/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/el/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/el/onedrive-perms.md b/docs/el/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/el/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/el/opera-install.md b/docs/el/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/el/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/el/otp-backup-developer.md b/docs/el/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/el/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/el/otp-backup.md b/docs/el/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/el/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/el/overview.md b/docs/el/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/el/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/el/policy-config.md b/docs/el/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/el/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/el/quickstart.md b/docs/el/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/el/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/es/account-types.md b/docs/es/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/es/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/es/chrome-issues.md b/docs/es/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/es/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/es/debug-info.md b/docs/es/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/es/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/es/edge-backup.md b/docs/es/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/es/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/es/edge-install.md b/docs/es/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/es/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/es/edge-issues.md b/docs/es/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/es/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/es/edge-privacy.md b/docs/es/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/es/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/es/export-and-import.md b/docs/es/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/es/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/es/firefox-issues.md b/docs/es/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/es/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/es/index.md b/docs/es/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/es/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/es/lost-codes.md b/docs/es/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/es/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/es/manual-update.md b/docs/es/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/es/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/es/onedrive-perms.md b/docs/es/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/es/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/es/opera-install.md b/docs/es/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/es/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/es/otp-backup-developer.md b/docs/es/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/es/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/es/otp-backup.md b/docs/es/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/es/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/es/overview.md b/docs/es/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/es/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/es/policy-config.md b/docs/es/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/es/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/es/quickstart.md b/docs/es/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/es/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/fa/account-types.md b/docs/fa/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/fa/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/fa/chrome-issues.md b/docs/fa/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/fa/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fa/debug-info.md b/docs/fa/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/fa/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/fa/edge-backup.md b/docs/fa/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/fa/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/fa/edge-install.md b/docs/fa/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/fa/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/fa/edge-issues.md b/docs/fa/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/fa/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fa/export-and-import.md b/docs/fa/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/fa/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/fa/firefox-issues.md b/docs/fa/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/fa/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fa/index.md b/docs/fa/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/fa/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/fa/lost-codes.md b/docs/fa/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/fa/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/fa/manual-update.md b/docs/fa/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/fa/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/fa/onedrive-perms.md b/docs/fa/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/fa/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/fa/opera-install.md b/docs/fa/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/fa/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/fa/otp-backup-developer.md b/docs/fa/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/fa/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/fa/otp-backup.md b/docs/fa/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/fa/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/fa/overview.md b/docs/fa/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/fa/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/fa/policy-config.md b/docs/fa/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/fa/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/fa/quickstart.md b/docs/fa/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/fa/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/fi/account-types.md b/docs/fi/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/fi/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/fi/chrome-issues.md b/docs/fi/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/fi/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fi/debug-info.md b/docs/fi/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/fi/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/fi/edge-backup.md b/docs/fi/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/fi/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/fi/edge-install.md b/docs/fi/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/fi/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/fi/edge-issues.md b/docs/fi/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/fi/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fi/edge-privacy.md b/docs/fi/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/fi/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/fi/export-and-import.md b/docs/fi/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/fi/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/fi/firefox-issues.md b/docs/fi/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/fi/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fi/index.md b/docs/fi/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/fi/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/fi/lost-codes.md b/docs/fi/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/fi/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/fi/manual-update.md b/docs/fi/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/fi/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/fi/onedrive-perms.md b/docs/fi/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/fi/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/fi/opera-install.md b/docs/fi/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/fi/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/fi/otp-backup-developer.md b/docs/fi/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/fi/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/fi/otp-backup.md b/docs/fi/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/fi/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/fi/overview.md b/docs/fi/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/fi/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/fi/policy-config.md b/docs/fi/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/fi/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/fi/quickstart.md b/docs/fi/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/fi/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/fr/account-types.md b/docs/fr/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/fr/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/fr/chrome-issues.md b/docs/fr/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/fr/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fr/debug-info.md b/docs/fr/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/fr/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/fr/edge-backup.md b/docs/fr/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/fr/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/fr/edge-install.md b/docs/fr/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/fr/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/fr/edge-issues.md b/docs/fr/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/fr/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fr/edge-privacy.md b/docs/fr/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/fr/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/fr/export-and-import.md b/docs/fr/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/fr/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/fr/firefox-issues.md b/docs/fr/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/fr/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/fr/index.md b/docs/fr/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/fr/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/fr/lost-codes.md b/docs/fr/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/fr/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/fr/manual-update.md b/docs/fr/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/fr/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/fr/onedrive-perms.md b/docs/fr/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/fr/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/fr/opera-install.md b/docs/fr/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/fr/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/fr/otp-backup-developer.md b/docs/fr/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/fr/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/fr/otp-backup.md b/docs/fr/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/fr/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/fr/overview.md b/docs/fr/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/fr/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/fr/policy-config.md b/docs/fr/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/fr/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/fr/quickstart.md b/docs/fr/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/fr/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/he/account-types.md b/docs/he/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/he/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/he/chrome-issues.md b/docs/he/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/he/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/he/debug-info.md b/docs/he/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/he/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/he/edge-backup.md b/docs/he/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/he/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/he/edge-install.md b/docs/he/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/he/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/he/edge-issues.md b/docs/he/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/he/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/he/edge-privacy.md b/docs/he/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/he/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/he/export-and-import.md b/docs/he/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/he/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/he/firefox-issues.md b/docs/he/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/he/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/he/index.md b/docs/he/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/he/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/he/lost-codes.md b/docs/he/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/he/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/he/manual-update.md b/docs/he/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/he/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/he/onedrive-perms.md b/docs/he/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/he/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/he/opera-install.md b/docs/he/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/he/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/he/otp-backup-developer.md b/docs/he/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/he/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/he/otp-backup.md b/docs/he/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/he/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/he/overview.md b/docs/he/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/he/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/he/policy-config.md b/docs/he/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/he/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/he/quickstart.md b/docs/he/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/he/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/hu/account-types.md b/docs/hu/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/hu/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/hu/chrome-issues.md b/docs/hu/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/hu/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/hu/debug-info.md b/docs/hu/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/hu/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/hu/edge-backup.md b/docs/hu/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/hu/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/hu/edge-install.md b/docs/hu/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/hu/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/hu/edge-issues.md b/docs/hu/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/hu/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/hu/edge-privacy.md b/docs/hu/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/hu/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/hu/export-and-import.md b/docs/hu/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/hu/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/hu/firefox-issues.md b/docs/hu/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/hu/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/hu/index.md b/docs/hu/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/hu/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/hu/lost-codes.md b/docs/hu/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/hu/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/hu/manual-update.md b/docs/hu/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/hu/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/hu/onedrive-perms.md b/docs/hu/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/hu/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/hu/opera-install.md b/docs/hu/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/hu/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/hu/otp-backup-developer.md b/docs/hu/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/hu/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/hu/otp-backup.md b/docs/hu/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/hu/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/hu/overview.md b/docs/hu/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/hu/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/hu/policy-config.md b/docs/hu/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/hu/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/hu/quickstart.md b/docs/hu/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/hu/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/id/account-types.md b/docs/id/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/id/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/id/chrome-issues.md b/docs/id/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/id/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/id/debug-info.md b/docs/id/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/id/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/id/edge-backup.md b/docs/id/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/id/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/id/edge-install.md b/docs/id/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/id/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/id/edge-issues.md b/docs/id/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/id/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/id/edge-privacy.md b/docs/id/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/id/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/id/export-and-import.md b/docs/id/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/id/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/id/firefox-issues.md b/docs/id/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/id/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/id/index.md b/docs/id/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/id/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/id/lost-codes.md b/docs/id/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/id/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/id/manual-update.md b/docs/id/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/id/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/id/onedrive-perms.md b/docs/id/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/id/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/id/opera-install.md b/docs/id/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/id/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/id/otp-backup-developer.md b/docs/id/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/id/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/id/otp-backup.md b/docs/id/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/id/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/id/overview.md b/docs/id/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/id/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/id/policy-config.md b/docs/id/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/id/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/id/quickstart.md b/docs/id/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/id/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/it/account-types.md b/docs/it/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/it/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/it/chrome-issues.md b/docs/it/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/it/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/it/debug-info.md b/docs/it/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/it/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/it/edge-backup.md b/docs/it/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/it/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/it/edge-install.md b/docs/it/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/it/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/it/edge-issues.md b/docs/it/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/it/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/it/edge-privacy.md b/docs/it/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/it/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/it/export-and-import.md b/docs/it/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/it/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/it/firefox-issues.md b/docs/it/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/it/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/it/index.md b/docs/it/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/it/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/it/lost-codes.md b/docs/it/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/it/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/it/manual-update.md b/docs/it/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/it/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/it/onedrive-perms.md b/docs/it/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/it/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/it/opera-install.md b/docs/it/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/it/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/it/otp-backup-developer.md b/docs/it/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/it/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/it/otp-backup.md b/docs/it/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/it/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/it/overview.md b/docs/it/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/it/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/it/policy-config.md b/docs/it/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/it/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/it/quickstart.md b/docs/it/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/it/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/ja/account-types.md b/docs/ja/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/ja/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/ja/chrome-issues.md b/docs/ja/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/ja/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ja/debug-info.md b/docs/ja/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/ja/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/ja/edge-backup.md b/docs/ja/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/ja/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/ja/edge-install.md b/docs/ja/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/ja/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/ja/edge-issues.md b/docs/ja/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/ja/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ja/edge-privacy.md b/docs/ja/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/ja/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/ja/export-and-import.md b/docs/ja/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/ja/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/ja/firefox-issues.md b/docs/ja/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/ja/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ja/index.md b/docs/ja/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/ja/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/ja/lost-codes.md b/docs/ja/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/ja/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/ja/manual-update.md b/docs/ja/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/ja/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/ja/onedrive-perms.md b/docs/ja/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/ja/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/ja/opera-install.md b/docs/ja/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/ja/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/ja/otp-backup-developer.md b/docs/ja/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/ja/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/ja/otp-backup.md b/docs/ja/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/ja/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/ja/overview.md b/docs/ja/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/ja/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/ja/policy-config.md b/docs/ja/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/ja/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/ja/quickstart.md b/docs/ja/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/ja/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/ko/account-types.md b/docs/ko/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/ko/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/ko/chrome-issues.md b/docs/ko/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/ko/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ko/debug-info.md b/docs/ko/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/ko/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/ko/edge-backup.md b/docs/ko/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/ko/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/ko/edge-install.md b/docs/ko/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/ko/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/ko/edge-issues.md b/docs/ko/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/ko/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ko/edge-privacy.md b/docs/ko/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/ko/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/ko/export-and-import.md b/docs/ko/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/ko/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/ko/firefox-issues.md b/docs/ko/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/ko/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ko/index.md b/docs/ko/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/ko/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/ko/lost-codes.md b/docs/ko/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/ko/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/ko/manual-update.md b/docs/ko/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/ko/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/ko/onedrive-perms.md b/docs/ko/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/ko/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/ko/opera-install.md b/docs/ko/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/ko/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/ko/otp-backup-developer.md b/docs/ko/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/ko/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/ko/otp-backup.md b/docs/ko/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/ko/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/ko/overview.md b/docs/ko/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/ko/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/ko/policy-config.md b/docs/ko/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/ko/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/ko/quickstart.md b/docs/ko/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/ko/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/nl/account-types.md b/docs/nl/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/nl/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/nl/chrome-issues.md b/docs/nl/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/nl/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/nl/debug-info.md b/docs/nl/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/nl/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/nl/edge-backup.md b/docs/nl/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/nl/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/nl/edge-install.md b/docs/nl/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/nl/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/nl/edge-issues.md b/docs/nl/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/nl/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/nl/edge-privacy.md b/docs/nl/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/nl/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/nl/export-and-import.md b/docs/nl/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/nl/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/nl/firefox-issues.md b/docs/nl/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/nl/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/nl/index.md b/docs/nl/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/nl/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/nl/lost-codes.md b/docs/nl/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/nl/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/nl/manual-update.md b/docs/nl/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/nl/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/nl/onedrive-perms.md b/docs/nl/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/nl/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/nl/opera-install.md b/docs/nl/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/nl/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/nl/otp-backup-developer.md b/docs/nl/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/nl/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/nl/otp-backup.md b/docs/nl/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/nl/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/nl/overview.md b/docs/nl/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/nl/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/nl/policy-config.md b/docs/nl/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/nl/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/nl/quickstart.md b/docs/nl/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/nl/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/no/account-types.md b/docs/no/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/no/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/no/chrome-issues.md b/docs/no/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/no/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/no/debug-info.md b/docs/no/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/no/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/no/edge-backup.md b/docs/no/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/no/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/no/edge-install.md b/docs/no/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/no/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/no/edge-issues.md b/docs/no/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/no/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/no/edge-privacy.md b/docs/no/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/no/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/no/export-and-import.md b/docs/no/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/no/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/no/firefox-issues.md b/docs/no/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/no/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/no/index.md b/docs/no/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/no/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/no/lost-codes.md b/docs/no/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/no/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/no/manual-update.md b/docs/no/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/no/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/no/onedrive-perms.md b/docs/no/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/no/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/no/opera-install.md b/docs/no/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/no/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/no/otp-backup-developer.md b/docs/no/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/no/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/no/otp-backup.md b/docs/no/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/no/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/no/overview.md b/docs/no/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/no/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/no/policy-config.md b/docs/no/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/no/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/no/quickstart.md b/docs/no/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/no/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/pl/account-types.md b/docs/pl/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/pl/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/pl/chrome-issues.md b/docs/pl/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/pl/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pl/debug-info.md b/docs/pl/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/pl/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/pl/edge-backup.md b/docs/pl/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/pl/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/pl/edge-install.md b/docs/pl/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/pl/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/pl/edge-issues.md b/docs/pl/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/pl/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pl/edge-privacy.md b/docs/pl/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/pl/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/pl/export-and-import.md b/docs/pl/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/pl/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/pl/firefox-issues.md b/docs/pl/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/pl/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pl/index.md b/docs/pl/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/pl/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/pl/lost-codes.md b/docs/pl/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/pl/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/pl/manual-update.md b/docs/pl/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/pl/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/pl/onedrive-perms.md b/docs/pl/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/pl/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/pl/opera-install.md b/docs/pl/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/pl/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/pl/otp-backup-developer.md b/docs/pl/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/pl/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/pl/otp-backup.md b/docs/pl/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/pl/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/pl/overview.md b/docs/pl/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/pl/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/pl/policy-config.md b/docs/pl/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/pl/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/pl/quickstart.md b/docs/pl/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/pl/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/pt/account-types.md b/docs/pt/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/pt/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/pt/chrome-issues.md b/docs/pt/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/pt/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pt/debug-info.md b/docs/pt/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/pt/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/pt/edge-backup.md b/docs/pt/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/pt/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/pt/edge-install.md b/docs/pt/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/pt/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/pt/edge-issues.md b/docs/pt/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/pt/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pt/edge-privacy.md b/docs/pt/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/pt/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/pt/export-and-import.md b/docs/pt/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/pt/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/pt/firefox-issues.md b/docs/pt/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/pt/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pt/index.md b/docs/pt/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/pt/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/pt/lost-codes.md b/docs/pt/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/pt/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/pt/manual-update.md b/docs/pt/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/pt/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/pt/onedrive-perms.md b/docs/pt/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/pt/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/pt/opera-install.md b/docs/pt/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/pt/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/pt/otp-backup-developer.md b/docs/pt/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/pt/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/pt/otp-backup.md b/docs/pt/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/pt/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/pt/overview.md b/docs/pt/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/pt/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/pt/policy-config.md b/docs/pt/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/pt/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/pt/quickstart.md b/docs/pt/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/pt/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/pt_BR/account-types.md b/docs/pt_BR/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/pt_BR/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/pt_BR/chrome-issues.md b/docs/pt_BR/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/pt_BR/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pt_BR/debug-info.md b/docs/pt_BR/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/pt_BR/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/pt_BR/edge-backup.md b/docs/pt_BR/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/pt_BR/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/pt_BR/edge-install.md b/docs/pt_BR/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/pt_BR/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/pt_BR/edge-issues.md b/docs/pt_BR/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/pt_BR/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pt_BR/edge-privacy.md b/docs/pt_BR/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/pt_BR/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/pt_BR/export-and-import.md b/docs/pt_BR/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/pt_BR/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/pt_BR/firefox-issues.md b/docs/pt_BR/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/pt_BR/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/pt_BR/index.md b/docs/pt_BR/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/pt_BR/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/pt_BR/lost-codes.md b/docs/pt_BR/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/pt_BR/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/pt_BR/manual-update.md b/docs/pt_BR/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/pt_BR/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/pt_BR/onedrive-perms.md b/docs/pt_BR/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/pt_BR/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/pt_BR/opera-install.md b/docs/pt_BR/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/pt_BR/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/pt_BR/otp-backup-developer.md b/docs/pt_BR/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/pt_BR/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/pt_BR/otp-backup.md b/docs/pt_BR/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/pt_BR/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/pt_BR/overview.md b/docs/pt_BR/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/pt_BR/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/pt_BR/policy-config.md b/docs/pt_BR/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/pt_BR/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/pt_BR/quickstart.md b/docs/pt_BR/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/pt_BR/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/ro/account-types.md b/docs/ro/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/ro/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/ro/chrome-issues.md b/docs/ro/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/ro/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ro/debug-info.md b/docs/ro/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/ro/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/ro/edge-backup.md b/docs/ro/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/ro/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/ro/edge-install.md b/docs/ro/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/ro/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/ro/edge-issues.md b/docs/ro/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/ro/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ro/edge-privacy.md b/docs/ro/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/ro/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/ro/export-and-import.md b/docs/ro/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/ro/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/ro/firefox-issues.md b/docs/ro/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/ro/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ro/index.md b/docs/ro/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/ro/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/ro/lost-codes.md b/docs/ro/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/ro/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/ro/manual-update.md b/docs/ro/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/ro/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/ro/onedrive-perms.md b/docs/ro/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/ro/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/ro/opera-install.md b/docs/ro/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/ro/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/ro/otp-backup-developer.md b/docs/ro/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/ro/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/ro/otp-backup.md b/docs/ro/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/ro/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/ro/overview.md b/docs/ro/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/ro/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/ro/policy-config.md b/docs/ro/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/ro/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/ro/quickstart.md b/docs/ro/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/ro/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/ru/account-types.md b/docs/ru/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/ru/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/ru/chrome-issues.md b/docs/ru/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/ru/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ru/debug-info.md b/docs/ru/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/ru/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/ru/edge-backup.md b/docs/ru/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/ru/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/ru/edge-install.md b/docs/ru/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/ru/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/ru/edge-issues.md b/docs/ru/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/ru/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ru/edge-privacy.md b/docs/ru/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/ru/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/ru/export-and-import.md b/docs/ru/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/ru/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/ru/firefox-issues.md b/docs/ru/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/ru/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/ru/index.md b/docs/ru/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/ru/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/ru/lost-codes.md b/docs/ru/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/ru/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/ru/manual-update.md b/docs/ru/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/ru/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/ru/onedrive-perms.md b/docs/ru/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/ru/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/ru/opera-install.md b/docs/ru/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/ru/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/ru/otp-backup-developer.md b/docs/ru/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/ru/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/ru/otp-backup.md b/docs/ru/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/ru/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/ru/overview.md b/docs/ru/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/ru/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/ru/policy-config.md b/docs/ru/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/ru/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/ru/quickstart.md b/docs/ru/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/ru/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/si/account-types.md b/docs/si/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/si/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/si/chrome-issues.md b/docs/si/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/si/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/si/debug-info.md b/docs/si/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/si/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/si/edge-backup.md b/docs/si/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/si/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/si/edge-install.md b/docs/si/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/si/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/si/edge-issues.md b/docs/si/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/si/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/si/export-and-import.md b/docs/si/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/si/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/si/firefox-issues.md b/docs/si/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/si/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/si/index.md b/docs/si/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/si/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/si/lost-codes.md b/docs/si/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/si/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/si/manual-update.md b/docs/si/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/si/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/si/onedrive-perms.md b/docs/si/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/si/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/si/opera-install.md b/docs/si/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/si/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/si/otp-backup-developer.md b/docs/si/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/si/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/si/otp-backup.md b/docs/si/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/si/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/si/overview.md b/docs/si/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/si/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/si/policy-config.md b/docs/si/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/si/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/si/quickstart.md b/docs/si/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/si/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/sr/account-types.md b/docs/sr/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/sr/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/sr/chrome-issues.md b/docs/sr/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/sr/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/sr/debug-info.md b/docs/sr/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/sr/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/sr/edge-backup.md b/docs/sr/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/sr/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/sr/edge-install.md b/docs/sr/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/sr/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/sr/edge-issues.md b/docs/sr/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/sr/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/sr/edge-privacy.md b/docs/sr/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/sr/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/sr/export-and-import.md b/docs/sr/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/sr/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/sr/firefox-issues.md b/docs/sr/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/sr/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/sr/index.md b/docs/sr/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/sr/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/sr/lost-codes.md b/docs/sr/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/sr/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/sr/manual-update.md b/docs/sr/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/sr/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/sr/onedrive-perms.md b/docs/sr/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/sr/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/sr/opera-install.md b/docs/sr/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/sr/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/sr/otp-backup-developer.md b/docs/sr/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/sr/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/sr/otp-backup.md b/docs/sr/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/sr/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/sr/overview.md b/docs/sr/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/sr/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/sr/policy-config.md b/docs/sr/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/sr/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/sr/quickstart.md b/docs/sr/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/sr/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/sv/account-types.md b/docs/sv/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/sv/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/sv/chrome-issues.md b/docs/sv/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/sv/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/sv/debug-info.md b/docs/sv/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/sv/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/sv/edge-backup.md b/docs/sv/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/sv/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/sv/edge-install.md b/docs/sv/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/sv/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/sv/edge-issues.md b/docs/sv/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/sv/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/sv/edge-privacy.md b/docs/sv/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/sv/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/sv/export-and-import.md b/docs/sv/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/sv/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/sv/firefox-issues.md b/docs/sv/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/sv/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/sv/index.md b/docs/sv/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/sv/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/sv/lost-codes.md b/docs/sv/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/sv/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/sv/manual-update.md b/docs/sv/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/sv/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/sv/onedrive-perms.md b/docs/sv/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/sv/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/sv/opera-install.md b/docs/sv/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/sv/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/sv/otp-backup-developer.md b/docs/sv/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/sv/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/sv/otp-backup.md b/docs/sv/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/sv/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/sv/overview.md b/docs/sv/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/sv/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/sv/policy-config.md b/docs/sv/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/sv/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/sv/quickstart.md b/docs/sv/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/sv/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/tr/account-types.md b/docs/tr/account-types.md new file mode 100644 index 000000000..978175ede --- /dev/null +++ b/docs/tr/account-types.md @@ -0,0 +1,13 @@ +--- +title: Hesap Türleri +stub: account-types +lang: en +ver: 1 +--- + +| Tür | Detaylar | +| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Zamana Dayalı | TOTP | +| Sayaca Dayalı | HOTP | +| Battle.net | Gizli Anahtar alma aracı: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/tr/chrome-issues.md b/docs/tr/chrome-issues.md new file mode 100644 index 000000000..9721cf9ce --- /dev/null +++ b/docs/tr/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Sorunları +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### KİMLİK DOĞRULAYICIYI YENİDEN YÜKLEMEK VERİLERİNİZİ TEMİZLEYECEKTİR. HERHANGİ BİR SORUNU GİDERMEK İÇİN KİMLİK DOĞRULAYICIYI ASLA YENİDEN YÜKLEMEYİN + +" %} + +- Parolanızı hatırlayamıyor veya gizli anahtarlarınızı kaybettiniz mi ve yedeğiniz yok mu? [Kayıp Kodlar](lost-codes)'a bakın +- Çeviriye yardım etmek mi istiyorsunuz veya çeviriyle ilgili bir sorununuz mu var? [Crowdin sayfamızı kontrol edin](https://crowdin.com/project/authenticator-firefox) +- Bir hata veya özellik talebiniz mi var? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/tr/debug-info.md b/docs/tr/debug-info.md new file mode 100644 index 000000000..2475792f9 --- /dev/null +++ b/docs/tr/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Hata Ayıklama Bilgilerini Alma +stub: debug-info +lang: en +ver: 1 +--- + +Ayrıntılı hata ayıklama bilgilerini bildirmek için aşağıdaki adımları izleyin. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Kimlik Doğrulayıcıyı aç +2. Kimlik Doğrulayıcıya sağ tıklayın ve "İncele" yi tıklayın + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. "Consol" sekmesine gidin + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Tüm mesajları kopyalayıp sorun açıklamasına yapıştırın + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. `about:debugging` sayfasına gidin +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. "Tamam" ı tıklayın + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Konsol sekmesinde olduğunuzdan emin olun + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Kimlik Doğrulayıcıyı tekrar açın +7. Tüm mesajları kopyalayıp sorun açıklamasına yapıştırın + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/tr/edge-backup.md b/docs/tr/edge-backup.md new file mode 100644 index 000000000..a5e27d620 --- /dev/null +++ b/docs/tr/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Eski Edge'de yedekleme +stub: edge-backup +lang: en +ver: 1 +--- + +1. Kimlik Doğrulayıcıyı açın, sağ tıklayın ve "Öğeyi İncele" yi seçin + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Yeni pencerenin üst kısmındaki "Konsol" sekmesine gidin +3. Bunu konsola yapıştırın ve enter tuşuna basın + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Sonucu not defterine kopyala + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. `.json` ile biten bir dosya olarak kaydedin + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/tr/edge-install.md b/docs/tr/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/tr/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/tr/edge-issues.md b/docs/tr/edge-issues.md new file mode 100644 index 000000000..c4d29a470 --- /dev/null +++ b/docs/tr/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Sorunları +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### KİMLİK DOĞRULAYICIYI YENİDEN YÜKLEMEK VERİLERİNİZİ TEMİZLEYECEKTİR. HERHANGİ BİR SORUNU GİDERMEK İÇİN KİMLİK DOĞRULAYICIYI ASLA YENİDEN YÜKLEMEYİN + +" %} + +- Parolanızı hatırlayamıyor veya gizli anahtarlarınızı kaybettiniz mi ve yedeğiniz yok mu? [Kayıp Kodlar](lost-codes)'a bakın +- Çeviriye yardımcı olmak mı istiyorsunuz veya çeviri ile ilgili bir sorun mu yaşıyorsunuz? [Crowdin sayfamızı kontrol edin](https://crowdin.com/project/authenticator-firefox) +- Bir hata veya özellik talebiniz mi var? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/tr/edge-privacy.md b/docs/tr/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/tr/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/tr/export-and-import.md b/docs/tr/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/tr/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/tr/firefox-issues.md b/docs/tr/firefox-issues.md new file mode 100644 index 000000000..5fb78e419 --- /dev/null +++ b/docs/tr/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Sorunları +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Parolanızı hatırlayamıyor veya gizli anahtarlarınızı kaybettiniz mi ve yedeğiniz yok mu? [Kayıp Kodlar](lost-codes)'a bakın +- Çeviriye yardımcı olmak mı istiyorsunuz veya çeviri ile ilgili bir sorun mu yaşıyorsunuz? [Crowdin sayfamızı kontrol edin](https://crowdin.com/project/authenticator-firefox) +- Bir hata veya özellik talebiniz mi var? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/tr/index.md b/docs/tr/index.md new file mode 100644 index 000000000..8b33e206b --- /dev/null +++ b/docs/tr/index.md @@ -0,0 +1,7 @@ +--- +title: Dizin +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/tr/lost-codes.md b/docs/tr/lost-codes.md new file mode 100644 index 000000000..75ab247a8 --- /dev/null +++ b/docs/tr/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Kayıp Kodlar +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Hesaplarınızı geri almak için atmanız gereken birkaç adım: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Yaygın kurtarma linkleri: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/tr/manual-update.md b/docs/tr/manual-update.md new file mode 100644 index 000000000..1d30e3fdf --- /dev/null +++ b/docs/tr/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Elle Güncelleme +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. `chrome://extensions` sayfasına gidin + +2. Sağ üsttekiki "Geliştirici modu" etiketli kutuyu işaretleyin + +3. "Uzantıları Şimdi Güncelle"yi tıklayın + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. `about:addons` sayfasına gidin + +2. Click the gear at the top right + +3. "Güncellemeleri Kontrol Et" i tıklayın + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/tr/onedrive-perms.md b/docs/tr/onedrive-perms.md new file mode 100644 index 000000000..efdb596e0 --- /dev/null +++ b/docs/tr/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive İzinleri +stub: onedrive-perms +lang: en +ver: 1 +--- + +Kurumsal OneDrive hesapları "Kullanıcı dosyalarına tam erişim" iznini gerektirir. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[Microsoft'a göre](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Kurumsal OneDrive hesaplarının şu anda Files.ReadWrite.AppFolder iznini desteklemediğini unutmayın. \ No newline at end of file diff --git a/docs/tr/opera-install.md b/docs/tr/opera-install.md new file mode 100644 index 000000000..2ca1ad194 --- /dev/null +++ b/docs/tr/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera, Kimlik Doğrulayıcıyı [Chrome Web Mağazası'ndan ](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai) yüklemek için kullanabileceğiniz [Install Chrome Extensions ](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) adlı bir uzantıyı resmi olarak sağlar. + +Kimlik Doğrulayıcıyı Opera'da test etmediğimizi lütfen unutmayın. Hatalarla karşılaşabilirsiniz. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/tr/otp-backup-developer.md b/docs/tr/otp-backup-developer.md new file mode 100644 index 000000000..aff770ded --- /dev/null +++ b/docs/tr/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Otpauth URI'lerine ilişkin belgelere [buradan](https://github.com/google/google-authenticator/wiki/Key-Uri-Format) ulaşılabilir. Örneğin, bir yedekleme böyle bir şeye benzeyebilir: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +İpuçları: + +- Yayınlayan kuruluş ve hesap adının iki nokta üst üste içeremeyeceğini unutmayın (`:` veya `%3A`) +- Dosyayı `düz metin` olarak kaydedin + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/tr/otp-backup.md b/docs/tr/otp-backup.md new file mode 100644 index 000000000..99f914177 --- /dev/null +++ b/docs/tr/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Uygulama | Sürüm | Notlar | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------- | +| [Kimlik Doğrulayıcı Uzantısı](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Şifrelenmiş yedeklemeler desteklenmez | {: .table .table-striped} + +[Geliştirici bilgileri](otp-backup-developer) \ No newline at end of file diff --git a/docs/tr/overview.md b/docs/tr/overview.md new file mode 100644 index 000000000..1445da149 --- /dev/null +++ b/docs/tr/overview.md @@ -0,0 +1,19 @@ +--- +title: Kimlik Doğrulayıcı Uzantısı nedir? +stub: genel görünüm +lang: en +ver: 1 +--- + +Kimlik Doğrulayıcı Uzantısı tarayıcı içi Tek Kullanımlık Parola (OTP) istemcisidir. Kimlik Doğrulayıcı Uzantısı hem zamana dayalı Tek Kullanımlık Parolayı (TOTP, [RFC 6238](https://tools.ietf.org/html/rfc6238)'de belirtilmiştir) ve HMAC tabanlı Tek Kullanımlık Parolayı (HOTP, [RFC 4226](https://tools.ietf.org/html/rfc4226)'da belirtilmiştir) destekler. + +Başka bir deyişle, Kimlik Doğrulayıcı Uzantısı Google Authenticator gibi uygulamaların tam alternatifi olarak kullanılabilir. + +## Ana Özellikler + +* Karekodlarını tarayarak hesap ekleyin +* Verileri bir parola ile şifreleyin +* Tarayıcılar arasında verileri eşitleyin +* Verileri bulut hizmetlerine yedekleyin veya verileri bir dosyaya aktarın +* Akıllı filtreleme ve arama +* Battle.net ve Steam desteği \ No newline at end of file diff --git a/docs/tr/policy-config.md b/docs/tr/policy-config.md new file mode 100644 index 000000000..6bd68ff4c --- /dev/null +++ b/docs/tr/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Politika Yapılandırması +stub: policy-config +lang: en +ver: 1 +--- + +Bu sayfa yöneticiler içindir. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). Daha fazla bilgi aşağıda mevcuttur. Open an issue to request more policy controls. + +#### Uzantı Kimlikleri + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +Chrome politikalarının biçimi platform başına farklıdır ancak Linux için çalışan bir yapılandırma şöyle görünür: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/tr/quickstart.md b/docs/tr/quickstart.md new file mode 100644 index 000000000..334aca9ab --- /dev/null +++ b/docs/tr/quickstart.md @@ -0,0 +1,45 @@ +--- +title: İlk Hesabınızı Ekleyin +stub: hızlı başlangıç +lang: en +ver: 2 +--- + +Bu hızlı başlangıç Kimlik Doğrulayıcı Uzantısına örnek bir hesabın nasıl ekleneceğini açıklar. + +## Ön koşullar + +Kimlik Doğrulayıcı Uzantısını kurun ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +Kimlik Doğrulayıcı Uzantısını Chrome'a ilk yüklediğinizde simgesini araç çubuğuna sabitlemelisiniz. + +![araç çubuğuna sabitle](/assets/quickstart/pin-to-toolbar.png) + +## Kare Kod ekleyin + +1. Tarayıcınızdaki Kimlik Doğrulayıcı Uzantının simgesini tıklayın + +2. Pencerenin sağ üst köşesindeki tarama simgesine tıklayın. + + ![karekod butonuna tıklayın](/assets/quickstart/add-qr.png) + +3. Karekodunu tamamen kapsayan bir kare çizmek için tıklayın ve sürükleyin + + + +4. Yeni hesap eklendikten sonra pencerede yeni bir giriş göreceksiniz. + +6 basamaklı sayı, geçerli tek kullanımlık şifrenizdir, sağ alt köşedeki daire geçerli şifre için ne kadar süre kaldığını söyler. Bu hesabı bir mobil uygulamaya eklemek istiyorsanız, bu hesabın karekodunu görmek için girişin sağ üst köşesindeki karekod simgesine tıklayabilirsiniz. + +## Elle Hesap Ekleyin + +1. Tarayıcınızdaki Kimlik Doğrulayıcı Uzantının simgesini tıklayın + +2. Pencerenin sağ üst köşesindeki kalem simgesini tıklayın. ![elle giriş](/assets/quickstart/click-edit.png) + +3. Pencerenin sağ üst köşesindeki artı düğmesini tıklayın. **Elle Giriş**'i seçin. ![elle giriş](/assets/quickstart/click-add.png) + +4. Bu hesabın ilişkili olduğu web sitesinin adını **Yayınlayan Kuruluş** alanına girin, **Gizli Anahtar** alanına size verilen gizli anahtarı girin ve son olarak **Tamam**'ı tıklayın. ![hesap ekle](/assets/quickstart/add-account.png) + +5. Yeni hesap eklendikten sonra pencerede yeni bir giriş göreceksiniz. ![giriş](/assets/quickstart/example-entry.png) + diff --git a/docs/uk/account-types.md b/docs/uk/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/uk/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/uk/chrome-issues.md b/docs/uk/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/uk/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/uk/debug-info.md b/docs/uk/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/uk/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/uk/edge-backup.md b/docs/uk/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/uk/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/uk/edge-install.md b/docs/uk/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/uk/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/uk/edge-issues.md b/docs/uk/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/uk/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/uk/edge-privacy.md b/docs/uk/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/uk/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/uk/export-and-import.md b/docs/uk/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/uk/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/uk/firefox-issues.md b/docs/uk/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/uk/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/uk/index.md b/docs/uk/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/uk/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/uk/lost-codes.md b/docs/uk/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/uk/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/uk/manual-update.md b/docs/uk/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/uk/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/uk/onedrive-perms.md b/docs/uk/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/uk/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/uk/opera-install.md b/docs/uk/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/uk/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/uk/otp-backup-developer.md b/docs/uk/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/uk/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/uk/otp-backup.md b/docs/uk/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/uk/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/uk/overview.md b/docs/uk/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/uk/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/uk/policy-config.md b/docs/uk/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/uk/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/uk/quickstart.md b/docs/uk/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/uk/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/vi/account-types.md b/docs/vi/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/vi/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/vi/chrome-issues.md b/docs/vi/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/vi/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/vi/debug-info.md b/docs/vi/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/vi/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/vi/edge-backup.md b/docs/vi/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/vi/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/vi/edge-install.md b/docs/vi/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/vi/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/vi/edge-issues.md b/docs/vi/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/vi/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/vi/edge-privacy.md b/docs/vi/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/vi/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/vi/export-and-import.md b/docs/vi/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/vi/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/vi/firefox-issues.md b/docs/vi/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/vi/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/vi/index.md b/docs/vi/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/vi/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/vi/lost-codes.md b/docs/vi/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/vi/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/vi/manual-update.md b/docs/vi/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/vi/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/vi/onedrive-perms.md b/docs/vi/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/vi/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/vi/opera-install.md b/docs/vi/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/vi/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/vi/otp-backup-developer.md b/docs/vi/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/vi/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/vi/otp-backup.md b/docs/vi/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/vi/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/vi/overview.md b/docs/vi/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/vi/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/vi/policy-config.md b/docs/vi/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/vi/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/vi/quickstart.md b/docs/vi/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/vi/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/zh_CN/account-types.md b/docs/zh_CN/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/zh_CN/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/zh_CN/chrome-issues.md b/docs/zh_CN/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/zh_CN/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/zh_CN/debug-info.md b/docs/zh_CN/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/zh_CN/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/zh_CN/edge-backup.md b/docs/zh_CN/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/zh_CN/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/zh_CN/edge-install.md b/docs/zh_CN/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/zh_CN/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/zh_CN/edge-issues.md b/docs/zh_CN/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/zh_CN/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/zh_CN/edge-privacy.md b/docs/zh_CN/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/zh_CN/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/zh_CN/export-and-import.md b/docs/zh_CN/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/zh_CN/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/zh_CN/firefox-issues.md b/docs/zh_CN/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/zh_CN/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/zh_CN/index.md b/docs/zh_CN/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/zh_CN/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/zh_CN/lost-codes.md b/docs/zh_CN/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/zh_CN/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/zh_CN/manual-update.md b/docs/zh_CN/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/zh_CN/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/zh_CN/onedrive-perms.md b/docs/zh_CN/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/zh_CN/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/zh_CN/opera-install.md b/docs/zh_CN/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/zh_CN/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/zh_CN/otp-backup-developer.md b/docs/zh_CN/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/zh_CN/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/zh_CN/otp-backup.md b/docs/zh_CN/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/zh_CN/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/zh_CN/overview.md b/docs/zh_CN/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/zh_CN/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/zh_CN/policy-config.md b/docs/zh_CN/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/zh_CN/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/zh_CN/quickstart.md b/docs/zh_CN/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/zh_CN/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) + diff --git a/docs/zh_TW/account-types.md b/docs/zh_TW/account-types.md new file mode 100644 index 000000000..5ff708b00 --- /dev/null +++ b/docs/zh_TW/account-types.md @@ -0,0 +1,13 @@ +--- +title: Account Types +stub: account-types +lang: en +ver: 1 +--- + +| Type | Details | +| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Time Based | TOTP | +| Couter Based | HOTP | +| Battle.net | Tool to get secret: [Sneezry/PyGetBlizSecret](https://github.com/Sneezry/PyGetBlizSecret/) | +| Steam | You need your shared_secret, some basic instructions are available [here](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-android-windows) | {: .table .table-striped} \ No newline at end of file diff --git a/docs/zh_TW/chrome-issues.md b/docs/zh_TW/chrome-issues.md new file mode 100644 index 000000000..0ed6210fe --- /dev/null +++ b/docs/zh_TW/chrome-issues.md @@ -0,0 +1,16 @@ +--- +title: Chrome Issues +stub: chrome-issues +lang: en +ver: 1 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/zh_TW/debug-info.md b/docs/zh_TW/debug-info.md new file mode 100644 index 000000000..55be97b3f --- /dev/null +++ b/docs/zh_TW/debug-info.md @@ -0,0 +1,54 @@ +--- +title: Getting Debugging Information +stub: debug-info +lang: en +ver: 1 +--- + +Follow these steps to report detailed debugging information. + +- [Chrome](#chrome) +- [Firefox](#firefox) + +* * * + +## Chrome + +1. Open Authenticator +2. Right click Authenticator and click "Inspect" + +![step2](/assets/debugging-screenshots/chrome/step2.PNG) + +3. Go to the "Console" tab + +![step5](/assets/debugging-screenshots/chrome/step3.PNG) + +4. Copy and paste any messages into the issue description + +![step4](/assets/debugging-screenshots/chrome/step4.PNG) + +* * * + +## Firefox + +1. Go to `about:debugging` +2. Check the box that says "Enable add-on debugging" + +![step2](/assets/debugging-screenshots/firefox/step2.PNG) + +3. Click the link that says "Debug" under Authenticator + +![step3](/assets/debugging-screenshots/firefox/step3.PNG) + +4. Click "Ok" + +![step4](/assets/debugging-screenshots/firefox/step4.PNG) + +5. Make sure that you are on the console tab + +![step5](/assets/debugging-screenshots/firefox/step5.PNG) + +6. Open Authenticator again +7. Copy and paste any messages into the issue description + +![step7](/assets/debugging-screenshots/firefox/step7.PNG) \ No newline at end of file diff --git a/docs/zh_TW/edge-backup.md b/docs/zh_TW/edge-backup.md new file mode 100644 index 000000000..ec5bf27d8 --- /dev/null +++ b/docs/zh_TW/edge-backup.md @@ -0,0 +1,27 @@ +--- +title: Backing up in Old Edge +stub: edge-backup +lang: en +ver: 1 +--- + +1. Open Authenticator, right click, and choose "Inspect Element" + +![step1](/assets/edge-backup-screenshots/step1.PNG) + +2. Go to the "Console" tab at the top of the new window +3. Paste this into the console and hit enter + +```javascript +browser.storage.local.get(d=>console.log(JSON.stringify(d,null,2))) +``` + +![step3](/assets/edge-backup-screenshots/step3.PNG) + +4. Copy the result to notepad + +![step4](/assets/edge-backup-screenshots/step4.PNG) + +5. Save as a file ending in `.json` + +![step5](/assets/edge-backup-screenshots/step5.PNG) \ No newline at end of file diff --git a/docs/zh_TW/edge-install.md b/docs/zh_TW/edge-install.md new file mode 100644 index 000000000..743405376 --- /dev/null +++ b/docs/zh_TW/edge-install.md @@ -0,0 +1,22 @@ +--- +title: Install Authenticator extension in Edge +stub: edge-install +lang: en +ver: 1 +--- + +# Install from Chrome Web Store + +Edge users can install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). Learn more about how to add an extension to Microsoft Edge from the Chrome Web Store, see . + +# Why Authenticator is removed from Microsoft Edge store + +The Edge version has been rejected in certification and Microsoft refuses to be specific as to why this is happening. + +> Thank you for contacting us. The product, including its listing, does not accurately represent the product and may mislead users. Your product may not use a name or icon that is too similar to that of other products. Products need to have unique functionality and value in the Store. You may want to review the metadata section of our Product Quality guidelines here: https://msdn.microsoft.com/en-us/library/windows/apps/mt652261.aspx. + +The reason could be the extension's name, Authenticator, is too generic, and Microsoft Edge team believes that may mislead some users. + +# Any plan for the future + +We have realized the generic name is a problem, and we are working on renaming the extension to a more recognizable name. diff --git a/docs/zh_TW/edge-issues.md b/docs/zh_TW/edge-issues.md new file mode 100644 index 000000000..37f882b85 --- /dev/null +++ b/docs/zh_TW/edge-issues.md @@ -0,0 +1,16 @@ +--- +title: Edge Issues +stub: edge-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message=" + +#### REINSTALLING AUTHENTICATOR WILL CLEAR YOUR DATA. NEVER REINSTALL AUTHENTICATOR TO FIX ANY ISSUES + +" %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/zh_TW/edge-privacy.md b/docs/zh_TW/edge-privacy.md new file mode 100644 index 000000000..2f2fee880 --- /dev/null +++ b/docs/zh_TW/edge-privacy.md @@ -0,0 +1,27 @@ +--- +title: +stub: +layout: +lang: +ver: +--- +### + +* * * + +### + +- +- +- +- + +### + + + +### + + + +### \ No newline at end of file diff --git a/docs/zh_TW/export-and-import.md b/docs/zh_TW/export-and-import.md new file mode 100644 index 000000000..62e5c8948 --- /dev/null +++ b/docs/zh_TW/export-and-import.md @@ -0,0 +1,70 @@ +--- +title: Export and Import Backups +stub: export-and-import +lang: en +ver: 1 +--- + +This guide explains how to export backups from Authenticator Extension and import previous backups to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Export backup file to local machine + +![backup menu](/assets/quickstart/backup-menu1.png) + +Go to **Settings -> Backup** and click **Download Backup File** or **Download Password-Protected Backup** to save a backup of your accounts to your computer. + +If you haven't set a password in **Security** menu, the **Download Password-Protected Backup** button will be hidden. + +Unencrypted backup files use a standardized backup format that can be imported to other OTP clients. See [Standard Backup Format](https://authenticator.cc/docs/en/otp-backup) to learn more. + +> If you have Steam or Blizzard accounts, unencrypted backup files will not use the standardized backup format. + +{% include warning.html class="danger" message="It is strongly recommended to only use password-protected backups. A password may be set in **Settings -> Security**." %} + +## Export backup file to 3rd party storage services + +Authenticator Extension can automatically backing up files to Google Drive, OneDrive and Dropbox. To enable cloud storage backup, click the service button to link to your cloud storage service account. + +![backup menu](/assets/quickstart/backup-menu2.png) + +> You may need to wait for a few seconds before the login page appears. + +After logging in, your linked cloud account will be visible in the cloud backup page. + +![cloud backup](/assets/quickstart/cloud-backup.png) + +## Import backup files + +To import backup files to Authenticator extension, open the **Backup** menu and click the **Import Backup** button. + +![backup menu](/assets/quickstart/backup-menu1.png) + +A new page will open with the following options: **Import Backup File**, **Import QR Image Backup**, and **Import Text Backup**. + +![import backup](/assets/quickstart/import-backup.png) + +Choose an import method based on what format of backup you have: + +- `authenticator.json` or `authenticator.txt`. If your backup file is plain text with a `.json` or `.txt` file extension, use **Import Backup File**. You may be asked to enter a password if the backup is encrypted. + + > The file name may be different if you changed it when you export the backup file or you use cloud backup. + > + > If you exported the backup file by clicking the **Download Backup File** or **Download Password-Protected Backup** button, look for your backup on your computer. + > + > If you setup cloud backup, look for your backup in your cloud storage account. Authenticator uses a folder named **Authenticator Backups**. Backup files are named by date in the format **yyyymmdd.json**. + +- If you have a screenshot of a QR image, use **Import QR Image Backup**. You can select multiple images to import more than one account at a time. + + > You can also import Google Authenticator accounts. In Google Authenticator, tap on the three dots in the upper right-hand corner of the screen. Tap on Transfer Accounts. Tap on Export Accounts. Verify your identity. Choose the account information you wish to transfer from the list. Tap on Next. Take a screenshot to save the QR image \(iPhone\), or take a picture with another phone/camera \(Android\). Then use **Import QR Image Backup** to import the accounts. + > + > Google Authenticator supports exporting up to 10 accounts at one time. However, when importing to Authenticator Extension it is recommended to export five accounts at one time to prevent errors. + +- If you saved your backup as a string of text instead of a file or have OTP URLs from other OTP clients, use **Import Text Backup**. diff --git a/docs/zh_TW/firefox-issues.md b/docs/zh_TW/firefox-issues.md new file mode 100644 index 000000000..261c52115 --- /dev/null +++ b/docs/zh_TW/firefox-issues.md @@ -0,0 +1,12 @@ +--- +title: Firefox Issues +stub: firefox-issues +lang: en +ver: 2 +--- + +{% include warning.html class="danger" message="Reinstalling Authenticator with your storage location set to 'local' will cause data loss." %} + +- Can't remember your password or lost your secrets and don't have a backup? See [Lost Codes](lost-codes) +- Want to help translate or have an issue with translation? [Check our Crowdin page](https://crowdin.com/project/authenticator-firefox) +- Have a bug or feature request? [File an issue](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose) or [Tweet with @AuthExtension](https://twitter.com/intent/tweet?text=@AuthExtension) \ No newline at end of file diff --git a/docs/zh_TW/index.md b/docs/zh_TW/index.md new file mode 100644 index 000000000..93349a5ee --- /dev/null +++ b/docs/zh_TW/index.md @@ -0,0 +1,7 @@ +--- +title: Index +stub: index +lang: en +layout: docs-index +--- + diff --git a/docs/zh_TW/lost-codes.md b/docs/zh_TW/lost-codes.md new file mode 100644 index 000000000..4666e2aa5 --- /dev/null +++ b/docs/zh_TW/lost-codes.md @@ -0,0 +1,19 @@ +--- +title: Lost Codes +stub: lost-codes +lang: en +ver: 1 +--- + +Most of the time, losing your secrets doesn't mean you will lose your account forever. Here are a few steps to take to get your accounts back: + +- Websites usually give a recovery code to you when you enable 2FA on your account. Use your recovery code to get access to your account. +- If you don't have a recovery code go to the site's support and ask them to disable two factor authentication on your account for you. Recovering your account this way can take a while to process and you will likely need to provide proof of identity. + +To prevent from losing codes in the future remember to make a backup every time you add a code. + +### Common recovery links: + +- [Google](https://support.google.com/accounts/answer/185834) +- [Twitter](https://help.twitter.com/en/managing-your-account/issues-with-login-authentication) +- [Facebook](https://www.facebook.com/help/147926301947841) \ No newline at end of file diff --git a/docs/zh_TW/manual-update.md b/docs/zh_TW/manual-update.md new file mode 100644 index 000000000..d8f49dbda --- /dev/null +++ b/docs/zh_TW/manual-update.md @@ -0,0 +1,26 @@ +--- +title: Manually Updating +stub: manual-update +lang: en +ver: 1 +--- + +## Chrome + +1. Go to `chrome://extensions` + +2. Check the box labelled "Developer Mode" in the top right + +3. Click "Update Extensions Now" + +![chrome](/assets/update-screenshots/chrome.png) + +## Firefox + +1. Go to `about:addons` + +2. Click the gear at the top right + +3. Click "Check for Updates" + +![firefox](/assets/update-screenshots/firefox.png) \ No newline at end of file diff --git a/docs/zh_TW/onedrive-perms.md b/docs/zh_TW/onedrive-perms.md new file mode 100644 index 000000000..8af5e93d7 --- /dev/null +++ b/docs/zh_TW/onedrive-perms.md @@ -0,0 +1,12 @@ +--- +title: OneDrive Permissions +stub: onedrive-perms +lang: en +ver: 1 +--- + +Business OneDrive accounts require the "Have full access to user files" permission. Normally, Authenticator would request "Have full access to the application's folder." This is due to Microsoft not implementing the more restrictive app folder permission for business accounts. + +[According to Microsoft](https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/special-folders-appfolder?view=odsp-graph-online#getting-authorization-from-the-user): + +> To have your own app's folder, you must request either the Files.ReadWrite.AppFolder or Files.ReadWrite permission scope when getting an access token. For more details, see authentication. Note, Business OneDrive accounts do not currently support the Files.ReadWrite.AppFolder permission. \ No newline at end of file diff --git a/docs/zh_TW/opera-install.md b/docs/zh_TW/opera-install.md new file mode 100644 index 000000000..a8ac0638c --- /dev/null +++ b/docs/zh_TW/opera-install.md @@ -0,0 +1,10 @@ +--- +title: Install in Opera +stub: opera-install +lang: en +ver: 1 +--- + +Opera officially provides an extension called [Install Chrome Extensions](https://addons.opera.com/en/extensions/details/install-chrome-extensions/) that you can use to install Authenticator from [Chrome Web Store](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai). + +Please note that we don't test Authenticator in Opera. You may encounter bugs. If you have an issue in Opera, please [open a bug report](https://github.com/Authenticator-Extension/Authenticator/issues/new/choose). \ No newline at end of file diff --git a/docs/zh_TW/otp-backup-developer.md b/docs/zh_TW/otp-backup-developer.md new file mode 100644 index 000000000..0ca06721e --- /dev/null +++ b/docs/zh_TW/otp-backup-developer.md @@ -0,0 +1,22 @@ +--- +title: Standard Backup Format Developer Info +stub: otp-backup-developer +lang: en +ver: 1 +--- + +Backups are just text files with one otpauth URI per line. Documentation on otpauth URIs are available [here](https://github.com/google/google-authenticator/wiki/Key-Uri-Format). For example, a backup could look like this: + + otpauth://totp/example.com?secret=FLIQ7AABIXF2DBUYE7VYAV2T7232KVYB + otpauth://totp/Test%20Account:?secret=R6TTJ5T26NWTHPIPXAOYQ6BVWEBLE6W2&issuer=Test%20Account + otpauth://totp/Another%20Test%20Account:example.com?secret=5W6HHVETUEPLR26KRQOPHTR6Q4JYRVJQ&issuer=Another%20Test%20Account + otpauth://totp/?secret=AFKVXHTAZZQKCHI3XSZPX5NKQRFXL3AD + otpauth://totp/Account%20with%20Period:example.com?secret=LJL6765YQRQQ533ACSI6YUXTLZYY7GBI&issuer=Account%20with%20Period&period=60 + + +Tips: + +- Remember that the issuer and account name cannot contain a colon (`:` or `%3A`) +- Save the file as `text/plain` + +If your application can import and export backups in this format please [raise an issue](https://github.com/Authenticator-Extension/authenticator.cc/issues/new) so we can put you on [the list](otp-backup). \ No newline at end of file diff --git a/docs/zh_TW/otp-backup.md b/docs/zh_TW/otp-backup.md new file mode 100644 index 000000000..6b7cee840 --- /dev/null +++ b/docs/zh_TW/otp-backup.md @@ -0,0 +1,17 @@ +--- +title: Standard Backup Format +stub: otp-backup +lang: en +ver: 1 +--- + +Some 2FA applications support interoperable backups. In other words, if you make a backup with an application listed below, you can use that backup with any other application on this list. + +| Application | Version | Notes | +| ---------------------------------------------------------------------------------------- | ------- | ------------------------------------ | +| [Authenticator Extension](https://authenticator.cc) | v5.3.0+ | Encrypted backups not supported | +| [FreeOTP+](https://github.com/helloworld1/FreeOTPPlus) | 1.3+ | | +| [Aegis](https://getaegis.app/) | v1.2+ | Import only, use "Plain text" option | +| [Authenticator (GNOME)](https://flathub.org/apps/details/com.belmoussaoui.Authenticator) | v4.0.0+ | Encrypted backups not supported | {: .table .table-striped} + +[Developer information](otp-backup-developer) \ No newline at end of file diff --git a/docs/zh_TW/overview.md b/docs/zh_TW/overview.md new file mode 100644 index 000000000..862c30e00 --- /dev/null +++ b/docs/zh_TW/overview.md @@ -0,0 +1,19 @@ +--- +title: What is Authenticator Extension? +stub: overview +lang: en +ver: 1 +--- + +Authenticator Extension is an in-browser One-Time Password (OTP) client. Authenticator Extension supports both Time-Based One-Time Password (TOTP, specified in [RFC 6238](https://tools.ietf.org/html/rfc6238)) and HMAC-Based One-Time Password (HOTP, specified in [RFC 4226](https://tools.ietf.org/html/rfc4226)). + +In other words, Authenticator Extension can serve as a drop-in replacement for apps such as Google Authenticator. + +## Key Features + +* Add accounts by scanning QR codes +* Encrypt data with a password +* Sync data between browsers +* Backup data to cloud services or export data to a file +* Smart filtering and search +* Battle.net and Steam support \ No newline at end of file diff --git a/docs/zh_TW/policy-config.md b/docs/zh_TW/policy-config.md new file mode 100644 index 000000000..c263d6fbf --- /dev/null +++ b/docs/zh_TW/policy-config.md @@ -0,0 +1,50 @@ +--- +title: Policy Configuration +stub: policy-config +lang: en +ver: 1 +--- + +This page is for administrators. Supported settings are documented in [schema-chrome.json](https://github.com/Authenticator-Extension/Authenticator/blob/release/manifests/schema-chrome.json). More information is available below. Open an issue to request more policy controls. + +#### Extension IDs + +Chrome: `bhghoamapcdpbohphigoooaddinpkbai` + +Firefox: `authenticator@mymindstorm` + +## Firefox + +Documentation: [Deploy](https://support.mozilla.org/en-US/kb/deploying-firefox-with-extensions), [Configure](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests) + +Example: + +```jsonc +{ + "name": "authenticator@mymindstorm", + "description": "ignored", + "type": "storage", + "data": + { + // Your settings here + } +} +``` + +## Chrome + +Documentation: [Deploy](https://support.google.com/chrome/a/answer/6306504), [Configure](https://chromium.org/administrators/configuring-policy-for-extensions) + +The format for Chrome policies is different per-platform, but a working config for Linux would look like this: + +```jsonc +{ + "3rdparty": { + "extensions": { + "bhghoamapcdpbohphigoooaddinpkbai": { + // Your settings here + } + } + } +} +``` \ No newline at end of file diff --git a/docs/zh_TW/quickstart.md b/docs/zh_TW/quickstart.md new file mode 100644 index 000000000..27e3b6eb1 --- /dev/null +++ b/docs/zh_TW/quickstart.md @@ -0,0 +1,45 @@ +--- +title: Add Your First Account +stub: quickstart +lang: en +ver: 2 +--- + +This quickstart explains how to add an example account to Authenticator Extension. + +## Prerequisites + +Install Authenticator Extension ([Chrome](https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/auth-helper/), [Edge](https://microsoftedge.microsoft.com/addons/detail/ocglkepbibnalbgmbachknglpdipeoio)) + +When you first install Authenticator Extension in Chrome, you should pin its icon to the toolbar. + +![pin to toolbar](/assets/quickstart/pin-to-toolbar.png) + +## Add a QR Code + +1. Click Authenticator Extension's icon in your browser + +2. Click the scan icon at the top right corner of the window. + + ![click qr button](/assets/quickstart/add-qr.png) + +3. Click and drag to draw a square that completely covers the QR code + + + +4. After the new account is added, you will see a new entry in the window. + +The 6-digit number is your current one-time password, circle at bottom right corner tells you how much time left for the current password. If you want to add this account into a mobile app, you can click the QR icon at top right corner of the entry to show the QR code for this account. + +## Add an Account Manually + +1. Click Authenticator Extension's icon in your browser + +2. Click the pencil icon at the top right corner of the window. ![manual entry](/assets/quickstart/click-edit.png) + +3. Click the plus button at the top right corner of the window. Select **Manual Entry**. ![manual entry](/assets/quickstart/click-add.png) + +4. Input the name of the website that this account is associated with in **Issuer** field, the account secret given to you in the **Secret** field, and finally click **Ok**. ![add account](/assets/quickstart/add-account.png) + +5. After the new account is added, you will see a new entry in the window. ![entry](/assets/quickstart/example-entry.png) +