Multitenancy for web services

This section explains how multitenancy works for BMC ProactiveNet web services.

Overview of multitenancy for web services

BMC ProactiveNet web services support the multitenancy feature only if your BMC ProactiveNet setup is integrated with BMC Atrium CMDB which is integrated with the BMC Cloud Lifecycle Management extension.

Now, the following web service APIs support multitenancy:

• Stats
• Configdata
• Metadata

For more information about these APIs, see Retrieving data from BMC ProactiveNet.

You can use the multitenancy feature by specifying the tenant name in a web service request, and it can fetch data that belongs to the tenant specified. It is optional to specify tenant name in a web service request.

For information about the multitenancy feature, see Tenant-aware support in a cloud environment.

Sending a tenant name in a web service request

If you use URL-encoded format, you can specify a tenant name in an authenticate web service request. If you specify the tenant name in the authenticate web service request, you do not have to specify it in your subsequent web service requests. BMC ProactiveNet Server internally saves the tenant name and uses it for your subsequent web service requests. If you do not specify the tenant name in an authenticate web service request, you need to specify the tenant name in the configdata, metadata, or stats web service requests. Based on the tenant name, your web service request fetches data that is specific to that particular tenant.

If you use Base64 encoded format, you need to specify the tenant name in the configdata, metadata, or stats web service requests.

The URL given in the following example fetches performance data for the specified devices that are specific to the tenant, calbro.

For more information about the authenticate web service request, see Authenticating user credentials.