Skip to main content

Canonical MaaS

The MaaS integration reads a MaaS region through its REST API: the region's zones and resource pools, every machine it manages, and the subnets it knows about. It runs on an Integrator, since a MaaS region controller is normally only reachable inside your network.

It is read-only. The integration never allocates, deploys, powers or releases a machine.

What it collects​

SyncCollects
Machine discoveryEvery machine with its status, power state, owner, zone, pool, architecture, CPU, memory, deployed OS, addresses and MACs
Network discoverySubnets with their VLAN, fabric, space and gateway

Machines are kept as their own records, alongside hosts rather than written into them. A machine whose address matches a host a scan has found is linked to it.

Create an API key​

  1. Sign in to MaaS as a user who can see the machines to inventory. An administrator sees every machine; a regular user sees only its own and unallocated ones.
  2. Under Preferences > API keys, generate a key and copy it. It has the form consumer:token:secret.

Connect it​

  1. Under Integrations, add Canonical MaaS with the region URL (for example http://maas.example.com:5240/MAAS) and the API key.
  2. In the integration's settings, assign the Integrator that can reach the region controller.
  3. Enable the syncs you want.

If the region is served over HTTPS with a self-signed certificate, the first connection records its fingerprint and later connections must present the same certificate.