You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by li...@apache.org on 2022/06/15 02:19:44 UTC

[pulsar] branch master updated: [fix][doc] Add an import statement to the Java code sample for Oauth2 (#16048)

This is an automated email from the ASF dual-hosted git repository.

liuyu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git


The following commit(s) were added to refs/heads/master by this push:
     new 71b0dd73435 [fix][doc] Add an import statement to the Java code sample for Oauth2 (#16048)
71b0dd73435 is described below

commit 71b0dd73435e8690460664861d474c570aff7eb4
Author: momo-jun <60...@users.noreply.github.com>
AuthorDate: Wed Jun 15 10:19:39 2022 +0800

    [fix][doc] Add an import statement to the Java code sample for Oauth2 (#16048)
---
 site2/docs/concepts-messaging.md                         |  2 +-
 site2/docs/security-oauth2.md                            | 16 +++++++++++-----
 .../versioned_docs/version-2.10.0/security-oauth2.md     | 16 +++++++++++-----
 .../versioned_docs/version-2.6.1/security-oauth2.md      | 10 ++++++----
 .../versioned_docs/version-2.6.2/security-oauth2.md      | 10 ++++++----
 .../versioned_docs/version-2.6.3/security-oauth2.md      | 10 ++++++----
 .../versioned_docs/version-2.6.4/security-oauth2.md      |  4 +++-
 .../versioned_docs/version-2.7.0/security-oauth2.md      |  4 +++-
 .../versioned_docs/version-2.7.1/security-oauth2.md      |  4 +++-
 .../versioned_docs/version-2.7.2/security-oauth2.md      | 10 ++++++----
 .../versioned_docs/version-2.7.3/security-oauth2.md      | 10 ++++++----
 .../versioned_docs/version-2.7.4/security-oauth2.md      | 10 ++++++----
 .../versioned_docs/version-2.8.0/security-oauth2.md      | 15 ++++++++++-----
 .../versioned_docs/version-2.8.1/security-oauth2.md      | 15 ++++++++++-----
 .../versioned_docs/version-2.8.2/security-oauth2.md      | 15 ++++++++++-----
 .../versioned_docs/version-2.8.3/security-oauth2.md      | 15 ++++++++++-----
 .../versioned_docs/version-2.9.0/security-oauth2.md      | 15 ++++++++++-----
 .../versioned_docs/version-2.9.1/security-oauth2.md      | 15 ++++++++++-----
 .../versioned_docs/version-2.9.2/security-oauth2.md      | 15 ++++++++++-----
 19 files changed, 138 insertions(+), 73 deletions(-)

diff --git a/site2/docs/concepts-messaging.md b/site2/docs/concepts-messaging.md
index 79da84c7293..4c5cbad6937 100644
--- a/site2/docs/concepts-messaging.md
+++ b/site2/docs/concepts-messaging.md
@@ -868,7 +868,7 @@ There are diverse system topics depending on namespaces. The following table out
 | Namespace | TopicName | Domain | Count | Usage |
 |-----------|-----------|--------|-------|-------|
 | pulsar/system | `transaction_coordinator_assign_${id}` | Persistent | Default 16 | Transaction coordinator |
-| pulsar/system | `_transaction_log${tc_id}` | Persistent | Default 16 | Transaction log |
+| pulsar/system | `__transaction_log_${tc_id}` | Persistent | Default 16 | Transaction log |
 | pulsar/system | `resource-usage` | Non-persistent | Default 4 | Resource group service |
 | host/port | `heartbeat` | Persistent | 1 | Heartbeat detection |
 | User-defined-ns | [`__change_events`](concepts-multi-tenancy.md#namespace-change-events-and-topic-level-policies) | Persistent | Default 4 | Topic events |
diff --git a/site2/docs/security-oauth2.md b/site2/docs/security-oauth2.md
index 45408d318e2..bc6a8b387c7 100644
--- a/site2/docs/security-oauth2.md
+++ b/site2/docs/security-oauth2.md
@@ -18,7 +18,7 @@ The authentication type determines how to obtain an access token through an OAut
 
 :::note
 
-Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 :::
 
@@ -83,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 URL issuerUrl = new URL("https://dev-kt-aa9ne.us.auth0.com");
 URL credentialsUrl = new URL("file:///path/to/KeyFile.json");
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -213,7 +215,11 @@ This example shows how to configure OAuth2 authentication in Node.js client.
 
 ```
 
-> Note: The support for OAuth2 authentication is only available in Node.js client 1.6.2 and later versions.
+:::note
+
+The support for OAuth2 authentication is only available in Node.js client 1.6.2 and later versions.
+
+:::
 
 ## Broker configuration
 To enable OAuth2 authentication in brokers, add the following parameters to the `broker.conf` or `standalone.conf` file.
@@ -251,7 +257,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -270,7 +276,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -288,5 +294,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.10.0/security-oauth2.md b/site2/website/versioned_docs/version-2.10.0/security-oauth2.md
index 63c7d968140..b1fdb124a4d 100644
--- a/site2/website/versioned_docs/version-2.10.0/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.10.0/security-oauth2.md
@@ -19,7 +19,7 @@ The authentication type determines how to obtain an access token through an OAut
 
 :::note
 
-Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 :::
 
@@ -84,6 +84,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 URL issuerUrl = new URL("https://dev-kt-aa9ne.us.auth0.com");
 URL credentialsUrl = new URL("file:///path/to/KeyFile.json");
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -214,7 +216,11 @@ This example shows how to configure OAuth2 authentication in Node.js client.
 
 ```
 
-> Note: The support for OAuth2 authentication is only available in Node.js client 1.6.2 and later versions.
+:::note
+
+The support for OAuth2 authentication is only available in Node.js client 1.6.2 and later versions.
+
+:::
 
 ## CLI configuration
 
@@ -235,7 +241,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -254,7 +260,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -272,5 +278,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.6.1/security-oauth2.md b/site2/website/versioned_docs/version-2.6.1/security-oauth2.md
index efda09d6d7c..fbea9674901 100644
--- a/site2/website/versioned_docs/version-2.6.1/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.6.1/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -165,7 +167,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -184,7 +186,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -202,5 +204,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.6.2/security-oauth2.md b/site2/website/versioned_docs/version-2.6.2/security-oauth2.md
index a05ee031088..06429c998b4 100644
--- a/site2/website/versioned_docs/version-2.6.2/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.6.2/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -165,7 +167,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -184,7 +186,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -202,5 +204,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.6.3/security-oauth2.md b/site2/website/versioned_docs/version-2.6.3/security-oauth2.md
index a05ee031088..06429c998b4 100644
--- a/site2/website/versioned_docs/version-2.6.3/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.6.3/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -165,7 +167,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -184,7 +186,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -202,5 +204,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.6.4/security-oauth2.md b/site2/website/versioned_docs/version-2.6.4/security-oauth2.md
index 95b3fcccd86..be59b5510eb 100644
--- a/site2/website/versioned_docs/version-2.6.4/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.6.4/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com/oauth/token";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
diff --git a/site2/website/versioned_docs/version-2.7.0/security-oauth2.md b/site2/website/versioned_docs/version-2.7.0/security-oauth2.md
index 600b2cf543d..da469dff5ef 100644
--- a/site2/website/versioned_docs/version-2.7.0/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.7.0/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
diff --git a/site2/website/versioned_docs/version-2.7.1/security-oauth2.md b/site2/website/versioned_docs/version-2.7.1/security-oauth2.md
index 600b2cf543d..da469dff5ef 100644
--- a/site2/website/versioned_docs/version-2.7.1/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.7.1/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
diff --git a/site2/website/versioned_docs/version-2.7.2/security-oauth2.md b/site2/website/versioned_docs/version-2.7.2/security-oauth2.md
index 5bb1e245619..df60e1d91e4 100644
--- a/site2/website/versioned_docs/version-2.7.2/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.7.2/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +188,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +207,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +225,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.7.3/security-oauth2.md b/site2/website/versioned_docs/version-2.7.3/security-oauth2.md
index 5bb1e245619..df60e1d91e4 100644
--- a/site2/website/versioned_docs/version-2.7.3/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.7.3/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +188,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +207,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +225,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.7.4/security-oauth2.md b/site2/website/versioned_docs/version-2.7.4/security-oauth2.md
index 5bb1e245619..df60e1d91e4 100644
--- a/site2/website/versioned_docs/version-2.7.4/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.7.4/security-oauth2.md
@@ -18,7 +18,7 @@ This library allows you to authenticate the Pulsar client by using an access tok
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
 #### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+> Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
 
 #### Client credentials
 
@@ -80,6 +80,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +188,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +207,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +225,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.8.0/security-oauth2.md b/site2/website/versioned_docs/version-2.8.0/security-oauth2.md
index 600b2cf543d..4249e4afb1d 100644
--- a/site2/website/versioned_docs/version-2.8.0/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.8.0/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.8.1/security-oauth2.md b/site2/website/versioned_docs/version-2.8.1/security-oauth2.md
index 600b2cf543d..4249e4afb1d 100644
--- a/site2/website/versioned_docs/version-2.8.1/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.8.1/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.8.2/security-oauth2.md b/site2/website/versioned_docs/version-2.8.2/security-oauth2.md
index 600b2cf543d..4249e4afb1d 100644
--- a/site2/website/versioned_docs/version-2.8.2/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.8.2/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.8.3/security-oauth2.md b/site2/website/versioned_docs/version-2.8.3/security-oauth2.md
index 600b2cf543d..4249e4afb1d 100644
--- a/site2/website/versioned_docs/version-2.8.3/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.8.3/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 String issuerUrl = "https://dev-kt-aa9ne.us.auth0.com";
 String credentialsUrl = "file:///path/to/KeyFile.json";
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
\ No newline at end of file
diff --git a/site2/website/versioned_docs/version-2.9.0/security-oauth2.md b/site2/website/versioned_docs/version-2.9.0/security-oauth2.md
index d26e8857a36..d8421bc4755 100644
--- a/site2/website/versioned_docs/version-2.9.0/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.9.0/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 URL issuerUrl = new URL("https://dev-kt-aa9ne.us.auth0.com");
 URL credentialsUrl = new URL("file:///path/to/KeyFile.json");
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.9.1/security-oauth2.md b/site2/website/versioned_docs/version-2.9.1/security-oauth2.md
index 09f2fc71d18..97f3a6e26d8 100644
--- a/site2/website/versioned_docs/version-2.9.1/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.9.1/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2;
+
 URL issuerUrl = new URL("https://dev-kt-aa9ne.us.auth0.com");
 URL credentialsUrl = new URL("file:///path/to/KeyFile.json");
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
diff --git a/site2/website/versioned_docs/version-2.9.2/security-oauth2.md b/site2/website/versioned_docs/version-2.9.2/security-oauth2.md
index 09f2fc71d18..0ce597e78cc 100644
--- a/site2/website/versioned_docs/version-2.9.2/security-oauth2.md
+++ b/site2/website/versioned_docs/version-2.9.2/security-oauth2.md
@@ -17,8 +17,11 @@ This library allows you to authenticate the Pulsar client by using an access tok
 
 The authentication type determines how to obtain an access token through an OAuth 2.0 authorization flow.
 
-#### Note
-> Currently, the Pulsar Java client only supports the `client_credentials` authentication type .
+:::note
+
+Currently, the Pulsar Java client only supports the `client_credentials` authentication type.
+
+:::
 
 #### Client credentials
 
@@ -80,6 +83,8 @@ You can use the factory method to configure authentication for Pulsar Java clien
 
 ```java
 
+import org.apache.pulsar.client.impl.auth.oauth2.AuthenticationFactoryOAuth2; 
+
 URL issuerUrl = new URL("https://dev-kt-aa9ne.us.auth0.com");
 URL credentialsUrl = new URL("file:///path/to/KeyFile.json");
 String audience = "https://dev-kt-aa9ne.us.auth0.com/api/v2/";
@@ -186,7 +191,7 @@ tenants list
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-client
@@ -205,7 +210,7 @@ produce test-topic -m "test-message" -n 10
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).
 
 ### pulsar-perf
@@ -223,5 +228,5 @@ bin/pulsar-perf produce --service-url pulsar+ssl://streamnative.cloud:6651 \
 
 ```
 
-Set the `admin-url` parameter to the Web service URL. A Web service URLis a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
+Set the `admin-url` parameter to the Web service URL. A Web service URL is a combination of the protocol, hostname and port ID, such as `pulsar://localhost:6650`.
 Set the `privateKey`, `issuerUrl`, and `audience` parameters to the values based on the configuration in the key file. For details, see [authentication types](#authentication-types).