OpenStack

OpenStack is an open source software solution for creating private and public clouds.

Asset Types Fetched

This adapter fetches the following types of assets:

• Devices, Compute Services

Before You Begin

APIs

Axonius uses the OpenStack API.

Authentication Methods

• Username and Password
• Application Credentials

Connecting the Adapter in Axonius

Required Parameters

1. Authentication Type - Select between Username & Password and Application Credentials.

Required parameters for Username & Password authentication:

1. User Name and Password - The credentials for a user account that has the permissions to fetch assets.
2. User Domain – The domain where the user account is defined, for example default, cisco, ldap, etc.
3. Project - The project name.
4. Project Domain - The domain where the project/tenant is defined.

Required parameters for Application Credentials authentication:

1. Application Credential ID and Application Credential Secret - See the following example (includes mock data):

   example-appcred:
     auth:
       auth_url: http://example.com/identity
       application_credential_id: 0123456789abcdef0123456789abcdef
       application_credential_secret: MOCK_SECRET_KEEP_IT_LONG_AND_RANDOM_STAY_SAFE_12
     auth_type: v3applicationcredential
     region_name: RegionOne

Optional Parameters

1. Authentication URL - An authentication URL for the Identity service.

2. Additional openstack hosts JSON file - You can configure a connection using parameters in this dialog box, or upload additional connection parameters them from a JSON file. The JSON file is in the format of a single list containing dictionaries, where each dictionary must contain:

   1. The Authentication URL
   2. Additional connection parameters, depending on the authentication method selected.

   ❗️

   Attention

   Each connection parameter must be configured either in the dialog box or in the JSON file (or both). When the parameters are configured in the JSON file, their values are used for that specific connection; If they are not configured in the JSON file, their values taken from the dialog box.

   Example JSON file:

[
  {
    "auth_url": "<auth url>", # (1)
    "username": "<username>", # (2)
    "password": "<password>", # (2)
    "project": "<project>", # (3)
    "domain": "<domain>", # (4)
    "verify": True/False # Verify SSL
  }
]

6. Run as Admin user (default: enabled) - This option requires the user to have an admin role in OpenStack. If the user is not an admin, the connection will fail. Disable it to connect with non-admin credentials.

   📘

   Note

   Admin credentials can fetch data from multiple projects to which they are assigned. Non-admin credentials can only fetch data from a single project.

7. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

📘

Note

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters.

Fetch Hypervisors as Assets - Select this option to fetch Hypervisor entities as assets.

📘

Note

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.