Improving example properties for token provider

I've added all properties that can be configured, along with comments describing what their values should be set to and in which cases they will be required.

Author: Michael-A-McMahon

ojdbc-provider-azure/example-token.properties

@@ -37,14 +37,101 @@
 ################################################################################
 
 # An example of a connection properties file that configures Oracle JDBC to
-# login using an OAUTH access token issued by Azure's Active Directory service.
+# login using an OAuth access token issued by Azure's Active Directory service.
 #
 # This file can be located by Oracle JDBC using the "oracle.jdbc.config.file"
 # connection property. For details, see:
 # https://docs.oracle.com/en/database/oracle/oracle-database/23/jajdb/oracle/jdbc/OracleConnection.html#CONNECTION_PROPERTY_CONFIG_FILE
 
-# Configures the Azure OAUTH Token Provider. The application ID URI of the
-# database is configured as an environment variables or JVM system properties
-# named "DATABASE_APP_ID_URI".
+# The oracle.jdbc.provider.accessToken property needs to be configured as 
+# the value seen below. This property enables the Oracle JDBC to use the
+# Azure Access Token Provider.
 oracle.jdbc.provider.accessToken=ojdbc-provider-azure-token
-oracle.jdbc.provider.accessToken.scope=${DATABASE_APP_ID_URI}/.default
+
+# The scope property needs to identify an application that represents
+# Oracle Database. The scope is composed of the application ID URI of
+# from the database's App Registration, followed by the name of a scope
+# or ".default".
+# The value of this property is described here:
+# https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc
+# And the registration of a database application is described here:
+# https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/registering-oracle-database-instance-microsoft-entra-id-tenancy.html
+oracle.jdbc.provider.accessToken.scope=https://example.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/.default
+
+# The authenticationMethod property is optional in most cases. If this
+# property is not configured, a provider will try each non-interactive
+# authentication method until one succeeds:
+# 1. service-principal
+# 2. password
+# 3. managed-identity
+# In addition to the values listed above, this property can be set to one
+# of the following values to use an interactive method: interactive or device-code
+# These values are described here: 
+# https://github.com/oracle/ojdbc-extensions/tree/main/ojdbc-provider-azure#configuring-authentication-for-resource-providers
+# oracle.jdbc.provider.accessToken.authenticationMethod=interactive
+
+# The tenantId property will override the AZURE_TENANT_ID environment variable. 
+# If the environment variable is not set, this property needs to be configured
+# for service-principal and password authentication. 
+# The value of this property is described here:
+# https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant
+# oracle.jdbc.provider.accessToken.tenantId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+
+# The clientId property will override the AZURE_CLIENT_ID environment variable. 
+# If that environment variable is not set, this property needs to be configured
+# for service-principal and password authentication. For managed-identity 
+# authentication, this property can be used to authenticate as a user assigned 
+# managed identity.
+# The value of this property is the Application (client) ID from an App Registration
+# as described here:
+# https://learn.microsoft.com/en-us/entra/identity-platform/v2-protocols#app-registration
+# oracle.jdbc.provider.accessToken.clientId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+
+# The clientCertificatePath property will override the AZURE_CLIENT_CERTIFICATE_PATH 
+# environment variable. 
+# If that environment variable is not set, this property needs to be configured
+# for service-principal authentication, unless a client secret is being used instead.
+# The value of this property is the file system path of a certificate file
+# as described here:
+# https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal#option-1-recommended-upload-a-trusted-certificate-issued-by-a-certificate-authority
+# oracle.jdbc.provider.accessToken.clientCertificatePath=/path/to/certificate.pem
+
+# The clientCertificatePassword property will override the AZURE_CLIENT_CERTIFICATE_PASSWORD 
+# environment variable. 
+# If that environment variable is not set, this property needs to be configured
+# for service-principal authentication if a PFX certificate is used. This property is
+# not required if a PEM certificate is used, or if a client secret is used instead of
+# a certificate.
+# The value of this property is the password used to protect a PFX certificate file
+# located by the clientCertificatePath property (above) or the 
+# AZURE_CLIENT_CERTIFICATE_PATH environment variable
+# oracle.jdbc.provider.accessToken.clientCertificatePassword=xxxxxxxx
+
+# The clientSecret property will override the AZURE_CLIENT_SECRET environment variable. 
+# If that environment variable is not set, this property needs to be configured
+# for service-principal authentication, unless a certificate is used instead.
+# The value of this property is a client secret from an App registration, as
+# described here:
+# https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal#option-3-create-a-new-client-secret
+# oracle.jdbc.provider.accessToken.clientSecret=xxxxxxxx
+
+# The username property will override the AZURE_USERNAME environment variable. 
+# If that environment variable is not set, this property needs to be configured
+# for password authentication.
+# The value of this property is the username of an Azure account.
+# oracle.jdbc.provider.accessToken.username=xxxxxxxx
+
+# The password property will override the AZURE_PASSWORD environment variable. 
+# If that environment variable is not set, this property needs to be configured
+# for password authentication.
+# The value of this property is the password of an Azure account identified by the
+# username property or AZURE_USERNAME environment variable.
+# oracle.jdbc.provider.accessToken.password=xxxxxxxx
+
+# The redirectUri property only needs to be configured for interactive authentication.
+# If it is not configured, a provider will use any available port on http://localhost
+# by default.
+# The value of this property is a redirect URL which has been added to an App 
+# registration, as described here:
+# https://learn.microsoft.com/en-us/entra/identity-platform/reply-url
+# oracle.jdbc.provider.accessToken.redirectUri=http://localhost:8080