Skip to main content

Example: Adding a Linux target system

This section shows you the typical procedure for adding a Linux target system, using the Linux SSH connector to list accounts and synchronize passwords.

Requirements

This example assumes that:

  • Another target system has been added as a source of profiles, as in the Active Directory example.

  • The Python packages required by the agtlinux_ng connector are installed, following the instructions below.

Install Python prerequisite

The agtlinux_ng connector used for Linux target systems requires several Python packages, including fabric, to establish SSH connections. Install these packages before adding the LINUX target system.

  1. Open the Command Prompt as Administrator.

  2. Navigate to the <Program Files path>\Bravura Security\Bravura Security Fabric\<instance>\agent\ directory.

  3. Run the following command:

    py -m pip install -r agtlinux_ng_requirements.txt

    Note

    If you do not run this command from an elevated command prompt, pip may silently install the packages into a per-user location that the connector cannot access, without returning an error.

  4. Verify that the packages installed to the correct location:

    py -m pip show fabric

    Confirm that Location: points to the Python installation directory (for example, C:\Program Files\Python314\Lib\site-packages), not a location under a user profile.

Add the target system

To add the Linux target system:

  1. Log in to the Bravura Security Fabric Front-end (PSF) as superuser.

  2. Click Manage the system > Resources > Target systems > Manually defined.

  3. Click Add new…

  4. Enter the following information:

    • ID LINUX

    • Type Generic Linux Server (SSH)

    • Description Linux Lab Server

  5. Click Change to the right of the Address field.

  6. Enter your Linux server IP address in the Server field.

    lab-targeting-linux-address

    Leave other fields set to their default.

  7. Click Continue to return to the Target system information page.

    Note

    Do not select the Source of profile IDs option for this target.

  8. Scroll to the bottom of the page and click Add.

    The Administrator credentials page will be displayed.

    lab-targeting-linux-added

  9. Enter and confirm the Administrator ID and Password.

    Deselect Updated by Bravura Privilege?

  10. Click OK to confirm the action.

  11. Click Update.

    lab-targeting-linux-creds-added

  12. Click the Test connection tab.

  13. Click Test credentials and test that the credentials work.

    The Results column should show "Success".

  14. Click Test list, click Refresh then click Show users to see the list of users.

  15. Run auto-discovery for the LINUX target, similar to Targeting Active Directory, to load accounts and information.

  16. Verify auto-discovery of accounts by running a user accounts report for the LINUX target.

    Tip

    When you run the accounts report, set the Target system ID to LINUX in Search criteria before clicking Run.

    In this case, because you did not select Source of Profile IDs on the Target system information page, the accounts have been loaded, but only accounts with short IDs that match existing Profile IDs show up as "Auto-associated". The rest of the Account status' appear "Unclaimed" because they do not match any existing Bravura Security Fabric user profiles.

    lab-targeting-linux-report-user-accounts
In this section: