Azure Analysis Services Connection
See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Azure Analysis Services connector.
Azure Analysis Services is a cloud-based analytics service by Microsoft Azure, providing data modeling and interactive analysis capabilities for organizations.
This topic describes how to authenticate to Azure Analysis Services and configure any necessary connection properties in the Azure Analysis Services connection connector.
Connection Configuration
Each connection property available in the Azure Analysis Services connector is explained below.
Connection Name
The name of the connection to be created should be provided. This is the name that will display on the list of available connections.
Auth Scheme
The type of authentication to use when connecting to Azure Analysis Services.
AzureAD: Set this to perform Azure Active Directory OAuth authentication.
AzureMSI: Set this to automatically obtain Managed Service Identity credentials when running on an Azure VM.
AzureServicePrincipal: Set this to authenticate as an Azure Service Principal using client credentials.
AzureServicePrincipalCert: Set this to authenticate as an Azure Service Principal using a certificate.
AzurePassword: Set this to submit User and Password to Azure. Under the hood, an OAuth process will still take place, but user/password credentials will be submitted which will avoid a browser window that will request authorization.
URL
The HTTP or HTTPS URL used to connect to the Azure Analysis Services.
URL Format Example: asazure://[region ].asazure.windows.net/[server ].
You can obtain the server name in Azure portal -> Overview -> Server name.
User
The Azure Analysis Services user account used to authenticate.
Password
The password used to authenticate the user.
Azure Tenant
The Microsoft Online tenant being used to access data. If not specified, your default tenant is used.
Example: contoso.onmicrosoft.com.
Alternatively, specify the tenant Id. This value is the directory Id in the Azure Portal > Azure Active Directory > Properties.
Azure Environment
The Azure Environment to use when establishing a connection.
Possible Values:
GLOBAL
CHINA
USGOVT
USGOVTDOD
In most cases, leaving the environment set to global will work. However, if your Azure Account is added to a different environment, the Azure Environment may be used to specify which environment.
OAuth Client ID
The client Id assigned when you register your application with an OAuth authorization server.
OAuth Client Secret
The client secret assigned when you register your application with an OAuth authorization server.
OAuth Access Token
The access token for connecting using OAuth.
OAuth Refresh Token
The OAuth refresh token for the corresponding OAuth access token.
OAuthJWT Certificate Type
The type of key store containing the JWT Certificate.
| Certificate Type | Description |
|---|---|
| PFXFILE | The certificate store is the name of a PFX (PKCS12) file containing certificates. |
| PFXBLOB | The certificate store is a string (base-64-encoded) representing a certificate store in PFX (PKCS12) format. |
| JKSFILE | The certificate store is the name of a Java key store (JKS) file containing certificates. Note: this store type is only available in Java. |
| JKSBLOB | The certificate store is a string (base-64-encoded) representing a certificate store in Java key store (JKS) format. Note: this store type is only available in Java. |
| PEMKEY_FILE | The certificate store is the name of a PEM-encoded file that contains a private key and an optional certificate. |
| PEMKEY_BLOB | The certificate store is a string (base64-encoded) that contains a private key and an optional certificate. |
| PUBLIC_KEY_FILE | The certificate store is the name of a file that contains a PEM- or DER-encoded public key certificate. |
| PUBLIC_KEY_BLOB | The certificate store is a string (base-64-encoded) that contains a PEM- or DER-encoded public key certificate. |
| SSHPUBLIC_KEY_FILE | The certificate store is the name of a file that contains an SSH-style public key. |
| SSHPUBLIC_KEY_BLOB | The certificate store is a string (base-64-encoded) that contains an SSH-style public key. |
| P7BFILE | The certificate store is the name of a PKCS7 file containing certificates. |
| PPKFILE | The certificate store is the name of a file that contains a PPK (PuTTY Private Key). |
| XMLFILE | The certificate store is the name of a file that contains a certificate in XML format. |
| XMLBLOB | The certificate store is a string that contains a certificate in XML format. |
OAuthJWT Certificate Password
The password for the OAuth JWT certificate.
If the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
OAuthJWT Certificate Subject
The subject of the OAuth JWT certificate.
When loading a certificate the subject is used to locate the certificate in the store.
If an exact match is not found, the store is searched for subjects containing the value of the property.
If a match is still not found, the property is set to an empty string, and no certificate is selected.
The special value “*” picks the first certificate in the certificate store.
The certificate subject is a comma separated list of distinguished name fields and values.
Example: “CN=www.server.com, OU=test, C=US, E=support@gathr.one”.
Common fields and their meanings are displayed below:
| Field | Meaning |
|---|---|
| CN | Common Name. This is commonly a host name like www.server.com. |
| O | Organization |
| OU | Organizational Unit |
| L | Locality |
| S | State |
| C | Country |
| E | Email Address |
If a field value contains a comma it must be quoted.
Upload OAuthJWTCert File
Upload the OAuth JWT Certificate file for authentication.
Add Configuration: Additional properties can be added using this option as key-value pairs.
After entering all the details, click on the TEST button.
If the connection service identification and authentication details are provided correctly, a success message stating “connection available” is generated.
Click on the CREATE button to save the changes.
If the details are incorrect or the server is down, you will get a message “Connection unavailable”.
If you have any feedback on Gathr documentation, please email us!