Skip to content

Commit

Permalink
Merge pull request #390 from ritza-co/hotfix-add-discovery-docs
Browse files Browse the repository at this point in the history
[hotfix] DOCS-592, 593, add automox and workspace one pages
  • Loading branch information
sixhobbits authored Nov 25, 2024
2 parents b36ad4e + 8b95c9e commit fd35c7c
Show file tree
Hide file tree
Showing 24 changed files with 194 additions and 0 deletions.
95 changes: 95 additions & 0 deletions docs/auto-discovery/cloud-auto-discovery/automox-autodiscovery.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
title: "Automox Autodiscovery"
sidebar_position: 1.5
---

import ThemedImage from '@theme/ThemedImage'
import useBaseUrl from '@docusaurus/useBaseUrl'

[Automox](https://www.automox.com/) cloud discovery retrieves up-to-date details about your devices, operating systems, and software packages directly into Device42, which serves as a source of truth for your IT environment.

This page outlines the Automox autodiscovery items, authentication requirements, and how to set up and schedule a discovery job.

## Automox Autodiscovery Items

Device42 gets the following details when an Automox discovery job is run:

- Device name
- Serial number and UUID
- Operating System (name and version)
- Hardware make and model
- CPU model
- RAM
- Mounts
- IP and MAC addresses
- Installed software packages (display name and version)

## Authentication Requirements

Your Automox username and password are required for Device42 to request a bearer token. Bearer token authentication is then used for subsequent requests.

## Create an Automox Discovery Job

Navigate to **Discovery > Cloud** and click **+ Add Cloud Autodiscovery**.

Name the autodiscovery job and under the **Type** dropdown, select **Automox**.

<ThemedImage
alt="Add a new Automax job"
sources={{
light: useBaseUrl('/assets/images/automox-autodiscovery/type-dropdown-light.png'),
dark: useBaseUrl('/assets/images/automox-autodiscovery/type-dropdown-dark.png'),
}}
/>

Next to **Bearer Token**, click on the **magnifying glass icon** and select or create a Secret with your Automox username and password.

<ThemedImage
alt="Provide your Automox credentials"
sources={{
light: useBaseUrl('/assets/images/automox-autodiscovery/add-credentials-light.png'),
dark: useBaseUrl('/assets/images/automox-autodiscovery/add-credentials-dark.png'),
}}
/>

### Optional Fields

You can optionally select or add a **Service Level** to associate with the discovered Automox Configuration Items.

Choose an **Object Category for discovered devices**. If you'd like for the object category of existing devices to match the newly selected object, check the **Overwrite existing object categories** box.

Add **Tags for discovered devices** to categorize and later help you filter the discovered devices by your chosen tags.

<ThemedImage
alt="Optional autodiscovery job fields"
sources={{
light: useBaseUrl('/assets/images/automox-autodiscovery/options-light.png'),
dark: useBaseUrl('/assets/images/automox-autodiscovery/options-dark.png'),
}}
/>

### Schedule the Autodiscovery Job

You can automate the autodiscovery process by choosing the day(s) and time(s) when the job runs.

Create multiple jobs using the **+ Add another Autodiscovery Schedule** button.

<ThemedImage
alt="Schedule the job"
sources={{
light: useBaseUrl('/assets/images/automox-autodiscovery/schedule-light.png'),
dark: useBaseUrl('/assets/images/automox-autodiscovery/schedule-dark.png'),
}}
/>

### Run Now

Run the job immediately by navigating back to the **Cloud Autodiscovery** list page and clicking **Run Now** next to the job.

<ThemedImage
alt="Run the Automox job immediately"
sources={{
light: useBaseUrl('/assets/images/automox-autodiscovery/run-now-light.png'),
dark: useBaseUrl('/assets/images/automox-autodiscovery/run-now-dark.png'),
}}
/>
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
---
title: "Workspace ONE UEM (AirWatch) Autodiscovery"
sidebar_position: 8
---

import ThemedImage from '@theme/ThemedImage'
import useBaseUrl from '@docusaurus/useBaseUrl'

Workspace ONE Unified Endpoint Management (UEM), formerly known as VMware AirWatch, is supported by Device42 autodiscovery.

Create and schedule an autodiscovery job to fetch data about the devices and apps managed by your Workspace ONE UEM account and keep your Device42 CMDB updated as a central source of truth.

This page outlines the discovered items and how to set up and run a Workspace ONE UEM autodiscovery job.

## Workspace ONE UEM Autodiscovery Items

Currently, the following data is retrieved:

- Computers
- Mobile devices
- IP and MAC addresses
- Installed software and applications

## Create a Workspace ONE Autodiscovery Job

Navigate to **Discovery > Cloud** and click **+ Add Cloud Autodiscovery**.

Name the autodiscovery job, and under the **Type** dropdown, select **Workspace One**. Provide your account **URL** and **Tenant**, and select a **Remote Collector** to use for the job.

<ThemedImage
alt="Create a basic Workspace ONE autodiscovery job"
sources={{
light: useBaseUrl('/assets/images/workspace-one-eum-airwatch/add-new-job-light.png'),
dark: useBaseUrl('/assets/images/workspace-one-eum-airwatch/add-new-job-dark.png'),
}}
/>

### Add Credentials

Provide you Workspace ONE EUM username and password by creating a secure Secret. Click the **magnifying glass icon** next to **Basic credentials** to add a new Secret.

<ThemedImage
alt="Add new secret"
sources={{
light: useBaseUrl('/assets/images/workspace-one-eum-airwatch/basic-credentials-light.png'),
dark: useBaseUrl('/assets/images/workspace-one-eum-airwatch/basic-credentials-dark.png'),
}}
/>

### Optional Fields

Choose how to associate vendor metadata to the autodiscovered items. Under **Add device vendor metadata as**, you can specify **Custom Fields**, **Tags**, or **Do Nothing**.

<ThemedImage
alt="Vendor metadata option"
sources={{
light: useBaseUrl('/assets/images/workspace-one-eum-airwatch/vendor-metadata-option-light.png'),
dark: useBaseUrl('/assets/images/workspace-one-eum-airwatch/vendor-metadata-option-dark.png'),
}}
style={{ width: '50%' }}
/>

Choose an **Object Category for discovered devices**. If you'd like the object category of existing devices to match the newly selected object, check the **Overwrite existing object categories** box.

Add **Tags for discovered devices** to categorize and later help you filter the discovered devices by your chosen tags.

<ThemedImage
alt="Additional options"
sources={{
light: useBaseUrl('/assets/images/workspace-one-eum-airwatch/additional-options-light.png'),
dark: useBaseUrl('/assets/images/workspace-one-eum-airwatch/additional-options-dark.png'),
}}
/>

### Schedule the Autodiscovery Job

You can automate the autodiscovery process by choosing the day(s) and time(s) that the job will run.

Create multiple jobs using the **+ Add another Autodiscovery Schedule** button.

<ThemedImage
alt="Schedule job"
sources={{
light: useBaseUrl('/assets/images/workspace-one-eum-airwatch/job-schedule-light.png'),
dark: useBaseUrl('/assets/images/workspace-one-eum-airwatch/job-schedule-dark.png'),
}}
/>

### Run Now

Run the job immediately by navigating back to the **Cloud Autodiscovery** list page and clicking **Run Now** next to the job.

<ThemedImage
alt="Run the job"
sources={{
light: useBaseUrl('/assets/images/workspace-one-eum-airwatch/run-job-now-light.png'),
dark: useBaseUrl('/assets/images/workspace-one-eum-airwatch/run-job-now-dark.png'),
}}
/>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit fd35c7c

Please sign in to comment.