Binalyze AIR icon

Binalyze AIR

Manage Binalyze AIR resources

Actions99

Overview

The node interacts with the "Repository" resource of the Binalyze AIR system, specifically supporting the "Get Many" operation. This operation retrieves multiple evidence repositories filtered by organization IDs and other optional criteria. It is useful for workflows that need to list or search repositories across one or more organizations, enabling automation around repository management, auditing, or integration with other systems.

Practical examples include:

  • Fetching all repositories visible to a default or specific organization to display in a dashboard.
  • Searching repositories by name or filtering by host, path, or username to find relevant evidence storage locations.
  • Paginating through large sets of repositories to process them in batches.

Properties

Name Meaning
Organization IDs Comma-separated list of Organization IDs to filter repositories by. Use 0 to retrieve repositories visible to all organizations (default). Specify a single organization ID to get repositories visible only to that organization plus those visible to all.
Additional Fields A collection of optional filters and pagination controls:
- Filter By Host: Filter repositories by their host address.
- Filter By Path: Filter repositories by their path.
- Filter By Username: Filter repositories by username.
- Page Number: Which page of results to return (minimum 1).
- Page Size: Number of results per page (minimum 1).
- Search Term: Search repositories by name (supports partial matches).
- Type: Filter repositories by type; options are Amazon S3, Azure Storage, FTPS, SFTP, SMB.

Output

The node outputs JSON data representing the list of repositories matching the specified filters. Each item in the output typically contains repository details such as identifiers, names, types, paths, hosts, usernames, and visibility scopes according to the API's response structure.

There is no indication that this node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the Binalyze AIR API.
  • The node depends on the Binalyze AIR service being accessible and properly configured.
  • Pagination parameters allow handling large result sets efficiently.

Troubleshooting

  • Common Issues:

    • Providing invalid or unauthorized organization IDs may result in empty results or errors.
    • Incorrect pagination values (e.g., page number less than 1) might cause errors or unexpected behavior.
    • Filtering by unsupported repository types or invalid filter strings could lead to no results.

  • Error Messages:

    • "Unknown resource" error if the resource parameter is incorrectly set.
    • API authentication errors if the API key credential is missing or invalid.
    • Validation errors if required fields like Organization IDs are not provided or out of range.

  • Resolutions:

    • Ensure the Organization IDs are valid and accessible by the API key used.
    • Use correct pagination values starting from 1.
    • Verify API credentials and network connectivity to the Binalyze AIR service.

Links and References

Discussion