Merge pull request #372 from ritza-co/docs-19.01.14

Docs 19.01.14 release (Week 38, 2024)

docs/auto-discovery/cloud-auto-discovery/index.mdx

@@ -16,8 +16,8 @@ Device42 discovers cloud virtual machines, databases, and storage as devices. Th
 <ThemedImage
   alt="Cloud Discovery menu"
   sources={{
-    light: useBaseUrl('/assets/images/cloud-auto-discovery/cloud-auto-01-light.png'),
-    dark: useBaseUrl('/assets/images/cloud-auto-discovery/cloud-auto-01-dark.png'),
+    light: useBaseUrl('/assets/images/cloud-auto-discovery/cloud-discovery-type-light.png'),
+    dark: useBaseUrl('/assets/images/cloud-auto-discovery/cloud-discovery-type-dark.png'),
   }}
 />
 

docs/auto-discovery/cloud-auto-discovery/other-cloud-autodiscoveries.mdx

@@ -18,6 +18,7 @@ Device42 discovery supports the following cloud types, as listed in the dropdown
 - DigitalOcean
 - Google Cloud
 - Intune
+- Jamf
 - Linode
 - Microsoft Azure
 - OpenStack
@@ -27,8 +28,8 @@ Device42 discovery supports the following cloud types, as listed in the dropdown
 <ThemedImage
   alt="Cloud autodiscovery types"
   sources={{
-    light: useBaseUrl('/assets/images/other-cloud-autodiscovery/autodiscovery-types-light.png'),
-    dark: useBaseUrl('/assets/images/other-cloud-autodiscovery/autodiscovery-types-dark.png'),
+    light: useBaseUrl('/assets/images/other-cloud-autodiscovery/cloud-discovery-type-light.png'),
+    dark: useBaseUrl('/assets/images/other-cloud-autodiscovery/cloud-discovery-type-dark.png'),
   }}
 />
 

docs/auto-discovery/index.mdx

@@ -189,7 +189,7 @@ There is also a ping sweep tool built into Device42. Find it in the UI under **D
 
 The Device42 remote collector (RC) is a lightweight virtual appliance (a VM) that can be quickly deployed, for example, in places like a secure network segment. RCs can be selected to run autodiscovery jobs by simply choosing them when creating the job. Choose the desired RC from the **Remote Collector** dropdown when initially setting up a new autodiscovery job, or editing an existing discovery job. Most autodiscovery jobs that can be launched from the Device42 **Discovery** menu support running from a deployed RC.
 
-For more information head to the dedicated [Remote Collector page](auto-discovery/remote-collector-rc.md).
+For more information head to the dedicated [Remote Collector page](auto-discovery/remote-collector-rc.mdx).
 
 ## Scripts for Linux, Solaris, Windows, and Mac
 

docs/auto-discovery/jamf-autodiscovery.mdx

@@ -0,0 +1,81 @@
+---
+title: "Jamf Autodiscovery"
+sidebar_position: 15.5
+---
+
+import ThemedImage from '@theme/ThemedImage'
+import useBaseUrl from '@docusaurus/useBaseUrl'
+
+Device42 supports [Jamf](https://www.jamf.com/) autodiscovery from v19.02 of the Main Appliance. Run a Jamf cloud autodiscovery job to bring in your Apple ecosystem data.
+
+## Jamf Autodiscovery Items
+
+Currently, Jamf autodiscovery retrieves data on the following:
+
+- Computers
+- Mobile devices
+- IP and MAC addresses
+- Installed software and applications
+- Extension attributes (Custom Fields)
+
+## Requirements for Jamf autodiscovery
+
+To run a Jamf autodiscovery job, you need to set the appropriate permissions in your Jamf account and provide your Jamf username and password when creating the job.
+
+### Permission Requirements
+
+A standard Jamf user account with read-all permissions is required for autodiscovery. The easiest way to grant read-all permissions is to create a standard user account with the **Auditor** privilege set. 
+
+Alternatively, you can use a **Custom** privilege set with all-read permissions enabled. 
+
+For information on standard accounts and privilege sets, see the [Jamf Pro User Accounts and Groups](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/Jamf_Pro_User_Accounts_and_Groups.html) documentation.
+
+### Authentication Requirements 
+
+Your Jamf account username and password are required in the **Basic credentials** field of the **Add Cloud Autodiscovery** form.  
+
+Your username and password are used to request a bearer token. Bearer token authentication is then used for subsequent requests.
+
+## Create a Jamf Autodiscovery Job
+
+Navigate to **Discovery > Cloud** and click **+ Add Cloud Autodiscovery**. Select **Jamf** from the **Type** dropdown menu.
+
+<ThemedImage
+  alt="Add a new Jamf job"
+  sources={{
+    light: useBaseUrl('/assets/images/jamf-autodiscovery/new-job-light.png'),
+    dark: useBaseUrl('/assets/images/jamf-autodiscovery/new-job-dark.png'),
+  }}
+/>
+
+Optionally, add a **Customer for discovered devices:**
+
+<ThemedImage
+  alt="Add customer"
+  sources={{
+    light: useBaseUrl('/assets/images/jamf-autodiscovery/customer-option-light.png'),
+    dark: useBaseUrl('/assets/images/jamf-autodiscovery/customer-option-dark.png'),
+  }}
+/>
+
+### Run Now or Schedule the Job
+
+Scroll down to create a run schedule for the job. Create multiple schedules for the job with the **+ Add another Autodiscovery Schedule** button.
+
+<ThemedImage
+  alt="Create a discovery schedule"
+  sources={{
+    light: useBaseUrl('/assets/images/jamf-autodiscovery/jamf-schedule-light.png'),
+    dark: useBaseUrl('/assets/images/jamf-autodiscovery/jamf-schedule-dark.png'),
+  }}
+/>
+
+To run the job immediately, click **Save** to add it to the list of Cloud autodiscovery jobs and then click **Run Now**.
+
+<ThemedImage
+  alt="Create a discovery schedule"
+  sources={{
+    light: useBaseUrl('/assets/images/jamf-autodiscovery/jamf-run-now-light.png'),
+    dark: useBaseUrl('/assets/images/jamf-autodiscovery/jamf-run-now-dark.png'),
+  }}
+/>

docs/auto-discovery/linux-based-autodiscovery-software.md

@@ -3,7 +3,7 @@ title: "Linux Based Autodiscovery Software"
 sidebar_position: 17
 ---
 
-**Note:** Since v13.2, Device42 has supported Linux (and UNIX) based autodiscovery from within the main UI. If you are simply trying to run discovery against Linux or UNIX, see our [Linux and UNIX Server AutoDiscovery Instructions.](linux-unix-server-auto-discovery.mdx) or our [Remote Collector documentation](remote-collector-rc.md). If you want to use the standalone Linux discovery tools, continue reading below.
+**Note:** Since v13.2, Device42 has supported Linux (and UNIX) based autodiscovery from within the main UI. If you are simply trying to run discovery against Linux or UNIX, see our [Linux and UNIX Server AutoDiscovery Instructions.](linux-unix-server-auto-discovery.mdx) or our [Remote Collector documentation](remote-collector-rc.mdx). If you want to use the standalone Linux discovery tools, continue reading below.
 
 # Linux Based Autodiscovery Software