CIS Assessment icon

CIS Assessment

Interact with CIS Assessment API
Join our community

Actions5

Overview

This node, named "CIS Assessment," interacts with the CIS Assessment API to perform various operations related to assessments. Specifically, for the resource Campanha and operation Criar Campanha, it allows users to create a new campaign by specifying details such as the campaign name, area of activity, report type, and whether the report can be downloaded.

Common scenarios where this node is beneficial include automating the creation of assessment campaigns in security or compliance workflows, integrating campaign management into broader automation pipelines, or dynamically generating campaigns based on external triggers.

For example, a user might automate the creation of a new campaign whenever a new project starts, specifying the campaign's scope and report preferences programmatically.

Properties

Name Meaning
Nome Da Campanha The name to assign to the campaign. This is a required string input where you specify the campaign's title.
Área De Atuação The area of activity for the campaign. Choose one from:
- GLOBAL (Uso geral)
- PESSOAL (Para uso pessoal)
- PROFISSIONAL (Para uso profissional)
Tipo De Relatório Name or ID The type of report associated with the campaign. Select from a dynamically loaded list of report types or specify an ID using an expression. This is required.
Permitir Baixar Relatório Boolean flag indicating if the user is allowed to download the report generated by the campaign. Defaults to true.

Output

The node outputs a JSON array containing the response from the CIS Assessment API after creating the campaign. The exact structure depends on the API response but typically includes details about the newly created campaign such as its ID, name, status, and other metadata.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential to authenticate with the CIS Assessment API.
  • The node uses internal methods to load options dynamically for properties like report types.
  • Proper configuration of the API credentials within n8n is necessary for successful execution.

Troubleshooting

  • Operation Not Supported Error: If the selected operation or resource is not supported, the node throws an error stating the function is not supported. Ensure that the resource is set to "passport-api" and the operation to "passport-create" for creating campaigns.
  • Missing Required Fields: The node requires certain fields such as campaign name, area of activity, and report type. Omitting these will cause errors.
  • Invalid Report Type: Selecting or specifying an invalid report type ID may result in API errors. Use the dynamic options loader or valid IDs.
  • API Authentication Issues: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Network or API Errors: Check network connectivity and API availability if requests fail.

Links and References

Discussion