Inventorying macOS Systems

Introduction

The macOS inventory enables agentless collection of all relevant macOS systems within the IT infrastructure.
The Docusnap Enterprise Gateway (DEG) handles all communication between Docusnap365 and the target systems.
Similar to Linux inventory, access to macOS systems is performed exclusively via SSH.
For authentication, username/password or private keys are supported.

Basics

For a successful inventory, the macOS wizard requires the following information:

• Enterprise Gateway: Select an active Docusnap Enterprise Gateway.

• Basic Information: Specify organization, platform, and location.

• Inventory Data:

  • IPv4 address, IP address range, or hostname
  • Username and password or private key (including optional passphrase)
  • Optional: SSH port (default 22)

Prerequisites:

• The SSH service must be active on the target system and port 22 reachable.
• The specified user needs a valid home directory and bash or zsh as the default shell.
• Root or sudo privileges ensure that all system information can be collected.

General information about the wizards and scheduling can be found in the Wizard Guide.

“macOS” Wizard

The macOS wizard guides you step-by-step through the system inventory:

• Variant 1: IP address or IP address range
• Variant 2: Hostname or Fully Qualified Domain Name (FQDN)

Variant 1: IP address or IP address range

In the IPv4/Range/Hostname field, specify a single IP address or a complete IP address range.
Username, password, or private key always form a single unit.
Click New to add a new row.
After the job has been submitted to the Docusnap Enterprise Gateway, each address is inventoried individually.
Overlaps in IP address ranges are not checked automatically.

Variant 2: Hostname or Fully Qualified Domain Name (FQDN)

Alternatively, a single Mac can be inventoried directly via its hostname or FQDN.
The specifications for username, password, or private key are the same as in Variant 1.

Authentication: Password and Private Key

Two authentication methods are available for accessing macOS systems:

1. Username/Password – classic SSH login.
2. Private Key – import an existing key or use an RSA key created in Docusnap. An optional passphrase can also be provided.