add api client auth section to profile user guide

Author: tora-kozic

docs/userguides/profile.md

@@ -3,7 +3,9 @@
 Use the [code42 profile](../commands/profile.md) set of commands to establish the Code42 environment you're working
 within and your user information.
 
-First, create your profile:
+## User token authentication
+
+Use the following command to create your profile with user token authentication:
 ```bash
 code42 profile create --name MY_FIRST_PROFILE --server example.authority.com --username [email protected]
 ```
@@ -15,6 +17,19 @@ Your password is not shown when you do `code42 profile show`. However, `code42 p
 password exists for your profile. If you do not set a password, you will be securely prompted to enter a password each
 time you run a command.
 
+## API client authentication
+
+Once you've generated an API Client in your Code42 console, use the following command to create your profile with API client authentication:
+```bash
+code42 profile create-api-client --name MY_API_CLIENT_PROFILE --server example.authority.com --api-client-id "key-42" --secret "code42%api%client%secret"
+```
+
+```{eval-rst}
+.. note:: Remember to escape special characters in your API client secret like `!` with a backslash. ex: `"my!secret"` should be passed in as `"my\!secret"`
+```
+
+## View profiles
+
 You can add multiple profiles with different names and the change the default profile with the `use` command:
 
 ```bash

src/code42cli/profile.py

@@ -169,7 +169,7 @@ def set_password(new_password, profile_name=None):
             "\tcode42 profile create-api-client "
             "--name <profile-name> "
             "--server <authority-URL>"
-            "--api-key <api-key> "
+            "--api-client-id <api-client-id> "
             "--secret <api-client-secret>\n",
             bold=True,
         )

tests/test_profile.py

@@ -160,13 +160,13 @@ def test_create_profile_when_api_client_uses_expected_profile_values(config_acce
     config_accessor.get_profile.side_effect = NoConfigProfileError()
     profile_name = "profilename"
     server = "server"
-    api_key = "key-42"
+    api_client_id = "key-42"
     ssl_errors_disabled = True
     cliprofile.create_profile(
-        profile_name, server, api_key, ssl_errors_disabled, False, True
+        profile_name, server, api_client_id, ssl_errors_disabled, False, True
     )
     config_accessor.create_profile.assert_called_once_with(
-        profile_name, server, api_key, ssl_errors_disabled, False, True
+        profile_name, server, api_client_id, ssl_errors_disabled, False, True
     )