Setting up VPository with Microsoft Azure

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

Step 1 - Setting up Microsoft Azure

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

  1. Part of the setup of Microsoft Azure requires providing details given by VPository. So now, open a web browser and login VPository as manager.
  2. Click on your logo at the top right of the page and then select Manage VPository from the drop down menu.
  3. Select System Tools from the menu on the left hand side.
  4. Open the Single Sign-On tab and keep it opened. We will come back later.
    The Single Sign-On page of VPository
    The Single Sign-On page of VPository
  5. Open another tab/window in the web browser and visit Microsoft Azure.
  6. Create a new application in Azure. Name it VPository. Click Next.
    Creating application VPository
    Creating application VPository
  7. Fill-in the App properties. Copy the value of Single Sign-on (ASC) URL from VPository to Microsoft Azure as the SIGN-ON URL, and then copy the value of Audience URI (SP Entity ID) from VPository to Azure as APP ID URL.
    Filling in App properties
    Filling in App properties
  8. Click Complete.
  9. Click VIEW ENDPOINTS at the bottom of the screen.
    Clicking on View Endpoints
    Clicking on View Endpoints
  10. Copy the URL of FEDERATION METADATA DOCUMENT. Visit the URL and save the XML content to a new file.
    To open the URL of metadata
    To open the URL of metadata
  11. Open the CONFIGURE page.
    Configure server
    Configure server
  12. Choose Yes for the option USER ASSIGNMENT REQUIRED TO ACCESS APP.
    Enable the requirement of user assignment to acces app
    Enable the requirement of user assignment to acces app
  13. Click SAVE at the bottom of the screen to save the changes.
    Save changes
    Save changes
  14. Open the USERS AND GROUPS page.
    Opening Users and Groups page
    Opening Users and Groups page
  15. Select the person who will use VPository.
    Selecting people to assign
    Selecting people to assign
  16. Click ASSIGN at the bottom of the screen. Select YES for confirmation. Note that the assignment does not instantly grant this person accessibility toVPository . You still have to go through the process of inviting him/her to VPository, which will be mentioned in the next section.
    User assignment
    User assignment
  17. Repeat the assignment process on other people who need to access VPository.

Step 2 - Setting up VPository

  1. Go back to VPository. You should be opening the Single Sign-On tab of the System Tools page. Now, enter Azure as the Identity Provider (IDP) Name.
    IDP name entered
    IDP name entered
  2. In the IDP metadata field, upload the metadata file saved 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 VPository application has been assigned to you in Microsoft Azure, and try again.
  5. From now on, VPository is integrated with Microsoft Azure. You, as the manager can access VPository with your Microsoft Azure account and perform administration and management tasks. Team members, once being invited and have accepted the invitations, can loginVPository  from Visual Paradigm with their Microsoft Azure account.
    Login with Microsoft Azure
    Login with Microsoft Azure

Step 3 - Member management

Since the integration with Microsoft Azure, in order for someone to become a VPository member, he/she has to:

  1. Be a person who have been assigned the VPository application in Microsoft Azure and,
  2. Have accepted the invitation sent from VPository manager.

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 VPository as manager.
  2. Click on your logo at the top right of the page and then select Manage VPository from the drop down menu.
  3. Select Members from the menu on the left hand side.
  4. Under the Members tab, click Invite Member.
    Invite member
    Invite member
  5. Enter the name and email of the members. Make sure you have already assigned the VPository application to them in Microsoft Azure. If not, they won't be able to access any projects. Click Send Invitation.
    Send invitation
    Send invitation
  6. The invitee will receive an invitation shortly. Click on the activation link in the email.
    To activate VPository account
    To activate VPository account
  7. He/she will be redirected to a web page where he/she can fill in his name. Enter the name and click Activate with Azure.
    Activating VPository account
    Activating VPository account
    If success, he will see the Congratulations screen. From now on, he/she can access VPository from Visual Paradigm with his/her Microsoft Azure account.
    Activation success
    Activation success

Related Resources

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

 
6. Setting up VPository with Okta Table of Contents 8. Managing groups
 

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.