Actions88
- Container Actions
- Container List
- Container Create
- Container Inspect
- Container Top
- Container Logs
- Container Changes
- Container Export
- Container Stats
- Container Resize
- Container Start
- Container Stop
- Container Restart
- Container Kill
- Container Update
- Container Rename
- Container Pause
- Container Unpause
- Container Attach
- Container Attach Websocket
- Container Wait
- Container Delete
- Container Archive Info
- Container Archive
- Put Container Archive
- Container Prune
- Image Actions
- Network Actions
- Volume Actions
- Swarm Actions
- Node Actions
- Secret Actions
- System Actions
- Exec Actions
- Service Actions
- Task Actions
Overview
This node provides an interface to interact with Docker through the Portainer API. Specifically, the "System Auth" operation allows users to verify authentication configurations against a specified Docker endpoint managed by Portainer. This is useful for validating credentials or tokens before performing further Docker management tasks via the API.
Common scenarios include:
- Validating that a given authentication token or configuration is valid for accessing a particular Docker endpoint.
- Pre-checking credentials during automation workflows to avoid failures in subsequent Docker operations.
- Integrating Docker management securely within broader automation pipelines by ensuring proper authentication.
Properties
| Name | Meaning |
|---|---|
| EndpointID Name or ID | The identifier of the Docker endpoint managed by Portainer to which the authentication check will be applied. You can select from existing endpoints or specify an ID using an expression. |
| Auth Config | The authentication configuration (e.g., token or credentials) to validate against the selected Docker endpoint. This is sent as the request body. |
Output
The node outputs JSON data representing the result of the authentication check performed on the specified Docker endpoint. The exact structure depends on the Portainer API response but generally includes success or failure status and any relevant messages or error details.
No binary data output is involved.
Dependencies
- Requires access to a Portainer instance with its API enabled.
- Needs an API key or authentication credential configured in n8n to authenticate requests to the Portainer API.
- The node dynamically loads available Docker endpoints from Portainer to populate the endpoint selection list.
Troubleshooting
- Invalid Endpoint ID: If the specified endpoint ID does not exist or is incorrect, the node will fail to authenticate. Verify the endpoint exists in Portainer.
- Authentication Failure: Errors related to invalid or expired authentication configurations may occur. Ensure the provided auth config is correct and has necessary permissions.
- API Connectivity Issues: Network problems or incorrect Portainer URL/credentials can cause request failures. Confirm connectivity and credential correctness.
- Empty Endpoint List: If no endpoints are loaded, ensure the API key used has permission to list endpoints in Portainer.