KAIA Security Gate icon

KAIA Security Gate

Check entity context and block workflow if conditions are not met

KAIA Security Gate

AI-generated

Overview

The KAIA Security Gate node checks the context of a specified entity in a knowledge graph and blocks the workflow execution if certain conditions are not met. It is useful for enforcing security or access control policies based on entity attributes or relations. For example, it can verify if a user has a specific role or permission before allowing the workflow to proceed.

Use Case Examples

  1. Check if a user entity exists in the knowledge graph before continuing a workflow.
  2. Verify if a user's status relation equals 'active' to allow access to a resource.
  3. Block workflow execution if a user's permission relation does not exist or does not match a required value.

Properties

Name Meaning
Entity ID Entity identifier to check in the knowledge graph, e.g., 'user-123'.
Condition Optional condition to evaluate on the entity's relations. If not provided, the node checks if the entity exists.

Output

JSON

  • decision - The decision result from the security gate check, e.g., 'proceed' or 'block'.
  • reason - Reason for blocking the workflow if the decision is 'block'.
  • confidence - Confidence score of the decision.

Dependencies

  • Requires Kaia API credentials with base URL and token for authentication.

Troubleshooting

  • Common error: Missing or invalid Kaia API credentials. Ensure credentials are set correctly.
  • Error if Entity ID is not provided. Make sure to specify a valid entity identifier.
  • If the node blocks the workflow, check the reason and confidence in the error message to understand why the condition failed.
  • If the HTTP request to the Kaia API fails, verify network connectivity and API endpoint correctness.

Links

Discussion