OAuth interaction_required Error in Veeam Backup & Replication Console After Veeam Software Appliance Update
Challenge
The Veeam Backup & Replication Console displays the following error when attempting to connect to a Veeam Software Appliance that was recently updated:
Unable to perform OAuth authorization: interaction_required.
The Veeam Backup & Replication Console will report that it successfully auto-updated, however the connection still fails.
Cause
This issue occurs because some of Veeam Backup & Replication Console files were not updated. This can happen because the Veeam Backup & Replication Console has a configuration file, ClientUpdate.config, that contains excludeRules entries for the following files:
Veeam.Backup.UI.Launcher.dllVeeam.Backup.Shell.exe
Veeam Backup & Replication 13.0.1 included a fix that resolves the OAuth interaction_required error, and delivered in Veeam.Backup.UI.Launcher.dll. However, because this file is excluded by the Console's auto-update rules, the updated version is not retrieved and the OAuth failure persists even after the patch has been applied to the Backup Server.
Solution
The recommended solution is to remove the exclusion entries from the ClientUpdate.config file, then reconnect to the Veeam Software Appliance to trigger the download of the updated files.
On the Windows machine where the Veeam Backup & Replication Console is installed:
- Close the Veeam Backup & Replication Console and ensure no Console or Shell processes are running.
- Open the Veeam Backup & Replication Console install folder.
Default path:C:\Program Files\Veeam\Backup and Replication\Console\ - Create a backup copy of
ClientUpdate.config(for example,ClientUpdate.config.bak). - Open the
ClientUpdate.configfile and remove the following two lines from the<excludeRules>section:-
<fileName>Veeam.Backup.UI.Launcher.dll</fileName>
-
<fileName>Veeam.Backup.Shell.exe</fileName>
-
- Save the modified
ClientUpdate.configfile. - Relaunch the Veeam Backup & Replication Console and attempt to connect to the Veeam Software Appliance, the auto-update will retrieve the previously excluded binaries.
- The OAuth error should no longer occur, and the connection to the VSA should succeed.
(You may need to close and reopen the Veeam Backup & Replication Console to load the updated files.)
Validate Update Deployment
Note: The file version for Veeam.Backup.Shell.exe will display 13.0.1.180 for both the original and updated file.
In the Veeam Backup & Replication Console install folder, right-click on Veeam.Backup.UI.Launcher.dll and check the File version on the Details tab. The reported version should match that of the Veeam Software Appliance (e.g., 13.0.1.2067).
Alternatively, the file versions may be checked using the following simple PowerShell command:
If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.
Spelling error in text
Thank you!
Your feedback has been received and will be reviewed.
KB Feedback/Suggestion
This form is only for KB Feedback/Suggestions, if you need help with the software open a support case
Thank you!
Your feedback has been received and will be reviewed.
Oops! Something went wrong.
Please, try again later.