Axonius Documentation

    SD Elements


    SD Elements is a threat modeling and security requirements management platform that automates the identification of security controls and compliance requirements throughout the software development lifecycle.

    Use Cases the Adapter Solves

    • Application Security Visibility: Gain comprehensive visibility into security projects across your organization.
    • Security Task Tracking: Monitor security countermeasures and tasks assigned to development teams.
    • Compliance Monitoring: Track risk policy compliance across all projects and business units.

    Asset Types Fetched

    • Organizational Units | Application Resources | Tickets

    Data Retrieved through the Adapter

    The following data can be fetched by the adapter:

    Organizational Units (Business Units): Fields such as Remote ID, Name, Slug

    Application Resources: Fields such as Remote ID, Name, Description

    Tickets: Fields such as Remote ID, Task ID, Title


    Before You Begin

    Required Ports

    • TCP port 443 (HTTPS)

    Authentication Method

    API Token Authentication

    APIs

    Axonius uses the SD Elements API v2. The following endpoints are called:

    • GET /api/v2/business-units/ - Fetch business units
    • GET /api/v2/applications/ - Fetch applications
    • GET /api/v2/projects/ - Fetch security projects
    • GET /api/v2/projects/{project_id}/survey/ - Fetch project survey data
    • GET /api/v2/projects/{project_id}/survey/comments/ - Fetch survey comments
    • GET /api/v2/projects/{project_id}/problems/ - Fetch problems
    • GET /api/v2/projects/{project_id}/problems/{problem_id}/tasks/ - Fetch security tasks

    Permissions

    The following permissions are required:

    Administrator Role (Recommended)

    Assign the global role Administrator to the API user.

    Custom Global Role

    Alternatively, create a custom global role with the following permissions:

    • View all projects
    • View all business units
    • Manage users & groups (for API token generation)

    Supported From Version

    Supported from Axonius version 8.0.14

    Setting Up SD Elements to Work with Axonius

    To generate an API token in SD Elements:

    1. Log in to SD Elements with an account that has Administrator or appropriate custom role permissions.
    2. Navigate to Account Settings → API Tokens.
    3. Click Generate New Token or Create API Token.
    4. Provide a descriptive name for the token (e.g., "Axonius Integration").
    5. Copy the generated token immediately and store it securely.
    6. Note: The token will only be displayed once. If lost, you must generate a new token.

    Connecting the Adapter in Axonius

    Navigate to the Adapters page, search for SD Elements, and click on the adapter tile.

    Click Add Connection.

    To connect the adapter in Axonius, provide the following parameters:

    Required Parameters

    1. Host Name or IP Address - The base domain for the SD Elements API.
    2. API Token - An API Token generated from SD Elements UI under Account Settings → API Tokens.
    3. Connection Label - A name for this connection.

    SD Elements

    Optional Parameters

    1. 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.
    2. HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
    3. HTTPS Proxy User Name - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.
    4. HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.

    5. Select Gateway – Select the Axonius Gateway to use when connecting adapters whose sources are only accessible by an internal network and not from the primary Axonius instance, which may be an Axonius-hosted (SaaS) instance or Customer-hosted (on-premises / private cloud). To use this option, you need to set up an Axonius Gateway.



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


    Updated 3 months ago