Official docs out of date for API grant types needed
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Stale
- Tech stack
- php
- Domain
- api, authentication
Research direction
Start with the linked Configure Login by Auth0 documentation and the README, then reproduce the failure from the listed Sync settings steps using the stated WordPress and Auth0 versions. Confirm which grant types each sync option requires and document them; done when setup no longer relies on undocumented scopes and the failure provides useful guidance.
Written by the indexing model from the issue text.
Description
Checklist
- I have looked into the Readme and the documentation, and have not found a suitable solution or answer.
- I have searched the issues and have not found a suitable solution or answer.
- I have searched the Auth0 Community forums and have not found a suitable solution or answer.
- I agree to the terms within the Auth0 Code of Conduct.
Description
Adding Sync configuration settings in the admin fails with a fatal error and no useful error message if the application API is not configured to have the currently undocumented grant types of read:connections and I think create:user_tickets. Additionally depending on the sync options chosen you might need delete:users as well as read:users and create:users and update:users.
Those should at least be documented in the readme here, but you'll know best which scopes are actually needed now with v5.
To provide proper error messages and handling it probably needs read:client_grants too to help users know how to resolve the problem.
Reproduction
- Create an auth0 application and configure the API per the current docs with
read:usersandupdate:usersscopes enabled - Go to the admin Sync settings page for the plugin and enter a db connection name
- Save changes
- Fatal error screen shows
Additional context
No response
wp-auth0 version
5.5
WordPress version
6.9
PHP version
8.4
- Dominant language
- PHP
- Stars
- 182
- Forks
- 103
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from auth0/wordpress
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 3/5 1-2 days Newbie friendliness 78/100
-
Difficulty 4/5 3-5 days Newbie friendliness 35/100
-
Roadmap: Backlog
Difficulty 4/5 3-5 days Newbie friendliness 35/100
Similar issues
-
priority: p3
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
googleapis/librarian#7636 ·
-
0. Needs triage bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
nextcloud/fulltextsearch#1011 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
phpstan/phpstan-doctrine#794 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Automattic/static-site-importer#1767 ·