iTwin Users & Access Control

Overview

This node interacts with the iTwin Users and Access Control API to retrieve information about members of iTwin groups. Specifically, the "Get iTwin group member" operation fetches details about a single member within a specified iTwin group by their IDs. This is useful in scenarios where you need to verify membership, audit access, or manage permissions for users within an iTwin project or organization.

Practical examples include:

• Checking if a specific user belongs to a particular iTwin group.
• Retrieving detailed information about a group member for reporting or integration purposes.
• Automating access control workflows based on group membership status.

Properties

Output

The output is a JSON object representing the retrieved group member's data. The structure depends on the iTwin API response but typically includes member attributes such as user ID, roles, permissions, and other metadata related to the group membership.

If multiple items are returned (though this operation targets a single member), each item would be an individual JSON object in the output array.

No binary data output is indicated for this operation.

Dependencies

• Requires an API authentication token credential configured in n8n to access the iTwin Users and Access Control API.
• The node depends on the iTwin OAuth2 API credentials to authenticate requests.
• Internet connectivity to reach the iTwin API endpoints.

Troubleshooting

• Common issues:

  • Invalid or missing ID or Group ID parameters will cause the API call to fail.
  • Authentication errors if the API key or OAuth token is expired or misconfigured.
  • Network connectivity problems can prevent successful API calls.

• Error messages:

  • "Unknown operation: get-itwin-group-member" indicates the operation name might be misspelled or not supported.
  • API errors returned from iTwin (e.g., 404 Not Found) usually mean the member or group does not exist or the user lacks permission.
  • "iTwin Users execution failed" appears when the node encounters an error but continues execution due to the "continue on fail" setting; check the error message for details.

To resolve these:

• Verify that both ID and Group ID are correctly provided.
• Ensure valid and active API credentials are set up.
• Check network access and API endpoint availability.
• Review permissions for the authenticated user in the iTwin platform.

Links and References

• iTwin Developer Documentation
• iTwin Users and Access Control API Reference (general link; specific endpoints depend on API version)