feat(Authentication): Add support for Client Assertion

[evansims]

Description

This PR adds support for Client Assertion, as an alternative to using Client Secrets, when making requests against the Authentication API.

Changes include the introduction of two new SDK configuration properties:

• clientAssertionSigningKey, which accepts an OpenSSLAsymmetricKey object, a PEM formatted private key as a string, a file path to a PEM certificate (e.g. file://path/to/file.pem), or null to disable the feature. Defaults to null.
• clientAssertionSigningAlgorithm, which accepts a string. Defaults to RS256.

When configured, the clientAssertionSigningKey will take precedence over any configured clientSecret, where appropriate.

When passing a string as the value to clientAssertionSigningKey, the format can be anything the OpenSSL openssl_pkey_get_private()

Changes also include a new class, Auth0\SDK\Token\ClientAssertionGenerator. This is a template interstitial for Auth0\SDK\Token\Generator that will apply the necessary configuration to create a JSON Web Token appropriate for use with the Client Assertion feature.

Type of change

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update

Checklist

• My code follows the contributing guidelines of this repo
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass with my changes
• I have read the Auth0 general contribution guidelines
• I have read the Auth0 code of conduct

[github-actions]

👋 Thanks for contributing! Please be patient while a maintainer reviews your PR. In the meantime, please make sure you've read our contributing guide.

[codecov-commenter]

Codecov Report

Base: 100.00% // Head: 100.00% // No change to project coverage 👍

Coverage data is based on head (87a7de7) compared to base (2e23ec4).
Patch coverage: 100.00% of modified lines in pull request are covered.

Additional details and impacted files

@@             Coverage Diff             @@
##                main      #699   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
  Complexity      1282      1282           
===========================================
  Files             66        66           
  Lines           4498      4498           
===========================================
  Hits            4498      4498           

Impacted Files	Coverage Δ
src/API/Authentication.php	100.00% <100.00%> (ø)
src/Configuration/SdkConfiguration.php	100.00% <100.00%> (ø)
src/Token/Generator.php	100.00% <100.00%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.