directory_source_oauth_confirm_required
Developer and IT administrator messages for directory_source_oauth_confirm_required.
Since API version 1.1.
| Field | Value |
|---|---|
| Type | permission |
| Status | 403 |
| Surfaces | api, portal |
| Retryable | No |
What it means
Section titled “What it means”The authorization_url of a Connect Gusto, BambooHR or Google start is an OhAuthCat confirm page that names the organization and environment the directory will attach to. Only pressing Continue on that page, in the same browser, sends the IT admin on to the provider. This code means the flow reached OhAuthCat without that confirmation, so nothing was connected.
Likely causes
Section titled “Likely causes”- The link was opened in one browser and the provider’s consent screen finished in another.
- The browser blocked or dropped the confirm page’s cookie, for example in a strict privacy mode.
- Something posted the confirm form without the page’s own
csrffield or from another origin. - The provider’s consent URL was used directly instead of the
authorization_url.
How to fix it
Section titled “How to fix it”For developers
Section titled “For developers”- Send the IT admin’s browser to the
authorization_urlitself, not to a provider URL you build. - Start a new connect (
POST /) and ask them to finish it in one browser.v1/ directories/ {dir}/ source/ oauth/ start
For IT administrators
Section titled “For IT administrators”- Open the setup link again, check the organization name on the page and press Continue, then finish in the same browser.
Example
Section titled “Example”The provider returns the browser to OhAuthCat, which redirects to the app’s return_url with the error:
https://app.example.com/setup?ohauthcat_oauth=error&error_code=directory_source_oauth_confirm_required&directory_id=dir_01J9Z3K5V7W8X9Y0Z1A2B3C4D5Developer message
Section titled “Developer message”The connect link was not confirmed on its OhAuthCat confirm page (missing or mismatched confirm cookie, CSRF field or Origin), so nothing was connected; open the authorization_url and press Continue
IT administrator message
Section titled “IT administrator message”This connection wasn’t confirmed. Open the link again and press Continue
Translated IT administrator messages
Section titled “Translated IT administrator messages”The hosted portal shows these machine translations, which native speakers have not reviewed yet. Placeholders and identity provider console labels stay in English.
de: Diese Verbindung wurde nicht bestätigt. Öffnen Sie den Link erneut und klicken Sie auf Weiteres: Esta conexión no se confirmó. Vuelva a abrir el enlace y pulse Continuarfr: Cette connexion n’a pas été confirmée. Rouvrez le lien et cliquez sur Continuerja: この接続は確認されていません。リンクをもう一度開き、[続行] を押してくださいpt-BR: Esta conexão não foi confirmada. Abra o link novamente e clique em Continuar
Security invariants: 88.