Setting up Visual Paradigm Teamwork Server with Okta

Teamwork Server supports Okta for Enterprise clients. In this article we will go into the details of setting up SAML authentication through Okta. Although this is specific to Okta the concepts could be adapted to any other SAML Identity Provider.

Step 1 - Setting up Okta

In this section you will learn how to create a new application integration in Okta.

  1. Part of the setup of Okta requires providing details given by Teamwork Server. So now, open a web browser and login VP Server as administrator.
  2. Select System Tools from the menu on the left hand side.
  3. Open the Single Sign-On tab and keep it opened. We will come back later.
    The Single Sign-On page of Teamwork Server
    The Single Sign-On page of Teamwork Server
  4. Open another tab/window in the web browser and visit Okta.
  5. Create a new application integration in Okta. Select SAML 2.0 as sign-on method.
    Creating an application with SAML 2.0 as sign on method
    Creating an application with SAML 2.0 as sign on method
  6. Enter VP Teamwork Server as the name of application. Click Next.
    Entering application name
    Entering application name
  7. Fill-in the SAML settings. Copy the value of Single Sign-on (ASC) URL from Teamwork Server to Okta as the Single sign on URL, and then copy the value of Audience URI (SP Entity ID) from Teamwork Server to Okta.
    Filling in SAML settings
    Filling in SAML settings
  8. Click Next.
  9. Select I'm an Okta customer adding an internal app and then click Finish.
    Choosing identity
    Choosing identity
  10. Download the Identity Provider metadata under the Sign On tab.
    Download Identity Provider metadata
    Download Identity Provider metadata
  11. Open the People tab.
  12. Click Assign to People and then assign the application to people who will use Teamwork Server. Doing so does not instantly grant those people the accessibility to Teamwork Server. You still have to go through the process of inviting them to Teamwork Server, which will be mentioned in the next section.
    Assigning VP Teamwork Server (application) to people
    Assigning VP Teamwork Server (application) to people
  13. Click Done when finished.

Step 2 - Setting up Teamwork Server

  1. Go back to Teamwork Server. You should be opening the Single Sign-On tab of the System Tools page. Now, enter Okta as the Identity Provider (IDP) Name.
    IDP name entered
    IDP name entered
  2. In the IDP metadata field, upload the Identity Provider metadata file downloaded in the previous section.
    IDP metadata uploaded
    IDP metadata uploaded
  3. Click Apply.
  4. Click OK when you are prompted for confirmation. If sign-in success, you will be logged out automatically. If failed, please make sure the Teamwork Server application has been assigned to you in Okta, and try again.
  5. From now on, Teamwork Server is integrated with Okta. You, as the administrator can access Teamwork Server with your Okta account and perform administration and management tasks. Team members, once being invited and have accepted the invitations, can login Teamwork Server from Visual Paradigm with their Okta account.
    Login with Okta
    Login with Okta

Step 3 - Member management

Since the integration with Okta, in order for someone to become a Teamwork Server member, he/she has to:

  1. Be a person who have been assigned the Teamwork Server application in Okta and,
  2. Have accepted the invitation sent from Teamwork Server administrator.

The first point has been covered in step 1 above. In this section we are going to show you how to invite a member.

  1. Open a web browser and login VP Server as administrator.
  2. Select Members from the menu on the left hand side.
  3. Under the Members tab, click Invite Member.
    Invite member
    Invite member
  4. Enter the name and email of the members. Make sure you have already assigned the VP Teamwork Server application to them in Okta. If not, they won't be able to access any projects. Click Send Invitation.
    Send invitation
    Send invitation
  5. The invitee will receive an invitation shortly. Click on the activation link in the email.
    To activate Teamwork Server account
    To activate Teamwork Server account
  6. He/she will be redirected to a web page where he/she can fill in his name. Enter the name and click Activate with Okta.
    Activating Teamwork Server account
    Activating Teamwork Server account
    If success, he will see the Congratulations screen. From now on, he/she can access Teamwork Server from Visual Paradigm with his/her Okta account.
    Activation success
    Activation success

Related Resources

The following resources may help you learn more about the topic discussed in this page.

 
3. Managing members (Active Directory) Table of Contents 5. Setting up Visual Paradigm Teamwork Server with Microsoft Azure
 

Technical Support

Have technical issues or suggestions? Please contact Visual Paradigm Support Team.

Sales Support

Have questions related to registration, licensing or payment? Feel free to contact Visual Paradigm Sales Team.

Discussion Forum

Share your suggestions of opinions at VP Discussion Forum.