Define a new P4 Server connection

To define a new connection to a P4 Server in Visual Studio:

  1. Open the Open Connection dialog. You can open this dialog the following ways:

    • Add a new project in Visual Studio in the New Project dialog. In this dialog, select the Add to source control using P4 for Visual Studio - P4 for Visual Studio check box; then click OK.

      The Open Connection dialog appears unless:

      • You did not select the check box.
      • You have set the connection settings in Tools > Options > Source Control > P4 - Connections to default to an option other than Show the P4 server Connection. In this case, P4 for Visual Studio attempts to connect without showing the Open Connection dialog.
      • You are already connected. In this case, P4 for Visual Studio does not attempt to connect and marks the new project for add.

    • Open a solution or project under P4 Server source control in Visual Studio.

      The Open Connection dialog appears unless you’ve set the connection settings in Tools > Options > Source Control to default to the last P4 Server connection or to connection settings defined in your environment variables.

    • Go to File > Open Connection to a P4 Server in Visual Studio.

  2. Enter the server name and port number for this connection using host:port_number.

    If your P4 Server is enabled for SSL (Secure Sockets Layer) encryption, use the following syntax: ssl:host:port_number

    If you attempt to connect to an SSL-enabled P4 Server and you see a warning about an untrusted SSL connection or altered SSL fingerprint, contact your P4 Server administrator before completing the connection.

  3. In the User field, enter your user name.

    • To browse for a particular user, click the Browse…​ button and select the user from that list.
    • To create a user, click the New…​ button and fill in the appropriate information.

  4. (Optional) In the Workspace field, specify the name of your client workspace.

    • To browse for a particular client workspace, click the Browse…​ button and select the workspace from that list.
    • To create a client workspace, click the New…​ button.
    • In the New Workspace dialog, enter a workspace name and click OK.
    • In the Workspace dialog, entered the required information.

    To learn more on setting up client workspaces, see Manage workspace specifications.

  5. Click OK.

    P4 for Visual Studio connects to the specified P4 Server. If the user you are connecting with does not have a p4 ticket, P4V prompts you for your password.

Authentication

If the server you are connecting to is configured with multi-factor authentication (MFA), you are prompted for another layer of verification. Depending on the setup, you may need to select a method of verification before you can enter your credentials. To learn more, see p4 login2 in the P4 CLI Reference.

If the server you are connecting to is configured for authentication with P4 AS, the Identity Provider (IdP) web page opens, prompting you for the credentials registered with your Identity Provider (IdP). To learn more, see P4 Authentication Service Documentation or contact your administrator.