Micro Focus ALM/Quality Center

Minimal User Permissions & Viz User

We recommend that you create a new user within your external tool, to be used only in Viz. This is the user information you will enter when setting up your tool connection within Planview Viz. By creating a new user, you will ensure that the correct permissions are granted. 

In general, your user account should have sufficient permissions to read artifacts in your tool. 

Your user should have a secure password or token. Please be aware that Viz will not allow you to save a tool connection utilizing a weak password/token, such as 'tasktop.'

Connecting to the Micro Focus ALM/Quality Center Repository

Standard Authentication

Required Fields:

• URL  
  • Example Format: https://server.com:8080/qcbin
• Username 
• Password

Standard Authentication with OAuth2.0 Proxy Authentication

The MF ALM connector supports Standard Authentication with OAuth2.0 Proxy Authentication flow to authenticate with the proxy through an identity provider. It utilizes a base64-encoded representation of the username and password for authentication.

Required Fields:

• Location/Proxy URL
  • Example format: http://proxy-domain.com/proxy-path
• Identity Provider URL: Used to obtain the authentication token from the identity provider
• Client ID: A unique identifier assigned to a client application when it is registered with the identity provider
• Client Secret: Used to authenticate the identity of the client application when making requests to the identity provider
• Scope: Specify the access permissions
• Route: Based on the route, the request is redirected to the corresponding endpoint configured in the proxy
  • Example:
    Proxy URL: http://proxy-domain.com/proxy-path
    Suppose the proxy is configured with the following route and corresponding redirection URL:

    Route	Redirection URL
    Route123	https://dev-mfalm......com:8.../abc

    Resource Path: /obj/1234
    With this route configuration, upon successful authentication, the proxy will redirect the URL to: https://dev-mfalm...com:8.../abc/obj/1234

• Username: The username associated with the account used for authentication
• Password: The password associated with the provided username for authentication

1. HTTP Request Headers:
   • Authorization: OAuth2 token obtained from the Identity Provider
   • RepoAuthorization: base64-encoded representation of the username and password
   • AuthMode: Set to "pat" (Personal Access Token)
   • Route: Specify the route to the specific repository
2. Proxy Authentication with Identity Provider:
   • The proxy authenticates the OAuth2 token provided in the Authorization header with the Identity Provider, verifying its validity and checking for necessary permissions
3. Validation and Redirection:
   • Upon successful validation, the proxy replaces the content of the Authorization header with the RepoAuthorization token
   • The route header specifies the destination repository for redirection
   • If the validation process encounters an error, an error response is sent back to the client

API Key Access

Required Fields:

• URL  
  • Example Format: https://server.com:8080/qcbin
• Client ID 
  • see Micro Focus ALM/Quality Center instructions here
• API Key Secret
  • see Micro Focus ALM/Quality Center instructions here