Improved docs to better reflect authenticating to Private Clouds (#1187)

* Updated docs to reflect authenticating to Private Clouds

* Added rate limit warning

* updated docs

Author: duedares-rvj

README.md

@@ -134,11 +134,22 @@ auth0 login
 
 There are two ways to authenticate:
 
-- **As a user** - Recommended when invoking on a personal machine or other interactive environment. Facilitated by [device authorization](https://auth0.com/docs/get-started/authentication-and-authorization-flow/device-authorization-flow) flow.
-- **As a machine** - Recommended when running on a server or non-interactive environments (ex: CI). Facilitated by [client credentials](https://auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow) flow. Flags available for bypassing interactive shell.
+- **As a user** - Recommended when invoking on a personal machine or other interactive environment. Facilitated by [device authorization](https://auth0.com/docs/get-started/authentication-and-authorization-flow/device-authorization-flow) flow and cannot be used for private cloud tenants.
+- **As a machine** - Recommended when running on a server or non-interactive environments (ex: CI, authenticating to a **private cloud**).  Facilitated by [client credentials](https://auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow) flow. Flags available for bypassing interactive shell.
+
+
 
 > **Warning**
-> Authenticating as a user is not supported for **private cloud** tenants. Instead, those users should authenticate with client credentials.
+> Authenticating as a user is not supported for **private cloud** tenants. 
+> Instead, those users should authenticate with client credentials.
+> Refer command below:
+
+```bash
+auth0 login --domain <domain> --client-id <client-id> --client-secret <client-secret>
+```
+
+> **Note:**
+> Using the CLI will consume Management API rate limits according to the subscription plan. Ref [Rate limit Policy](https://auth0.com/docs/troubleshoot/customer-support/operational-policies/rate-limit-policy)
 
 ## Available Commands
 

docs/auth0_login.md

@@ -4,9 +4,12 @@ has_toc: false
 ---
 # auth0 login
 
-Authenticates the Auth0 CLI either as a user using personal credentials or as a machine using client credentials.
+Authenticates the Auth0 CLI using either personal credentials (user login) or client credentials (machine login).
+
+Use user login on personal machines or interactive environments (not supported for Private Cloud users).
+Use machine login for servers, CI, or any non-interactive environments — this is the recommended method for Private Cloud users.
+
 
-Authenticating as a user is recommended when working on a personal machine or other interactive environment; it is not available for Private Cloud users. Authenticating as a machine is recommended when running on a server or non-interactive environments (ex: CI).
 
 ## Usage
 ```

internal/cli/login.go

@@ -68,10 +68,10 @@ func loginCmd(cli *cli) *cobra.Command {
 		Use:   "login",
 		Args:  cobra.NoArgs,
 		Short: "Authenticate the Auth0 CLI",
-		Long: "Authenticates the Auth0 CLI either as a user using personal credentials or as a machine using client " +
-			"credentials.\n\nAuthenticating as a user is recommended when working on a personal machine or other " +
-			"interactive environment; it is not available for Private Cloud users. Authenticating as a machine is " +
-			"recommended when running on a server or non-interactive environments (ex: CI).",
+		Long: "Authenticates the Auth0 CLI using either personal credentials (user login) or client credentials (machine login)." +
+			"\n\nUse user login on personal machines or interactive environments (not supported for Private Cloud users).\n" +
+			"Use machine login for servers, CI, or any non-interactive environments — " +
+			"this is the recommended method for Private Cloud users.\n\n",
 		Example: `  auth0 login
   auth0 login --domain <tenant-domain> --client-id <client-id> --client-secret <client-secret>
   auth0 login --scopes "read:client_grants,create:client_grants"`,