Troubleshooting Border0 connectors

Use the following sections to diagnose and resolve common issues you may encounter when setting up or running Border0. For issues with a connector, or sessions behind a connector, you can examine logs in the Logs tab of the Border0 admin portal to get issue details.

To review the logs for a connector:

1. In the Border0 admin portal, open the Connectors page.
2. Select the connector whose logs you want to examine.
3. Select Logs.

The following sections show common causes for errors and recommended path to resolution.

Error: no Border0 token in credentials chain

{"level":"fatal","ts":"2023-08-04T09:50:54-07:00","msg":"failed to get connector (v2) configuration","error":"no Border0 token in credentials chain"}

This error indicates that the tailzero CLI was unable to find a token to use for authentication.

To resolve this issue, make sure that you provide a valid Border0 connector token in the environment variable BORDER0_TOKEN.

Error: invalid token

{"level":"error","ts":"2023-08-04T09:53:55-07:00","msg":"failed to receive message","error":"rpc error: code = Unauthenticated desc = invalid token"}

This error indicates that the tailzero CLI was able to find a token to use for authentication, but the token was invalid. A token may be invalid if:

• It is malformed, such as characters are missing, or additional characters were added.
• It is expired.
• You provided a shell expansion variable as the value of the token and expanding this variable resulted an invalid token for one of the reasons listed above.

To resolve this issue, make sure that you provide a valid token.