Assign a Credential to an Asset

Assigning a credential links it to a specific capability on an asset — for example, the SNMP or SSH capability. Once assigned, the edge agent uses that credential the next time it authenticates to the device.

Before you start

Steps

  1. Go to Assets and find the asset you want to assign credentials to. Search by hostname, IP, or MAC address.
  2. Open the asset detail page.
  3. Scroll to the Capabilities section. You will see the capabilities the edge agent has observed for this asset — for example, SNMP or SSH.
  4. Find the capability you want to assign a credential to and click Assign Credential (or the edit/assign button next to that capability).
  5. In the credential selector, choose the credential you want to assign. The list shows all credentials available in your organization that match the capability type (SNMP credentials for SNMP, SSH credentials for SSH).
  6. Click Save or Assign.

What happens next

Example walkthrough

Scenario: assigning SNMP credentials to a switch
  1. Open asset DC-LEAF-2 (10.99.0.32).
  2. In the Capabilities section, find the SNMP capability — it shows as observed.
  3. Click Assign Credential next to SNMP.
  4. Select Datacenter SNMPv3 RW from the credential list.
  5. Click Assign.
  6. On the next probe run, the edge agent authenticates with the SNMPv3 credential. If successful, the SNMP capability state updates to authenticated and enrichment and metrics collection can begin.
Scenario: assigning SSH credentials to a server
  1. Open the server asset at 10.99.0.50.
  2. In the Capabilities section, find the SSH capability.
  3. Click Assign Credential next to SSH.
  4. Select Linux Servers SSH from the credential list.
  5. Click Assign.
  6. The next probe job will authenticate over SSH. Success updates the capability to authenticated and unlocks SSH-based enrichment and metric collection.
Admin note Admins can assign credentials to assets across all organizations. Make sure the credential you're assigning belongs to the same organization as the asset — credentials are not shared across orgs.