CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 4 of 12

Two-factor authentication

When a company requires two-factor authentication, its API tokens work only for people who have set it up.

On this page

A token is not asked for a code. The check is whether the person behind the token has set up two-factor authentication when their company requires it.

Who is refused

Company requires two-factorPerson has set it upResult
NoEitherAllowed
YesYesAllowed
YesNo403

Which requests are checked

An endpoint's reference page says whether the check applies. The table says, for each area, whether its requests are checked.

AreaNeeds two-factor enrolment
AccountNone
Agencies and clients2 of 6 requests
AgencyNone
CoreClusterEvery request
DatabaseEvery request
DemosEvery request
Enterprise copies3 of 5 requests
Enterprise deploymentsSome requests
Environment variables3 of 4 requests
OperationsEvery request
OrganisationsNone
PHPEvery request
Packages and capacityEvery request
Password protectionEvery request
Performance auditsNone
Platform pluginsEvery request
Registry secrets4 of 5 requests
Repository connections2 of 4 requests
SitesEvery request
SnapshotsEvery request
SupportNone
TeamNone
Websites and environmentsSome requests
What's newNone
AccessEvery request
Application versionsNone
Create a siteEvery request
Platform tools2 of 4 requests
Marketplace keys6 of 8 requests
BillingEvery request
CopiesEvery request
CloudflareEvery request
EnvironmentsEvery request
Scheduled tasksEvery request
Deployment templatesEvery request
Deployment pipelineEvery request
Variables and secretsEvery request
DeploymentsEvery request
DomainsEvery request
Outbound email9 of 12 requests
Error pagesEvery request
FeedbackEvery request
Firewall7 of 20 requests
LogsEvery request
Magento storesEvery request
Maintenance modeEvery request
Maintenance windows6 of 14 requests
Web server rulesEvery request
Node.jsEvery request
OrdersEvery request
PageSpeedEvery request
PHP settingsEvery request
Laravel queuesEvery request
RedirectsEvery request
Pending changesEvery request
Account securityNone
SSH keysSome requests
TerminalEvery request
VarnishEvery request

The refusal

json
{
  "message": "Two-factor enrolment is required before using this.",
  "reason": "two_factor_required",
  "code": "two_factor_required"
}

The reason is the same on every endpoint the check guards. Set up two-factor authentication on your profile in the Control Panel, then send the request again with the same token.

Was this helpful?
Open in ClaudeOpen in ChatGPT