Skip to main content

Registering Mondoo Client

If you install Mondoo Client on a new asset using a system package instead of Mondoo’s automated installation script, you must register the asset manually.

note

If you need to automate registering Mondoo Clients, read Registering Mondoo Client Using a Credentials File.

  1. Log on to console.mondoo.com.

  2. Select the region, organization, and space where you want to scan the new asset.

  3. Select the INTEGRATIONS tab.

  4. Select ADD ANOTHER INTEGRATION and choose the type of asset you’re adding.

Copy registration token

  1. Copy the registration token.

  2. Open a terminal and run this command:

Register Mondoo Client
mondoo register --token "<PASTE_YOUR_TOKEN_HERE>"

✔ agent //agents.api.mondoo.app/spaces/gallant-payne-155889/agents/1NmjgNKCoeD9SOz2UHNkT9IdcVc registered successfully
note

Communication with Mondoo Platform is encrypted using HTTPS. The payload is signed to ensure it has not been tampered with.

Validating registration

The mondoo status command validates Mondoo Client registration and ensures that communication with Mondoo Platform is successful.

Unregistered Mondoo Client
mondoo status
→ API ConnectionConfig:    https://us.api.mondoo.com
→ API Status:    SERVING
→ API Version:    6
→ Space:
x client is not registered
x could not connect to mondoo platform
Correctly registered Client
mondoo status
→ API ConnectionConfig: https://us.api.mondoo.com
→ API Status: SERVING
→ API Version: 6
→ Space: //captain.api.mondoo.app/spaces/gallant-kilby-587371
→ Client: //agents.api.mondoo.app/spaces/gallant-kilby-587371/agents/1N9EGTzvlizF1n7vPtz21y7XFA3
→ Service Account: //agents.api.mondoo.app/spaces/gallant-kilby-587371/serviceaccounts/1N9EGTzvlizF1n7vPtz21y7XFA3
→ client is registered
→ client authenticated successfully
Invalid Mondoo Client registration
mondoo status
→ Space: //captain.api.mondoo.app/spaces/gallant-kilby-587371
→ Client: //agents.api.mondoo.app/spaces/gallant-kilby-587371/agents/1N9EGTzvlizF1n7vPtz21y7XFA3
→ Service Account: //agents.api.mondoo.app/spaces/gallant-kilby-587371/serviceaccounts/1N9EGTzvlizF1n7vPtz21y7XFA3
→ client is registered
x could not connect to mondoo platform error="rpc error: code = Unauthenticated desc = request permission unauthenticated"
No current system time (clock skew detected)
mondoo status
→ Space: //captain.api.mondoo.app/spaces/gallant-kilby-587371
→ Client: //agents.api.mondoo.app/spaces/gallant-kilby-587371/agents/1N9EGTzvlizF1n7vPtz21y7XFA3
→ Service Account: //agents.api.mondoo.app/spaces/gallant-kilby-587371/serviceaccounts/1N9EGTzvlizF1n7vPtz21y7XFA3
→ client is registered
x could not connect to mondoo platform error="rpc error: code = Unauthenticated desc = request permission unauthenticated"
! possible clock skew detected: 27m55.32301447s