Managing Tenants with APIs

This section guides you through invoking and working with the TenantManagementService and the operations you can work within this service.

1 Invoking the admin service
2 Operations included in the API

Invoking the admin service

TenantMgtAdminService is an admin service of the WSO2 Carbon platform. As admin services are secured to prevent anonymous invocations, you cannot view the WSDL of the admin service by default. Follow the steps below to view and invoke it:

Set the <HideAdminServiceWSDLs> element to false in <IS_HOME>/repository/conf/carbon.xml file.
<HideAdminServiceWSDLs>false</HideAdminServiceWSDLs>
Restart the Identity Server.
If you have started the server in default configurations, use the following URL in your browser to see the WSDL of the admin service: https://localhost:9443/services/TenantMgtAdminService?wsdl.

For more information on WSO2 admin services and how to invoke an admin service using either SoapUI or any other client program, see Calling Admin Services from Apps section in WSO2 Carbon documentation.

Operations included in the API

The following operations are available in the TenantManagement Service:

1 addTenant()
2 activateTenant()
3 deactivateTenant()
4 getTenant()
5 retrievePaginatedPartialSearchTenants()
6 retrievePaginatedTenants()
7 retrievePartialSearchTenants()
8 retrieveTenants()
9 updateTenant()

addTenant()

Description

Adds a new tenant.

Permission Level

/permission/protected/manage/monitor/tenants

Input Parameters

Parameter	Type	Description
tenantInfoBean	TenantInfoBean	Contains tenant related data
tenantInfoBean.tenantDomain	String	The domain name of the tenant
tenantInfoBean.active	Boolean	True - activate the tenant False- deactivate the tenant
tenantInfoBean.admin	String	The admin username
tenantInfoBean.adminPassword	String	The admin password
tenantInfoBean.createdDate	DateTime	The date and time that the tenant was created
tenantInfoBean.email	String	The email address of the tenant
tenantInfoBean.firstname	String	The first name of the tenant
tenantInfoBean.lastname	String	The last name of the tenant
tenantInfoBean.originatedService	String	-
tenantInfoBean.successKey	String	-
tenantInfoBean.tenantDomain	String	The tenant domain
tenantInfoBean.tenantId	Int	The tenant ID
tenantInfoBean.usagePlan	String	-

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.mgt.tenant.carbon.wso2.org" xmlns:xsd="http://beans.common.stratos.carbon.wso2.org/xsd">
    <soapenv:Header/>
    <soapenv:Body>
        <ser:addSkeletonTenant>
            <!Optional:>
            <ser:tenantInfoBean>
                <!Optional:>
                <xsd:active>true</xsd:active>
                <!Optional:>
                <xsd:admin>testuser</xsd:admin>
                <!Optional:>
                <xsd:adminPassword>testpw</xsd:adminPassword>
                <!Optional:>
                <xsd:createdDate></xsd:createdDate>
                <!Optional:>
                <xsd:email>testuser@example.com</xsd:email>
                <!Optional:>
                <xsd:firstname>First</xsd:firstname>
                <!Optional:>
                <xsd:lastname>Last</xsd:lastname>
                <!Optional:>
                <xsd:originatedService></xsd:originatedService>
                <!Optional:>
                <xsd:successKey></xsd:successKey>
                <!Optional:>
                <xsd:tenantDomain>example.com</xsd:tenantDomain>
                <!Optional:>
                <xsd:tenantId></xsd:tenantId>
                <!Optional:>
                <xsd:usagePlan></xsd:usagePlan>
            </ser:tenantInfoBean>
        </ser:addSkeletonTenant>
    </soapenv:Body>
</soapenv:Envelope>

Response

None

activateTenant()

Description

Activates an existing tenant.

Permission Level

/permission/protected/manage/modify/tenants

Input Parameters

Parameter	Type	Description
tenantDomain	String	The domain name of the tenant

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:ser="http://services.mgt.tenant.carbon.wso2.org">
    <soapenv:Header/>
    <soapenv:Body>
        <ser:activateTenant>
            <!Optional:>
            <ser:tenantDomain>example.com</ser:tenantDomain>
        </ser:activateTenant>
    </soapenv:Body>
</soapenv:Envelope>

Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:activateTenantResponse xmlns:ns="http://services.mgt.tenant.carbon.wso2.org">
            <ns:return xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" />
        </ns:activateTenantResponse>
    </soapenv:Body>
</soapenv:Envelope>