Skip to content

[ti_domaintools] Add Agentless Deployment Support #19475

Closed

Description

@mohitjha-elastic

Description

Add agentless support to the ti_domaintools.

Requirements

Following the established Phase I pattern, for each integration see the Onboarding Integration Guide.

1. Technical implementation

  • Update integration manifest.yml to enable agentless deployment mode ()
  • Update integration documentation with agentless deployment instructions
  • Update changelog.md

Example reference: #13367

2. Performance documentation

  • Test and document throughput in agentless (requires access to vendor environment and/or sample data)
  • Document specific metrics for each integration. For example/where possible:
    • API response time: Average time for vendor API calls to complete
    • Events processed per minute: How many log entries/events the integration can handle
    • Error rates: Percentage of failed API calls or data processing errors
    • Container resource usage: CPU and memory consumption under typical load
    • Vendor-specific limits: Rate limiting thresholds and API quotas

Example documentation format: "Crowdstrike Falcon Intelligence: 200ms avg API response, 5,000 events/min, 0.1% error rate, 512MB RAM/0.5CPU, 1000 API calls/hour limit"

Dependencies

  • Agentless infrastructure GA readiness (still in beta)
  • Input compatibility: Currently agentless is optimized for httpjson and cel inputs
  • UX enhancement: Add agentless deployment filter/toggle to integrations catalog page for better discoverability

Activity

  1. added
    enhancementNew feature or request
    Team:Security-Service IntegrationsSecurity Service Integrations team [elastic/security-service-integrations]
    Team:SDE-CrestCrest developers on the Security Integrations team [elastic/sit-crest-contractors]
    on Jun 10, 2026
  2. infra-vault-gh-plugin-prod commented on Jun 10, 2026

    @infra-vault-gh-plugin-prod

    Pinging @elastic/security-service-integrations (Team:Security-Service Integrations)

  3. github-actions commented on Jun 10, 2026

    @github-actions
    Contributor

    tl;dr: ti_domaintools is missing the policy-template deployment_modes.agentless metadata, so Fleet cannot expose agentless deployment yet; the safest implementation path is to mirror the ti_anomali/ti_flashpoint pattern (manifest + docs + changelog, and likely Kibana floor alignment).

    Recommendation

    Add agentless support in ti_domaintools by following the same rollout pattern already used in TI integrations:

    1. Add deployment_modes (default.enabled: true + agentless.enabled: true with owner metadata and release: beta) under policy_templates in packages/ti_domaintools/manifest.yml.
    2. Add deployment guidance in packages/ti_domaintools/_dev/build/docs/README.md (agentless + agent-based sections), then regenerate rendered docs.
    3. Add a changelog entry in packages/ti_domaintools/changelog.yml.
    4. Confirm whether Kibana minimum must be raised to ^8.18.0 for this package (as happened in prior TI agentless rollout).
    Findings
    • packages/ti_domaintools/manifest.yml:27-34 defines only inputs and has no deployment mode block:
    policy_templates:
      - name: domaintools
        ...
        inputs:
          - type: cel
    • packages/ti_anomali/manifest.yml:43-51 already has agentless metadata:
    deployment_modes:
      default:
        enabled: true
      agentless:
        enabled: true
        release: beta
        organization: security
        division: engineering
        team: security-service-integrations
    • packages/ti_flashpoint/manifest.yml:37-45 uses the same structure.
    • packages/ti_domaintools/_dev/build/docs/README.md:1-113 has no "How do I deploy this integration?" section.
    • packages/ti_anomali/docs/README.md:51-61 includes explicit deployment guidance (Agentless-based installation / Agent-based installation).
    • Prior art shows follow-up fixes were needed after initial enablement:
      • PR #14547 (initial ti_anomali agentless enablement)
      • PR #17253 (fixes incl. Kibana constraint update)
      • PR #18552 (agentless.release field rollout)

    Note: I could not read the full issue body via MCP due an integrity restriction, so findings are based on repository state + related merged PRs.

    Verification

    I ran local checks to confirm current state:

    $ grep -n "deployment_modes" packages/ti_domaintools/manifest.yml
    # (no output)
    
    $ grep -n "deployment_modes\|agentless" packages/ti_anomali/manifest.yml
    43:    deployment_modes:
    46:      agentless:
    
    $ grep -n "How do I deploy this integration\|Agentless-based installation" packages/ti_anomali/docs/README.md
    51:## How do I deploy this integration?
    55:### Agentless-based installation
    Detailed Action Plan
    1. Enable deployment modes in package manifest

      • Edit packages/ti_domaintools/manifest.yml under policy_templates[0] (around lines 27-34).
      • Add deployment_modes block matching current conventions used in ti_anomali and ti_flashpoint.
    2. Validate Kibana constraint compatibility for agentless

      • Review packages/ti_domaintools/manifest.yml:14 (^8.16.0 || ^9.0.0) against current agentless requirements.
      • If required, bump floor to ^8.18.0 || ^9.0.0 (same adjustment made in ti_anomali via #17253).
    3. Update docs source and rendered output

      • Add a deployment section in packages/ti_domaintools/_dev/build/docs/README.md (near requirements/setup), modeled after:
        • packages/ti_anomali/docs/README.md:51-61
        • packages/ti_flashpoint/docs/README.md:57-69
      • Regenerate rendered docs so packages/ti_domaintools/docs/README.md stays in sync.
    4. Record change in changelog

      • Add top entry in packages/ti_domaintools/changelog.yml describing agentless mode support and release level.
    5. Run package validation/tests used for TI packages

      • Build/lint/test package to confirm schema and docs rendering pass and Fleet UI metadata is accepted.
    Related Items
    Type Link Relevance
    PR #14547 First TI agentless rollout (ti_anomali)
    PR #17253 Follow-up fixes after agentless rollout (incl. Kibana constraint note)
    PR #18552 Added agentless.release metadata across integrations
    File packages/ti_domaintools/manifest.yml:27-34 Missing deployment_modes block
    File packages/ti_domaintools/_dev/build/docs/README.md:1-113 No deployment-mode guidance yet
    File packages/ti_anomali/manifest.yml:43-51 Reference implementation for deployment modes
    File packages/ti_flashpoint/manifest.yml:37-45 Second reference implementation for deployment modes
    File packages/ti_anomali/changelog.yml:65-67 Historical "Added Agentless deployment mode" entry
    File packages/ti_anomali/changelog.yml:55-57 Historical Kibana-floor follow-up for agentless

    Note

    🔒 Integrity filter blocked 31 items

    The following items were blocked because they don't meet the GitHub integrity level.

    To allow these resources, lower min-integrity in your GitHub frontmatter:

    tools:
      github:
        min-integrity: approved  # merged | approved | unapproved | none

    What is this? | From workflow: Issue Triage

    Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Integration:ti_domaintoolsDomainTools Feeds (Partner supported)Team:SDE-CrestCrest developers on the Security Integrations team [elastic/sit-crest-contractors]Team:Security-Service IntegrationsSecurity Service Integrations team [elastic/security-service-integrations]enhancementNew feature or request

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions