Topic
This article explains how to set up and use Cytracom's Teleport feature. There are two ways to set it up, depending on whether the user has a Unity Platform account.
Environment
- Cytracom ControlOne
- Unity Platform
- Microsoft Entra ID (formerly Azure Active Directory)
Description
ControlOne's Teleport feature gives MSP Partners and their customers a way to securely access multiple networks directly from the ControlOne Agent, without using a VPN. Teleport lets Partner user accounts connect to a customer's zone in seconds, for configuration after ControlOne has replaced a VPN, or for ongoing maintenance of the customer's network.
Every Teleport connection is protected by multi-factor authentication (MFA). Where the user's Teleport permission and MFA are set up depends on the user's account, so start by working out which setup the user needs.
Which Teleport setup does the user need?
Look the user up in Unity Platform. For a member of your team, select Admin in the left sidebar and check Team Management. For a customer's user, click Customers, select the customer and check the Users tab.
- The user is listed in Unity Platform: use Option 1: Users with a Unity Platform account. This applies even if the user signs in to the ControlOne Agent with Microsoft.
- The user isn't listed in Unity Platform: use Option 2: Users without a Unity Platform account. These are usually Microsoft Entra ID users synced into ControlOne, or users who sign in to the Agent with a ControlOne password.
The Agent's sign-in screen is a useful hint. A Unity Platform sign-in page usually means Option 1, and a Microsoft sign-in page usually means Option 2. Some customers have Unity Platform users sign in to the Agent with Microsoft, though, so confirm in Unity Platform before you start.
| Option 1: Unity Platform account | Option 2: No Unity Platform account | |
|---|---|---|
| Teleport permission | The user's role in Unity Platform | Teleport via ControlOne Agent in the ControlOne Portal |
| Where MFA is set up | Unity Platform | ControlOne Portal |
| MFA methods | Authenticator app only. SMS isn't supported. | SMS or an authenticator app |
| Password | The user's Unity Platform password | A ControlOne password, set with Forgot Password |
Option 1: Users with a Unity Platform account
Requirements
- The user has the ControlOne Agent Access and ControlOne Teleport Access permissions. In Unity Platform these come from the user's role: Super Admin, Admin, Technician and Co-Managed include both. End User and Billing don't include Teleport, and custom roles can't grant ControlOne permissions. See Unity Platform System Roles and Permissions.
- MFA is turned on for the user in Unity Platform. MFA is optional by default, and while it's optional the user is never asked to set up an authenticator app, so Teleport won't work for them.
- The user has set up an authenticator app on their Unity Platform account, and has signed in to the ControlOne Agent since. The Teleport option doesn't appear in the Agent until this is done.
Teleport lists only the customers where the user's Unity Platform role includes Teleport access. A partner role (Super Admin, Admin or Technician) reaches every customer under your partner account, unless a tenant override changes it. Setting a customer to No access removes that customer from the user's Teleport list. A Co-Managed user can only teleport within their own organization. See Change a User's Role and Tenant-Specific Permissions.
Step 1: Check the MFA status
1. In Unity Platform, click Customers and select the customer.
2. Select the Authentication tab.
3. Under Security Overview, check MFA Status. If it shows Optional, the customer's users haven't been required to set up MFA.
Step 2: Turn on MFA
You can turn on MFA for a whole customer or for individual users.
To require MFA for every user under the customer
1. On the customer's Authentication tab, in the Multi-Factor Authentication card, turn on MFA Enforcement and confirm. The Enable MFA button at the top right of the customer page does the same thing.
2. Check that MFA Status changes from Optional to Enforced.
If MFA is enforced for your whole partner account, the toggle is already on and shows "MFA is enforced at the partner level."
To require MFA for individual users
1. Open the user's profile. For a member of your team, select Admin in the left sidebar, then click the user's name in Team Management. For a customer's user, click Customers, select the customer, then open the user from the Users tab.
2. Select the Authentication tab, turn on MFA Enforcement and confirm. The card shows "User will be required to set up MFA on next login."
Step 3: Have the user set up an authenticator app
Have the user sign in to Unity Platform and set up an authenticator app when prompted.
Step 4: Confirm Teleport works
1. Have the user sign out of the ControlOne Agent, then sign back in. The Teleport option appears after this sign-in.
2. Have the user click Teleport and connect to a customer zone. The Agent asks for a code from the authenticator app to complete the connection.
Option 2: Users without a Unity Platform account
Users who aren't in Unity Platform, such as Microsoft Entra ID users synced into ControlOne, can still teleport. Their Teleport permission is set in the ControlOne Portal, and they need a ControlOne password and ControlOne MFA, which they set up once.
Requirements
- The user has Network Access via ControlOne Agent and Teleport via ControlOne Agent turned on in the ControlOne Portal.
- The user has set a ControlOne password and set up MFA, by SMS or an authenticator app, and has signed in to the ControlOne Agent since. The Teleport option doesn't appear in the Agent until this is done.
A partner user can teleport to every customer under your partner account. A customer's user can only teleport within their own organization.
Step 1: Turn on Teleport for the user
In the ControlOne Portal, open Users & Groups and edit the user's permissions. Turn on Network Access via ControlOne Agent and Teleport via ControlOne Agent.
Step 2: Have the user set a ControlOne password
1. On the ControlOne Management Login screen, click Forgot Password.
2. Enter the user's email address. For a Microsoft Entra ID user, use their Entra ID email address.
3. Have the user open the email and set a ControlOne password.
Step 3: Have the user set up MFA
Have the user sign in to the ControlOne Portal with the new password and set up MFA when prompted, using either SMS or an authenticator app. The user must finish this step. If they choose Skip multi-factor setup, Teleport won't appear.
Step 4: Confirm Teleport works
1. Have the user sign out of the ControlOne Agent, then sign back in the way they normally do. The Teleport option appears after this sign-in.
2. Have the user click Teleport and connect to a customer zone. The Agent asks for a code, sent by SMS or from the authenticator app, to complete the connection.
Note on password reset emails: reset links work only once. Some email security tools (such as Microsoft Defender Safe Links, Mimecast or INKY) open links to scan them, which uses the link up before the user clicks it. The user then sees "Failed to verify token." Request a new link and open only the newest email, or have the email security tool allow the sign-in links.
Considerations for both options
- If the partner is using device posture, the policy of a user's native assigned zone (not the target zone) will apply to all traffic during a Teleport session.
- If the partner is using an Agent Control Policy, the policy of a user's native assigned zone (not the target zone) will apply to all traffic during a Teleport session.
- The Security Policy applied to the target zone will apply to all traffic during a Teleport session.
- Once connected to a user zone in your tenant's environment, you can reach any device on any site or user zone that is connected to that zone.
- The destination zone is a user zone, like all agent connections.
Best practices
- If a user zone with access to all user/site zones you need to communicate with does not exist, you can create one and "connect" it. Users do not need to be assigned to this zone on the tenant environment to Teleport to that zone. See Ensuring connectivity to customer devices when troubleshooting with Teleport for more information.
- Give Teleport access only to the people who need it. For Unity Platform users, use roles and tenant overrides to limit which customers each person can reach.
- All partner users with Teleport access should accurately document their use of the Teleport feature when connecting to client (tenant) networks.
- Regularly review audit logs to ensure compliance with your established procedures. See Cytracom ControlOne: Analytics (Reporting) for more information.
Using Teleport
Users connect to customer zones directly from the ControlOne Agent.
1. In the ControlOne Agent, click the Teleport link.
2. The Agent will display a list of the customers you can teleport to. Enter the name of the client whose network you wish to access.
3. The Agent will display a list of existing zones within the customer's network. Enter the name of the zone you wish to access.
4. The Agent will prompt you to enter a reason for connecting to a customer's zone. The system will store this information as an Audit Event in the Partner and Customer Audit Log.
5. The Agent will prompt you for an MFA code. Enter the code from your authenticator app, or the code sent to you by SMS if you set up SMS under Option 2.
The Agent will now be connected to the customer's zone. That zone name will show in the top section of the Agent window. Also, the highlight on the portal icon in the toolbar will switch from green to blue, and appear on the other side of the icon.
Managing your Teleport connection
Once connected, you have two management options:
- Disconnect: This action will terminate your connection, and return you to the customer's zone upon reconnecting.
- Return: This option will disconnect you from the customer's zone and return you to your own assigned zone. To reconnect, you must provide a new connection reason and re-authenticate.
Reporting Teleport connections
To view Teleport sessions from your Partner account, click Reporting in the ControlOne Portal's Navigation menu, then click Events at the top of the screen. You will see a Teleport event subtype listing Teleport connections. You will also see this Teleport session in the tenant view.
Selecting the session displays the customer to which the user teleported, along with the reason, in the detail view.
Troubleshooting
- The Teleport option is missing from the Agent (Option 1): check the user's role in Unity Platform, then check that MFA is turned on and the user has set up an authenticator app. See Option 1. The user must sign out of the Agent and sign back in afterwards.
- The Teleport option is missing from the Agent (Option 2): check that Teleport via ControlOne Agent is on in the ControlOne Portal, and that the user set up MFA instead of skipping it. See Option 2. The user must sign out of the Agent and sign back in afterwards.
- Not sure which option applies: see Which Teleport setup does the user need? If the user is in Unity Platform, Teleport checks their Unity Platform authenticator app, so Option 2's ControlOne password and MFA won't work for them.
- A customer is missing from the Teleport list (Option 1): check the user's Roles & Permissions tab in Unity Platform. A tenant override of No access, or a role without Teleport access on that customer, removes it from the list.
- The password reset link shows "Failed to verify token": the link was already used, often by an email security scanner. See the note on password reset emails above.
Additional Resources
- Cytracom ControlOne: Ensuring connectivity to customer devices when troubleshooting with Teleport
- Unity Platform System Roles and Permissions
- Change a User's Role and Tenant-Specific Permissions
- Cytracom ControlOne: Analytics (Reporting)
Still have questions? Click here to learn how to contact Cytracom Technical Support or open a ticket.