Team Computers

Team computers give administrators control over managing computers that people use at your company. Team computers operate in host only mode (i.e. you cannot connect from them to another computer). These computers can be assigned to a member of your team, to a group of people on your team, or to Guest Access. You can manage and re-assign these computers from here.

Configuring Team Computers

Team Computers are provisioned by an administrator using the team's Computer Key. Once provisioned they are fully controlled by the teams administrators and can be reassigned remotely. Team Computers can only act as hosts, that means you can make connections to them but not from them.

computers.png

When a member of your team installs Parsec and signs in using email and password or SAML directly without using the team's Computer Key, administrators can still limit access to their computer by putting restrictions on the user's account through groups, but the administrator cannot reassign the computer or see it in the admin dashboard. 

Assigning Team Computers

Team computers can be assigned to a team member, to a group, or they can be unassigned.

Unassigned computers

Computers in this state have not yet been assigned or they have been explicitly unassigned. They are ready to be assigned but no one can connect to them unless they are used for Guest Access.

User assignment

A computer can be assigned to a single team member. The assigned person will be able to connect to the computer as if they had logged in on it themselves, they can however not use it as a client to connect to other computers. The assigned person can invite others to connect to the computer using either share links or the friend system. The group restrictions of the assigned person still apply and nobody outside of the team can connect (unless the computer is also used for Guest Access).

Group assignment

Computers assigned to a group are considered Shared Computers, multiple people may have access to them. It's important to note that assigning a computer to a group doesn't always mean that members of that group can connect to it, and it's also possible that members of other groups can connect to it. This is controlled through group connections. See Shared Computers for details.

Setup and Install Team Computer

Team Computers are provisioned by using the Team ID and Team's Computer Key, which can be obtained from the Teams administrator panel, in the Team Computers section. The Computer Key is unique and can be regenerated at any time, but keep in mind that regenerating will invalidate the old key. Make sure to store it somewhere safe and treat it as a secret, it shouldn't be widely shared.

team_panel_id_and_computer_key.png

Get the Parsec installer from the downloads page. While running the installer, you'll likely want to select "Shared" to use the same Parsec account for all users and allow access to the login screen.

installer_shared_option.png

Once installed, click "Set up as Team Computer" in the login screen, and insert your Team ID and Team Computer Key from earlier.

login_screen_set_up_as_team_computer.png

Once a computer is provisioned, it will show up in the Teams admin panel's Computers section. There, you can assign the computer to a user or a group of people by clicking "Assign" so that they get access to the machine. Guest Access can be enabled by switching from OFF to ON.

teams_panel_computers_section.png

Optional: Setup and Install Team Computer using command line interface

Team Computers are provisioned by using the Team ID and Team's Computer Key, which can be obtained from the Teams administrator panel, in the Team Computers section. The Computer Key is unique and can be regenerated at any time, but keep in mind that regenerating will invalidate the old key. Make sure to store it somewhere safe and treat it as a secret, it shouldn't be widely shared.

team_panel_id_and_computer_key.png

To provision a computer you run the Parsec installer (available to download from the Downloads page), passing in the team id and your team's Computer Key. As Team Computers can only act as hosts you can only use the Computer Key on Windows. When provisioning a computer you can also immediately assign it by passing additional command line arguments. A previously provisioned computer can also be reassigned by re-running the script.

Installing Parsec and setting up the computer as a Teams computer without assigning to a specific user.

Using the Parsec installer with specific command line flags will allow you to write the authentication file.  You must run the installer as an administrator.  

Then use the below example replacing the my_team_id with your real Parsec Team ID [not alias], and replacing teams_computer_key with your team's Computer Key.  

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key

On completion of the installer running, an authentication file (user.bin) will be written to:

C:\ProgramData\Parsec

An install log will appear at location:

C:\Program Files\Parsec\log.txt

Parsec then will run after completion, and you can assign the computer from the admin dashboard.

If the Team Computer successfully authenticated, it will show the hostname of the computer on the top right followed by #0

mceclip0.png

Assigning to a user

You can assign a computer to a user using their Parsec email or their Parsec user ID (the number after the # symbol in their Parsec username, eg. user#1234 would be 1234). If the email does not match an existing team member the computer becomes reserved and once a user with a matching email joins the team the computer is automatically assigned to them. You can revoke reservations through the admin dashboard.

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key /user_email=user@emailaddress.com

or

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key /user_id=user_id

You can verify if the computer was assigned to an existing team member by viewing the username at the top right of the Parsec app. 

mceclip1.png

If the computer is reserved for a future user it will show the hostname of the computer on the top right followed by #0.

mceclip0.png

 

Assigning to a group

To assign to a group you need the groups id. The group id can be found under Groups & Members in the admin dashboard. Select the group, then click Edit Group. The group id is shown under the group name.

mceclip0.png

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key /team_group_id=team_group_id

If the machine successfully authenticated, it will show the hostname of the computer on the top right followed by #0

mceclip0.png

Enabling Guest Access

When you enable a computer for guest access you can later schedule guest access invites to it through the admin dashboard.

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key /guest_access=1

A computer can both be assigned to a group or user and used for guest access. 

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key /user_email=user@emailaddress.com /guest_access=1

or

./parsec-windows.exe /silent /shared /team_id=my_team_id /team_computer_key=teams_computer_key /team_group_id=team_group_id /guest_access=1 
Team Computers and Guest Access

Team Computers can be enabled for Guest Access either through the Computers tab in the admin dashboard or when provisioning the computer. Once enabled the computer will show in the Guest Access tab for all admins and guest access coordinators. A Team Computer can both be assigned to a user or group and have Guest Access enabled at the same time.