[SDK-2757] Improve support for custom domain configurations

[evansims]

Changes

A community GitHub issue was reported (#538) in which Management SDK calls don't work with custom domains "out of the box." After some testing, I confirmed our current handling of the single-use domain configuration option in both the stable and upcoming release of the PHP are not adequate to cover the needs of custom domain users.

In particular, without providing a means of specifying both the tenant domain and a custom domain, Management SDK calls will be broken unless the customer writes custom code exchange boilerplate because of the reasons outlined here: https://auth0.com/docs/brand-and-customize/custom-domains#step-3-complete-feature-specific-setup

This PR adds a new configuration option, customDomain. When this is configured, the SDK will automatically adapt API calls and Token verifications to ensure the appropriate domains are used at the appropriate times. This fixes out-of-the-box Management SDK calls and provides a clearer API by explicitly separating the definitions of tenant domain and custom domain during configuration.

References

Resolves #538

Testing

• Test coverage was added for the changes.
• All tests pass with 100% coverage.
• Run composer run tests or composer run tests:docker to run these tests locally, or review the CircleCI tests ran on this PR.

Contributor Checklist

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 Code of Conduct

[Nyholm]

Lovely!

I tested this and it works for me.
Thank you

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.